@microsoft/connected-workbooks 3.2.2-beta → 3.3.2-beta

package/dist/tests/xmlInnerPartsUtils.test.js

@@ -37,94 +37,235 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 var mocks_1 = require("./mocks");
 var utils_1 = require("../src/utils");
-describe("Workbook Manager tests", function () {
+var globals_1 = require("@jest/globals");
+var jszip_1 = __importDefault(require("jszip"));
+var workbookTemplate_1 = require("../src/workbookTemplate");
+(0, globals_1.describe)("Workbook Manager tests", function () {
     var mockConnectionString = "<connections xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\" xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\" xmlns:xr16=\"http://schemas.microsoft.com/office/spreadsheetml/2017/revision16\" mc:Ignorable=\"xr16\">\n        <connection id=\"1\" xr16:uid=\"{86BA784C-6640-4989-A85E-EB4966B9E741}\" keepAlive=\"1\" name=\"Query - Query1\" description=\"Connection to the 'Query1' query in the workbook.\" type=\"5\" refreshedVersion=\"7\" background=\"1\" saveData=\"1\">\n        <dbPr connection=\"Provider=Microsoft.Mashup.OleDb.1;Data Source=$Workbook$;Location=Query1;\" command=\"SELECT * FROM [Query1]\"/></connection></connections>";
-    test("Connection XML attributes contain new query name", function () { return __awaiter(void 0, void 0, void 0, function () {
+    (0, globals_1.test)("Connection XML attributes contain new query name", function () { return __awaiter(void 0, void 0, void 0, function () {
         var connectionXmlFileString;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0: return [4 /*yield*/, utils_1.xmlInnerPartsUtils.updateConnections(mockConnectionString, "newQueryName", true)];
                 case 1:
                     connectionXmlFileString = (_a.sent()).connectionXmlFileString;
-                    expect(connectionXmlFileString.replace(/ /g, "")).toContain('command="SELECT * FROM [newQueryName]'.replace(/ /g, ""));
-                    expect(connectionXmlFileString.replace(/ /g, "")).toContain('name="Query - newQueryName"'.replace(/ /g, ""));
-                    expect(connectionXmlFileString.replace(/ /g, "")).toContain("description=\"Connection to the 'newQueryName' query in the workbook.\"".replace(/ /g, ""));
+                    (0, globals_1.expect)(connectionXmlFileString.replace(/ /g, "")).toContain('command="SELECT * FROM [newQueryName]'.replace(/ /g, ""));
+                    (0, globals_1.expect)(connectionXmlFileString.replace(/ /g, "")).toContain('name="Query - newQueryName"'.replace(/ /g, ""));
+                    (0, globals_1.expect)(connectionXmlFileString.replace(/ /g, "")).toContain("description=\"Connection to the 'newQueryName' query in the workbook.\"".replace(/ /g, ""));
                     return [2 /*return*/];
             }
         });
     }); });
-    test("Connection XML attributes contain refreshOnLoad value", function () { return __awaiter(void 0, void 0, void 0, function () {
+    (0, globals_1.test)("Connection XML attributes contain refreshOnLoad value", function () { return __awaiter(void 0, void 0, void 0, function () {
         var connectionXmlFileString;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0: return [4 /*yield*/, utils_1.xmlInnerPartsUtils.updateConnections(mockConnectionString, "newQueryName", true)];
                 case 1:
                     connectionXmlFileString = (_a.sent()).connectionXmlFileString;
-                    expect(connectionXmlFileString.replace(/ /g, "")).toContain('refreshOnLoad="1"');
+                    (0, globals_1.expect)(connectionXmlFileString.replace(/ /g, "")).toContain('refreshOnLoad="1"');
                     return [2 /*return*/];
             }
         });
     }); });
-    test("SharedStrings XML contains new query name", function () { return __awaiter(void 0, void 0, void 0, function () {
+    (0, globals_1.test)("SharedStrings XML contains new query name", function () { return __awaiter(void 0, void 0, void 0, function () {
         var newSharedStrings;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0: return [4 /*yield*/, utils_1.xmlInnerPartsUtils.updateSharedStrings('<sst xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" count="1" uniqueCount="1"><si><t>Query1</t></si><si><t/></si></sst>', "newQueryName")];
                 case 1:
                     newSharedStrings = (_a.sent()).newSharedStrings;
-                    expect(newSharedStrings.replace(/ /g, "")).toContain(mocks_1.sharedStringsXmlMock.replace(/ /g, ""));
+                    (0, globals_1.expect)(newSharedStrings.replace(/ /g, "")).toContain(mocks_1.sharedStringsXmlMock.replace(/ /g, ""));
                     return [2 /*return*/];
             }
         });
     }); });
-    test("Tests SharedStrings update when XML contains query name", function () { return __awaiter(void 0, void 0, void 0, function () {
+    (0, globals_1.test)("Tests SharedStrings update when XML contains query name", function () { return __awaiter(void 0, void 0, void 0, function () {
         var newSharedStrings;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0: return [4 /*yield*/, utils_1.xmlInnerPartsUtils.updateSharedStrings('<sst xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" count="1" uniqueCount="1"><si><t>newQueryName</t></si><si><t/></si></sst>', "newQueryName")];
                 case 1:
                     newSharedStrings = (_a.sent()).newSharedStrings;
-                    expect(newSharedStrings.replace(/ /g, "")).toContain(mocks_1.existingSharedStringsXmlMock.replace(/ /g, ""));
+                    (0, globals_1.expect)(newSharedStrings.replace(/ /g, "")).toContain(mocks_1.existingSharedStringsXmlMock.replace(/ /g, ""));
                     return [2 /*return*/];
             }
         });
     }); });
-    test("SharedStrings XML returns new index", function () { return __awaiter(void 0, void 0, void 0, function () {
+    (0, globals_1.test)("SharedStrings XML returns new index", function () { return __awaiter(void 0, void 0, void 0, function () {
         var sharedStringIndex;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0: return [4 /*yield*/, utils_1.xmlInnerPartsUtils.updateSharedStrings('<sst xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" count="1" uniqueCount="1"><si><t>Query1</t></si><si><t/></si></sst>', "newQueryName")];
                 case 1:
                     sharedStringIndex = (_a.sent()).sharedStringIndex;
-                    expect(sharedStringIndex).toEqual(2);
+                    (0, globals_1.expect)(sharedStringIndex).toEqual(2);
                     return [2 /*return*/];
             }
         });
     }); });
-    test("SharedStrings XML returns existing index", function () { return __awaiter(void 0, void 0, void 0, function () {
+    (0, globals_1.test)("SharedStrings XML returns existing index", function () { return __awaiter(void 0, void 0, void 0, function () {
         var sharedStringIndex;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0: return [4 /*yield*/, utils_1.xmlInnerPartsUtils.updateSharedStrings('<sst xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" count="1" uniqueCount="1"><si><t>newQueryName</t></si><si><t/></si></sst>', "newQueryName")];
                 case 1:
                     sharedStringIndex = (_a.sent()).sharedStringIndex;
-                    expect(sharedStringIndex).toEqual(1);
+                    (0, globals_1.expect)(sharedStringIndex).toEqual(1);
                     return [2 /*return*/];
             }
         });
     }); });
-    test("Table XML contains refrshonload value", function () { return __awaiter(void 0, void 0, void 0, function () {
+    (0, globals_1.test)("Table XML contains refrshonload value", function () { return __awaiter(void 0, void 0, void 0, function () {
         var _a, sharedStringIndex, newSharedStrings;
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0: return [4 /*yield*/, utils_1.xmlInnerPartsUtils.updateSharedStrings('<sst xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" count="1" uniqueCount="1"><si><t>Query1</t></si><si><t/></si></sst>', "newQueryName")];
                 case 1:
                     _a = _b.sent(), sharedStringIndex = _a.sharedStringIndex, newSharedStrings = _a.newSharedStrings;
-                    expect(sharedStringIndex).toEqual(2);
-                    expect(newSharedStrings.replace(/ /g, "")).toContain(mocks_1.sharedStringsXmlMock.replace(/ /g, ""));
+                    (0, globals_1.expect)(sharedStringIndex).toEqual(2);
+                    (0, globals_1.expect)(newSharedStrings.replace(/ /g, "")).toContain(mocks_1.sharedStringsXmlMock.replace(/ /g, ""));
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, globals_1.test)("Table XML contains correct Table reference value with headers included", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var singleTableDefaultTemplate, defaultZipFile, data, tableData, _a;
+        var _b;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    singleTableDefaultTemplate = workbookTemplate_1.SIMPLE_BLANK_TABLE_TEMPLATE;
+                    (0, globals_1.expect)(function () { return __awaiter(void 0, void 0, void 0, function () {
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0: return [4 /*yield*/, jszip_1.default.loadAsync(singleTableDefaultTemplate, {
+                                        base64: true,
+                                    })];
+                                case 1: return [2 /*return*/, _a.sent()];
+                            }
+                        });
+                    }); }).not.toThrow();
+                    return [4 /*yield*/, jszip_1.default.loadAsync(singleTableDefaultTemplate, {
+                            base64: true,
+                        })];
+                case 1:
+                    defaultZipFile = _c.sent();
+                    data = [
+                        ["ID", "Name", "Income", "Gross", "Bonus"],
+                        [123, "Alan C", 155000, 155000, 0.15],
+                        [331, "Tim C", 65000, 13000, 0.12],
+                        [222, "Bill G", 29501, 8850.3, 0.18],
+                        [5582, "Mitch M", 87960, 17592, 0.15],
+                        [43, "Dan F", 197296, 19729.6, 0.22],
+                        [22, "Perry T-P", 186006, 37201.2, 0.4],
+                        [335, "Mdrake", 197136, 78854.4, 0.1],
+                        [6590, "Dr P", 139636, 41890.8, 0.13],
+                    ];
+                    tableData = utils_1.gridUtils.parseToTableData({ data: data, config: { promoteHeaders: true, adjustColumnNames: true } });
+                    return [4 /*yield*/, utils_1.xmlPartsUtils.updateWorkbookDataAndConfigurations(defaultZipFile, undefined, tableData)];
+                case 2:
+                    _c.sent();
+                    _a = globals_1.expect;
+                    return [4 /*yield*/, ((_b = defaultZipFile.file("xl/tables/table1.xml")) === null || _b === void 0 ? void 0 : _b.async("text"))];
+                case 3:
+                    _a.apply(void 0, [_c.sent()]).toContain("A1:E9");
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, globals_1.test)("Table XML contains correct Table reference value without headers included", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var singleTableDefaultTemplate, defaultZipFile, data, tableData, _a;
+        var _b;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    singleTableDefaultTemplate = workbookTemplate_1.SIMPLE_BLANK_TABLE_TEMPLATE;
+                    (0, globals_1.expect)(function () { return __awaiter(void 0, void 0, void 0, function () {
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0: return [4 /*yield*/, jszip_1.default.loadAsync(singleTableDefaultTemplate, {
+                                        base64: true,
+                                    })];
+                                case 1: return [2 /*return*/, _a.sent()];
+                            }
+                        });
+                    }); }).not.toThrow();
+                    return [4 /*yield*/, jszip_1.default.loadAsync(singleTableDefaultTemplate, {
+                            base64: true,
+                        })];
+                case 1:
+                    defaultZipFile = _c.sent();
+                    data = [
+                        ["ID", "Name", "Income", "Gross", "Bonus"],
+                        [123, "Alan C", 155000, 155000, 0.15],
+                        [331, "Tim C", 65000, 13000, 0.12],
+                        [222, "Bill G", 29501, 8850.3, 0.18],
+                        [5582, "Mitch M", 87960, 17592, 0.15],
+                        [43, "Dan F", 197296, 19729.6, 0.22],
+                        [22, "Perry T-P", 186006, 37201.2, 0.4],
+                        [335, "Mdrake", 197136, 78854.4, 0.1],
+                        [6590, "Dr P", 139636, 41890.8, 0.13],
+                    ];
+                    tableData = utils_1.gridUtils.parseToTableData({ data: data, config: { promoteHeaders: false, adjustColumnNames: true } });
+                    return [4 /*yield*/, utils_1.xmlPartsUtils.updateWorkbookDataAndConfigurations(defaultZipFile, undefined, tableData)];
+                case 2:
+                    _c.sent();
+                    _a = globals_1.expect;
+                    return [4 /*yield*/, ((_b = defaultZipFile.file("xl/tables/table1.xml")) === null || _b === void 0 ? void 0 : _b.async("text"))];
+                case 3:
+                    _a.apply(void 0, [_c.sent()]).toContain("A1:E10");
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, globals_1.test)("Table XML contains correct Table reference value using template", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var movedTableDefaultTemplate, templateMovedZipFile, data, tableData, _a;
+        var _b;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    movedTableDefaultTemplate = workbookTemplate_1.WORKBOOK_TEMPLATE_MOVED_TABLE;
+                    (0, globals_1.expect)(function () { return __awaiter(void 0, void 0, void 0, function () {
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0: return [4 /*yield*/, jszip_1.default.loadAsync(movedTableDefaultTemplate, {
+                                        base64: true,
+                                    })];
+                                case 1: return [2 /*return*/, _a.sent()];
+                            }
+                        });
+                    }); }).not.toThrow();
+                    return [4 /*yield*/, jszip_1.default.loadAsync(movedTableDefaultTemplate, {
+                            base64: true,
+                        })];
+                case 1:
+                    templateMovedZipFile = _c.sent();
+                    data = [
+                        ["ID", "Name", "Income", "Gross", "Bonus"],
+                        [123, "Alan C", 155000, 155000, 0.15],
+                        [331, "Tim C", 65000, 13000, 0.12],
+                        [222, "Bill G", 29501, 8850.3, 0.18],
+                        [5582, "Mitch M", 87960, 17592, 0.15],
+                        [43, "Dan F", 197296, 19729.6, 0.22],
+                        [22, "Perry T-P", 186006, 37201.2, 0.4],
+                        [335, "Mdrake", 197136, 78854.4, 0.1],
+                        [6590, "Dr P", 139636, 41890.8, 0.13],
+                    ];
+                    tableData = utils_1.gridUtils.parseToTableData({ data: data, config: { promoteHeaders: true, adjustColumnNames: true } });
+                    return [4 /*yield*/, utils_1.xmlPartsUtils.updateWorkbookDataAndConfigurations(templateMovedZipFile, { templateFile: templateMovedZipFile }, tableData)];
+                case 2:
+                    _c.sent();
+                    _a = globals_1.expect;
+                    return [4 /*yield*/, ((_b = templateMovedZipFile.file("xl/tables/table1.xml")) === null || _b === void 0 ? void 0 : _b.async("text"))];
+                case 3:
+                    _a.apply(void 0, [_c.sent()]).toContain("B2:F10");
                     return [2 /*return*/];
             }
         });

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 export interface QueryInfo {
     refreshOnOpen: boolean;
     queryMashup: string;
@@ -29,9 +30,14 @@ export interface GridConfig {
     adjustColumnNames?: boolean;
 }
 export interface FileConfigs {
-    templateFile?: File;
+    templateFile?: File | Buffer;
     docProps?: DocProps;
     hostName?: string;
+    templateSettings?: TemplateSettings;
+}
+export interface TemplateSettings {
+    tableName?: string;
+    sheetName?: string;
 }
 export declare enum DataTypes {
     null = 0,

package/dist/utils/constants.js

@@ -2,8 +2,8 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 Object.defineProperty(exports, "__esModule", { value: true });
-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.columnIndexOutOfRangeErr = exports.relsNotFoundErr = 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.docMetadataXmlPath = exports.relsXmlPath = exports.docPropsCoreXmlPath = exports.section1mPath = exports.pivotCachesPath = exports.queryTablesPath = exports.workbookXmlPath = exports.queryTableXmlPath = exports.tableXmlPath = exports.sheetsXmlPath = exports.sharedStringsXmlPath = exports.connectionsXmlPath = void 0;
-exports.OFU = exports.headers = exports.URLS = exports.defaults = exports.elementAttributesValues = exports.dataTypeKind = exports.elementAttributes = exports.element = exports.BOM = exports.falseStr = exports.trueStr = void 0;
+exports.textResultType = exports.application = exports.uint8ArrayType = exports.blobFileType = exports.relationshipErr = exports.columnIndexOutOfRangeErr = exports.xlRelsNotFoundErr = exports.relsNotFoundErr = exports.arrayIsntMxNErr = exports.unexpectedErr = exports.promotedHeadersCannotBeUsedWithoutAdjustingColumnNamesErr = exports.InvalidColumnNameErr = exports.stylesNotFoundErr = exports.EmptyQueryNameErr = exports.QueryNameInvalidCharsErr = exports.QueryNameMaxLengthErr = exports.invalidDataTypeErr = exports.headerNotFoundErr = exports.invalidValueInColumnErr = exports.tableReferenceNotFoundErr = exports.tableNotFoundErr = exports.queryTableNotFoundErr = exports.templateWithInitialDataErr = exports.formulaSectionNotFoundErr = exports.queryConnectionNotFoundErr = exports.queryAndPivotTableNotFoundErr = exports.queryNameNotFoundErr = exports.emptyQueryMashupErr = exports.base64NotFoundErr = exports.sheetsNotFoundErr = exports.WorkbookNotFoundERR = exports.connectionsNotFoundErr = exports.sharedStringsNotFoundErr = exports.docPropsAppXmlPath = exports.labelInfoXmlPath = exports.workbookRelsXmlPath = exports.docPropsRootElement = exports.docMetadataXmlPath = exports.relsXmlPath = exports.docPropsCoreXmlPath = exports.section1mPath = exports.pivotCachesPath = exports.tablesFolderPath = exports.queryTablesPath = exports.workbookXmlPath = exports.queryTableXmlPath = exports.tableXmlPath = exports.sheetsXmlPath = exports.sharedStringsXmlPath = exports.connectionsXmlPath = void 0;
+exports.OFU = exports.headers = exports.URLS = exports.defaults = exports.elementAttributesValues = exports.dataTypeKind = exports.elementAttributes = exports.element = exports.BOM = exports.falseStr = exports.trueStr = exports.maxQueryLength = exports.divider = exports.section1PathPrefix = exports.emptyValue = exports.falseValue = exports.trueValue = exports.pivotCachesPathPrefix = exports.xmlTextResultType = void 0;
 exports.connectionsXmlPath = "xl/connections.xml";
 exports.sharedStringsXmlPath = "xl/sharedStrings.xml";
 exports.sheetsXmlPath = "xl/worksheets/sheet1.xml";
@@ -11,14 +11,19 @@ exports.tableXmlPath = "xl/tables/table1.xml";
 exports.queryTableXmlPath = "xl/queryTables/queryTable1.xml";
 exports.workbookXmlPath = "xl/workbook.xml";
 exports.queryTablesPath = "xl/queryTables/";
+exports.tablesFolderPath = "xl/tables/";
 exports.pivotCachesPath = "xl/pivotCache/";
 exports.section1mPath = "Formulas/Section1.m";
 exports.docPropsCoreXmlPath = "docProps/core.xml";
 exports.relsXmlPath = "_rels/.rels";
 exports.docMetadataXmlPath = "docMetadata";
 exports.docPropsRootElement = "cp:coreProperties";
+exports.workbookRelsXmlPath = "xl/_rels/workbook.xml.rels";
+exports.labelInfoXmlPath = "docMetadata/LabelInfo.xml";
+exports.docPropsAppXmlPath = "docProps/app.xml";
 exports.sharedStringsNotFoundErr = "SharedStrings were not found in template";
 exports.connectionsNotFoundErr = "Connections were not found in template";
+exports.WorkbookNotFoundERR = "workbook was 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";
@@ -29,6 +34,7 @@ exports.formulaSectionNotFoundErr = "Formula section wasn't found in template";
 exports.templateWithInitialDataErr = "Cannot use a template file with initial data";
 exports.queryTableNotFoundErr = "Query table wasn't found in template";
 exports.tableNotFoundErr = "Table wasn't found in template";
+exports.tableReferenceNotFoundErr = "Reference not found in the table XML.";
 exports.invalidValueInColumnErr = "Invalid cell value in column";
 exports.headerNotFoundErr = "Invalid JSON file, header is missing";
 exports.invalidDataTypeErr = "Invalid JSON file, invalid data type";
@@ -41,7 +47,9 @@ exports.promotedHeadersCannotBeUsedWithoutAdjustingColumnNamesErr = "Headers can
 exports.unexpectedErr = "Unexpected error";
 exports.arrayIsntMxNErr = "Array isn't MxN";
 exports.relsNotFoundErr = ".rels were not found in template";
+exports.xlRelsNotFoundErr = "workbook.xml.rels were not found xl";
 exports.columnIndexOutOfRangeErr = "Column index out of range";
+exports.relationshipErr = "Relationship not found";
 exports.blobFileType = "blob";
 exports.uint8ArrayType = "uint8array";
 exports.application = "application/xlsx";
@@ -85,6 +93,9 @@ exports.element = {
     dimension: "dimension",
     selection: "selection",
     kindCell: "c",
+    sheet: "sheet",
+    relationships: "Relationships",
+    relationship: "Relationship"
 };
 exports.elementAttributes = {
     connection: "connection",
@@ -98,6 +109,11 @@ exports.elementAttributes = {
     name: "name",
     description: "description",
     id: "id",
+    Id: "Id",
+    relationId: "r:id",
+    relationId1: "RId1",
+    relationId2: "RId2",
+    relationId3: "RId3",
     type: "Type",
     value: "Value",
     relationshipInfo: "RelationshipInfoContainer",
@@ -117,6 +133,7 @@ exports.elementAttributes = {
     x14acDyDescent: "x14ac:dyDescent",
     xr3uid: "xr3:uid",
     space: "xml:space",
+    target: "Target",
 };
 exports.dataTypeKind = {
     string: "str",
@@ -134,6 +151,7 @@ exports.defaults = {
     queryName: "Query1",
     sheetName: "Sheet1",
     columnName: "Column",
+    tableName: "Table1",
 };
 exports.URLS = {
     PQ: [

package/dist/utils/documentUtils.js

@@ -93,13 +93,27 @@ var convertToExcelColumn = function (index) {
     var base = 26; // number of letters in the alphabet
     while (index >= 0) {
         var remainder = index % base;
-        columnStr = String.fromCharCode(remainder + 65) + columnStr; // ASCII 'A' is 65
+        columnStr = String.fromCharCode(remainder + 'A'.charCodeAt(0)) + columnStr;
         index = Math.floor(index / base) - 1;
     }
     return columnStr;
 };
-var getTableReference = function (numberOfCols, numberOfRows) {
-    return "A1:".concat(getCellReferenceRelative(numberOfCols, numberOfRows));
+/**
+ * Parse an Excel range (e.g. "B2:D10") and return its starting row and column indices.
+ * @param cellRangeRef - Range reference string.
+ * @returns Object with numeric row and column.
+ */
+var GetStartPosition = function (cellRangeRef) {
+    var match = cellRangeRef.toUpperCase().match(/^([A-Z]+)(\d+)/);
+    if (!match) {
+        return { row: 0, column: 0 };
+    }
+    var colLetters = match[1], rowStr = match[2];
+    var row = parseInt(rowStr, 10);
+    var column = colLetters
+        .split("")
+        .reduce(function (acc, char) { return acc * 26 + (char.charCodeAt(0) - "A".charCodeAt(0) + 1); }, 0);
+    return { row: row, column: column };
 };
 var createCellElement = function (doc, colIndex, rowIndex, data) {
     var cell = doc.createElementNS(doc.documentElement.namespaceURI, constants_1.element.kindCell);
@@ -146,8 +160,8 @@ exports.default = {
     getCellReferenceRelative: getCellReferenceRelative,
     getCellReferenceAbsolute: getCellReferenceAbsolute,
     createCell: createCellElement,
-    getTableReference: getTableReference,
     updateCellData: updateCellData,
     resolveType: resolveType,
     convertToExcelColumn: convertToExcelColumn,
+    GetStartPosition: GetStartPosition,
 };

package/dist/utils/tableUtils.js

@@ -45,7 +45,17 @@ var constants_1 = require("./constants");
 var documentUtils_1 = __importDefault(require("./documentUtils"));
 var uuid_1 = require("uuid");
 var xmldom_qsa_1 = require("xmldom-qsa");
-var updateTableInitialDataIfNeeded = function (zip, tableData, updateQueryTable) { return __awaiter(void 0, void 0, void 0, function () {
+/**
+ * Update initial data for a table, its sheet, query table, and defined name if provided.
+ * @param zip - The JSZip instance containing workbook parts.
+ * @param cellRangeRef - Cell range reference (e.g. "A1:C5").
+ * @param sheetPath - Path to the sheet XML within the zip.
+ * @param tablePath - Path to the table XML within the zip.
+ * @param tableName - Name of the table.
+ * @param tableData - Optional TableData containing headers and rows.
+ * @param updateQueryTable - Whether to update the associated queryTable part.
+ */
+var updateTableInitialDataIfNeeded = function (zip, cellRangeRef, sheetPath, tablePath, sheetName, tableData, updateQueryTable) { return __awaiter(void 0, void 0, void 0, function () {
     var sheetsXmlString, newSheet, queryTableXmlString, newQueryTable, workbookXmlString, newWorkbook, tableXmlString, newTable;
     var _a, _b, _c, _d;
     return __generator(this, function (_e) {
@@ -54,14 +64,14 @@ var updateTableInitialDataIfNeeded = function (zip, tableData, updateQueryTable)
                 if (!tableData) {
                     return [2 /*return*/];
                 }
-                return [4 /*yield*/, ((_a = zip.file(constants_1.sheetsXmlPath)) === null || _a === void 0 ? void 0 : _a.async(constants_1.textResultType))];
+                return [4 /*yield*/, ((_a = zip.file(sheetPath)) === null || _a === void 0 ? void 0 : _a.async(constants_1.textResultType))];
             case 1:
                 sheetsXmlString = _e.sent();
                 if (sheetsXmlString === undefined) {
                     throw new Error(constants_1.sheetsNotFoundErr);
                 }
-                newSheet = updateSheetsInitialData(sheetsXmlString, tableData);
-                zip.file(constants_1.sheetsXmlPath, newSheet);
+                newSheet = updateSheetsInitialData(sheetsXmlString, tableData, cellRangeRef);
+                zip.file(sheetPath, newSheet);
                 if (!updateQueryTable) return [3 /*break*/, 5];
                 return [4 /*yield*/, ((_b = zip.file(constants_1.queryTableXmlPath)) === null || _b === void 0 ? void 0 : _b.async(constants_1.textResultType))];
             case 2:
@@ -79,22 +89,30 @@ var updateTableInitialDataIfNeeded = function (zip, tableData, updateQueryTable)
                 if (workbookXmlString === undefined) {
                     throw new Error(constants_1.sheetsNotFoundErr);
                 }
-                newWorkbook = updateWorkbookInitialData(workbookXmlString, tableData);
+                newWorkbook = updateWorkbookInitialData(workbookXmlString, sheetName + GenerateReferenceFromString(cellRangeRef));
                 zip.file(constants_1.workbookXmlPath, newWorkbook);
                 _e.label = 5;
-            case 5: return [4 /*yield*/, ((_d = zip.file(constants_1.tableXmlPath)) === null || _d === void 0 ? void 0 : _d.async(constants_1.textResultType))];
+            case 5: return [4 /*yield*/, ((_d = zip.file(tablePath)) === null || _d === void 0 ? void 0 : _d.async(constants_1.textResultType))];
             case 6:
                 tableXmlString = _e.sent();
                 if (tableXmlString === undefined) {
                     throw new Error(constants_1.tableNotFoundErr);
                 }
-                newTable = updateTablesInitialData(tableXmlString, tableData, updateQueryTable);
-                zip.file(constants_1.tableXmlPath, newTable);
+                newTable = updateTablesInitialData(tableXmlString, tableData, cellRangeRef, updateQueryTable);
+                zip.file(tablePath, newTable);
                 return [2 /*return*/];
         }
     });
 }); };
-var updateTablesInitialData = function (tableXmlString, tableData, updateQueryTable) {
+/**
+ * Generate updated table XML string with new columns, reference, and filter range.
+ * @param tableXmlString - Original table XML.
+ * @param tableData - TableData containing column names.
+ * @param cellRangeRef - Cell range reference.
+ * @param updateQueryTable - Whether to include queryTable attributes.
+ * @returns Serialized XML string of the updated table.
+ */
+var updateTablesInitialData = function (tableXmlString, tableData, cellRangeRef, updateQueryTable) {
     if (updateQueryTable === void 0) { updateQueryTable = false; }
     var parser = new xmldom_qsa_1.DOMParser();
     var serializer = new xmldom_qsa_1.XMLSerializer();
@@ -115,19 +133,24 @@ var updateTablesInitialData = function (tableXmlString, tableData, updateQueryTa
     tableColumns.setAttribute(constants_1.elementAttributes.count, tableData.columnNames.length.toString());
     tableDoc
         .getElementsByTagName(constants_1.element.table)[0]
-        .setAttribute(constants_1.elementAttributes.reference, "A1:".concat(documentUtils_1.default.getCellReferenceRelative(tableData.columnNames.length - 1, tableData.rows.length + 1)));
+        .setAttribute(constants_1.elementAttributes.reference, cellRangeRef);
     tableDoc
         .getElementsByTagName(constants_1.element.autoFilter)[0]
-        .setAttribute(constants_1.elementAttributes.reference, "A1:".concat(documentUtils_1.default.getCellReferenceRelative(tableData.columnNames.length - 1, tableData.rows.length + 1)));
+        .setAttribute(constants_1.elementAttributes.reference, cellRangeRef);
     return serializer.serializeToString(tableDoc);
 };
-var updateWorkbookInitialData = function (workbookXmlString, tableData) {
+/**
+ * Update the definedName element in workbook XML to a custom name.
+ * @param workbookXmlString - Original workbook XML string.
+ * @param customDefinedName - New defined name text content (e.g. "!$A$1:$C$5").
+ * @returns Serialized XML string of the updated workbook.
+ */
+var updateWorkbookInitialData = function (workbookXmlString, customDefinedName) {
     var newParser = new xmldom_qsa_1.DOMParser();
     var newSerializer = new xmldom_qsa_1.XMLSerializer();
     var workbookDoc = newParser.parseFromString(workbookXmlString, constants_1.xmlTextResultType);
     var definedName = workbookDoc.getElementsByTagName(constants_1.element.definedName)[0];
-    definedName.textContent =
-        constants_1.defaults.sheetName + "!$A$1:".concat(documentUtils_1.default.getCellReferenceAbsolute(tableData.columnNames.length - 1, tableData.rows.length + 1));
+    definedName.textContent = customDefinedName;
     return newSerializer.serializeToString(workbookDoc);
 };
 var updateQueryTablesInitialData = function (queryTableXmlString, tableData) {
@@ -147,42 +170,64 @@ var updateQueryTablesInitialData = function (queryTableXmlString, tableData) {
     queryTableDoc.getElementsByTagName(constants_1.element.queryTableRefresh)[0].setAttribute(constants_1.elementAttributes.nextId, (tableData.columnNames.length + 1).toString());
     return serializer.serializeToString(queryTableDoc);
 };
-var updateSheetsInitialData = function (sheetsXmlString, tableData) {
+/**
+ * Update sheet XML with header row and data rows based on TableData.
+ * @param sheetsXmlString - Original sheet XML string.
+ * @param tableData - TableData containing headers and rows.
+ * @param cellRangeRef - Cell range reference.
+ * @returns Serialized XML string of the updated sheet.
+ */
+var updateSheetsInitialData = function (sheetsXmlString, tableData, cellRangeRef) {
+    var _a = documentUtils_1.default.GetStartPosition(cellRangeRef), row = _a.row, column = _a.column;
     var parser = new xmldom_qsa_1.DOMParser();
     var serializer = new xmldom_qsa_1.XMLSerializer();
     var sheetsDoc = parser.parseFromString(sheetsXmlString, constants_1.xmlTextResultType);
     var sheetData = sheetsDoc.getElementsByTagName(constants_1.element.sheetData)[0];
     sheetData.textContent = "";
-    var rowIndex = 0;
     var columnRow = sheetsDoc.createElementNS(sheetsDoc.documentElement.namespaceURI, constants_1.element.row);
-    columnRow.setAttribute(constants_1.elementAttributes.row, (rowIndex + 1).toString());
-    columnRow.setAttribute(constants_1.elementAttributes.spans, "1:" + tableData.columnNames.length);
+    columnRow.setAttribute(constants_1.elementAttributes.row, row.toString());
+    columnRow.setAttribute(constants_1.elementAttributes.spans, column + ":" + (column + tableData.columnNames.length - 1));
     columnRow.setAttribute(constants_1.elementAttributes.x14acDyDescent, "0.3");
     tableData.columnNames.forEach(function (col, colIndex) {
-        columnRow.appendChild(documentUtils_1.default.createCell(sheetsDoc, colIndex, rowIndex, col));
+        columnRow.appendChild(documentUtils_1.default.createCell(sheetsDoc, colIndex + column - 1, row - 1, col));
     });
     sheetData.appendChild(columnRow);
-    rowIndex++;
-    tableData.rows.forEach(function (row) {
+    row++;
+    tableData.rows.forEach(function (_row) {
         var newRow = sheetsDoc.createElementNS(sheetsDoc.documentElement.namespaceURI, constants_1.element.row);
-        newRow.setAttribute(constants_1.elementAttributes.row, (rowIndex + 1).toString());
-        newRow.setAttribute(constants_1.elementAttributes.spans, "1:" + row.length);
+        newRow.setAttribute(constants_1.elementAttributes.row, row.toString());
+        newRow.setAttribute(constants_1.elementAttributes.spans, column + ":" + (column + tableData.columnNames.length - 1));
         newRow.setAttribute(constants_1.elementAttributes.x14acDyDescent, "0.3");
-        row.forEach(function (cellContent, colIndex) {
-            newRow.appendChild(documentUtils_1.default.createCell(sheetsDoc, colIndex, rowIndex, cellContent));
+        _row.forEach(function (cellContent, colIndex) {
+            newRow.appendChild(documentUtils_1.default.createCell(sheetsDoc, colIndex + column - 1, row - 1, cellContent));
         });
         sheetData.appendChild(newRow);
-        rowIndex++;
+        row++;
     });
-    var reference = documentUtils_1.default.getTableReference(tableData.rows[0].length - 1, tableData.rows.length + 1);
-    sheetsDoc.getElementsByTagName(constants_1.element.dimension)[0].setAttribute(constants_1.elementAttributes.reference, reference);
-    sheetsDoc.getElementsByTagName(constants_1.element.selection)[0].setAttribute(constants_1.elementAttributes.sqref, reference);
+    sheetsDoc.getElementsByTagName(constants_1.element.dimension)[0].setAttribute(constants_1.elementAttributes.reference, cellRangeRef);
+    sheetsDoc.getElementsByTagName(constants_1.element.selection)[0].setAttribute(constants_1.elementAttributes.sqref, cellRangeRef);
     return serializer.serializeToString(sheetsDoc);
 };
+/**
+ * Add Excel-style dollar signs and a '!' prefix to a cell range.
+ * Converts "A1:B2" into "!$A$1:$B$2".
+ * @param cellRangeRef - Range reference string without dollar signs.
+ * @returns Range with dollar signs and prefix.
+ */
+var GenerateReferenceFromString = function (cellRangeRef) {
+    return "!" + cellRangeRef.split(":").map(function (part) {
+        var match = part.match(/^([A-Za-z]+)(\d+)$/);
+        if (match) {
+            var col = match[1], row = match[2];
+            return "$".concat(col.toUpperCase(), "$").concat(row);
+        }
+    }).join(":");
+};
 exports.default = {
     updateTableInitialDataIfNeeded: updateTableInitialDataIfNeeded,
     updateSheetsInitialData: updateSheetsInitialData,
     updateWorkbookInitialData: updateWorkbookInitialData,
     updateTablesInitialData: updateTablesInitialData,
     updateQueryTablesInitialData: updateQueryTablesInitialData,
+    GenerateReferenceFromString: GenerateReferenceFromString,
 };