fix: check range of record

Author: m.r

.github/workflows/manually-release-publish.yml

@@ -1,6 +1,23 @@
 name: Manually Release & Publish Package
 on:
- workflow_dispatch
+ workflow_dispatch:
+    inputs:
+      skip-release:
+        description: 'Skip Release Job'
+        required: true
+        default: 'false'
+        type: choice
+        options:
+          - 'false'
+          - 'true'
+      skip-publish-gpr:
+        description: 'Skip publish Github Job'
+        required: true
+        default: 'false'
+        type: choice
+        options:
+          - 'false'
+          - 'true'
   # push:
   #   branches:
   #     - main
@@ -13,6 +30,7 @@ on:
   #     - CHANGELOG.md
 jobs:
   release:
+    if: ${{ github.event.inputs.skip-release == 'false' }}
     name: Create release package
     runs-on: ubuntu-latest
     steps: 
@@ -41,25 +59,33 @@ jobs:
         tag_name: ${{env.PV}}
         release_name: Release v${{env.PV}}
         body: ${{env.PB}}
-   publish-gpr:
-      needs: build
+  publish-gpr:
+      needs: release
+      if: ${{always() && (needs.release.result == 'success' || needs.release.result == 'skipped') && github.event.inputs.skip-publish-gpr == 'false'}}
       runs-on: ubuntu-latest
       permissions:
         contents: read
         packages: write
       steps:
-        - uses: actions/checkout@v4
-        - uses: actions/setup-node@v4
-          with:
-            node-version: 20
-            registry-url: https://npm.pkg.github.com/
-        - run: npm ci
-        - run: npm publish
-          env:
-            NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}
-      publish:
+      - uses: actions/checkout@v4
+      # Setup .npmrc file to publish to GitHub Packages
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: 'https://npm.pkg.github.com'
+          # Defaults to the user or organization that owns the workflow file
+          scope: '@mohammadrezaeicode'
+      - run: npm set @mohammadrezaeicode:registry=https://npm.pkg.github.com/  
+      - run: npm login --scope=@mohammadrezaeicode --registry=https://npm.pkg.github.com 
+      - run: npm adduser 
+      - run: npm ci
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  publish:
         name: Publish to NPM
-        needs: release
+        needs: publish-gpr
+        if: ${{always() && (needs.publish-gpr.result == 'success' || needs.publish-gpr.result == 'skipped') }}
         runs-on: ubuntu-latest
         steps:    
         - name: Checkout to code

.npmrc

@@ -1 +1,3 @@
-@mohammadrezaeicode:registry=https://npm.pkg.github.com
+//@npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN}
+mohammadrezaeicode:registry=https://npm.pkg.github.com
+always-auth=true

README.md

@@ -1,6 +1,6 @@
 # MR Excel
 
-![Test](https://github.com/mohammadrezaeicode/github-action/actions/workflows/test.yml/badge.svg) [![Release & Publish](https://github.com/mohammadrezaeicode/mr-excel-repo/actions/workflows/release.yml/badge.svg)](https://github.com/mohammadrezaeicode/mr-excel-repo/actions/workflows/release.yml)
+![Test](https://github.com/mohammadrezaeicode/github-action/actions/workflows/test.yml/badge.svg) [![Release & Publish](https://github.com/mohammadrezaeicode/mr-excel-repo/actions/workflows/release.yml/badge.svg)](https://github.com/mohammadrezaeicode/mr-excel-repo/actions/workflows/manually-release-publish.yml)
 
 `MR-Excel` is a powerful JavaScript library designed for reading and writing Excel files. It enables users to extract data seamlessly from Excel documents while providing an array of advanced writing features. These include commenting, styling, applying formulas, merging cells, inserting images into cells, adding background images, grouping rows, and implementing conditional formatting. Additionally, the library supports multi-style values and offers functions for cell merging and styling, as well as commenting features.
 

dist/excel-table.amd.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-CzrjgJVS.cjs");exports.Validator=e.validateExcelTable;exports.addGlobalOptionFromExcelTable=e.addGlobalOptionFromExcelTable;exports.addGlobalOptions=e.addGlobalOptions;exports.convertTableToExcel=e.convertTableToExcel;exports.excelToJson=e.excelToJson;exports.excelToNode=e.excelToNode;exports.extractExcelData=e.extractExcelData;exports.generateCSV=e.generateCSV;exports.generateExcel=e.generateExcel;exports.generateText=e.generateText;exports.replaceInExcel=e.replaceInExcel;exports.sideBySideLineByLine=e.sideBySideLineByLine;exports.themeBaseGenerate=e.themeBaseGenerate;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-DkpykvyS.cjs");exports.Validator=e.validateExcelTable;exports.addGlobalOptionFromExcelTable=e.addGlobalOptionFromExcelTable;exports.addGlobalOptions=e.addGlobalOptions;exports.convertTableToExcel=e.convertTableToExcel;exports.excelToJson=e.excelToJson;exports.excelToNode=e.excelToNode;exports.extractExcelData=e.extractExcelData;exports.generateCSV=e.generateCSV;exports.generateExcel=e.generateExcel;exports.generateText=e.generateText;exports.replaceInExcel=e.replaceInExcel;exports.sideBySideLineByLine=e.sideBySideLineByLine;exports.themeBaseGenerate=e.themeBaseGenerate;

dist/excel-table.cjs

@@ -215,7 +215,7 @@ declare type ConditionalFormattingTopOperation = "belowAverage" | "aboveAverage"
  * @param {boolean} [config.keepStyle] - Whether to keep the style.
  * @param {RowHeightScaleFunction} [config.rowHeightScaleFunction] - The function to scale row height.
  * @param {ColWidthScaleFunction} [config.colWidthScaleFunction] - The function to scale column width.
- * @returns {Promise<ExcelTable>} The generated Excel table.
+ * @returns {Promise<string | number[] | Blob | DataModel.Buffer | undefined>} The generated Excel table.
  */
 export declare function convertTableToExcel(queryForTable?: string, table?: HTMLTableElement, config?: {
     keepStyle?: boolean;
@@ -396,8 +396,8 @@ export declare function excelToJson(uri: string, fetchFunc?: Function, withHeade
  * @param {string} uri - The URI of the Excel file.
  * @param {string | null} [queryForTable] - The query selector for the table.
  * @param {HTMLDivElement | null} [containerElement] - The container element.
- * @param {ExcelToNodeConfig} [config={}] - The configuration options.
- * @returns {Promise<void>} The result of the conversion.
+ * @param {ExcelToNodeConfig} [config=defaultConfig] - The configuration options.
+ * @returns {Promise<HTMLTableElement[] | "Done">} The result of the conversion.
  */
 export declare function excelToNode(uri: string, queryForTable?: string | null, containerElement?: HTMLDivElement | null, config?: ExcelToNodeConfig): Promise<HTMLTableElement[] | "Done">;
 
@@ -436,7 +436,7 @@ declare type ExtractedData = (string | null | undefined)[][];
  * @param {string} uri - The URI of the Excel file.
  * @param {boolean} [isBackend=false] - Whether the extraction is done on the backend.
  * @param {Function} [fetchFunc] - The function to fetch data.
- * @returns {Promise<ExtractResult>} The extracted data.
+ * @returns {Promise<DataModel.ReadResult>} The extracted data.
  */
 export declare function extractExcelData(uri: string, isBackend?: boolean, fetchFunc?: Function): Promise<DataModel.ReadResult>;
 
@@ -487,20 +487,20 @@ declare type FormulaType = "AVERAGE" | "SUM" | "COUNT" | "MAX" | "MIN";
 declare function generalValidationCheck(value: never, validateProperty: ValidationObject, property: string, strict: boolean, warn: boolean): boolean;
 
 /**
- * Generates a CSV file from an Excel table.
+ * Generates a CSV file from an Excel table Object.
  * @param {ExcelTable} excelTable - The Excel table.
  * @param {boolean} [asZip=false] - Whether to generate the CSV as a ZIP file.
- * @returns {Promise<Blob>} The generated CSV file.
+ * @returns {Promise<string[] | "done" | undefined>} The generated CSV file.
  */
 export declare function generateCSV(excelTable: ExcelTable, asZip?: boolean): Promise<string[] | "done" | undefined>;
 
 export declare function generateExcel(data: ExcelTable, styleKey?: string): Promise<string | number[] | Blob | Buffer_2 | undefined>;
 
 /**
- * Generates a text file from an Excel table.
+ * Generates a text file from an Excel table Object.
  * @param {ExcelTable} excelTable - The Excel table.
  * @param {boolean} [asZip=false] - Whether to generate the text file as a ZIP file.
- * @returns {Promise<Blob>} The generated text file.
+ * @returns {Promise<string[] | "done" | undefined>} The generated text file.
  */
 export declare function generateText(excelTable: ExcelTable, asZip?: boolean): Promise<string[] | "done" | undefined>;
 
@@ -891,7 +891,7 @@ declare interface SideBySide {
 /**
  * Generates an Excel file with side-by-side data.
  * @param {SideBySide[][]} data - The side-by-side data.
- * @returns {Promise<ExcelTable>} The generated Excel table.
+ * @returns {Promise<string | number[] | Blob | DataModel.Buffer | undefined>} The generated Excel table.
  */
 export declare function sideBySideLineByLine(data: SideBySide[][]): Promise<string | number[] | DataModel.Buffer | Blob | undefined>;
 
@@ -1021,7 +1021,7 @@ declare type StyleType = "conditionalFormatting" | "CF" | "headerFooter" | "HF";
  * Generates an Excel file with a theme.
  * @param {ExcelTable | Data[] | Data[][]} data - The data for the Excel file.
  * @param {ThemeOption} [option] - The theme options.
- * @returns {Promise<ExcelTable>} The generated Excel table.
+ * @returns {Promise<string | number[] | Blob | DataModel.Buffer | undefined>} The generated Excel table.
  */
 export declare function themeBaseGenerate(data: ExcelTable | Data[] | Data[][], option?: ThemeOption): Promise<string | number[] | DataModel.Buffer | Blob | undefined>;