to-spreadsheet 1.2.0 → 1.4.0

package/README.md

@@ -40,6 +40,55 @@ generateExcel(sampleData); // <-- by default generate XLSX for node
 generateExcel(sampleData, EnvironmentType.BROWSER); // <-- for browser
 ```
 
+# Reading / Importing
+
+`to-spreadsheet` can also read spreadsheets back into plain JavaScript values. The
+reader works in **both Node.js and the browser** and covers `.xlsx` (OOXML) files —
+those produced by this library as well as ordinary files from Excel and other tools —
+plus CSV text.
+
+## Reading an `.xlsx` file
+
+```ts
+import { readExcel } from 'to-spreadsheet/lib/index';
+
+// Node.js: pass a file path, a Buffer, or a Uint8Array/ArrayBuffer
+const workbook = await readExcel('./report.xlsx');
+
+// Browser: pass a File/Blob (e.g. from <input type="file">) or an ArrayBuffer
+// const workbook = await readExcel(file);
+
+workbook.sheets.forEach((sheet) => {
+  console.log(sheet.title);   // sheet (tab) name
+  console.log(sheet.rows);    // ReadCellValue[][] — a dense grid, gaps are null
+});
+```
+
+Each cell comes back as a `string`, `number`, `boolean`, `Date` (for date-formatted
+cells) or `null` (empty). Date conversion can be disabled to get the raw Excel serial:
+
+```ts
+const workbook = await readExcel('./report.xlsx', { cellDates: false });
+```
+
+Formula cells are surfaced on an optional parallel `sheet.formulas` grid (the formula
+text without the leading `=`), present only when a sheet contains at least one formula.
+
+## Parsing CSV
+
+```ts
+import { parseCsv } from 'to-spreadsheet/lib/index';
+
+const rows = parseCsv('name,age\nalice,30\n"bob, jr.",25');
+// [["name","age"], ["alice","30"], ["bob, jr.","25"]]
+
+// custom delimiter
+const tsv = parseCsv(tabText, { delimiter: '\t' });
+```
+
+`parseCsv` follows RFC 4180: quoted fields, escaped quotes (`""`), embedded commas and
+newlines, `\r\n`/`\n` line endings, and a leading UTF-8 BOM are all handled.
+
 # Cell Features
 
 ## Dates
@@ -145,7 +194,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 +339,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/generate-excel.d.ts

@@ -1,7 +1,19 @@
-import { IPage } from "./index";
+import { IPage, IWorkbook } from "./index";
+declare const generateTree: (workbook: IWorkbook) => {
+    "[Content_Types].xml": string;
+    "_rels/.rels": string;
+    "docProps/app.xml": string;
+    "docProps/core.xml": string;
+    "xl/_rels/workbook.xml.rels": string;
+    "xl/sharedStrings.xml": string;
+    "xl/styles.xml": string;
+    "xl/theme/theme1.xml": string;
+    "xl/workbook.xml": string;
+};
 declare enum EnvironmentType {
     NODE = 0,
     BROWSER = 1
 }
+declare const buildWorkbook: (dump: IPage[]) => IWorkbook;
 declare const generateExcel: (dump: IPage[], environmentType?: EnvironmentType) => Promise<void>;
-export { generateExcel, EnvironmentType };
+export { generateExcel, EnvironmentType, buildWorkbook, generateTree };

package/lib/generate-excel.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnvironmentType = exports.generateExcel = void 0;
+exports.generateTree = exports.buildWorkbook = exports.EnvironmentType = exports.generateExcel = void 0;
 const content_types_xml_1 = require("./content-types.xml");
 const _rels_1 = require("./_rels/.rels");
 const app_xml_1 = require("./docProps/app.xml");
@@ -11,7 +11,7 @@ const styles_xml_1 = require("./xl/styles.xml");
 const theme1_xml_1 = require("./xl/theme/theme1.xml");
 const workbook_xml_1 = require("./xl/workbook.xml");
 const sheet_xml_1 = require("./xl/worksheets/sheet.xml");
-const index_1 = require("./index");
+const types_1 = require("./types");
 const util_1 = require("./util");
 const generateTree = (workbook) => {
     const styleMap = new Map();
@@ -20,7 +20,7 @@ const generateTree = (workbook) => {
     workbook.sheets.forEach(sheet => {
         sheet.rows.forEach(row => {
             row.cells.forEach(cell => {
-                if (cell.type === index_1.ICellType.date) {
+                if (cell.type === types_1.ICellType.date) {
                     hasDateCells = true;
                 }
                 if ('style' in cell && cell.style) {
@@ -32,41 +32,42 @@ const generateTree = (workbook) => {
     });
     return Object.assign({ "[Content_Types].xml": (0, content_types_xml_1.generateContentTypesXml)(workbook), "_rels/.rels": (0, _rels_1.generateRels)(), "docProps/app.xml": (0, app_xml_1.generateAppXml)(workbook), "docProps/core.xml": (0, core_xml_1.generateCoreXml)({}), "xl/_rels/workbook.xml.rels": (0, workbook_xml_rels_1.generateWorkBookXmlRels)(workbook), "xl/sharedStrings.xml": (0, sharedStrings_xml_1.generateSharedStrings)(workbook), "xl/styles.xml": (0, styles_xml_1.generateStyleXml)(styleMap, hasDateCells), "xl/theme/theme1.xml": (0, theme1_xml_1.generateTheme1)(), "xl/workbook.xml": (0, workbook_xml_1.generateWorkBookXml)(workbook) }, workbook.sheets.reduce((acc, sheet, idx) => (Object.assign(Object.assign({}, acc), { [`xl/worksheets/sheet${idx + 1}.xml`]: (0, sheet_xml_1.generateSheetXml)(sheet, styleMap, hasDateCells) })), {}));
 };
+exports.generateTree = generateTree;
 var EnvironmentType;
 (function (EnvironmentType) {
     EnvironmentType[EnvironmentType["NODE"] = 0] = "NODE";
     EnvironmentType[EnvironmentType["BROWSER"] = 1] = "BROWSER";
 })(EnvironmentType || (EnvironmentType = {}));
 exports.EnvironmentType = EnvironmentType;
-const generateExcel = (dump, environmentType = EnvironmentType.NODE) => {
+const buildWorkbook = (dump) => {
     const strings = [];
     const sheets = dump.map(({ title, content }) => {
         const rows = content.map(row => {
             const cells = [];
             row.forEach(content => {
                 if (typeof content === 'number') {
-                    cells.push({ type: index_1.ICellType.number, value: content });
+                    cells.push({ type: types_1.ICellType.number, value: content });
                 }
                 else if (typeof content === 'string') {
-                    const type = index_1.ICellType.string;
+                    const type = types_1.ICellType.string;
                     let value = strings.indexOf(content);
                     if (value === -1) {
                         strings.push(content);
                         value = strings.length - 1;
                     }
-                    cells.push({ type: index_1.ICellType.string, value });
+                    cells.push({ type: types_1.ICellType.string, value });
                 }
                 else if (content instanceof util_1.SkipCell) {
                     for (let i = 0; i < content.getSkipCell(); i++) {
-                        cells.push({ type: index_1.ICellType.skip, value: undefined });
+                        cells.push({ type: types_1.ICellType.skip, value: undefined });
                     }
                 }
                 else if (content instanceof util_1.Equation) {
-                    cells.push({ type: index_1.ICellType.equation, value: content });
+                    cells.push({ type: types_1.ICellType.equation, value: content });
                 }
                 else if (content && typeof content === 'object' && 'type' in content) {
                     const cell = content;
-                    if (cell.type === index_1.ICellType.string && typeof cell.value === 'string') {
+                    if (cell.type === types_1.ICellType.string && typeof cell.value === 'string') {
                         let stringIndex = strings.indexOf(cell.value);
                         if (stringIndex === -1) {
                             strings.push(cell.value);
@@ -79,18 +80,22 @@ const generateExcel = (dump, environmentType = EnvironmentType.NODE) => {
                     }
                 }
                 else {
-                    cells.push({ type: index_1.ICellType.skip });
+                    cells.push({ type: types_1.ICellType.skip });
                 }
             });
             return { cells };
         });
         return { title, rows };
     });
-    const workbook = {
+    return {
         sheets,
         strings,
         filename: "tem.xlsx"
     };
+};
+exports.buildWorkbook = buildWorkbook;
+const generateExcel = (dump, environmentType = EnvironmentType.NODE) => {
+    const workbook = buildWorkbook(dump);
     if (environmentType === EnvironmentType.BROWSER) {
         return generateExcelWorkbookBrowser(workbook);
     }

package/lib/index.d.ts

@@ -1,21 +1,8 @@
 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";
-declare enum ICellType {
-    string = "s",
-    number = "n",
-    date = "d",
-    skip = "skip",
-    equation = "equation"
-}
-declare enum BorderStyle {
-    none = "none",
-    thin = "thin",
-    medium = "medium",
-    thick = "thick",
-    double = "double",
-    dotted = "dotted",
-    dashed = "dashed"
-}
+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";
+import { readExcel, ReadCellValue, IReadSheet, IReadWorkbook, IReadOptions, ReadExcelInput } from "./read-excel";
+import { parseCsv, ICsvOptions } from "./read-csv";
+import { ICellType, BorderStyle, HorizontalAlignment, VerticalAlignment } from "./types";
 interface IBorder {
     top?: BorderStyle;
     right?: BorderStyle;
@@ -27,6 +14,8 @@ interface ICellStyle {
     border?: IBorder;
     backgroundColor?: string;
     foregroundColor?: string;
+    horizontalAlignment?: HorizontalAlignment;
+    verticalAlignment?: VerticalAlignment;
 }
 interface ICellString {
     type: ICellType.string;
@@ -51,7 +40,7 @@ interface ICellDate {
     value: Date;
     style?: ICellStyle;
 }
-declare type ICell = ICellString | ICellNumber | ICellDate | ICellSkip | ICellEquation;
+type ICell = ICellString | ICellNumber | ICellDate | ICellSkip | ICellEquation;
 interface IRows {
     cells: ICell[];
 }
@@ -68,7 +57,8 @@ 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 };
+export { ReadCellValue, IReadSheet, IReadWorkbook, IReadOptions, ReadExcelInput, ICsvOptions };
 declare const sampleData: ({
     title: string;
     content: (string[] | (number | Equation)[])[];
@@ -82,4 +72,5 @@ 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 };
+export { readExcel, parseCsv };

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.parseCsv = exports.readExcel = 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,26 +21,19 @@ 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; } });
-var ICellType;
-(function (ICellType) {
-    ICellType["string"] = "s";
-    ICellType["number"] = "n";
-    ICellType["date"] = "d";
-    ICellType["skip"] = "skip";
-    ICellType["equation"] = "equation";
-})(ICellType || (ICellType = {}));
-exports.ICellType = ICellType;
-var BorderStyle;
-(function (BorderStyle) {
-    BorderStyle["none"] = "none";
-    BorderStyle["thin"] = "thin";
-    BorderStyle["medium"] = "medium";
-    BorderStyle["thick"] = "thick";
-    BorderStyle["double"] = "double";
-    BorderStyle["dotted"] = "dotted";
-    BorderStyle["dashed"] = "dashed";
-})(BorderStyle || (BorderStyle = {}));
-exports.BorderStyle = BorderStyle;
+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; } });
+const read_excel_1 = require("./read-excel");
+Object.defineProperty(exports, "readExcel", { enumerable: true, get: function () { return read_excel_1.readExcel; } });
+const read_csv_1 = require("./read-csv");
+Object.defineProperty(exports, "parseCsv", { enumerable: true, get: function () { return read_csv_1.parseCsv; } });
+const types_1 = require("./types");
+Object.defineProperty(exports, "ICellType", { enumerable: true, get: function () { return types_1.ICellType; } });
+Object.defineProperty(exports, "BorderStyle", { enumerable: true, get: function () { return types_1.BorderStyle; } });
+Object.defineProperty(exports, "HorizontalAlignment", { enumerable: true, get: function () { return types_1.HorizontalAlignment; } });
+Object.defineProperty(exports, "VerticalAlignment", { enumerable: true, get: function () { return types_1.VerticalAlignment; } });
 const sampleData = [
     {
         title: 'Maifee1', content: [
@@ -57,9 +50,9 @@ const sampleData = [
         title: 'BorderDemo',
         content: [
             [
-                (0, util_1.createBorderedCell)('Product', (0, util_1.createAllBorders)(BorderStyle.thick, '#000000')),
-                (0, util_1.createBorderedCell)('Price', (0, util_1.createAllBorders)(BorderStyle.thick, '#000000')),
-                (0, util_1.createBorderedCell)('Total', (0, util_1.createAllBorders)(BorderStyle.thick, '#000000'))
+                (0, util_1.createBorderedCell)('Product', (0, util_1.createAllBorders)(types_1.BorderStyle.thick, '#000000')),
+                (0, util_1.createBorderedCell)('Price', (0, util_1.createAllBorders)(types_1.BorderStyle.thick, '#000000')),
+                (0, util_1.createBorderedCell)('Total', (0, util_1.createAllBorders)(types_1.BorderStyle.thick, '#000000'))
             ],
             [
                 (0, util_1.createBorderedCell)('Apple', (0, util_1.createLeftBorder)()),
@@ -69,8 +62,8 @@ const sampleData = [
             [
                 (0, util_1.createStyledCell)('Custom', {
                     border: {
-                        left: BorderStyle.double,
-                        bottom: BorderStyle.thin,
+                        left: types_1.BorderStyle.double,
+                        bottom: types_1.BorderStyle.thin,
                         color: '#0000FF'
                     }
                 }),
@@ -90,7 +83,7 @@ const sampleData = [
             [
                 'Project Start',
                 (0, util_1.createDateCell)(new Date('2024-01-01')),
-                (0, util_1.createBorderedDateCell)(new Date('2024-01-15'), (0, util_1.createAllBorders)(BorderStyle.thin, '#000000'))
+                (0, util_1.createBorderedDateCell)(new Date('2024-01-15'), (0, util_1.createAllBorders)(types_1.BorderStyle.thin, '#000000'))
             ],
             [
                 'Milestone 1',
@@ -101,8 +94,8 @@ const sampleData = [
                 'Custom Date Style',
                 (0, util_1.createDateCell)(new Date('2024-06-15'), {
                     border: {
-                        top: BorderStyle.thick,
-                        bottom: BorderStyle.double,
+                        top: types_1.BorderStyle.thick,
+                        bottom: types_1.BorderStyle.double,
                         color: '#FF0000'
                     }
                 }),
@@ -145,12 +138,53 @@ const sampleData = [
                 (0, util_1.createStyledCell)('Complex', {
                     backgroundColor: '#FFFFCC',
                     foregroundColor: '#0000FF',
-                    border: (0, util_1.createAllBorders)(BorderStyle.thick, '#000000')
+                    border: (0, util_1.createAllBorders)(types_1.BorderStyle.thick, '#000000')
                 }),
                 'Plain text',
                 42
             ]
         ]
+    },
+    {
+        title: 'AlignmentDemo',
+        content: [
+            [
+                'Feature',
+                'Horizontal Alignment',
+                'Vertical Alignment',
+                'Both Alignments'
+            ],
+            [
+                'Left Align',
+                (0, util_1.createHorizontallyAlignedCell)('Left Text', types_1.HorizontalAlignment.left),
+                (0, util_1.createVerticallyAlignedCell)('Top Text', types_1.VerticalAlignment.top),
+                (0, util_1.createAlignedCell)('Top-Left', types_1.HorizontalAlignment.left, types_1.VerticalAlignment.top)
+            ],
+            [
+                'Center Align',
+                (0, util_1.createHorizontallyAlignedCell)('Center Text', types_1.HorizontalAlignment.center),
+                (0, util_1.createVerticallyAlignedCell)('Center Text', types_1.VerticalAlignment.center),
+                (0, util_1.createCenteredCell)('Full Center')
+            ],
+            [
+                'Right Align',
+                (0, util_1.createHorizontallyAlignedCell)('Right Text', types_1.HorizontalAlignment.right),
+                (0, util_1.createVerticallyAlignedCell)('Bottom Text', types_1.VerticalAlignment.bottom),
+                (0, util_1.createAlignedCell)('Bottom-Right', types_1.HorizontalAlignment.right, types_1.VerticalAlignment.bottom)
+            ],
+            [
+                'Complex Style',
+                (0, util_1.createStyledCell)('All Features', {
+                    horizontalAlignment: types_1.HorizontalAlignment.center,
+                    verticalAlignment: types_1.VerticalAlignment.center,
+                    backgroundColor: '#CCFFCC',
+                    foregroundColor: '#FF0000',
+                    border: (0, util_1.createAllBorders)(types_1.BorderStyle.thick, '#000000')
+                }),
+                (0, util_1.createAlignedCell)(new Date(), types_1.HorizontalAlignment.right, types_1.VerticalAlignment.center),
+                (0, util_1.createCenteredCell)(42)
+            ]
+        ]
     }
 ];
 exports.sampleData = sampleData;

package/lib/read-csv.d.ts

@@ -0,0 +1,6 @@
+interface ICsvOptions {
+    delimiter?: string;
+    skipEmptyTrailingRow?: boolean;
+}
+declare const parseCsv: (text: string, options?: ICsvOptions) => string[][];
+export { parseCsv, ICsvOptions };

package/lib/read-csv.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCsv = void 0;
+const parseCsv = (text, options = {}) => {
+    var _a;
+    const delimiter = (_a = options.delimiter) !== null && _a !== void 0 ? _a : ",";
+    const skipEmptyTrailingRow = options.skipEmptyTrailingRow !== false;
+    const delim = delimiter.charAt(0);
+    if (text.charCodeAt(0) === 0xfeff)
+        text = text.slice(1);
+    const rows = [];
+    let row = [];
+    let field = "";
+    let inQuotes = false;
+    let i = 0;
+    const length = text.length;
+    const endField = () => {
+        row.push(field);
+        field = "";
+    };
+    const endRow = () => {
+        endField();
+        rows.push(row);
+        row = [];
+    };
+    while (i < length) {
+        const char = text[i];
+        if (inQuotes) {
+            if (char === '"') {
+                if (text[i + 1] === '"') {
+                    field += '"';
+                    i += 2;
+                    continue;
+                }
+                inQuotes = false;
+                i++;
+                continue;
+            }
+            field += char;
+            i++;
+            continue;
+        }
+        if (char === '"') {
+            inQuotes = true;
+            i++;
+            continue;
+        }
+        if (char === delim) {
+            endField();
+            i++;
+            continue;
+        }
+        if (char === "\n") {
+            endRow();
+            i++;
+            continue;
+        }
+        if (char === "\r") {
+            endRow();
+            if (text[i + 1] === "\n")
+                i += 2;
+            else
+                i++;
+            continue;
+        }
+        field += char;
+        i++;
+    }
+    if (field.length > 0 || row.length > 0) {
+        endRow();
+    }
+    if (skipEmptyTrailingRow &&
+        rows.length > 0 &&
+        rows[rows.length - 1].length === 1 &&
+        rows[rows.length - 1][0] === "") {
+        rows.pop();
+    }
+    return rows;
+};
+exports.parseCsv = parseCsv;

package/lib/read-excel.d.ts

@@ -0,0 +1,23 @@
+/// <reference types="node" />
+type ReadCellValue = string | number | boolean | Date | null;
+interface IReadSheet {
+    title: string;
+    rows: ReadCellValue[][];
+    formulas?: (string | null)[][];
+}
+interface IReadWorkbook {
+    sheets: IReadSheet[];
+}
+interface IReadOptions {
+    cellDates?: boolean;
+}
+type ReadExcelInput = string | Uint8Array | ArrayBuffer | Blob;
+declare const columnLettersToIndex: (letters: string) => number;
+declare const excelSerialToDate: (serial: number) => Date;
+declare const parseSharedStrings: (sharedStringsXml: string | undefined) => string[];
+declare const parseWorksheet: (sheetXml: string, sharedStrings: string[], dateStyleFlags: boolean[], cellDates: boolean) => {
+    rows: ReadCellValue[][];
+    formulas?: (string | null)[][] | undefined;
+};
+declare const readExcel: (input: ReadExcelInput, options?: IReadOptions) => Promise<IReadWorkbook>;
+export { readExcel, ReadCellValue, IReadSheet, IReadWorkbook, IReadOptions, ReadExcelInput, columnLettersToIndex, excelSerialToDate, parseSharedStrings, parseWorksheet, };

package/lib/read-excel.js

@@ -0,0 +1,265 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseWorksheet = exports.parseSharedStrings = exports.excelSerialToDate = exports.columnLettersToIndex = exports.readExcel = void 0;
+const decodeXml = (text) => text
+    .replace(/&#x([0-9a-fA-F]+);/g, (_, hex) => String.fromCodePoint(parseInt(hex, 16)))
+    .replace(/&#(\d+);/g, (_, dec) => String.fromCodePoint(parseInt(dec, 10)))
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&quot;/g, '"')
+    .replace(/&apos;/g, "'")
+    .replace(/&amp;/g, "&");
+const getAttr = (attrs, name) => {
+    const match = attrs.match(new RegExp(`\\b${name}\\s*=\\s*"([^"]*)"|\\b${name}\\s*=\\s*'([^']*)'`));
+    if (!match)
+        return undefined;
+    return decodeXml(match[1] !== undefined ? match[1] : match[2]);
+};
+const columnLettersToIndex = (letters) => {
+    let index = 0;
+    for (let i = 0; i < letters.length; i++) {
+        index = index * 26 + (letters.charCodeAt(i) - 64);
+    }
+    return index - 1;
+};
+exports.columnLettersToIndex = columnLettersToIndex;
+const excelSerialToDate = (serial) => {
+    const excelEpoch = new Date(1900, 0, 1);
+    const offset = serial >= 60 ? 2 : 1;
+    const millis = excelEpoch.getTime() + (serial - offset) * 24 * 60 * 60 * 1000;
+    return new Date(millis);
+};
+exports.excelSerialToDate = excelSerialToDate;
+const BUILTIN_DATE_FORMAT_IDS = new Set([
+    14, 15, 16, 17, 18, 19, 20, 21, 22, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36,
+    45, 46, 47, 50, 51, 52, 53, 54, 55, 56, 57, 58,
+]);
+const isDateFormatCode = (code) => {
+    const stripped = code
+        .replace(/\[[^\]]*\]/g, "")
+        .replace(/"[^"]*"/g, "")
+        .replace(/\\./g, "");
+    return /[yYdDhHsS]/.test(stripped) || /\bmm?m?m?\b/.test(stripped) && /[yYdDhH]/.test(code);
+};
+const parseDateStyleFlags = (stylesXml) => {
+    if (!stylesXml)
+        return [];
+    const dateNumFmtIds = new Set(BUILTIN_DATE_FORMAT_IDS);
+    const numFmtRe = /<numFmt\b([^>]*)\/?>/g;
+    let numFmtMatch;
+    while ((numFmtMatch = numFmtRe.exec(stylesXml)) !== null) {
+        const id = Number(getAttr(numFmtMatch[1], "numFmtId"));
+        const code = getAttr(numFmtMatch[1], "formatCode");
+        if (!Number.isNaN(id) && code && isDateFormatCode(code)) {
+            dateNumFmtIds.add(id);
+        }
+    }
+    const cellXfsBlock = stylesXml.match(/<cellXfs\b[^>]*>([\s\S]*?)<\/cellXfs>/);
+    if (!cellXfsBlock)
+        return [];
+    const flags = [];
+    const xfRe = /<xf\b([^>]*?)(?:\/>|>[\s\S]*?<\/xf>)/g;
+    let xfMatch;
+    while ((xfMatch = xfRe.exec(cellXfsBlock[1])) !== null) {
+        const numFmtId = Number(getAttr(xfMatch[1], "numFmtId"));
+        flags.push(!Number.isNaN(numFmtId) && dateNumFmtIds.has(numFmtId));
+    }
+    return flags;
+};
+const parseSharedStrings = (sharedStringsXml) => {
+    if (!sharedStringsXml)
+        return [];
+    const strings = [];
+    const siRe = /<si\b[^>]*>([\s\S]*?)<\/si>|<si\b[^>]*\/>/g;
+    let siMatch;
+    while ((siMatch = siRe.exec(sharedStringsXml)) !== null) {
+        const inner = siMatch[1] || "";
+        let text = "";
+        const tRe = /<t\b[^>]*>([\s\S]*?)<\/t>|<t\b[^>]*\/>/g;
+        let tMatch;
+        while ((tMatch = tRe.exec(inner)) !== null) {
+            text += decodeXml(tMatch[1] || "");
+        }
+        strings.push(text);
+    }
+    return strings;
+};
+exports.parseSharedStrings = parseSharedStrings;
+const parseWorkbookRels = (relsXml) => {
+    const map = new Map();
+    if (!relsXml)
+        return map;
+    const relRe = /<Relationship\b([^>]*)\/?>/g;
+    let match;
+    while ((match = relRe.exec(relsXml)) !== null) {
+        const id = getAttr(match[1], "Id");
+        let target = getAttr(match[1], "Target");
+        if (!id || !target)
+            continue;
+        target = target.replace(/^\//, "").replace(/^xl\//, "");
+        map.set(id, `xl/${target}`);
+    }
+    return map;
+};
+const parseWorkbookSheets = (workbookXml) => {
+    var _a, _b;
+    if (!workbookXml)
+        return [];
+    const sheets = [];
+    const sheetRe = /<sheet\b([^>]*)\/?>/g;
+    let match;
+    while ((match = sheetRe.exec(workbookXml)) !== null) {
+        const name = (_a = getAttr(match[1], "name")) !== null && _a !== void 0 ? _a : `Sheet${sheets.length + 1}`;
+        const rId = (_b = getAttr(match[1], "r:id")) !== null && _b !== void 0 ? _b : getAttr(match[1], "id");
+        sheets.push({ name, rId });
+    }
+    return sheets;
+};
+const parseWorksheet = (sheetXml, sharedStrings, dateStyleFlags, cellDates) => {
+    var _a;
+    const rows = [];
+    const formulas = [];
+    let sawFormula = false;
+    const rowRe = /<row\b([^>]*)>([\s\S]*?)<\/row>/g;
+    let rowMatch;
+    let sequentialRowIndex = -1;
+    while ((rowMatch = rowRe.exec(sheetXml)) !== null) {
+        sequentialRowIndex++;
+        const rAttr = getAttr(rowMatch[1], "r");
+        const rowIndex = rAttr ? Number(rAttr) - 1 : sequentialRowIndex;
+        const rowInner = rowMatch[2];
+        const rowValues = [];
+        const rowFormulas = [];
+        let sequentialColIndex = -1;
+        const cellRe = /<c\b([^>]*?)(?:\/>|>([\s\S]*?)<\/c>)/g;
+        let cellMatch;
+        while ((cellMatch = cellRe.exec(rowInner)) !== null) {
+            sequentialColIndex++;
+            const attrs = cellMatch[1];
+            const inner = cellMatch[2] || "";
+            const ref = getAttr(attrs, "r");
+            const colLetters = ref ? ref.replace(/[0-9]/g, "") : "";
+            const colIndex = colLetters ? columnLettersToIndex(colLetters) : sequentialColIndex;
+            const type = getAttr(attrs, "t") || "n";
+            const styleIndex = Number(getAttr(attrs, "s") || "0");
+            const fMatch = inner.match(/<f\b[^>]*>([\s\S]*?)<\/f>|<f\b[^>]*\/>/);
+            const formula = fMatch ? decodeXml(fMatch[1] || "") : null;
+            if (formula)
+                sawFormula = true;
+            const vMatch = inner.match(/<v\b[^>]*>([\s\S]*?)<\/v>/);
+            const rawValue = vMatch ? decodeXml(vMatch[1]) : undefined;
+            let value = null;
+            if (type === "s") {
+                const idx = Number(rawValue);
+                value = Number.isNaN(idx) ? "" : (_a = sharedStrings[idx]) !== null && _a !== void 0 ? _a : "";
+            }
+            else if (type === "inlineStr") {
+                const isMatch = inner.match(/<is\b[^>]*>([\s\S]*?)<\/is>/);
+                let text = "";
+                if (isMatch) {
+                    const tRe = /<t\b[^>]*>([\s\S]*?)<\/t>/g;
+                    let tMatch;
+                    while ((tMatch = tRe.exec(isMatch[1])) !== null)
+                        text += decodeXml(tMatch[1]);
+                }
+                value = text;
+            }
+            else if (type === "str") {
+                value = rawValue !== null && rawValue !== void 0 ? rawValue : (formula !== null && formula !== void 0 ? formula : "");
+            }
+            else if (type === "b") {
+                value = rawValue === "1" || rawValue === "true";
+            }
+            else if (type === "e") {
+                value = rawValue !== null && rawValue !== void 0 ? rawValue : null;
+            }
+            else {
+                if (rawValue === undefined || rawValue === "") {
+                    value = formula !== null ? formula : null;
+                }
+                else {
+                    const num = Number(rawValue);
+                    if (Number.isNaN(num)) {
+                        value = rawValue;
+                    }
+                    else if (cellDates && dateStyleFlags[styleIndex]) {
+                        value = excelSerialToDate(num);
+                    }
+                    else {
+                        value = num;
+                    }
+                }
+            }
+            rowValues[colIndex] = value;
+            rowFormulas[colIndex] = formula;
+        }
+        rows[rowIndex] = rowValues;
+        formulas[rowIndex] = rowFormulas;
+    }
+    const width = rows.reduce((max, row) => Math.max(max, row ? row.length : 0), 0);
+    for (let r = 0; r < rows.length; r++) {
+        if (!rows[r])
+            rows[r] = [];
+        for (let c = 0; c < width; c++) {
+            if (rows[r][c] === undefined)
+                rows[r][c] = null;
+            if (!formulas[r])
+                formulas[r] = [];
+            if (formulas[r][c] === undefined)
+                formulas[r][c] = null;
+        }
+    }
+    return sawFormula ? { rows, formulas } : { rows };
+};
+exports.parseWorksheet = parseWorksheet;
+const toZipInput = (input) => __awaiter(void 0, void 0, void 0, function* () {
+    if (typeof input === "string") {
+        const fs = require("fs");
+        return fs.readFileSync(input);
+    }
+    return input;
+});
+const readExcel = (input, options = {}) => __awaiter(void 0, void 0, void 0, function* () {
+    const cellDates = options.cellDates !== false;
+    const JSZip = require("jszip");
+    const zip = yield JSZip.loadAsync(yield toZipInput(input));
+    const readPart = (path) => __awaiter(void 0, void 0, void 0, function* () {
+        const file = zip.file(path);
+        return file ? yield file.async("string") : undefined;
+    });
+    const [workbookXml, relsXml, sharedStringsXml, stylesXml] = yield Promise.all([
+        readPart("xl/workbook.xml"),
+        readPart("xl/_rels/workbook.xml.rels"),
+        readPart("xl/sharedStrings.xml"),
+        readPart("xl/styles.xml"),
+    ]);
+    const sharedStrings = parseSharedStrings(sharedStringsXml);
+    const dateStyleFlags = parseDateStyleFlags(stylesXml);
+    const rels = parseWorkbookRels(relsXml);
+    const sheetRefs = parseWorkbookSheets(workbookXml);
+    const sheets = [];
+    for (let i = 0; i < sheetRefs.length; i++) {
+        const ref = sheetRefs[i];
+        let path = ref.rId ? rels.get(ref.rId) : undefined;
+        if (!path || !zip.file(path))
+            path = `xl/worksheets/sheet${i + 1}.xml`;
+        const sheetXml = yield readPart(path);
+        if (sheetXml === undefined) {
+            sheets.push({ title: ref.name, rows: [] });
+            continue;
+        }
+        const parsed = parseWorksheet(sheetXml, sharedStrings, dateStyleFlags, cellDates);
+        sheets.push(Object.assign({ title: ref.name }, parsed));
+    }
+    return { sheets };
+});
+exports.readExcel = readExcel;

package/lib/types.d.ts

@@ -0,0 +1,34 @@
+declare enum ICellType {
+    string = "s",
+    number = "n",
+    date = "d",
+    skip = "skip",
+    equation = "equation"
+}
+declare enum BorderStyle {
+    none = "none",
+    thin = "thin",
+    medium = "medium",
+    thick = "thick",
+    double = "double",
+    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"
+}
+export { ICellType, BorderStyle, HorizontalAlignment, VerticalAlignment };

package/lib/types.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VerticalAlignment = exports.HorizontalAlignment = exports.BorderStyle = exports.ICellType = void 0;
+var ICellType;
+(function (ICellType) {
+    ICellType["string"] = "s";
+    ICellType["number"] = "n";
+    ICellType["date"] = "d";
+    ICellType["skip"] = "skip";
+    ICellType["equation"] = "equation";
+})(ICellType || (ICellType = {}));
+exports.ICellType = ICellType;
+var BorderStyle;
+(function (BorderStyle) {
+    BorderStyle["none"] = "none";
+    BorderStyle["thin"] = "thin";
+    BorderStyle["medium"] = "medium";
+    BorderStyle["thick"] = "thick";
+    BorderStyle["double"] = "double";
+    BorderStyle["dotted"] = "dotted";
+    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;

package/lib/util.d.ts

@@ -1,4 +1,5 @@
-import { IRows, IBorder, BorderStyle, ICellStyle, ICell } from ".";
+import { IRows, IBorder, ICellStyle, ICell } from ".";
+import { BorderStyle, HorizontalAlignment, VerticalAlignment } from "./types";
 declare const indexToVbIndex: (index: number) => number;
 declare const indexToVbRelationIndex: (index: number) => number;
 declare const indexToRowIndex: (index: number) => string;
@@ -33,4 +34,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,7 +1,7 @@
 "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;
-const _1 = require(".");
+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 types_1 = require("./types");
 const indexToVbIndex = (index) => index + 1;
 exports.indexToVbIndex = indexToVbIndex;
 const indexToVbRelationIndex = (index) => indexToVbIndex(index) + 2;
@@ -41,7 +41,7 @@ const writeEquation = (equation) => new Equation(equation);
 exports.writeEquation = writeEquation;
 const createBorder = (border) => border;
 exports.createBorder = createBorder;
-const createAllBorders = (style = _1.BorderStyle.thin, color = "#000000") => ({
+const createAllBorders = (style = types_1.BorderStyle.thin, color = "#000000") => ({
     top: style,
     right: style,
     bottom: style,
@@ -49,22 +49,22 @@ const createAllBorders = (style = _1.BorderStyle.thin, color = "#000000") => ({
     color
 });
 exports.createAllBorders = createAllBorders;
-const createTopBorder = (style = _1.BorderStyle.thin, color = "#000000") => ({
+const createTopBorder = (style = types_1.BorderStyle.thin, color = "#000000") => ({
     top: style,
     color
 });
 exports.createTopBorder = createTopBorder;
-const createBottomBorder = (style = _1.BorderStyle.thin, color = "#000000") => ({
+const createBottomBorder = (style = types_1.BorderStyle.thin, color = "#000000") => ({
     bottom: style,
     color
 });
 exports.createBottomBorder = createBottomBorder;
-const createLeftBorder = (style = _1.BorderStyle.thin, color = "#000000") => ({
+const createLeftBorder = (style = types_1.BorderStyle.thin, color = "#000000") => ({
     left: style,
     color
 });
 exports.createLeftBorder = createLeftBorder;
-const createRightBorder = (style = _1.BorderStyle.thin, color = "#000000") => ({
+const createRightBorder = (style = types_1.BorderStyle.thin, color = "#000000") => ({
     right: style,
     color
 });
@@ -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("|");
 };
@@ -96,14 +98,14 @@ exports.getStyleKey = getStyleKey;
 const createStyledCell = (value, style) => {
     if (typeof value === 'string') {
         return {
-            type: _1.ICellType.string,
+            type: types_1.ICellType.string,
             value: value,
             style
         };
     }
     else {
         return {
-            type: _1.ICellType.number,
+            type: types_1.ICellType.number,
             value,
             style
         };
@@ -123,7 +125,7 @@ const dateToExcelSerial = (date) => {
 exports.dateToExcelSerial = dateToExcelSerial;
 const createDateCell = (date, style) => {
     return {
-        type: _1.ICellType.date,
+        type: types_1.ICellType.date,
         value: date,
         style
     };
@@ -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, types_1.HorizontalAlignment.center, types_1.VerticalAlignment.center);
+};
+exports.createCenteredCell = createCenteredCell;

package/lib/xl/styles.xml.js

@@ -1,25 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateStyleXml = void 0;
-const __1 = require("..");
+const types_1 = require("../types");
 const generateBorderXml = (border) => {
     const getColorXml = (color) => color ? `<color rgb="${color.replace('#', 'FF')}" />` : '';
     const getBorderSideXml = (side, color) => {
-        if (!side || side === __1.BorderStyle.none) {
+        if (!side || side === types_1.BorderStyle.none) {
             return '<left />';
         }
         return `<left style="${side}">${getColorXml(color)}</left>`;
     };
-    const leftXml = !border.left || border.left === __1.BorderStyle.none
+    const leftXml = !border.left || border.left === types_1.BorderStyle.none
         ? '<left />'
         : `<left style="${border.left}">${getColorXml(border.color)}</left>`;
-    const rightXml = !border.right || border.right === __1.BorderStyle.none
+    const rightXml = !border.right || border.right === types_1.BorderStyle.none
         ? '<right />'
         : `<right style="${border.right}">${getColorXml(border.color)}</right>`;
-    const topXml = !border.top || border.top === __1.BorderStyle.none
+    const topXml = !border.top || border.top === types_1.BorderStyle.none
         ? '<top />'
         : `<top style="${border.top}">${getColorXml(border.color)}</top>`;
-    const bottomXml = !border.bottom || border.bottom === __1.BorderStyle.none
+    const bottomXml = !border.bottom || border.bottom === types_1.BorderStyle.none
         ? '<bottom />'
         : `<bottom style="${border.bottom}">${getColorXml(border.color)}</bottom>`;
     return `
@@ -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/lib/xl/worksheets/sheet.xml.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateSheetXml = void 0;
-const __1 = require("../..");
+const types_1 = require("../../types");
 const util_1 = require("../../util");
 const generateSheetXml = (sheet, styleMap, hasDateCells = false) => {
     const styleToIndex = new Map();
@@ -29,11 +29,11 @@ const generateSheetXml = (sheet, styleMap, hasDateCells = false) => {
         rowContent += `<row r="${(0, util_1.indexToVbIndex)(rowIndex)}">\n`;
         row.cells.forEach((cell, cellIndex) => {
             const cellType = cell.type;
-            if (cellType !== __1.ICellType.skip) {
+            if (cellType !== types_1.ICellType.skip) {
                 const cellPosition = (0, util_1.rowColumnToVbPosition)(cellIndex, rowIndex);
                 const cellValue = cell.value || '';
                 let styleIndex = 0;
-                let isDateCell = cell.type === __1.ICellType.date;
+                let isDateCell = cell.type === types_1.ICellType.date;
                 if ('style' in cell && cell.style) {
                     const styleKey = (0, util_1.getStyleKey)(cell.style);
                     const baseStyleIndex = styleToIndex.get(styleKey) || 0;
@@ -47,13 +47,13 @@ const generateSheetXml = (sheet, styleMap, hasDateCells = false) => {
                 else if (isDateCell && hasDateCells) {
                     styleIndex = styleMap.size;
                 }
-                if (cell.type === __1.ICellType.equation) {
+                if (cell.type === types_1.ICellType.equation) {
                     rowContent += `
               <c r="${cellPosition}" t="n" s="${styleIndex}">
                 <f aca="false">${cell.value.getEquation()}</f>
               </c>\n`;
                 }
-                else if (cell.type === __1.ICellType.date) {
+                else if (cell.type === types_1.ICellType.date) {
                     const excelDateValue = (0, util_1.dateToExcelSerial)(cell.value);
                     rowContent += `
               <c r="${cellPosition}" t="n" s="${styleIndex}">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "to-spreadsheet",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "npm package to create spreadsheet in node environment and in browser",
   "keywords": [
     "excel",
@@ -30,11 +30,6 @@
   ],
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
-  "scripts": {
-    "prepare": "npm run build",
-    "build": "tsc",
-    "test:compile": "npx ts-node src/index.ts"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/maifeeulasad/to-spreadsheet.git"
@@ -49,7 +44,7 @@
   },
   "homepage": "https://github.com/maifeeulasad/to-spreadsheet#readme",
   "dependencies": {
-    "archiver": "^6.0.1",
+    "archiver": "^7.0.1",
     "file-saver": "^2.0.5",
     "jszip": "^3.10.1"
   },
@@ -59,10 +54,18 @@
     "LICENSE"
   ],
   "devDependencies": {
-    "@types/archiver": "^5.3.3",
+    "@tsconfig/node16": "1.0.4",
+    "@types/archiver": "^6.0.4",
     "@types/file-saver": "^2.0.5",
     "@types/node": "^17.0.35",
     "ts-node": "^10.8.0",
-    "typescript": "^4.7.2"
+    "typescript": "^4.7.2",
+    "vitest": "^2.1.9"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test:compile": "npx ts-node src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}