feature: init V7.0.0

Author: m.r

.github/workflows/manually_test.yml

@@ -8,6 +8,7 @@ on:
         default: 'main'
       os:
         description: 'Operating System'
+        type: choice
         required: true
         default: 'ubuntu-latest'
         options:

README.md

@@ -34,11 +34,15 @@ important functions of library that are defined with specific use cases as follo
 
 <a id="excel-to-node"></a>
 
-- **`🆕 excelToNode`**: This function reads an uploaded Excel file and generates a representation of the tables from its sheets. It can either return the table directly or insert it into a specified container node provided as input.
+- **` excelToNode`**: This function reads an uploaded Excel file and generates a representation of the tables from its sheets. It can either return the table directly or insert it into a specified container node provided as input.
 
 <a id="excel-to-json"></a>
 
-- **`🆕 excelToJson`**: This function reads an Excel file and returns a JSON object that represents the data contained in the file.
+- **` excelToJson`**: This function reads an Excel file and returns a JSON object that represents the data contained in the file.
+
+<a id="replace-in-excel"></a>
+
+- **`replaceInExcel`**: This function is used to replace data based on a defined flag, such as {{FLAG}}, in Excel.
 
 The example has been moved to a separate repository for easier updates. You can find it in the ["**_`mr-excel-example-gallery`_**"](https://github.com/mohammadrezaeicode/mr-excel-example-gallery)([**_link_**](https://github.com/mohammadrezaeicode/mr-excel-example-gallery))
 
@@ -88,16 +92,20 @@ The example has been moved to a separate repository for easier updates. You can
   - [**`How to use extractExcelData`**](#extract-excel-data-usage)
 - [**`generateCSV && generateText`**](#generate-csv-txt)
   - [**`How to use generateCSV && generateText`**](#generate-csv-txt-usage)
-- [**`🆕 excelToNode`**](#excel-to-node)
-  - [**`🆕 How to use excelToNode`**](#excel-to-node-usage)
-- [**`🆕 excelToJson`**](#excel-to-json)
-  - [**`🆕 How to use excelToJson`**](#excel-to-json-usage)
+- [**` excelToNode`**](#excel-to-node)
+  - [**` How to use excelToNode`**](#excel-to-node-usage)
+- [**` excelToJson`**](#excel-to-json)
+  - [**` How to use excelToJson`**](#excel-to-json-usage)
+- [**`🆕 replaceInExcel`**](#replace-in-excel)
+  - [**`🆕 How to use replaceInExcel`**](#replace-in-excel-usage)
 - [**`interface`**](#interface)
 - [**`Migrate Version`**](#migrate)
+  - [**`Migrating from 6 to 7`**](#migrating-6)
   - [**`Migrating from 5 to 6`**](#migrating-5)
   - [**`Migrating from 4 to 5`**](#migrating-4)
   - [**`Migrating from 3 to 4`**](#migrating-3)
   - [**`Migrating from 2 to 3`**](#migrating-2)
+- [**`Release note`**](#release-note)
 
 
 <a id="installation"></a>
@@ -659,9 +667,34 @@ ExcelTable.excelToNode(uri, queryForTable, containerElement, config)
 
 </details>
 
+<a id="replace-in-excel-usage"></a>
+
+### 🆕 How to use replaceInExcel
+
+To use this function, you should provide {{FLAG}} in Excel. Change the relevant cells to represent the flag ({{name}}, e.g.) and pass them to the function. Additionally, you should supply the data that will replace the flag. Here’s an example for clarification:
+[Excel that used for example](https://github.com/mohammadrezaeicode/mr-excel-page-repo/blob/main/public/replacer.xlsx?raw=true)
+
+<details>
+
+<summary>Display Code</summary>
+
+```javascript
+ExcelTable.excelToNode(Link, Replace Map,Replacer Map)
+-----
+ExcelTable.replaceInExcel("./replacer.xlsx", {
+  V: "test Data",
+  v1: "This is value one",
+  v2: "This is value two",
+});
+```
+
+</details>
+
+![result imag](https://github.com/mohammadrezaeicode/mr-excel-page-repo/blob/main/public/img/replacer.png?raw=true)
+
 <a id="excel-to-json-usage"></a>
 
-### 🆕 How to use excelToJson
+### How to use excelToJson
 
 <details>
 
@@ -7156,6 +7189,24 @@ The primary interface of the library is located in the excel-table.d.ts file. [C
 
 In this section, we define the significant changes that require migration for the upcoming version.
 
+<a id="migrating-6"></a>
+
+## Migrating from 6 to 7 [⬆️](#table-of-contents)
+
+To successfully migrate from version 6 to version 7, you should update the following options:
+
+- change in the interface of `MultiStyleValue`:
+
+```
+export interface MapMultiStyleValue {
+  [key: string]: MultiStyleValue[];
+}
+export interface MultiStyleValue {
+  value: string | number;
+  styleId?: string;
+}
+```
+
 <a id="migrating-5"></a>
 
 ## Migrating from 5 to 6 [⬆️](#table-of-contents)
@@ -7226,8 +7277,22 @@ To migrate from Version 2 to Version 3, you need to follow the steps below:
   - Change "backgroundColor" to "backgroundColor."
   - Replace "color" with "color."
 
+<a id="release-note"></a>
+
 ## Release Notes [⬆️](#table-of-contents)
 
+#### New Features
+
+- A drop-down option (multi-select option) provides the ability to create a cell that contains multiple selectable values.`sheet`->`[n]`->`dropDowns`
+- The `replaceInExcel` functionality in Excel allows you to replace data in an existing file using flags provided within the spreadsheet.
+
+#### Bug Fixes
+
+- `generateExcel` supports empty objects and will generate an empty Excel file.
+
+> [!NOTE]  
+> The related interface has not changed, so the sheet needs to be provided in TypeScript.
+
 ### Version 6.0.1 (2024-08-11)
 
 #### New Features

_test_/__mocks__/file-saver.ts

@@ -0,0 +1,3 @@
+import { jest } from "@jest/globals";
+
+export const saveAs = jest.fn();

_test_/__mocks__/xs.ts

@@ -0,0 +1,14 @@
+import { jest } from "@jest/globals";
+
+const JSZip = jest.fn();
+
+JSZip.mockImplementation(() => {
+  return {
+    loadAsync: jest.fn(),
+    generateAsync: jest.fn<any>().mockResolvedValue({
+      slice: jest.fn().mockReturnValue("mockedValue"),
+    }), // Mocking generateAsync to return a resolved promise
+  };
+});
+
+export default JSZip; // Mocking the default export

_test_/src/functions/excel-to-json.test.ts

@@ -12,6 +12,63 @@ const mockedExtractExcelData = <jest.Mock<typeof extractExcelData>>(
   extractExcelData
 );
 describe("excel-to-node data tests", () => {
+  test("excelToJson 2", async () => {
+    jest.resetAllMocks();
+    const map = new Map<string, string>();
+    map.set("sheet1", "Sheet1");
+    map.set("sheet2", "Sheet2");
+    mockedExtractExcelData.mockReturnValue(
+      Promise.resolve({
+        data: {
+          sheet1: [
+            ["test value for cell", "3"],
+            ,
+            ,
+            ["7", "6", "5", "4"],
+            ,
+            ,
+            [, , , , , "h"],
+          ],
+          Sheet2: [, , ["a"], , , [, , "e"]],
+        },
+        sheetName: map.entries(),
+        sheetNameObject: {
+          sheet1: "nameSheet",
+          sheet2: "Sheet2",
+        },
+        maxLengthOfColumn: {
+          sheet1: 5,
+          Sheet2: 2,
+        },
+      } as ReadResult)
+    );
+    let result = await excelToJson(
+      "https://github.com/mohammadrezaeicode/mr-excel-page-repo/blob/main/public/y.xlsx?raw=true"
+    ).catch((e: string) => {
+      return e;
+    });
+    expect(extractExcelData).toBeCalledTimes(1);
+    expect(result).toEqual({
+      nameSheet: [
+        {},
+        {
+          "3": "6",
+          property3: "5",
+          property4: "4",
+          "test value for cell": "7",
+        },
+        {
+          property6: "h",
+        },
+      ],
+      Sheet2: [
+        {},
+        {
+          property3: "e",
+        },
+      ],
+    });
+  }, 150000);
   test("excelToJson", async () => {
     jest.resetAllMocks();
     const map = new Map<string, string>();

_test_/src/functions/generate-csv-mocked-2.test.ts

@@ -54,8 +54,95 @@ describe("generateCSV", () => {
       },
       true
     );
-    expect(mockGenerateAsync).toHaveBeenCalledTimes(1);
+    // expect(mockGenerateAsync).toHaveBeenCalledTimes(1);
     expect(saveAs).toHaveBeenCalledTimes(1);
     expect(result).toBe("done");
   });
+  test("should create a zip and save it 2", async () => {
+    let result = await generateCSV(
+      {
+        fileName:"test",
+        sheet: [
+          {
+            data: [
+              { a: 1, b: "b1" },
+              { a: 2, b: "b2" },
+            ],
+            headers: [
+              {
+                label: "a",
+                text: "a",
+              },
+              {
+                label: "b",
+                text: "b",
+              },
+            ],
+          },
+        ],
+      },
+      true
+    );
+    // expect(mockGenerateAsync).toHaveBeenCalledTimes(1);
+    expect(saveAs).toHaveBeenCalledTimes(1);
+    expect(result).toBe("done");
+  });
+   test("should create a blob and save it", async () => {
+     let result = await generateCSV(
+       {
+         sheet: [
+           {
+             data: [
+               { a: 1, b: "b1" },
+               { a: 2, b: "b2" },
+             ],
+             headers: [
+               {
+                 label: "a",
+                 text: "a",
+               },
+               {
+                 label: "b",
+                 text: "b",
+               },
+             ],
+           },
+         ],
+       },
+       false
+     );
+    //  expect(mockGenerateAsync).toHaveBeenCalledTimes(1);
+     expect(saveAs).toHaveBeenCalledTimes(1);
+     expect(result).toBe(undefined);
+   });
+   test("should create a blob and save it 2", async () => {
+     let result = await generateCSV(
+       {
+        fileName:"test",
+         sheet: [
+           {
+             data: [
+               { a: 1, b: "b1" },
+               { a: 2, b: "b2" },
+             ],
+             headers: [
+               {
+                 label: "a",
+                 text: "a",
+               },
+               {
+                 label: "b",
+                 text: "b",
+               },
+             ],
+           },
+         ],
+       },
+       false,
+       true
+     );
+     //  expect(mockGenerateAsync).toHaveBeenCalledTimes(1);
+     expect(saveAs).toHaveBeenCalledTimes(1);
+     expect(result).toBe(undefined);
+   });
 });