TMP PR

.eslintignore

@@ -11,6 +11,7 @@ src/interpreter/plugin/3rdparty
 *.config.js
 karma.*
 doc
+test/unit/_setupFiles/*.js
 
 # Auto-generated directories
 commonjs
@@ -25,4 +26,3 @@ test-jasmine
 test-jest
 typedoc
 typings
-test/_setupFiles/*.js

.eslintrc.js

@@ -90,7 +90,6 @@ module.exports = {
     'jsdoc/empty-tags': 'warn',
     'jsdoc/implements-on-classes': 'warn',
     'jsdoc/multiline-blocks': 'warn',
-    'jsdoc/tag-lines': 'warn',
     'jsdoc/no-multi-asterisks': 'warn',
     'jsdoc/require-param-description': 'warn',
     'jsdoc/require-param-name': 'warn',
@@ -104,8 +103,9 @@ module.exports = {
     'jsdoc/require-yields-check': 'warn',
     'jsdoc/valid-types': 'warn',
     'jsdoc/require-jsdoc': ['warn', {
+      checkConstructors: false,
       require: {
-        ArrowFunctionExpression: true,
+        ArrowFunctionExpression: false,
         ClassDeclaration: true,
         ClassExpression: true,
         FunctionDeclaration: true,

.github/workflows/audit.yml

@@ -18,7 +18,7 @@ jobs:
   audit:
     strategy:
       matrix:
-        node-version: [ '20' ]
+        node-version: [ '22' ]
         os: [ 'ubuntu-latest' ]
     name: audit
     runs-on: ${{ matrix.os }}

.github/workflows/build-docs.yml

@@ -18,7 +18,7 @@ jobs:
   publish-docs:
     strategy:
       matrix:
-        node-version: [ '20' ]
+        node-version: [ '22' ]
         os: [ 'ubuntu-latest' ]
     name: build-docs
     runs-on: ${{ matrix.os }}

.github/workflows/build.yml

@@ -20,7 +20,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        node-version: [ 20, 22 ]
+        node-version: [ 20, 22, 24 ]
         os: [ ubuntu-latest, windows-latest, macos-latest ]
         install-command: [ i, ci ]
     runs-on: ${{ matrix.os }}

.github/workflows/codeql-advanced.yml

@@ -0,0 +1,100 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL Advanced"
+
+on:
+  push:
+    branches: [ "master", "develop", "milestone*" ]
+  pull_request:
+    branches: [ "master", "develop", "milestone*" ]
+  schedule:
+    - cron: '37 18 * * 6'
+
+jobs:
+  analyze:
+    name: Analyze (${{ matrix.language }})
+    # Runner size impacts CodeQL analysis time. To learn more, please see:
+    #   - https://gh.io/recommended-hardware-resources-for-running-codeql
+    #   - https://gh.io/supported-runners-and-hardware-resources
+    #   - https://gh.io/using-larger-runners (GitHub.com only)
+    # Consider using larger runners or machines with greater resources for possible analysis time improvements.
+    runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
+    permissions:
+      # required for all workflows
+      security-events: write
+
+      # required to fetch internal or private CodeQL packs
+      packages: read
+
+      # only required for workflows in private repositories
+      actions: read
+      contents: read
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+        - language: actions
+          build-mode: none
+        - language: javascript-typescript
+          build-mode: none
+        # CodeQL supports the following values keywords for 'language': 'actions', 'c-cpp', 'csharp', 'go', 'java-kotlin', 'javascript-typescript', 'python', 'ruby', 'rust', 'swift'
+        # Use `c-cpp` to analyze code written in C, C++ or both
+        # Use 'java-kotlin' to analyze code written in Java, Kotlin or both
+        # Use 'javascript-typescript' to analyze code written in JavaScript, TypeScript or both
+        # To learn more about changing the languages that are analyzed or customizing the build mode for your analysis,
+        # see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning.
+        # If you are analyzing a compiled language, you can modify the 'build-mode' for that language to customize how
+        # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    # Add any setup steps before running the `github/codeql-action/init` action.
+    # This includes steps like installing compilers or runtimes (`actions/setup-node`
+    # or others). This is typically only required for manual builds.
+    # - name: Setup runtime (example)
+    #   uses: actions/setup-example@v1
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+        build-mode: ${{ matrix.build-mode }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+
+        # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
+        # queries: security-extended,security-and-quality
+
+    # If the analyze step fails for one of the languages you are analyzing with
+    # "We were unable to automatically build your code", modify the matrix above
+    # to set the build mode to "manual" for that language. Then modify this step
+    # to build your code.
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
+    - if: matrix.build-mode == 'manual'
+      shell: bash
+      run: |
+        echo 'If you are using a "manual" build mode for one or more of the' \
+          'languages you are analyzing, replace this with the commands to build' \
+          'your code, for example:'
+        echo '  make bootstrap'
+        echo '  make release'
+        exit 1
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3
+      with:
+        category: "/language:${{matrix.language}}"

.github/workflows/lint.yml

@@ -18,7 +18,7 @@ jobs:
   lint:
     strategy:
       matrix:
-        node-version: [ '20' ]
+        node-version: [ '22' ]
         os: [ 'ubuntu-latest' ]
     name: lint
     runs-on: ${{ matrix.os }}

.github/workflows/performance.yml

@@ -14,7 +14,7 @@ jobs:
   performance-test:
     strategy:
       matrix:
-        node-version: [ '20' ]
+        node-version: [ '22' ]
         os: [ 'ubuntu-latest' ]
     name: Test performance
     runs-on: ${{ matrix.os }}

.github/workflows/publish.yml

@@ -12,7 +12,7 @@ jobs:
   publish-docs:
     strategy:
       matrix:
-        node-version: [ '20' ]
+        node-version: [ '22' ]
         os: [ 'ubuntu-latest' ]
     name: publish-docs
     runs-on: ${{ matrix.os }}

.github/workflows/test.yml

@@ -18,7 +18,7 @@ jobs:
   unit-tests:
     strategy:
       matrix:
-        node-version: [ '20' ]
+        node-version: [ '22' ]
         os: [ 'ubuntu-latest' ]
     name: unit-tests
     runs-on: ${{ matrix.os }}
@@ -37,7 +37,7 @@ jobs:
       - name: Run tests
         run: |
           npm run test:unit.ci -- --coverage
-          
+
       - name: Upload coverage to Codecov
         uses: codecov/codecov-action@6004246f47ab62d32be025ce173b241cd84ac58e # https://github.com/codecov/codecov-action/releases/tag/v1.0.13
         env:
@@ -46,7 +46,7 @@ jobs:
   browser-tests:
     strategy:
       matrix:
-        node-version: [ '20' ]
+        node-version: [ '22' ]
         os: [ 'ubuntu-latest' ]
     name: browser-tests
     runs-on: ${{ matrix.os }}

CHANGELOG.md

@@ -7,6 +7,17 @@ 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)
+- 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] - 2025-08-11
 
 ### Fixed

DEV_DOCS.md

@@ -0,0 +1,9 @@
+# Dev Docs
+
+Random notes and things to know useful for maintainers and contributors.
+
+## Sources of the function translations
+
+HF supports internationalization and provides the localized function names for all built-in languages. When looking for the valid translations for the new functions, try these sources:
+- https://support.microsoft.com/en-us/office/excel-functions-translator-f262d0c0-991c-485b-89b6-32cc8d326889
+- http://dolf.trieschnigg.nl/excel/index.php

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