to-spreadsheet 1.2.0 → 1.3.0

package/README.md

@@ -145,7 +145,7 @@ const data = [
  - [x] Cell borders
  - [x] Cell styling (background colors, foreground colors, dates)
  - [x] Date cells with proper Excel formatting
- - [ ] Cell alignment
+ - [x] Cell alignment (horizontal and vertical)
  - [ ] Sheet styling
 
 ## Cell Borders
@@ -290,3 +290,121 @@ Colors should be specified in hex format:
 - `#000000` - Black
 - `#FFFFFF` - White
 - `#CCCCCC` - Light gray
+
+## Cell Alignment
+
+You can align cell content both horizontally and vertically:
+
+### Basic Alignment Usage
+
+```ts
+import { 
+  generateExcel, 
+  createHorizontallyAlignedCell, 
+  createVerticallyAlignedCell, 
+  createAlignedCell,
+  createCenteredCell,
+  HorizontalAlignment, 
+  VerticalAlignment 
+} from 'to-spreadsheet/lib/index';
+
+const data = [
+  {
+    title: 'AlignmentDemo',
+    content: [
+      [
+        'Feature',
+        'Horizontal',
+        'Vertical',
+        'Both'
+      ],
+      [
+        'Left Align',
+        createHorizontallyAlignedCell('Left Text', HorizontalAlignment.left),
+        createVerticallyAlignedCell('Top Text', VerticalAlignment.top),
+        createAlignedCell('Top-Left', HorizontalAlignment.left, VerticalAlignment.top)
+      ],
+      [
+        'Center Align',
+        createHorizontallyAlignedCell('Center Text', HorizontalAlignment.center),
+        createVerticallyAlignedCell('Center Text', VerticalAlignment.center),
+        createCenteredCell('Full Center')
+      ],
+      [
+        'Right Align',
+        createHorizontallyAlignedCell('Right Text', HorizontalAlignment.right),
+        createVerticallyAlignedCell('Bottom Text', VerticalAlignment.bottom),
+        createAlignedCell('Bottom-Right', HorizontalAlignment.right, VerticalAlignment.bottom)
+      ]
+    ]
+  }
+];
+```
+
+### Horizontal Alignment Options
+
+- `HorizontalAlignment.general` - General alignment (Excel default)
+- `HorizontalAlignment.left` - Left alignment
+- `HorizontalAlignment.center` - Center alignment  
+- `HorizontalAlignment.right` - Right alignment
+- `HorizontalAlignment.fill` - Fill alignment
+- `HorizontalAlignment.justify` - Justify alignment
+- `HorizontalAlignment.centerContinuous` - Center across selection
+- `HorizontalAlignment.distributed` - Distributed alignment
+
+### Vertical Alignment Options
+
+- `VerticalAlignment.top` - Top alignment
+- `VerticalAlignment.center` - Center alignment
+- `VerticalAlignment.bottom` - Bottom alignment
+- `VerticalAlignment.justify` - Justify alignment
+- `VerticalAlignment.distributed` - Distributed alignment
+
+### Alignment Helper Functions
+
+- `createHorizontallyAlignedCell(value, alignment)` - Creates cell with horizontal alignment
+- `createVerticallyAlignedCell(value, alignment)` - Creates cell with vertical alignment
+- `createAlignedCell(value, horizontal, vertical)` - Creates cell with both alignments
+- `createCenteredCell(value)` - Creates center-aligned cell (convenience function)
+
+### Combined with Other Features
+
+Alignment works seamlessly with all other styling features:
+
+```ts
+import { 
+  createStyledCell, 
+  HorizontalAlignment, 
+  VerticalAlignment,
+  createAllBorders, 
+  BorderStyle 
+} from 'to-spreadsheet/lib/index';
+
+const data = [
+  {
+    title: 'ComplexStyling',
+    content: [
+      [
+        // Full styling with alignment, colors, and borders
+        createStyledCell('Complete Style', {
+          horizontalAlignment: HorizontalAlignment.center,
+          verticalAlignment: VerticalAlignment.center,
+          backgroundColor: '#CCFFCC',
+          foregroundColor: '#FF0000',
+          border: createAllBorders(BorderStyle.thick, '#000000')
+        }),
+        
+        // Aligned date cell
+        createDateCell(new Date(), {
+          horizontalAlignment: HorizontalAlignment.right,
+          verticalAlignment: VerticalAlignment.center,
+          backgroundColor: '#FFFFCC'
+        }),
+        
+        // Simple centered text
+        createCenteredCell('Centered')
+      ]
+    ]
+  }
+];
+```

package/lib/index.d.ts

@@ -1,5 +1,5 @@
 import { generateExcel, EnvironmentType } from "./generate-excel";
-import { SkipCell, skipCell, Equation, writeEquation, createBorder, createAllBorders, createTopBorder, createBottomBorder, createLeftBorder, createRightBorder, createStyledCell, createBorderedCell, createDateCell, createBorderedDateCell, createBackgroundCell, createForegroundCell, createColoredCell, createBackgroundDateCell } from "./util";
+import { SkipCell, skipCell, Equation, writeEquation, createBorder, createAllBorders, createTopBorder, createBottomBorder, createLeftBorder, createRightBorder, createStyledCell, createBorderedCell, createDateCell, createBorderedDateCell, createBackgroundCell, createForegroundCell, createColoredCell, createBackgroundDateCell, createHorizontallyAlignedCell, createVerticallyAlignedCell, createAlignedCell, createCenteredCell } from "./util";
 declare enum ICellType {
     string = "s",
     number = "n",
@@ -16,6 +16,23 @@ declare enum BorderStyle {
     dotted = "dotted",
     dashed = "dashed"
 }
+declare enum HorizontalAlignment {
+    general = "general",
+    left = "left",
+    center = "center",
+    right = "right",
+    fill = "fill",
+    justify = "justify",
+    centerContinuous = "centerContinuous",
+    distributed = "distributed"
+}
+declare enum VerticalAlignment {
+    top = "top",
+    center = "center",
+    bottom = "bottom",
+    justify = "justify",
+    distributed = "distributed"
+}
 interface IBorder {
     top?: BorderStyle;
     right?: BorderStyle;
@@ -27,6 +44,8 @@ interface ICellStyle {
     border?: IBorder;
     backgroundColor?: string;
     foregroundColor?: string;
+    horizontalAlignment?: HorizontalAlignment;
+    verticalAlignment?: VerticalAlignment;
 }
 interface ICellString {
     type: ICellType.string;
@@ -68,7 +87,7 @@ interface IPage {
     title: string;
     content: (string | number | undefined | SkipCell | Equation | ICell)[][];
 }
-export { ICell, ISheet, IWorkbook, IRows, ICellType, IPage, BorderStyle, IBorder, ICellStyle, ICellDate };
+export { ICell, ISheet, IWorkbook, IRows, ICellType, IPage, BorderStyle, IBorder, ICellStyle, ICellDate, HorizontalAlignment, VerticalAlignment };
 declare const sampleData: ({
     title: string;
     content: (string[] | (number | Equation)[])[];
@@ -82,4 +101,4 @@ declare const sampleData: ({
     title: string;
     content: (string | number | ICell)[][];
 })[];
-export { generateExcel, sampleData, EnvironmentType, skipCell, writeEquation, createBorder, createAllBorders, createTopBorder, createBottomBorder, createLeftBorder, createRightBorder, createStyledCell, createBorderedCell, createDateCell, createBorderedDateCell, createBackgroundCell, createForegroundCell, createColoredCell, createBackgroundDateCell };
+export { generateExcel, sampleData, EnvironmentType, skipCell, writeEquation, createBorder, createAllBorders, createTopBorder, createBottomBorder, createLeftBorder, createRightBorder, createStyledCell, createBorderedCell, createDateCell, createBorderedDateCell, createBackgroundCell, createForegroundCell, createColoredCell, createBackgroundDateCell, createHorizontallyAlignedCell, createVerticallyAlignedCell, createAlignedCell, createCenteredCell };

package/lib/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createBackgroundDateCell = exports.createColoredCell = exports.createForegroundCell = exports.createBackgroundCell = exports.createBorderedDateCell = exports.createDateCell = exports.createBorderedCell = exports.createStyledCell = exports.createRightBorder = exports.createLeftBorder = exports.createBottomBorder = exports.createTopBorder = exports.createAllBorders = exports.createBorder = exports.writeEquation = exports.skipCell = exports.EnvironmentType = exports.sampleData = exports.generateExcel = exports.BorderStyle = exports.ICellType = void 0;
+exports.createCenteredCell = exports.createAlignedCell = exports.createVerticallyAlignedCell = exports.createHorizontallyAlignedCell = exports.createBackgroundDateCell = exports.createColoredCell = exports.createForegroundCell = exports.createBackgroundCell = exports.createBorderedDateCell = exports.createDateCell = exports.createBorderedCell = exports.createStyledCell = exports.createRightBorder = exports.createLeftBorder = exports.createBottomBorder = exports.createTopBorder = exports.createAllBorders = exports.createBorder = exports.writeEquation = exports.skipCell = exports.EnvironmentType = exports.sampleData = exports.generateExcel = exports.VerticalAlignment = exports.HorizontalAlignment = exports.BorderStyle = exports.ICellType = void 0;
 const generate_excel_1 = require("./generate-excel");
 Object.defineProperty(exports, "generateExcel", { enumerable: true, get: function () { return generate_excel_1.generateExcel; } });
 Object.defineProperty(exports, "EnvironmentType", { enumerable: true, get: function () { return generate_excel_1.EnvironmentType; } });
@@ -21,6 +21,10 @@ Object.defineProperty(exports, "createBackgroundCell", { enumerable: true, get:
 Object.defineProperty(exports, "createForegroundCell", { enumerable: true, get: function () { return util_1.createForegroundCell; } });
 Object.defineProperty(exports, "createColoredCell", { enumerable: true, get: function () { return util_1.createColoredCell; } });
 Object.defineProperty(exports, "createBackgroundDateCell", { enumerable: true, get: function () { return util_1.createBackgroundDateCell; } });
+Object.defineProperty(exports, "createHorizontallyAlignedCell", { enumerable: true, get: function () { return util_1.createHorizontallyAlignedCell; } });
+Object.defineProperty(exports, "createVerticallyAlignedCell", { enumerable: true, get: function () { return util_1.createVerticallyAlignedCell; } });
+Object.defineProperty(exports, "createAlignedCell", { enumerable: true, get: function () { return util_1.createAlignedCell; } });
+Object.defineProperty(exports, "createCenteredCell", { enumerable: true, get: function () { return util_1.createCenteredCell; } });
 var ICellType;
 (function (ICellType) {
     ICellType["string"] = "s";
@@ -41,6 +45,27 @@ var BorderStyle;
     BorderStyle["dashed"] = "dashed";
 })(BorderStyle || (BorderStyle = {}));
 exports.BorderStyle = BorderStyle;
+var HorizontalAlignment;
+(function (HorizontalAlignment) {
+    HorizontalAlignment["general"] = "general";
+    HorizontalAlignment["left"] = "left";
+    HorizontalAlignment["center"] = "center";
+    HorizontalAlignment["right"] = "right";
+    HorizontalAlignment["fill"] = "fill";
+    HorizontalAlignment["justify"] = "justify";
+    HorizontalAlignment["centerContinuous"] = "centerContinuous";
+    HorizontalAlignment["distributed"] = "distributed";
+})(HorizontalAlignment || (HorizontalAlignment = {}));
+exports.HorizontalAlignment = HorizontalAlignment;
+var VerticalAlignment;
+(function (VerticalAlignment) {
+    VerticalAlignment["top"] = "top";
+    VerticalAlignment["center"] = "center";
+    VerticalAlignment["bottom"] = "bottom";
+    VerticalAlignment["justify"] = "justify";
+    VerticalAlignment["distributed"] = "distributed";
+})(VerticalAlignment || (VerticalAlignment = {}));
+exports.VerticalAlignment = VerticalAlignment;
 const sampleData = [
     {
         title: 'Maifee1', content: [
@@ -151,6 +176,47 @@ const sampleData = [
                 42
             ]
         ]
+    },
+    {
+        title: 'AlignmentDemo',
+        content: [
+            [
+                'Feature',
+                'Horizontal Alignment',
+                'Vertical Alignment',
+                'Both Alignments'
+            ],
+            [
+                'Left Align',
+                (0, util_1.createHorizontallyAlignedCell)('Left Text', HorizontalAlignment.left),
+                (0, util_1.createVerticallyAlignedCell)('Top Text', VerticalAlignment.top),
+                (0, util_1.createAlignedCell)('Top-Left', HorizontalAlignment.left, VerticalAlignment.top)
+            ],
+            [
+                'Center Align',
+                (0, util_1.createHorizontallyAlignedCell)('Center Text', HorizontalAlignment.center),
+                (0, util_1.createVerticallyAlignedCell)('Center Text', VerticalAlignment.center),
+                (0, util_1.createCenteredCell)('Full Center')
+            ],
+            [
+                'Right Align',
+                (0, util_1.createHorizontallyAlignedCell)('Right Text', HorizontalAlignment.right),
+                (0, util_1.createVerticallyAlignedCell)('Bottom Text', VerticalAlignment.bottom),
+                (0, util_1.createAlignedCell)('Bottom-Right', HorizontalAlignment.right, VerticalAlignment.bottom)
+            ],
+            [
+                'Complex Style',
+                (0, util_1.createStyledCell)('All Features', {
+                    horizontalAlignment: HorizontalAlignment.center,
+                    verticalAlignment: VerticalAlignment.center,
+                    backgroundColor: '#CCFFCC',
+                    foregroundColor: '#FF0000',
+                    border: (0, util_1.createAllBorders)(BorderStyle.thick, '#000000')
+                }),
+                (0, util_1.createAlignedCell)(new Date(), HorizontalAlignment.right, VerticalAlignment.center),
+                (0, util_1.createCenteredCell)(42)
+            ]
+        ]
     }
 ];
 exports.sampleData = sampleData;

package/lib/util.d.ts

@@ -1,4 +1,4 @@
-import { IRows, IBorder, BorderStyle, ICellStyle, ICell } from ".";
+import { IRows, IBorder, BorderStyle, ICellStyle, ICell, HorizontalAlignment, VerticalAlignment } from ".";
 declare const indexToVbIndex: (index: number) => number;
 declare const indexToVbRelationIndex: (index: number) => number;
 declare const indexToRowIndex: (index: number) => string;
@@ -33,4 +33,8 @@ declare const createBackgroundCell: (value: string | number, backgroundColor: st
 declare const createForegroundCell: (value: string | number, foregroundColor: string) => ICell;
 declare const createColoredCell: (value: string | number, backgroundColor: string, foregroundColor: string) => ICell;
 declare const createBackgroundDateCell: (date: Date, backgroundColor: string) => ICell;
-export { indexToVbIndex, indexToVbRelationIndex, indexToRowIndex, rowColumnToVbPosition, calculateExtant, SkipCell, skipCell, Equation, writeEquation, createBorder, createAllBorders, createTopBorder, createBottomBorder, createLeftBorder, createRightBorder, getBorderKey, getStyleKey, createStyledCell, createBorderedCell, dateToExcelSerial, createDateCell, createBorderedDateCell, createBackgroundCell, createForegroundCell, createColoredCell, createBackgroundDateCell };
+declare const createHorizontallyAlignedCell: (value: string | number | Date, alignment: HorizontalAlignment) => ICell;
+declare const createVerticallyAlignedCell: (value: string | number | Date, alignment: VerticalAlignment) => ICell;
+declare const createAlignedCell: (value: string | number | Date, horizontal: HorizontalAlignment, vertical: VerticalAlignment) => ICell;
+declare const createCenteredCell: (value: string | number | Date) => ICell;
+export { indexToVbIndex, indexToVbRelationIndex, indexToRowIndex, rowColumnToVbPosition, calculateExtant, SkipCell, skipCell, Equation, writeEquation, createBorder, createAllBorders, createTopBorder, createBottomBorder, createLeftBorder, createRightBorder, getBorderKey, getStyleKey, createStyledCell, createBorderedCell, dateToExcelSerial, createDateCell, createBorderedDateCell, createBackgroundCell, createForegroundCell, createColoredCell, createBackgroundDateCell, createHorizontallyAlignedCell, createVerticallyAlignedCell, createAlignedCell, createCenteredCell };

package/lib/util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createBackgroundDateCell = exports.createColoredCell = exports.createForegroundCell = exports.createBackgroundCell = exports.createBorderedDateCell = exports.createDateCell = exports.dateToExcelSerial = exports.createBorderedCell = exports.createStyledCell = exports.getStyleKey = exports.getBorderKey = exports.createRightBorder = exports.createLeftBorder = exports.createBottomBorder = exports.createTopBorder = exports.createAllBorders = exports.createBorder = exports.writeEquation = exports.Equation = exports.skipCell = exports.SkipCell = exports.calculateExtant = exports.rowColumnToVbPosition = exports.indexToRowIndex = exports.indexToVbRelationIndex = exports.indexToVbIndex = void 0;
+exports.createCenteredCell = exports.createAlignedCell = exports.createVerticallyAlignedCell = exports.createHorizontallyAlignedCell = exports.createBackgroundDateCell = exports.createColoredCell = exports.createForegroundCell = exports.createBackgroundCell = exports.createBorderedDateCell = exports.createDateCell = exports.dateToExcelSerial = exports.createBorderedCell = exports.createStyledCell = exports.getStyleKey = exports.getBorderKey = exports.createRightBorder = exports.createLeftBorder = exports.createBottomBorder = exports.createTopBorder = exports.createAllBorders = exports.createBorder = exports.writeEquation = exports.Equation = exports.skipCell = exports.SkipCell = exports.calculateExtant = exports.rowColumnToVbPosition = exports.indexToRowIndex = exports.indexToVbRelationIndex = exports.indexToVbIndex = void 0;
 const _1 = require(".");
 const indexToVbIndex = (index) => index + 1;
 exports.indexToVbIndex = indexToVbIndex;
@@ -88,7 +88,9 @@ const getStyleKey = (style) => {
     const parts = [
         getBorderKey(style.border),
         style.backgroundColor || "no-bg",
-        style.foregroundColor || "no-fg"
+        style.foregroundColor || "no-fg",
+        style.horizontalAlignment || "no-halign",
+        style.verticalAlignment || "no-valign"
     ];
     return parts.join("|");
 };
@@ -149,3 +151,34 @@ const createBackgroundDateCell = (date, backgroundColor) => {
     return createDateCell(date, { backgroundColor });
 };
 exports.createBackgroundDateCell = createBackgroundDateCell;
+const createHorizontallyAlignedCell = (value, alignment) => {
+    if (value instanceof Date) {
+        return createDateCell(value, { horizontalAlignment: alignment });
+    }
+    return createStyledCell(value, { horizontalAlignment: alignment });
+};
+exports.createHorizontallyAlignedCell = createHorizontallyAlignedCell;
+const createVerticallyAlignedCell = (value, alignment) => {
+    if (value instanceof Date) {
+        return createDateCell(value, { verticalAlignment: alignment });
+    }
+    return createStyledCell(value, { verticalAlignment: alignment });
+};
+exports.createVerticallyAlignedCell = createVerticallyAlignedCell;
+const createAlignedCell = (value, horizontal, vertical) => {
+    if (value instanceof Date) {
+        return createDateCell(value, {
+            horizontalAlignment: horizontal,
+            verticalAlignment: vertical
+        });
+    }
+    return createStyledCell(value, {
+        horizontalAlignment: horizontal,
+        verticalAlignment: vertical
+    });
+};
+exports.createAlignedCell = createAlignedCell;
+const createCenteredCell = (value) => {
+    return createAlignedCell(value, _1.HorizontalAlignment.center, _1.VerticalAlignment.center);
+};
+exports.createCenteredCell = createCenteredCell;

package/lib/xl/styles.xml.js

@@ -59,6 +59,20 @@ const generateFillXml = (color) => {
       </patternFill>
     </fill>`;
 };
+const generateAlignmentXml = (style) => {
+    const hasAlignment = style.horizontalAlignment || style.verticalAlignment;
+    if (!hasAlignment) {
+        return '';
+    }
+    let alignmentAttrs = '';
+    if (style.horizontalAlignment) {
+        alignmentAttrs += ` horizontal="${style.horizontalAlignment}"`;
+    }
+    if (style.verticalAlignment) {
+        alignmentAttrs += ` vertical="${style.verticalAlignment}"`;
+    }
+    return `<alignment${alignmentAttrs} />`;
+};
 const generateStyleXml = (styleMap, hasDateCells = false) => {
     const styles = Array.from(styleMap.values());
     const styleCount = styles.length;
@@ -98,14 +112,18 @@ const generateStyleXml = (styleMap, hasDateCells = false) => {
             const borderIndex = Array.from(uniqueBorders.keys()).indexOf(JSON.stringify(style.border || {}));
             const fontIndex = Array.from(uniqueFonts.keys()).indexOf(style.foregroundColor || "default");
             const fillIndex = Array.from(uniqueFills.keys()).indexOf(style.backgroundColor || "none");
-            return `<xf numFmtId="0" fontId="${fontIndex}" fillId="${fillIndex}" borderId="${borderIndex}" xfId="0" />`;
+            const alignmentXml = generateAlignmentXml(style);
+            const applyAlignment = style.horizontalAlignment || style.verticalAlignment ? ' applyAlignment="1"' : '';
+            return `<xf numFmtId="0" fontId="${fontIndex}" fillId="${fillIndex}" borderId="${borderIndex}" xfId="0"${applyAlignment}>${alignmentXml}</xf>`;
         }).join('\n        ');
         cellXfsXml += '\n        ';
         cellXfsXml += styles.map((style, index) => {
             const borderIndex = Array.from(uniqueBorders.keys()).indexOf(JSON.stringify(style.border || {}));
             const fontIndex = Array.from(uniqueFonts.keys()).indexOf(style.foregroundColor || "default");
             const fillIndex = Array.from(uniqueFills.keys()).indexOf(style.backgroundColor || "none");
-            return `<xf numFmtId="164" fontId="${fontIndex}" fillId="${fillIndex}" borderId="${borderIndex}" xfId="0" />`;
+            const alignmentXml = generateAlignmentXml(style);
+            const applyAlignment = style.horizontalAlignment || style.verticalAlignment ? ' applyAlignment="1"' : '';
+            return `<xf numFmtId="164" fontId="${fontIndex}" fillId="${fillIndex}" borderId="${borderIndex}" xfId="0"${applyAlignment}>${alignmentXml}</xf>`;
         }).join('\n        ');
         cellXfsCount = styleCount * 2;
     }
@@ -114,7 +132,9 @@ const generateStyleXml = (styleMap, hasDateCells = false) => {
             const borderIndex = Array.from(uniqueBorders.keys()).indexOf(JSON.stringify(style.border || {}));
             const fontIndex = Array.from(uniqueFonts.keys()).indexOf(style.foregroundColor || "default");
             const fillIndex = Array.from(uniqueFills.keys()).indexOf(style.backgroundColor || "none");
-            return `<xf numFmtId="0" fontId="${fontIndex}" fillId="${fillIndex}" borderId="${borderIndex}" xfId="0" />`;
+            const alignmentXml = generateAlignmentXml(style);
+            const applyAlignment = style.horizontalAlignment || style.verticalAlignment ? ' applyAlignment="1"' : '';
+            return `<xf numFmtId="0" fontId="${fontIndex}" fillId="${fillIndex}" borderId="${borderIndex}" xfId="0"${applyAlignment}>${alignmentXml}</xf>`;
         }).join('\n        ');
     }
     return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "to-spreadsheet",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "npm package to create spreadsheet in node environment and in browser",
   "keywords": [
     "excel",