Merge tag '3.1.0' into develop

sequba · sequba · commit 786a26b62704 · 2025-10-14T09:44:50.000+02:00
3.1.0
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [Unreleased]
 
+## [3.1.0] - 2025-10-14
+
 ### Changed
 
 - Renamed the `arraySizeMethod` parameter in the `FunctionMetadata` interface to `sizeOfResultArrayMethod`. The `arraySizeMethod` is deprecated and will be removed in one of the next major releases. [#1401](https://github.com/handsontable/hyperformula/issues/1401)
diff --git a/README.md b/README.md
@@ -98,7 +98,7 @@ hf.setCellContents({ sheet: sheetId, row: 0, col: 0 }, [['Monthly Payment', '=PM
 console.log(`${hf.getCellValue({ sheet: sheetId, row: 0, col: 0 })}: ${hf.getCellValue({ sheet: sheetId, row: 0, col: 1 })}`);
 ```
 
-[Run this code in StackBlitz](https://stackblitz.com/github/handsontable/hyperformula-demos/tree/3.0.x/mortgage-calculator)
+[Run this code in StackBlitz](https://stackblitz.com/github/handsontable/hyperformula-demos/tree/3.1.x/mortgage-calculator)
 
 ## Contributing
 
diff --git a/docs/guide/basic-operations.md b/docs/guide/basic-operations.md
@@ -228,7 +228,7 @@ consists of a sheet ID, column ID, and row ID, like this:
 
 Alternatively, you can work with the **A1 notation** known from
 spreadsheets like Excel or Google Sheets. The API provides the helper
-function [`simpleCellAddressFromString`](../api/globals.md#simplecelladdressfromstring) which you can use to retrieve
+function [`simpleCellAddressFromString`](../api/classes/hyperformula.md#simplecelladdressfromstring) which you can use to retrieve
 the [`SimpleCellAddress`](../api/interfaces/simplecelladdress) .
 :::
 
diff --git a/docs/guide/custom-functions.md b/docs/guide/custom-functions.md
@@ -363,7 +363,7 @@ This demo contains the implementation of both the
 [`DOUBLE_RANGE`](#advanced-custom-function-example) custom functions.
 
 <iframe
-  :src="`https://codesandbox.io/embed/github/handsontable/hyperformula-demos/tree/3.0.x/custom-functions?autoresize=1&fontsize=11&hidenavigation=1&theme=light&view=preview&v=${$page.buildDateURIEncoded}`"
+  :src="`https://codesandbox.io/embed/github/handsontable/hyperformula-demos/tree/3.1.x/custom-functions?autoresize=1&fontsize=11&hidenavigation=1&theme=light&view=preview&v=${$page.buildDateURIEncoded}`"
   style="width:100%; height:1070px; border:0; border-radius: 4px; overflow:hidden;"
   title="handsontable/hyperformula-demos: react-demo"
   allow="accelerometer; ambient-light-sensor; camera; encrypted-media; geolocation; gyroscope; hid; microphone; midi; payment; usb; vr; xr-spatial-tracking"
diff --git a/docs/guide/file-import.md b/docs/guide/file-import.md
@@ -18,7 +18,7 @@ To import XLSX files, use a third-party [XLSX parser](https://www.npmjs.com/sear
 
 This example uses [ExcelJS](https://www.npmjs.com/package/exceljs) to import XLSX files into HyperFormula.
 
-See full example on [GitHub](https://github.com/handsontable/hyperformula-demos/tree/3.0.x/read-excel-file).
+See full example on [GitHub](https://github.com/handsontable/hyperformula-demos/tree/3.1.x/read-excel-file).
 
 ```js
 const ExcelJS = require('exceljs');
diff --git a/docs/guide/integration-with-angular.md b/docs/guide/integration-with-angular.md
@@ -7,7 +7,7 @@ For more details, see the [client-side installation](client-side-installation.md
 ## Demo
 
 <iframe
-  :src="`https://codesandbox.io/embed/github/handsontable/hyperformula-demos/tree/3.0.x/angular-demo?autoresize=1&fontsize=11&hidenavigation=1&theme=light&view=preview&v=${$page.buildDateURIEncoded}`"
+  :src="`https://codesandbox.io/embed/github/handsontable/hyperformula-demos/tree/3.1.x/angular-demo?autoresize=1&fontsize=11&hidenavigation=1&theme=light&view=preview&v=${$page.buildDateURIEncoded}`"
   style="width:100%; height:1070px; border:0; border-radius: 4px; overflow:hidden;"
   title="handsontable/hyperformula-demos: react-demo"
   allow="accelerometer; ambient-light-sensor; camera; encrypted-media; geolocation; gyroscope; hid; microphone; midi; payment; usb; vr; xr-spatial-tracking"
diff --git a/docs/guide/integration-with-react.md b/docs/guide/integration-with-react.md
@@ -7,7 +7,7 @@ For more details, see the [client-side installation](client-side-installation.md
 ## Demo
 
 <iframe
-  :src="`https://codesandbox.io/embed/github/handsontable/hyperformula-demos/tree/3.0.x/react-demo?autoresize=1&fontsize=11&hidenavigation=1&theme=light&view=preview&v=${$page.buildDateURIEncoded}`"
+  :src="`https://codesandbox.io/embed/github/handsontable/hyperformula-demos/tree/3.1.x/react-demo?autoresize=1&fontsize=11&hidenavigation=1&theme=light&view=preview&v=${$page.buildDateURIEncoded}`"
   style="width:100%; height:1070px; border:0; border-radius: 4px; overflow:hidden;"
   title="handsontable/hyperformula-demos: react-demo"
   allow="accelerometer; ambient-light-sensor; camera; encrypted-media; geolocation; gyroscope; hid; microphone; midi; payment; usb; vr; xr-spatial-tracking"
diff --git a/docs/guide/integration-with-svelte.md b/docs/guide/integration-with-svelte.md
@@ -7,7 +7,7 @@ For more details, see the [client-side installation](client-side-installation.md
 ## Demo
 
 <iframe
-  :src="`https://codesandbox.io/embed/github/handsontable/hyperformula-demos/tree/3.0.x/svelte-demo?autoresize=1&fontsize=11&hidenavigation=1&theme=light&view=preview&v=${$page.buildDateURIEncoded}`"
+  :src="`https://codesandbox.io/embed/github/handsontable/hyperformula-demos/tree/3.1.x/svelte-demo?autoresize=1&fontsize=11&hidenavigation=1&theme=light&view=preview&v=${$page.buildDateURIEncoded}`"
   style="width:100%; height:1070px; border:0; border-radius: 4px; overflow:hidden;"
   title="handsontable/hyperformula-demos: react-demo"
   allow="accelerometer; ambient-light-sensor; camera; encrypted-media; geolocation; gyroscope; hid; microphone; midi; payment; usb; vr; xr-spatial-tracking"
diff --git a/docs/guide/integration-with-vue.md b/docs/guide/integration-with-vue.md
@@ -36,7 +36,7 @@ This demo uses the [Vue 3](https://v3.vuejs.org/) framework. If you are looking
 :::
 
 <iframe
-  :src="`https://codesandbox.io/embed/github/handsontable/hyperformula-demos/tree/3.0.x/vue-3-demo?autoresize=1&fontsize=11&hidenavigation=1&theme=light&view=preview&v=${$page.buildDateURIEncoded}`"
+  :src="`https://codesandbox.io/embed/github/handsontable/hyperformula-demos/tree/3.1.x/vue-3-demo?autoresize=1&fontsize=11&hidenavigation=1&theme=light&view=preview&v=${$page.buildDateURIEncoded}`"
   style="width:100%; height:1070px; border:0; border-radius: 4px; overflow:hidden;"
   title="handsontable/hyperformula-demos: react-demo"
   allow="accelerometer; ambient-light-sensor; camera; encrypted-media; geolocation; gyroscope; hid; microphone; midi; payment; usb; vr; xr-spatial-tracking"
diff --git a/docs/guide/release-notes.md b/docs/guide/release-notes.md
@@ -6,6 +6,19 @@ This page lists HyperFormula release notes. The format is based on
 HyperFormula adheres to
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 3.1.0
+
+**Release date: October 14, 2025**
+
+### Changed
+
+- Renamed the `arraySizeMethod` parameter in the `FunctionMetadata` interface to `sizeOfResultArrayMethod`. The `arraySizeMethod` is deprecated and will be removed in one of the next major releases. [#1401](https://github.com/handsontable/hyperformula/issues/1401)
+- Renamed the `arrayFunction` parameter in the `FunctionMetadata` interface to `enableArrayArithmeticForArguments`. The `arrayFunction` is deprecated and will be removed in one of the next major releases. [#1401](https://github.com/handsontable/hyperformula/issues/1401)
+
+### Fixed
+
+- Fixed an issue where the `OFFSET` function was ignoring the sheet reference in the provided address. [#1477](https://github.com/handsontable/hyperformula/issues/1477)
+
 ## 3.0.1
 
 **Release date: August 11, 2025**
diff --git a/docs/index.md b/docs/index.md
@@ -103,7 +103,7 @@ hf.setCellContents({ sheet: sheetId, row: 0, col: 0 }, [['Monthly Payment', '=PM
 console.log(`${hf.getCellValue({ sheet: sheetId, row: 0, col: 0 })}: ${hf.getCellValue({ sheet: sheetId, row: 0, col: 1 })}`);
 ```
 
-[Run this code in StackBlitz](https://stackblitz.com/github/handsontable/hyperformula-demos/tree/3.0.x/mortgage-calculator)
+[Run this code in StackBlitz](https://stackblitz.com/github/handsontable/hyperformula-demos/tree/3.1.x/mortgage-calculator)
 
 ## Contributing
 
diff --git a/ht.config.js b/ht.config.js
@@ -6,5 +6,5 @@ module.exports = {
   HT_VERSION: packageBody.version,
   HT_PACKAGE_NAME: packageBody.name,
   HT_BUILD_DATE: moment().format('DD/MM/YYYY HH:mm:ss'),
-  HT_RELEASE_DATE: '11/08/2025',
+  HT_RELEASE_DATE: '14/10/2025',
 };
diff --git a/jest.config.js b/jest.config.js
@@ -50,4 +50,11 @@ module.exports = {
   transform: {
     "^.+\\.(ts|tsx)$": "ts-jest"
   },
+
+  watchPathIgnorePatterns: [
+    '/node_modules/',
+    '/dist/',
+    '/commonjs/',
+    '/es/',
+  ]
 };
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
diff --git a/src/HyperFormula.ts b/src/HyperFormula.ts
diff --git a/src/parser/FormulaParser.ts b/src/parser/FormulaParser.ts
diff --git a/test/unit/parser/offset-translation.spec.ts b/test/unit/parser/offset-translation.spec.ts
