@js-ak/excel-toolbox 1.5.0 → 1.6.0

package/build/cjs/lib/template/utils/validate-worksheet-xml.js

@@ -33,9 +33,7 @@ function validateWorksheetXml(xml) {
     const requiredElements = [
         { name: "sheetViews", tag: "<sheetViews>" },
         { name: "sheetFormatPr", tag: "<sheetFormatPr" },
-        { name: "cols", tag: "<cols>" },
         { name: "sheetData", tag: "<sheetData>" },
-        { name: "mergeCells", tag: "<mergeCells" },
     ];
     for (const { name, tag } of requiredElements) {
         if (!xml.includes(tag)) {
@@ -100,59 +98,82 @@ function validateWorksheetXml(xml) {
         }
     }
     // 4. Check mergeCells
-    const mergeCellsStart = xml.indexOf("<mergeCells");
-    const mergeCellsEnd = xml.indexOf("</mergeCells>");
-    if (mergeCellsStart === -1 || mergeCellsEnd === -1) {
-        return createError("Invalid mergeCells structure");
-    }
-    const mergeCellsContent = xml.substring(mergeCellsStart, mergeCellsEnd);
-    const countMatch = mergeCellsContent.match(/count="(\d+)"/);
-    if (!countMatch) {
-        return createError("Count attribute not specified for mergeCells");
-    }
-    const mergeCellTags = mergeCellsContent.match(/<mergeCell\s+ref="([A-Z]+\d+:[A-Z]+\d+)"\s*\/>/g);
-    if (!mergeCellTags) {
-        return createError("No merged cells found");
-    }
-    // Check if the number of mergeCells matches the count attribute
-    if (mergeCellTags.length !== parseInt(countMatch[1])) {
-        return createError("Mismatch in the number of merged cells", `Expected: ${countMatch[1]}, found: ${mergeCellTags.length}`);
-    }
-    // Check for duplicates of mergeCell
-    const mergeRefs = new Set();
-    const duplicates = new Set();
-    for (const mergeTag of mergeCellTags) {
-        const refMatch = mergeTag.match(/ref="([A-Z]+\d+:[A-Z]+\d+)"/);
-        if (!refMatch) {
-            return createError("Invalid merge cell format", `Tag: ${mergeTag}`);
-        }
-        const ref = refMatch[1];
-        if (mergeRefs.has(ref)) {
-            duplicates.add(ref);
+    if (xml.includes("<mergeCells")) {
+        const mergeCellsStart = xml.indexOf("<mergeCells");
+        const mergeCellsEnd = xml.indexOf("</mergeCells>");
+        if (mergeCellsStart === -1 || mergeCellsEnd === -1) {
+            return createError("Invalid mergeCells structure");
+        }
+        const mergeCellsContent = xml.substring(mergeCellsStart, mergeCellsEnd);
+        const countMatch = mergeCellsContent.match(/count="(\d+)"/);
+        if (!countMatch) {
+            return createError("Count attribute not specified for mergeCells");
+        }
+        const mergeCellTags = mergeCellsContent.match(/<mergeCell\s+ref="([A-Z]+\d+:[A-Z]+\d+)"\s*\/>/g);
+        if (!mergeCellTags) {
+            return createError("No merged cells found");
+        }
+        // Check if the number of mergeCells matches the count attribute
+        if (mergeCellTags.length !== parseInt(countMatch[1])) {
+            return createError("Mismatch in the number of merged cells", `Expected: ${countMatch[1]}, found: ${mergeCellTags.length}`);
+        }
+        // Check for duplicates of mergeCell
+        const mergeRefs = new Set();
+        const duplicates = new Set();
+        for (const mergeTag of mergeCellTags) {
+            const refMatch = mergeTag.match(/ref="([A-Z]+\d+:[A-Z]+\d+)"/);
+            if (!refMatch) {
+                return createError("Invalid merge cell format", `Tag: ${mergeTag}`);
+            }
+            const ref = refMatch[1];
+            if (mergeRefs.has(ref)) {
+                duplicates.add(ref);
+            }
+            else {
+                mergeRefs.add(ref);
+            }
         }
-        else {
-            mergeRefs.add(ref);
+        if (duplicates.size > 0) {
+            return createError("Duplicates of merged cells found", `Duplicates: ${Array.from(duplicates).join(", ")}`);
+        }
+        // Check for overlapping merge ranges
+        const mergedRanges = Array.from(mergeRefs).map(ref => {
+            const [start, end] = ref.split(":");
+            return {
+                endCol: end.match(/[A-Z]+/)?.[0] || "",
+                endRow: parseInt(end.match(/\d+/)?.[0] || "0"),
+                startCol: start.match(/[A-Z]+/)?.[0] || "",
+                startRow: parseInt(start.match(/\d+/)?.[0] || "0"),
+            };
+        });
+        for (let i = 0; i < mergedRanges.length; i++) {
+            for (let j = i + 1; j < mergedRanges.length; j++) {
+                const a = mergedRanges[i];
+                const b = mergedRanges[j];
+                if (rangesIntersect(a, b)) {
+                    return createError("Found intersecting merged cells", `Intersecting: ${getRangeString(a)} and ${getRangeString(b)}`);
+                }
+            }
         }
-    }
-    if (duplicates.size > 0) {
-        return createError("Duplicates of merged cells found", `Duplicates: ${Array.from(duplicates).join(", ")}`);
-    }
-    // Check for overlapping merge ranges
-    const mergedRanges = Array.from(mergeRefs).map(ref => {
-        const [start, end] = ref.split(":");
-        return {
-            endCol: end.match(/[A-Z]+/)?.[0] || "",
-            endRow: parseInt(end.match(/\d+/)?.[0] || "0"),
-            startCol: start.match(/[A-Z]+/)?.[0] || "",
-            startRow: parseInt(start.match(/\d+/)?.[0] || "0"),
-        };
-    });
-    for (let i = 0; i < mergedRanges.length; i++) {
-        for (let j = i + 1; j < mergedRanges.length; j++) {
-            const a = mergedRanges[i];
-            const b = mergedRanges[j];
-            if (rangesIntersect(a, b)) {
-                return createError("Found intersecting merged cells", `Intersecting: ${getRangeString(a)} and ${getRangeString(b)}`);
+        // 6. Additional check: all mergeCell tags refer to existing cells
+        for (const mergeTag of mergeCellTags) {
+            const refMatch = mergeTag.match(/ref="([A-Z]+\d+:[A-Z]+\d+)"/);
+            if (!refMatch) {
+                return createError("Invalid merge cell format", `Tag: ${mergeTag}`);
+            }
+            const [cell1, cell2] = refMatch[1].split(":");
+            const cell1Col = cell1.match(/[A-Z]+/)?.[0];
+            const cell1Row = parseInt(cell1.match(/\d+/)?.[0] || "0");
+            const cell2Col = cell2.match(/[A-Z]+/)?.[0];
+            const cell2Row = parseInt(cell2.match(/\d+/)?.[0] || "0");
+            if (!cell1Col || !cell2Col || isNaN(cell1Row) || isNaN(cell2Row)) {
+                return createError("Invalid merged cell coordinates", `Merged cells: ${refMatch[1]}`);
+            }
+            // Check if the merged cells exist
+            const cell1Exists = allCells.some(c => c.row === cell1Row && c.col === cell1Col);
+            const cell2Exists = allCells.some(c => c.row === cell2Row && c.col === cell2Col);
+            if (!cell1Exists || !cell2Exists) {
+                return createError("Merged cell reference points to non-existent cells", `Merged cells: ${refMatch[1]}, missing: ${!cell1Exists ? `${cell1Col}${cell1Row}` : `${cell2Col}${cell2Row}`}`);
             }
         }
     }
@@ -181,27 +202,6 @@ function validateWorksheetXml(xml) {
             return createError("Cell is outside the specified area (by column)", `Cell: ${cell.col}${cell.row}, dimension: ${dimensionMatch[1]}`);
         }
     }
-    // 6. Additional check: all mergeCell tags refer to existing cells
-    for (const mergeTag of mergeCellTags) {
-        const refMatch = mergeTag.match(/ref="([A-Z]+\d+:[A-Z]+\d+)"/);
-        if (!refMatch) {
-            return createError("Invalid merge cell format", `Tag: ${mergeTag}`);
-        }
-        const [cell1, cell2] = refMatch[1].split(":");
-        const cell1Col = cell1.match(/[A-Z]+/)?.[0];
-        const cell1Row = parseInt(cell1.match(/\d+/)?.[0] || "0");
-        const cell2Col = cell2.match(/[A-Z]+/)?.[0];
-        const cell2Row = parseInt(cell2.match(/\d+/)?.[0] || "0");
-        if (!cell1Col || !cell2Col || isNaN(cell1Row) || isNaN(cell2Row)) {
-            return createError("Invalid merged cell coordinates", `Merged cells: ${refMatch[1]}`);
-        }
-        // Check if the merged cells exist
-        const cell1Exists = allCells.some(c => c.row === cell1Row && c.col === cell1Col);
-        const cell2Exists = allCells.some(c => c.row === cell2Row && c.col === cell2Col);
-        if (!cell1Exists || !cell2Exists) {
-            return createError("Merged cell reference points to non-existent cells", `Merged cells: ${refMatch[1]}, missing: ${!cell1Exists ? `${cell1Col}${cell1Row}` : `${cell2Col}${cell2Row}`}`);
-        }
-    }
     return { isValid: true };
 }
 // A function to check if two ranges intersect

package/build/cjs/lib/template/utils/write-rows-to-stream.js

@@ -13,34 +13,74 @@ const prepare_row_to_cells_js_1 = require("./prepare-row-to-cells.js");
  * for the first row written to the file. Subsequent rows are written
  * with incrementing row numbers.
  *
- * @param output - A file write stream to write the Excel XML to.
- * @param rows - An async iterable of rows, where each row is an array
- *               of values.
- * @param startRowNumber - The starting row number to use for the first
- *                         row written to the file.
- *
- * @returns An object with a single property `rowNumber`, which is the
- *          last row number written to the file (i.e., the `startRowNumber`
- *          plus the number of rows written).
+ * @param {WritableLike} output - A file write stream to write the Excel XML to.
+ * @param {AsyncIterable<unknown[] | unknown[][]>} rows - An async iterable of rows, where each row is an array
+ *                                                        of values or an array of arrays of values.
+ * @param {number} startRowNumber - The starting row number to use for the first
+ *                                 row written to the file.
+ * @returns {Promise<{
+ *   dimension: {
+ *     maxColumn: string;
+ *     maxRow: number;
+ *     minColumn: string;
+ *     minRow: number;
+ *   };
+ *   rowNumber: number;
+ * }>} An object containing:
+ *   - dimension: The boundaries of the written data (min/max columns and rows)
+ *   - rowNumber: The last row number written to the file
  */
 async function writeRowsToStream(output, rows, startRowNumber) {
     let rowNumber = startRowNumber;
+    const dimension = {
+        maxColumn: "A",
+        maxRow: startRowNumber,
+        minColumn: "A",
+        minRow: startRowNumber,
+    };
+    // Функция для сравнения колонок (A < B, AA > Z и т.д.)
+    const compareColumns = (a, b) => {
+        if (a === b)
+            return 0;
+        return a.length === b.length ? (a < b ? -1 : 1) : (a.length < b.length ? -1 : 1);
+    };
+    const processRow = (row, currentRowNumber) => {
+        const cells = (0, prepare_row_to_cells_js_1.prepareRowToCells)(row, currentRowNumber);
+        if (cells.length === 0)
+            return;
+        output.write(`<row r="${currentRowNumber}">${cells.map(cell => cell.cellXml).join("")}</row>`);
+        // Обновление границ
+        const firstCellRef = cells[0]?.cellRef;
+        const lastCellRef = cells[cells.length - 1]?.cellRef;
+        if (firstCellRef) {
+            const colLetters = firstCellRef.match(/[A-Z]+/)?.[0] || "";
+            if (compareColumns(colLetters, dimension.minColumn) < 0) {
+                dimension.minColumn = colLetters;
+            }
+        }
+        if (lastCellRef) {
+            const colLetters = lastCellRef.match(/[A-Z]+/)?.[0] || "";
+            if (compareColumns(colLetters, dimension.maxColumn) > 0) {
+                dimension.maxColumn = colLetters;
+            }
+        }
+        dimension.maxRow = currentRowNumber;
+    };
     for await (const row of rows) {
-        // Transform the row into XML
+        if (!row.length)
+            continue;
         if (Array.isArray(row[0])) {
             for (const subRow of row) {
-                const cells = (0, prepare_row_to_cells_js_1.prepareRowToCells)(subRow, rowNumber);
-                // Write the row to the file
-                output.write(`<row r="${rowNumber}">${cells.join("")}</row>`);
+                if (!subRow.length)
+                    continue;
+                processRow(subRow, rowNumber);
                 rowNumber++;
             }
         }
         else {
-            const cells = (0, prepare_row_to_cells_js_1.prepareRowToCells)(row, rowNumber);
-            // Write the row to the file
-            output.write(`<row r="${rowNumber}">${cells.join("")}</row>`);
+            processRow(row, rowNumber);
             rowNumber++;
         }
     }
-    return { rowNumber };
+    return { dimension, rowNumber };
 }

package/build/esm/lib/template/template-fs.js

@@ -2,6 +2,7 @@ import * as fs from "node:fs/promises";
 import * as fsSync from "node:fs";
 import * as path from "node:path";
 import * as readline from "node:readline";
+import crypto from "node:crypto";
 import * as Xml from "../xml/index.js";
 import * as Zip from "../zip/index.js";
 import * as Utils from "./utils/index.js";
@@ -31,6 +32,16 @@ export class TemplateFs {
      * @type {boolean}
      */
     #isProcessing = false;
+    /**
+     * The keys for the Excel files in the template.
+     */
+    #excelKeys = {
+        contentTypes: "[Content_Types].xml",
+        sharedStrings: "xl/sharedStrings.xml",
+        styles: "xl/styles.xml",
+        workbook: "xl/workbook.xml",
+        workbookRels: "xl/_rels/workbook.xml.rels",
+    };
     /**
      * Creates a Template instance.
      *
@@ -113,17 +124,19 @@ export class TemplateFs {
      * @returns The path of the sheet inside the workbook.
      * @throws {Error} If the sheet is not found.
      */
-    async #getSheetPath(sheetName) {
+    async #getSheetPathByName(sheetName) {
         // Read XML workbook to find sheet name and path
-        const workbookXml = Xml.extractXmlFromSheet(await this.#readFile("xl/workbook.xml"));
-        const sheetMatch = workbookXml.match(new RegExp(`<sheet[^>]+name="${sheetName}"[^>]+r:id="([^"]+)"[^>]*/>`));
-        if (!sheetMatch)
+        const workbookXml = Xml.extractXmlFromSheet(await this.#readFile(this.#excelKeys.workbook));
+        const sheetMatch = workbookXml.match(Utils.sheetMatch(sheetName));
+        if (!sheetMatch || !sheetMatch[1]) {
             throw new Error(`Sheet "${sheetName}" not found`);
+        }
         const rId = sheetMatch[1];
-        const relsXml = Xml.extractXmlFromSheet(await this.#readFile("xl/_rels/workbook.xml.rels"));
-        const relMatch = relsXml.match(new RegExp(`<Relationship[^>]+Id="${rId}"[^>]+Target="([^"]+)"[^>]*/>`));
-        if (!relMatch)
+        const relsXml = Xml.extractXmlFromSheet(await this.#readFile(this.#excelKeys.workbookRels));
+        const relMatch = relsXml.match(Utils.relationshipMatch(rId));
+        if (!relMatch || !relMatch[1]) {
             throw new Error(`Relationship "${rId}" not found`);
+        }
         return "xl/" + relMatch[1].replace(/^\/?xl\//, "");
     }
     /**
@@ -173,8 +186,8 @@ export class TemplateFs {
         await fs.writeFile(fullPath, Buffer.isBuffer(content) ? content : Buffer.from(content));
     }
     async #substitute(sheetName, replacements) {
-        const sharedStringsPath = "xl/sharedStrings.xml";
-        const sheetPath = await this.#getSheetPath(sheetName);
+        const sharedStringsPath = this.#excelKeys.sharedStrings;
+        const sheetPath = await this.#getSheetPathByName(sheetName);
         let sharedStringsContent = "";
         let sheetContent = "";
         if (this.fileKeys.has(sharedStringsPath)) {
@@ -233,30 +246,31 @@ export class TemplateFs {
         this.#ensureNotDestroyed();
         this.#isProcessing = true;
         try {
+            if (sourceName === newName) {
+                throw new Error("Source and new sheet names cannot be the same");
+            }
             // Read workbook.xml and find the source sheet
-            const workbookXmlPath = "xl/workbook.xml";
+            const workbookXmlPath = this.#excelKeys.workbook;
             const workbookXml = Xml.extractXmlFromSheet(await this.#readFile(workbookXmlPath));
             // Find the source sheet
-            const sheetRegex = new RegExp(`<sheet[^>]+name="${sourceName}"[^>]+r:id="([^"]+)"[^>]*/>`);
-            const sheetMatch = workbookXml.match(sheetRegex);
-            if (!sheetMatch)
+            const sheetMatch = workbookXml.match(Utils.sheetMatch(sourceName));
+            if (!sheetMatch || !sheetMatch[1]) {
                 throw new Error(`Sheet "${sourceName}" not found`);
-            const sourceRId = sheetMatch[1];
+            }
             // Check if a sheet with the new name already exists
             if (new RegExp(`<sheet[^>]+name="${newName}"`).test(workbookXml)) {
                 throw new Error(`Sheet "${newName}" already exists`);
             }
             // Read workbook.rels
             // Find the source sheet path by rId
-            const relsXmlPath = "xl/_rels/workbook.xml.rels";
+            const rId = sheetMatch[1];
+            const relsXmlPath = this.#excelKeys.workbookRels;
             const relsXml = Xml.extractXmlFromSheet(await this.#readFile(relsXmlPath));
-            const relRegex = new RegExp(`<Relationship[^>]+Id="${sourceRId}"[^>]+Target="([^"]+)"[^>]*/>`);
-            const relMatch = relsXml.match(relRegex);
-            if (!relMatch)
-                throw new Error(`Relationship "${sourceRId}" not found`);
+            const relMatch = relsXml.match(Utils.relationshipMatch(rId));
+            if (!relMatch || !relMatch[1]) {
+                throw new Error(`Relationship "${rId}" not found`);
+            }
             const sourceTarget = relMatch[1]; // sheetN.xml
-            if (!sourceTarget)
-                throw new Error(`Relationship "${sourceRId}" not found`);
             const sourceSheetPath = "xl/" + sourceTarget.replace(/^\/?.*xl\//, "");
             // Get the index of the new sheet
             const sheetNumbers = [...this.fileKeys]
@@ -285,7 +299,7 @@ export class TemplateFs {
             await this.#set(relsXmlPath, updatedRelsXml);
             // Read [Content_Types].xml
             // Update [Content_Types].xml
-            const contentTypesPath = "[Content_Types].xml";
+            const contentTypesPath = this.#excelKeys.contentTypes;
             const contentTypesXml = Xml.extractXmlFromSheet(await this.#readFile(contentTypesPath));
             const overrideTag = `<Override PartName="/xl/worksheets/${newSheetFilename}" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml"/>`;
             const updatedContentTypesXml = contentTypesXml.replace("</Types>", overrideTag + "</Types>");
@@ -343,18 +357,7 @@ export class TemplateFs {
             Utils.checkStartRow(startRowNumber);
             Utils.checkRows(preparedRows);
             // Find the sheet
-            const workbookXml = Xml.extractXmlFromSheet(await this.#readFile("xl/workbook.xml"));
-            const sheetMatch = workbookXml.match(new RegExp(`<sheet[^>]+name="${sheetName}"[^>]+r:id="([^"]+)"[^>]*/>`));
-            if (!sheetMatch || !sheetMatch[1]) {
-                throw new Error(`Sheet "${sheetName}" not found`);
-            }
-            const rId = sheetMatch[1];
-            const relsXml = Xml.extractXmlFromSheet(await this.#readFile("xl/_rels/workbook.xml.rels"));
-            const relMatch = relsXml.match(new RegExp(`<Relationship[^>]+Id="${rId}"[^>]+Target="([^"]+)"[^>]*/>`));
-            if (!relMatch || !relMatch[1]) {
-                throw new Error(`Relationship "${rId}" not found`);
-            }
-            const sheetPath = "xl/" + relMatch[1].replace(/^\/?xl\//, "");
+            const sheetPath = await this.#getSheetPathByName(sheetName);
             const sheetXmlRaw = await this.#readFile(sheetPath);
             const sheetXml = Xml.extractXmlFromSheet(sheetXmlRaw);
             let nextRow = 0;
@@ -390,7 +393,7 @@ export class TemplateFs {
             else {
                 updatedXml = sheetXml.replace(/<worksheet[^>]*>/, (match) => `${match}<sheetData>${rowsXml}</sheetData>`);
             }
-            await this.#set(sheetPath, updatedXml);
+            await this.#set(sheetPath, Utils.updateDimension(updatedXml));
         }
         finally {
             this.#isProcessing = false;
@@ -418,18 +421,8 @@ export class TemplateFs {
             const { rows, sheetName, startRowNumber } = data;
             if (!sheetName)
                 throw new Error("Sheet name is required");
-            // Read XML workbook to find sheet name and path
-            const workbookXml = Xml.extractXmlFromSheet(await this.#readFile("xl/workbook.xml"));
-            const sheetMatch = workbookXml.match(new RegExp(`<sheet[^>]+name="${sheetName}"[^>]+r:id="([^"]+)"[^>]*/>`));
-            if (!sheetMatch)
-                throw new Error(`Sheet "${sheetName}" not found`);
-            const rId = sheetMatch[1];
-            const relsXml = Xml.extractXmlFromSheet(await this.#readFile("xl/_rels/workbook.xml.rels"));
-            const relMatch = relsXml.match(new RegExp(`<Relationship[^>]+Id="${rId}"[^>]+Target="([^"]+)"[^>]*/>`));
-            if (!relMatch)
-                throw new Error(`Relationship "${rId}" not found`);
-            // Path to the desired sheet (sheet1.xml)
-            const sheetPath = "xl/" + relMatch[1].replace(/^\/?xl\//, "");
+            // Get the path to the sheet
+            const sheetPath = await this.#getSheetPathByName(sheetName);
             // The temporary file for writing
             const fullPath = path.join(this.destination, ...sheetPath.split("/"));
             const tempPath = fullPath + ".tmp";
@@ -438,6 +431,13 @@ export class TemplateFs {
             const output = fsSync.createWriteStream(tempPath, { encoding: "utf-8" });
             // Inserted rows flag
             let inserted = false;
+            let initialDimension = "";
+            const dimension = {
+                maxColumn: "A",
+                maxRow: 1,
+                minColumn: "A",
+                minRow: 1,
+            };
             const rl = readline.createInterface({
                 // Process all line breaks
                 crlfDelay: Infinity,
@@ -446,6 +446,21 @@ export class TemplateFs {
             let isCollecting = false;
             let collection = "";
             for await (const line of rl) {
+                // Process <dimension>
+                if (!initialDimension && /<dimension\s+ref="[^"]*"/.test(line)) {
+                    const dimensionMatch = line.match(/<dimension\s+ref="([^"]*)"/);
+                    if (dimensionMatch) {
+                        const dimensionRef = dimensionMatch[1];
+                        if (dimensionRef) {
+                            const [min, max] = dimensionRef.split(":");
+                            dimension.minColumn = min.slice(0, 1);
+                            dimension.minRow = parseInt(min.slice(1));
+                            dimension.maxColumn = max.slice(0, 1);
+                            dimension.maxRow = parseInt(max.slice(1));
+                        }
+                        initialDimension = line.match(/<dimension\s+ref="[^"]*"/)?.[0] || "";
+                    }
+                }
                 // Collect lines between <sheetData> and </sheetData>
                 if (!inserted && isCollecting) {
                     collection += line;
@@ -472,7 +487,13 @@ export class TemplateFs {
                                 output.write(innerRows);
                             }
                         }
-                        const { rowNumber: actualRowNumber } = await Utils.writeRowsToStream(output, rows, maxRowNumber);
+                        const { dimension: newDimension, rowNumber: actualRowNumber } = await Utils.writeRowsToStream(output, rows, maxRowNumber);
+                        if (compareColumns(newDimension.maxColumn, dimension.maxColumn) > 0) {
+                            dimension.maxColumn = newDimension.maxColumn;
+                        }
+                        if (newDimension.maxRow > dimension.maxRow) {
+                            dimension.maxRow = newDimension.maxRow;
+                        }
                         if (innerRows) {
                             const filteredRows = Utils.getRowsAbove(innerRowsMap, actualRowNumber);
                             if (filteredRows)
@@ -513,7 +534,13 @@ export class TemplateFs {
                         }
                     }
                     // new <row>
-                    const { rowNumber: actualRowNumber } = await Utils.writeRowsToStream(output, rows, maxRowNumber);
+                    const { dimension: newDimension, rowNumber: actualRowNumber } = await Utils.writeRowsToStream(output, rows, maxRowNumber);
+                    if (compareColumns(newDimension.maxColumn, dimension.maxColumn) > 0) {
+                        dimension.maxColumn = newDimension.maxColumn;
+                    }
+                    if (newDimension.maxRow > dimension.maxRow) {
+                        dimension.maxRow = newDimension.maxRow;
+                    }
                     if (innerRows) {
                         const filteredRows = Utils.getRowsAbove(innerRowsMap, actualRowNumber);
                         if (filteredRows) {
@@ -540,7 +567,13 @@ export class TemplateFs {
                     // Insert opening tag
                     output.write("<sheetData>");
                     // Prepare the rows
-                    await Utils.writeRowsToStream(output, rows, maxRowNumber);
+                    const { dimension: newDimension } = await Utils.writeRowsToStream(output, rows, maxRowNumber);
+                    if (compareColumns(newDimension.maxColumn, dimension.maxColumn) > 0) {
+                        dimension.maxColumn = newDimension.maxColumn;
+                    }
+                    if (newDimension.maxRow > dimension.maxRow) {
+                        dimension.maxRow = newDimension.maxRow;
+                    }
                     // Insert closing tag
                     output.write("</sheetData>");
                     if (after) {
@@ -561,8 +594,42 @@ export class TemplateFs {
             // Close the streams
             rl.close();
             output.end();
-            // Move the temporary file to the original location
-            await fs.rename(tempPath, fullPath);
+            // update dimension
+            {
+                const target = initialDimension;
+                const refRange = `${dimension.minColumn}${dimension.minRow}:${dimension.maxColumn}${dimension.maxRow}`;
+                const replacement = `<dimension ref="${refRange}"`;
+                let buffer = "";
+                let replaced = false;
+                const input = fsSync.createReadStream(tempPath, { encoding: "utf8" });
+                const output = fsSync.createWriteStream(fullPath);
+                await new Promise((resolve, reject) => {
+                    input.on("data", chunk => {
+                        buffer += chunk;
+                        if (!replaced) {
+                            const index = buffer.indexOf(target);
+                            if (index !== -1) {
+                                // Заменяем только первое вхождение
+                                buffer = buffer.replace(target, replacement);
+                                replaced = true;
+                            }
+                        }
+                        output.write(buffer);
+                        buffer = ""; // очищаем, т.к. мы уже записали
+                    });
+                    input.on("error", reject);
+                    output.on("error", reject);
+                    input.on("end", () => {
+                        // на всякий случай дописываем остаток
+                        if (buffer) {
+                            output.write(buffer);
+                        }
+                        output.end();
+                        resolve(true);
+                    });
+                });
+            }
+            await fs.unlink(tempPath);
         }
         finally {
             this.#isProcessing = false;
@@ -663,28 +730,38 @@ export class TemplateFs {
      * @param {Object} data - The data to create the template from.
      * @param {string} data.source - The path or buffer of the Excel file.
      * @param {string} data.destination - The path to save the template to.
+     * @param {boolean} data.isUniqueDestination - Whether to add a random UUID to the destination path.
      * @returns {Promise<Template>} A new Template instance.
      * @throws {Error} If reading or writing files fails.
      * @experimental This API is experimental and might change in future versions.
      */
     static async from(data) {
-        const { destination, source } = data;
+        const { destination, isUniqueDestination = true, source } = data;
         if (!destination) {
             throw new Error("Destination is required");
         }
+        // add random uuid to destination
+        const destinationWithUuid = isUniqueDestination
+            ? path.join(destination, crypto.randomUUID())
+            : destination;
         const buffer = typeof source === "string"
             ? await fs.readFile(source)
             : source;
         const files = await Zip.read(buffer);
         // if destination exists, remove it
-        await fs.rm(destination, { force: true, recursive: true });
+        await fs.rm(destinationWithUuid, { force: true, recursive: true });
         // Write all files to the file system, preserving exact paths
-        await fs.mkdir(destination, { recursive: true });
+        await fs.mkdir(destinationWithUuid, { recursive: true });
         await Promise.all(Object.entries(files).map(async ([filePath, content]) => {
-            const fullPath = path.join(destination, ...filePath.split("/"));
+            const fullPath = path.join(destinationWithUuid, ...filePath.split("/"));
             await fs.mkdir(path.dirname(fullPath), { recursive: true });
             await fs.writeFile(fullPath, content);
         }));
-        return new TemplateFs(new Set(Object.keys(files)), destination);
+        return new TemplateFs(new Set(Object.keys(files)), destinationWithUuid);
     }
 }
+const compareColumns = (a, b) => {
+    if (a === b)
+        return 0;
+    return a.length === b.length ? (a < b ? -1 : 1) : (a.length < b.length ? -1 : 1);
+};