@microsoft/connected-workbooks 2.1.24-beta → 2.1.25

package/README.md

@@ -1,7 +1,6 @@
 # Connected Workbooks
 [![Build Status](https://obilshield.visualstudio.com/ConnectedWorkbooks/_apis/build/status/microsoft.connected-workbooks?branchName=main)](https://obilshield.visualstudio.com/ConnectedWorkbooks/_build/latest?definitionId=14&branchName=main)
 [![License](https://img.shields.io/github/license/microsoft/connected-workbooks)](https://github.com/microsoft/connected-workbooks/blob/master/LICENSE)
-[![Snyk Vulnerabilities](https://img.shields.io/snyk/vulnerabilities/github/microsoft/connected-workbooks)](https://snyk.io/test/github/microsoft/connected-workbooks)
 
 A pure JS library, Microsoft backed, that provides xlsx workbook generation capabilities, allowing for:
 1. Fundemental **"Export to Excel"** capabilities for tabular data (landing in a table in Excel).
@@ -31,12 +30,12 @@ workbookManager.downloadWorkbook(blob, "MyTable.xlsx");
 ```
 
 ### 2. Export a table from raw data:
-```
+```typescript
 import workbookManager from '@microsoft/connected-workbooks';
 
 const grid = {
-  "promoteHeaders": true,
-  "data": [
+  config: { promoteHeaders:true, adjustColumnNames:true }
+  data: [
       ["Product", "Price", "InStock", "Category", "Date"],
       ["Widget A", 19.99, true, "Electronics", "10/26/2024"],
       ["Gizmo B", 9.99, true, "Accessories", "10/26/2024"],
@@ -152,9 +151,14 @@ async function `generateTableWorkbookFromGrid`: `Promise<Blob>`
 #### Grid
 |Parameter   | Type   | Required   | Description   |
 |---|---|---|---|
-| data | (string | number | boolean)[][] | __required__ | Grid data
-| promoteHeaders | boolean | optional | Should first row of gridData be used as the header, defaults to false - generating "Column1", "Column2"...
+| data | (string \| number \| boolean)[][] | __required__ | Grid data
+| config | GridConfig | optional | customizations to Grid handling (see GridConfig)
 
+#### GridConfig
+|Parameter   | Type   | Required   | Description   |
+|---|---|---|---|
+| promoteHeaders | boolean | optional | Should first row of gridData be used as the header, defaults to false - generating "Column1", "Column2"...
+| adjustColumnNames | boolean | optional | Should column names be adjusted to be valid Excel names (Fix duplicates for example), defaults to true
 
 #### FileConfigs
 |Parameter   | Type   | Required   | Description   |

package/dist/generators.js

@@ -7,7 +7,7 @@ const generateMashupXMLTemplate = (base64) => `<?xml version="1.0" encoding="utf
 exports.generateMashupXMLTemplate = generateMashupXMLTemplate;
 const generateSingleQueryMashup = (queryName, query) => `section Section1;
     
-    shared ${queryName} = 
+    shared #"${queryName}" = 
     ${query};`;
 exports.generateSingleQueryMashup = generateSingleQueryMashup;
 const generateCustomXmlFilePath = (i) => `customXml/item${i}.xml`;

package/dist/{GridParser.js → gridParser.js}

@@ -1,7 +1,10 @@
 "use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseToTableData = void 0;
 const constants_1 = require("./utils/constants");
+const utils_1 = require("./utils");
 const parseToTableData = (grid) => {
     if (!grid) {
         return undefined;
@@ -12,12 +15,13 @@ const parseToTableData = (grid) => {
 };
 exports.parseToTableData = parseToTableData;
 const parseGridRows = (grid) => {
+    var _a, _b;
     const gridData = grid.data;
     if (!gridData) {
         throw new Error(constants_1.gridNotFoundErr);
     }
     const rows = [];
-    if (!grid.promoteHeaders) {
+    if (!((_a = grid.config) === null || _a === void 0 ? void 0 : _a.promoteHeaders)) {
         const row = [];
         for (const prop in gridData[0]) {
             const cellValue = gridData[0][prop];
@@ -30,19 +34,25 @@ const parseGridRows = (grid) => {
         const row = [];
         for (const prop in rowData) {
             const cellValue = rowData[prop];
-            row.push(cellValue.toString());
+            row.push((_b = cellValue === null || cellValue === void 0 ? void 0 : cellValue.toString()) !== null && _b !== void 0 ? _b : "");
         }
         rows.push(row);
     }
     return rows;
 };
 const generateColumnNames = (grid) => {
-    if (grid.promoteHeaders) {
-        return grid.data[0].map((columnName) => columnName.toString());
-    }
+    var _a;
     const columnNames = [];
-    for (let i = 0; i < grid.data[0].length; i++) {
-        columnNames.push(`Column ${i + 1}`);
+    if (!((_a = grid.config) === null || _a === void 0 ? void 0 : _a.promoteHeaders)) {
+        for (let i = 0; i < grid.data[0].length; i++) {
+            columnNames.push(`${constants_1.defaults.columnName} ${i + 1}`);
+        }
+        return columnNames;
+    }
+    // We are adjusting column names by default.
+    if (!grid.config || grid.config.adjustColumnNames === undefined || grid.config.adjustColumnNames) {
+        return utils_1.tableUtils.getAdjustedColumnNames(grid.data[0]);
     }
-    return columnNames;
+    // Get column names and failed if it's not a legal name.
+    return utils_1.tableUtils.getRawColumnNames(grid.data[0]);
 };

package/dist/gridUtils.js

@@ -0,0 +1,58 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseToTableData = void 0;
+const constants_1 = require("./utils/constants");
+const utils_1 = require("./utils");
+const parseToTableData = (grid) => {
+    if (!grid) {
+        return undefined;
+    }
+    const columnNames = generateColumnNames(grid);
+    const rows = parseGridRows(grid);
+    return { columnNames: columnNames, rows: rows };
+};
+exports.parseToTableData = parseToTableData;
+const parseGridRows = (grid) => {
+    var _a, _b;
+    const gridData = grid.data;
+    if (!gridData) {
+        throw new Error(constants_1.gridNotFoundErr);
+    }
+    const rows = [];
+    if (!((_a = grid.config) === null || _a === void 0 ? void 0 : _a.promoteHeaders)) {
+        const row = [];
+        for (const prop in gridData[0]) {
+            const cellValue = gridData[0][prop];
+            row.push(cellValue.toString());
+        }
+        rows.push(row);
+    }
+    for (let i = 1; i < gridData.length; i++) {
+        const rowData = gridData[i];
+        const row = [];
+        for (const prop in rowData) {
+            const cellValue = rowData[prop];
+            row.push((_b = cellValue === null || cellValue === void 0 ? void 0 : cellValue.toString()) !== null && _b !== void 0 ? _b : "");
+        }
+        rows.push(row);
+    }
+    return rows;
+};
+const generateColumnNames = (grid) => {
+    var _a;
+    const columnNames = [];
+    if (!((_a = grid.config) === null || _a === void 0 ? void 0 : _a.promoteHeaders)) {
+        for (let i = 0; i < grid.data[0].length; i++) {
+            columnNames.push(`${constants_1.defaults.columnName} ${i + 1}`);
+        }
+        return columnNames;
+    }
+    // We are adjusting column names by default.
+    if (!grid.config || grid.config.adjustColumnNames === undefined || grid.config.adjustColumnNames) {
+        return utils_1.tableUtils.getAdjustedColumnNames(grid.data[0]);
+    }
+    // Get column names and failed if it's not a legal name.
+    return utils_1.tableUtils.getRawColumnNames(grid.data[0]);
+};

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as workbookManager from "./workbookManager";
 import { DataTypes } from "./types";
-import type { QueryInfo, FileConfigs, Grid } from "./types";
+import type { QueryInfo, FileConfigs, Grid, DocProps } from "./types";
 export { DataTypes };
-export type { QueryInfo, FileConfigs, Grid };
+export type { QueryInfo, FileConfigs, Grid, DocProps };
 export default workbookManager;

package/dist/src/generators.js

@@ -0,0 +1,14 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCustomXmlFilePath = exports.generateSingleQueryMashup = exports.generateMashupXMLTemplate = void 0;
+const generateMashupXMLTemplate = (base64) => `<?xml version="1.0" encoding="utf-16"?><DataMashup xmlns="http://schemas.microsoft.com/DataMashup">${base64}</DataMashup>`;
+exports.generateMashupXMLTemplate = generateMashupXMLTemplate;
+const generateSingleQueryMashup = (queryName, query) => `section Section1;
+    
+    shared #"${queryName}" = 
+    ${query};`;
+exports.generateSingleQueryMashup = generateSingleQueryMashup;
+const generateCustomXmlFilePath = (i) => `customXml/item${i}.xml`;
+exports.generateCustomXmlFilePath = generateCustomXmlFilePath;

package/dist/src/types.js

@@ -0,0 +1,28 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocPropsAutoUpdatedElements = exports.DocPropsModifiableElements = exports.DataTypes = void 0;
+var DataTypes;
+(function (DataTypes) {
+    DataTypes[DataTypes["null"] = 0] = "null";
+    DataTypes[DataTypes["string"] = 1] = "string";
+    DataTypes[DataTypes["number"] = 2] = "number";
+    DataTypes[DataTypes["boolean"] = 3] = "boolean";
+})(DataTypes = exports.DataTypes || (exports.DataTypes = {}));
+var DocPropsModifiableElements;
+(function (DocPropsModifiableElements) {
+    DocPropsModifiableElements["title"] = "dc:title";
+    DocPropsModifiableElements["subject"] = "dc:subject";
+    DocPropsModifiableElements["keywords"] = "cp:keywords";
+    DocPropsModifiableElements["createdBy"] = "dc:creator";
+    DocPropsModifiableElements["description"] = "dc:description";
+    DocPropsModifiableElements["lastModifiedBy"] = "cp:lastModifiedBy";
+    DocPropsModifiableElements["category"] = "cp:category";
+    DocPropsModifiableElements["revision"] = "cp:revision";
+})(DocPropsModifiableElements = exports.DocPropsModifiableElements || (exports.DocPropsModifiableElements = {}));
+var DocPropsAutoUpdatedElements;
+(function (DocPropsAutoUpdatedElements) {
+    DocPropsAutoUpdatedElements["created"] = "dcterms:created";
+    DocPropsAutoUpdatedElements["modified"] = "dcterms:modified";
+})(DocPropsAutoUpdatedElements = exports.DocPropsAutoUpdatedElements || (exports.DocPropsAutoUpdatedElements = {}));

package/dist/src/utils/arrayUtils.js

@@ -0,0 +1,46 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArrayReader = void 0;
+class ArrayReader {
+    constructor(array) {
+        this._array = array;
+        this._position = 0;
+    }
+    getInt32() {
+        const retVal = new DataView(this._array, this._position, 4).getInt32(0, true);
+        this._position += 4;
+        return retVal;
+    }
+    getBytes(bytes) {
+        const retVal = this._array.slice(this._position, bytes ? bytes + this._position : bytes);
+        this._position += retVal.byteLength;
+        return new Uint8Array(retVal);
+    }
+    reset() {
+        this._position = 0;
+    }
+}
+exports.ArrayReader = ArrayReader;
+function getInt32Buffer(val) {
+    const packageSizeBuffer = new ArrayBuffer(4);
+    new DataView(packageSizeBuffer).setInt32(0, val, true);
+    return new Uint8Array(packageSizeBuffer);
+}
+function concatArrays(...args) {
+    let size = 0;
+    args.forEach((arr) => (size += arr.byteLength));
+    const retVal = new Uint8Array(size);
+    let position = 0;
+    args.forEach((arr) => {
+        retVal.set(arr, position);
+        position += arr.byteLength;
+    });
+    return retVal;
+}
+exports.default = {
+    ArrayReader,
+    getInt32Buffer,
+    concatArrays,
+};

package/dist/src/utils/constants.js

@@ -0,0 +1,139 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.element = exports.BOM = exports.falseStr = exports.trueStr = exports.maxQueryLength = exports.divider = exports.section1PathPrefix = exports.emptyValue = exports.falseValue = exports.trueValue = exports.pivotCachesPathPrefix = exports.xmlTextResultType = exports.textResultType = exports.application = exports.uint8ArrayType = exports.blobFileType = exports.arrayIsntMxNErr = exports.unexpectedErr = exports.promotedHeadersCannotBeUsedWithoutAdjustingColumnNamesErr = exports.InvalidColumnNameErr = exports.stylesNotFoundErr = exports.EmptyQueryNameErr = exports.QueryNameInvalidCharsErr = exports.QueryNameMaxLengthErr = exports.invalidDataTypeErr = exports.headerNotFoundErr = exports.invalidValueInColumnErr = exports.tableNotFoundErr = exports.queryTableNotFoundErr = exports.templateWithInitialDataErr = exports.formulaSectionNotFoundErr = exports.queryConnectionNotFoundErr = exports.queryAndPivotTableNotFoundErr = exports.queryNameNotFoundErr = exports.emptyQueryMashupErr = exports.base64NotFoundErr = exports.sheetsNotFoundErr = exports.connectionsNotFoundErr = exports.sharedStringsNotFoundErr = exports.docPropsRootElement = exports.docPropsCoreXmlPath = exports.section1mPath = exports.pivotCachesPath = exports.queryTablesPath = exports.workbookXmlPath = exports.queryTableXmlPath = exports.tableXmlPath = exports.sheetsXmlPath = exports.sharedStringsXmlPath = exports.connectionsXmlPath = void 0;
+exports.URLS = exports.defaults = exports.elementAttributesValues = exports.dataTypeKind = exports.elementAttributes = void 0;
+exports.connectionsXmlPath = "xl/connections.xml";
+exports.sharedStringsXmlPath = "xl/sharedStrings.xml";
+exports.sheetsXmlPath = "xl/worksheets/sheet1.xml";
+exports.tableXmlPath = "xl/tables/table1.xml";
+exports.queryTableXmlPath = "xl/queryTables/queryTable1.xml";
+exports.workbookXmlPath = "xl/workbook.xml";
+exports.queryTablesPath = "xl/queryTables/";
+exports.pivotCachesPath = "xl/pivotCache/";
+exports.section1mPath = "Formulas/Section1.m";
+exports.docPropsCoreXmlPath = "docProps/core.xml";
+exports.docPropsRootElement = "cp:coreProperties";
+exports.sharedStringsNotFoundErr = "SharedStrings were not found in template";
+exports.connectionsNotFoundErr = "Connections were not found in template";
+exports.sheetsNotFoundErr = "Sheets were not found in template";
+exports.base64NotFoundErr = "Base64 was not found in template";
+exports.emptyQueryMashupErr = "Query mashup is empty";
+exports.queryNameNotFoundErr = "Query name was not found";
+exports.queryAndPivotTableNotFoundErr = "No such query found in Query Table or Pivot Table found in given template";
+exports.queryConnectionNotFoundErr = "No connection found for query";
+exports.formulaSectionNotFoundErr = "Formula section wasn't found in template";
+exports.templateWithInitialDataErr = "Cannot receive template file with initial data";
+exports.queryTableNotFoundErr = "Query table wasn't found in template";
+exports.tableNotFoundErr = "Table wasn't found in template";
+exports.invalidValueInColumnErr = "Invalid cell value in column";
+exports.headerNotFoundErr = "Invalid JSON file, header is missing";
+exports.invalidDataTypeErr = "Invalid JSON file, invalid data type";
+exports.QueryNameMaxLengthErr = "Query names are limited to 80 characters";
+exports.QueryNameInvalidCharsErr = 'Query names cannot contain periods or quotation marks. (. ")';
+exports.EmptyQueryNameErr = "Query name cannot be empty";
+exports.stylesNotFoundErr = "Styles were not found in template";
+exports.InvalidColumnNameErr = "Invalid column name";
+exports.promotedHeadersCannotBeUsedWithoutAdjustingColumnNamesErr = "Headers cannot be promoted without adjusting column names";
+exports.unexpectedErr = "Unexpected error";
+exports.arrayIsntMxNErr = "Array isn't MxN";
+exports.blobFileType = "blob";
+exports.uint8ArrayType = "uint8array";
+exports.application = "application/xlsx";
+exports.textResultType = "text";
+exports.xmlTextResultType = "text/xml";
+exports.pivotCachesPathPrefix = "pivotCacheDefinition";
+exports.trueValue = "1";
+exports.falseValue = "0";
+exports.emptyValue = "";
+exports.section1PathPrefix = "Section1/";
+exports.divider = "/";
+exports.maxQueryLength = 80;
+exports.trueStr = "true";
+exports.falseStr = "false";
+exports.BOM = "\ufeff";
+exports.element = {
+    sharedStringTable: "sst",
+    text: "t",
+    sharedStringItem: "si",
+    cellValue: "v",
+    databaseProperties: "dbPr",
+    queryTable: "queryTable",
+    cacheSource: "cacheSource",
+    item: "Item",
+    items: "Items",
+    itemPath: "ItemPath",
+    itemType: "ItemType",
+    itemLocation: "ItemLocation",
+    entry: "Entry",
+    stableEntries: "StableEntries",
+    tableColumns: "tableColumns",
+    tableColumn: "tableColumn",
+    table: "table",
+    autoFilter: "autoFilter",
+    definedName: "definedName",
+    queryTableFields: "queryTableFields",
+    queryTableField: "queryTableField",
+    queryTableRefresh: "queryTableRefresh",
+    sheetData: "sheetData",
+    row: "row",
+    dimension: "dimension",
+    kindCell: "c",
+};
+exports.elementAttributes = {
+    connection: "connection",
+    command: "command",
+    refreshOnLoad: "refreshOnLoad",
+    count: "count",
+    uniqueCount: "uniqueCount",
+    queryTable: "queryTable",
+    connectionId: "connectionId",
+    cacheSource: "cacheSource",
+    name: "name",
+    description: "description",
+    id: "id",
+    type: "Type",
+    value: "Value",
+    relationshipInfo: "RelationshipInfoContainer",
+    resultType: "ResultType",
+    fillColumnNames: "FillColumnNames",
+    fillTarget: "FillTarget",
+    fillLastUpdated: "FillLastUpdated",
+    day: "d",
+    uniqueName: "uniqueName",
+    queryTableFieldId: "queryTableFieldId",
+    reference: "ref",
+    tableColumnId: "tableColumnId",
+    nextId: "nextId",
+    row: "r",
+    spans: "spans",
+    x14acDyDescent: "x14ac:dyDescent",
+    xr3uid: "xr3:uid",
+};
+exports.dataTypeKind = {
+    string: "str",
+    number: "1",
+    boolean: "b",
+};
+exports.elementAttributesValues = {
+    connectionName: (queryName) => `Query - ${queryName}`,
+    connectionDescription: (queryName) => `Connection to the '${queryName}' query in the workbook.`,
+    connection: (queryName) => `Provider=Microsoft.Mashup.OleDb.1;Data Source=$Workbook$;Location="${queryName}";`,
+    connectionCommand: (queryName) => `SELECT * FROM [${queryName}]`,
+    tableResultType: () => "sTable",
+};
+exports.defaults = {
+    queryName: "Query1",
+    sheetName: "Sheet1",
+    columnName: "Column",
+};
+exports.URLS = {
+    PQ: [
+        "http://schemas.microsoft.com/DataMashup",
+        "http://schemas.microsoft.com/DataExplorer",
+        "http://schemas.microsoft.com/DataMashup/Temp",
+        "http://schemas.microsoft.com/DataExplorer/Temp",
+    ],
+    CONNECTED_WORKBOOK: "http://schemas.microsoft.com/ConnectedWorkbook",
+};

package/dist/src/utils/documentUtils.js

@@ -0,0 +1,102 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+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 });
+const constants_1 = require("./constants");
+const types_1 = require("../types");
+const createOrUpdateProperty = (doc, parent, property, value) => {
+    if (value === undefined) {
+        return;
+    }
+    const elements = parent.getElementsByTagName(property);
+    if ((elements === null || elements === void 0 ? void 0 : elements.length) === 0) {
+        const newElement = doc.createElement(property);
+        newElement.textContent = value;
+        parent.appendChild(newElement);
+    }
+    else if (elements.length > 1) {
+        throw new Error(`Invalid DocProps core.xml, multiple ${property} elements`);
+    }
+    else if ((elements === null || elements === void 0 ? void 0 : elements.length) > 0) {
+        elements[0].textContent = value;
+    }
+};
+const getDocPropsProperties = (zip) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const docPropsCoreXmlString = yield ((_a = zip.file(constants_1.docPropsCoreXmlPath)) === null || _a === void 0 ? void 0 : _a.async(constants_1.textResultType));
+    if (docPropsCoreXmlString === undefined) {
+        throw new Error("DocProps core.xml was not found in template");
+    }
+    const parser = new DOMParser();
+    const doc = parser.parseFromString(docPropsCoreXmlString, constants_1.xmlTextResultType);
+    const properties = doc.getElementsByTagName(constants_1.docPropsRootElement).item(0);
+    if (properties === null) {
+        throw new Error("Invalid DocProps core.xml");
+    }
+    return { doc, properties };
+});
+const getCellReferenceAbsolute = (col, row) => {
+    // 65 is the ascii value of first column 'A'
+    return "$" + String.fromCharCode(col + 65) + "$" + row.toString();
+};
+const getCellReferenceRelative = (col, row) => {
+    // 65 is the ascii value of first column 'A'
+    return String.fromCharCode(col + 65) + row.toString();
+};
+const getTableReference = (numberOfCols, numberOfRows) => {
+    return `A1:${getCellReferenceRelative(numberOfCols, numberOfRows)}`;
+};
+const createCellElement = (doc, colIndex, rowIndex, data) => {
+    const cell = doc.createElementNS(doc.documentElement.namespaceURI, constants_1.element.kindCell);
+    cell.setAttribute(constants_1.elementAttributes.row, getCellReferenceRelative(colIndex, rowIndex + 1));
+    const cellData = doc.createElementNS(doc.documentElement.namespaceURI, constants_1.element.cellValue);
+    updateCellData(data, cell, cellData, rowIndex === 0);
+    cell.appendChild(cellData);
+    return cell;
+};
+const updateCellData = (data, cell, cellData, rowHeader) => {
+    switch (resolveType(data, rowHeader)) {
+        case types_1.DataTypes.string:
+            cell.setAttribute(constants_1.element.text, constants_1.dataTypeKind.string);
+            break;
+        case types_1.DataTypes.number:
+            cell.setAttribute(constants_1.element.text, constants_1.dataTypeKind.number);
+            break;
+        case types_1.DataTypes.boolean:
+            cell.setAttribute(constants_1.element.text, constants_1.dataTypeKind.boolean);
+            break;
+    }
+    cellData.textContent = data;
+};
+const resolveType = (originalData, rowHeader) => {
+    const data = originalData;
+    if (rowHeader) {
+        // Headers should be string by default.
+        return types_1.DataTypes.string;
+    }
+    let dataType = isNaN(Number(data)) ? types_1.DataTypes.string : types_1.DataTypes.number;
+    if (dataType == types_1.DataTypes.string) {
+        if (data.trim() == constants_1.trueStr || data.trim() == constants_1.falseStr) {
+            dataType = types_1.DataTypes.boolean;
+        }
+    }
+    return dataType;
+};
+exports.default = {
+    createOrUpdateProperty,
+    getDocPropsProperties,
+    getCellReferenceRelative,
+    getCellReferenceAbsolute,
+    createCell: createCellElement,
+    getTableReference,
+    resolveType,
+};

package/dist/src/utils/gridUtils.js

@@ -0,0 +1,103 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+const constants_1 = require("../utils/constants");
+const parseToTableData = (grid) => {
+    var _a, _b, _c, _d;
+    if (grid === null || grid === undefined) {
+        grid = { data: [] };
+    }
+    if (grid.data === null || grid.data === undefined) {
+        grid.data = [];
+    }
+    const mergedGrid = {
+        config: {
+            promoteHeaders: (_b = (_a = grid.config) === null || _a === void 0 ? void 0 : _a.promoteHeaders) !== null && _b !== void 0 ? _b : false,
+            adjustColumnNames: (_d = (_c = grid.config) === null || _c === void 0 ? void 0 : _c.adjustColumnNames) !== null && _d !== void 0 ? _d : true,
+        },
+        data: grid.data.map((row) => row.map((value) => { var _a; return (_a = value === null || value === void 0 ? void 0 : value.toString()) !== null && _a !== void 0 ? _a : ""; })),
+    };
+    correctGrid(mergedGrid);
+    validateGrid(mergedGrid);
+    let columnNames = [];
+    if (mergedGrid.config.promoteHeaders && mergedGrid.config.adjustColumnNames) {
+        columnNames = getAdjustedColumnNames(mergedGrid.data.shift());
+    }
+    else if (mergedGrid.config.promoteHeaders && !mergedGrid.config.adjustColumnNames) {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        columnNames = mergedGrid.data.shift();
+    }
+    else {
+        columnNames = Array.from({ length: mergedGrid.data[0].length }, (_, index) => `${constants_1.defaults.columnName} ${index + 1}`);
+    }
+    return { columnNames: columnNames, rows: mergedGrid.data };
+};
+const correctGrid = (grid) => {
+    if (grid.data.length === 0) {
+        // empty grid fix
+        grid.config.promoteHeaders = false;
+        grid.data.push([""]);
+        return;
+    }
+    const getEmptyArray = (n) => Array.from({ length: n }, () => "");
+    if (grid.data[0].length === 0) {
+        grid.data[0] = [""];
+    }
+    // replace empty rows
+    grid.data.forEach((row, index) => {
+        if (row.length === 0) {
+            grid.data[index] = getEmptyArray(grid.data[0].length);
+        }
+    });
+    if (grid.config.promoteHeaders && grid.data.length === 1) {
+        // table in Excel should have at least 2 rows
+        grid.data.push(getEmptyArray(grid.data[0].length));
+    }
+};
+/*
+ * Validates the grid, throws an error if the grid is invalid.
+ * A valid grid has:
+ * - MxN structure.
+ * - If promoteHeaders is true - has at least 1 row, and in case adjustColumnNames is false, first row is unique and non empty.
+ */
+const validateGrid = (grid) => {
+    validateDataArrayDimensions(grid.data);
+    if (grid.config.promoteHeaders && grid.config.adjustColumnNames === false && !validateUniqueAndValidDataArray(grid.data[0])) {
+        throw new Error(constants_1.promotedHeadersCannotBeUsedWithoutAdjustingColumnNamesErr);
+    }
+};
+const validateDataArrayDimensions = (arr) => {
+    if (arr.length === 0 || arr[0].length === 0) {
+        throw new Error(constants_1.unexpectedErr);
+    }
+    if (!arr.every((innerArr) => innerArr.length === arr[0].length)) {
+        throw new Error(constants_1.arrayIsntMxNErr);
+    }
+};
+const validateUniqueAndValidDataArray = (arr) => {
+    if (arr.some((element) => element === "")) {
+        return false; // Array contains empty elements
+    }
+    const uniqueSet = new Set(arr);
+    return uniqueSet.size === arr.length;
+};
+const getAdjustedColumnNames = (columnNames) => {
+    if (columnNames === undefined) {
+        throw new Error(constants_1.unexpectedErr);
+    }
+    let i = 1;
+    // replace empty column names with default names, can still conflict if columns exist, but we handle that later
+    columnNames = columnNames.map((columnName) => columnName || `${constants_1.defaults.columnName} ${i++}`);
+    const uniqueNames = new Set();
+    return columnNames.map((name) => {
+        let uniqueName = name;
+        i = 1;
+        while (uniqueNames.has(uniqueName)) {
+            uniqueName = `${name} (${i++})`;
+        }
+        uniqueNames.add(uniqueName);
+        return uniqueName;
+    });
+};
+exports.default = { parseToTableData };

package/dist/src/utils/htmlUtils.js

@@ -0,0 +1,19 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+const extractTableValues = (table) => {
+    const rows = [];
+    // Extract values from each row
+    for (let i = 0; i < table.rows.length; i++) {
+        const row = table.rows[i];
+        const rowData = [];
+        for (let j = 0; j < row.cells.length; j++) {
+            const cell = row.cells[j];
+            rowData.push(cell.textContent || "");
+        }
+        rows.push(rowData);
+    }
+    return rows;
+};
+exports.default = { extractTableValues };

package/dist/src/utils/index.js

@@ -0,0 +1,24 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gridUtils = exports.htmlUtils = exports.tableUtils = exports.xmlInnerPartsUtils = exports.xmlPartsUtils = exports.documentUtils = exports.arrayUtils = exports.pqUtils = void 0;
+var pqUtils_1 = require("./pqUtils");
+Object.defineProperty(exports, "pqUtils", { enumerable: true, get: function () { return __importDefault(pqUtils_1).default; } });
+var arrayUtils_1 = require("./arrayUtils");
+Object.defineProperty(exports, "arrayUtils", { enumerable: true, get: function () { return __importDefault(arrayUtils_1).default; } });
+var documentUtils_1 = require("./documentUtils");
+Object.defineProperty(exports, "documentUtils", { enumerable: true, get: function () { return __importDefault(documentUtils_1).default; } });
+var xmlPartsUtils_1 = require("./xmlPartsUtils");
+Object.defineProperty(exports, "xmlPartsUtils", { enumerable: true, get: function () { return __importDefault(xmlPartsUtils_1).default; } });
+var xmlInnerPartsUtils_1 = require("./xmlInnerPartsUtils");
+Object.defineProperty(exports, "xmlInnerPartsUtils", { enumerable: true, get: function () { return __importDefault(xmlInnerPartsUtils_1).default; } });
+var tableUtils_1 = require("./tableUtils");
+Object.defineProperty(exports, "tableUtils", { enumerable: true, get: function () { return __importDefault(tableUtils_1).default; } });
+var htmlUtils_1 = require("./htmlUtils");
+Object.defineProperty(exports, "htmlUtils", { enumerable: true, get: function () { return __importDefault(htmlUtils_1).default; } });
+var gridUtils_1 = require("./gridUtils");
+Object.defineProperty(exports, "gridUtils", { enumerable: true, get: function () { return __importDefault(gridUtils_1).default; } });