TMP PR: Release/3.3.0

.eslintignore

@@ -15,6 +15,7 @@ test/_setupFiles/*.js
 
 # Auto-generated directories
 commonjs
+coverage
 dist
 doc
 es

.github/workflows/audit.yml

@@ -23,13 +23,12 @@ jobs:
     name: audit
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@722adc63f1aa60a57ec37892e133b1d319cae598 # https://github.com/actions/checkout/releases/tag/v2.0.0
-
       - name: Setup Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@56899e050abffc08c2b3b61f3ec6a79a9dc3223d # https://github.com/actions/setup-node/releases/tag/v1.4.4
         with:
           node-version: ${{ matrix.node-version }}
 
+      - uses: actions/checkout@722adc63f1aa60a57ec37892e133b1d319cae598 # https://github.com/actions/checkout/releases/tag/v2.0.0
+
       - name: Run audit
-        run: |
-          npm run audit
+        run: npm run audit

.github/workflows/build-docs.yml

@@ -23,17 +23,15 @@ jobs:
     name: build-docs
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@722adc63f1aa60a57ec37892e133b1d319cae598 # https://github.com/actions/checkout/releases/tag/v2.0.0
-
       - name: Setup Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@56899e050abffc08c2b3b61f3ec6a79a9dc3223d # https://github.com/actions/setup-node/releases/tag/v1.4.4
         with:
           node-version: ${{ matrix.node-version }}
 
+      - uses: actions/checkout@722adc63f1aa60a57ec37892e133b1d319cae598 # https://github.com/actions/checkout/releases/tag/v2.0.0
+
       - name: Install dependencies
-        run: |
-          npm ci
+        run: npm ci
 
       - name: Build docs
-        run: |
-          npm run docs:build
+        run: npm run docs:build

.github/workflows/build.yml

@@ -25,17 +25,15 @@ jobs:
         install-command: [ i, ci ]
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@722adc63f1aa60a57ec37892e133b1d319cae598 # https://github.com/actions/checkout/releases/tag/v2.0.0
-
       - name: Setup Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@56899e050abffc08c2b3b61f3ec6a79a9dc3223d # https://github.com/actions/setup-node/releases/tag/v1.4.4
         with:
           node-version: ${{ matrix.node-version }}
 
+      - uses: actions/checkout@722adc63f1aa60a57ec37892e133b1d319cae598 # https://github.com/actions/checkout/releases/tag/v2.0.0
+
       - name: Install dependencies
-        run: |
-          npm ${{ matrix.install-command }}
+        run: npm ${{ matrix.install-command }}
 
       - name: Build
-        run: |
-          npm run bundle-all
+        run: npm run bundle-all

.github/workflows/lint.yml

@@ -23,17 +23,15 @@ jobs:
     name: lint
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@722adc63f1aa60a57ec37892e133b1d319cae598 # https://github.com/actions/checkout/releases/tag/v2.0.0
-
       - name: Setup Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@56899e050abffc08c2b3b61f3ec6a79a9dc3223d # https://github.com/actions/setup-node/releases/tag/v1.4.4
         with:
           node-version: ${{ matrix.node-version }}
 
+      - uses: actions/checkout@722adc63f1aa60a57ec37892e133b1d319cae598 # https://github.com/actions/checkout/releases/tag/v2.0.0
+
       - name: Install dependencies
-        run: |
-          npm ci
+        run: npm ci
 
       - name: Run linter
-        run: |
-          npm run lint
+        run: npm run lint

.github/workflows/performance.yml

@@ -0,0 +1,76 @@
+name: Performance
+permissions:
+  contents: read
+  pull-requests: write
+
+on:
+  pull_request:
+    types:
+      - opened
+      - reopened
+      - synchronize # the head branch is updated from the base branch, new commits are pushed to the head branch, or the base branch is changed
+
+jobs:
+  performance-test:
+    strategy:
+      matrix:
+        node-version: [ '22' ]
+        os: [ 'ubuntu-latest' ]
+    name: Test performance
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@56899e050abffc08c2b3b61f3ec6a79a9dc3223d # https://github.com/actions/setup-node/releases/tag/v1.4.4
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: (base) Checkout main repository
+        uses: actions/checkout@5a4ac9002d0be2fb38bd78e4b4dbde5606d7042f # https://github.com/actions/checkout/releases/tag/v2.3.4
+        with:
+          ref: ${{ github.event.pull_request.base.sha }}
+
+      - name: Checkout hyperformula-tests repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          ssh-key: ${{ secrets.DEPLOY_TOKEN }}
+          repository: handsontable/hyperformula-tests
+          path: test/hyperformula-tests
+
+      - name: Fetch hyperformula-tests and sync branches
+        run: cd test && ./fetch-tests.sh
+
+      - name: (base) Install dependencies
+        run: npm ci
+
+      - name: (base) Run performance tests
+        run: npm run benchmark:write-to-file base.json
+
+      - name: (head) Checkout main repository
+        uses: actions/checkout@5a4ac9002d0be2fb38bd78e4b4dbde5606d7042f # https://github.com/actions/checkout/releases/tag/v2.3.4
+        with:
+          clean: false
+
+      - name: (head) Install dependencies
+        run: npm ci
+
+      - name: (head) Run performance tests
+        run: |
+          npm run benchmark:write-to-file head.json
+
+      - name: Compare the results
+        run: |
+          npm run benchmark:compare-benchmarks base.json head.json performance-report.md
+
+      - name: Publish a comment - header
+        uses: marocchino/sticky-pull-request-comment@6804b5ad49d19c10c9ae7cf5057352f7ff333f31 # https://github.com/marocchino/sticky-pull-request-comment/tree/v1.6.0
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          message: |
+            ## Performance comparison of head (${{ github.event.pull_request.head.sha }}) vs base (${{ github.event.pull_request.base.sha }})
+
+      - name: Publish a comment - performance comparison report
+        uses: marocchino/sticky-pull-request-comment@6804b5ad49d19c10c9ae7cf5057352f7ff333f31 # https://github.com/marocchino/sticky-pull-request-comment/tree/v1.6.0
+        with:
+          append: true
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          path: performance-report.md

.github/workflows/publish.yml

@@ -17,20 +17,18 @@ jobs:
     name: publish-docs
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@722adc63f1aa60a57ec37892e133b1d319cae598 # https://github.com/actions/checkout/releases/tag/v2.0.0
-
       - name: Setup Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@56899e050abffc08c2b3b61f3ec6a79a9dc3223d # https://github.com/actions/setup-node/releases/tag/v1.4.4
         with:
           node-version: ${{ matrix.node-version }}
 
+      - uses: actions/checkout@722adc63f1aa60a57ec37892e133b1d319cae598 # https://github.com/actions/checkout/releases/tag/v2.0.0
+
       - name: Install dependencies
-        run: |
-          npm ci
+        run: npm ci
 
       - name: Build docs
-        run: |
-          npm run docs:build
+        run: npm run docs:build
 
       - name: Deploy to GH pages
         uses: peaceiris/actions-gh-pages@ba0b7df03e25ff29c924be8149041119e9421ea6 # https://github.com/peaceiris/actions-gh-pages/releases/tag/v3.5.6

.github/workflows/test.yml

@@ -23,20 +23,35 @@ jobs:
     name: unit-tests
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@722adc63f1aa60a57ec37892e133b1d319cae598 # https://github.com/actions/checkout/releases/tag/v2.0.0
-
       - name: Setup Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@56899e050abffc08c2b3b61f3ec6a79a9dc3223d # https://github.com/actions/setup-node/releases/tag/v1.4.4
         with:
           node-version: ${{ matrix.node-version }}
 
+      - name: Checkout main repository
+        uses: actions/checkout@722adc63f1aa60a57ec37892e133b1d319cae598 # https://github.com/actions/checkout/releases/tag/v2.0.0
+
+      - name: Checkout hyperformula-tests repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          ssh-key: ${{ secrets.DEPLOY_TOKEN }}
+          repository: handsontable/hyperformula-tests
+          path: test/hyperformula-tests
+
+      - name: Fetch hyperformula-tests and sync branches
+        run: cd test && ./fetch-tests.sh
+
       - name: Install dependencies
-        run: |
-          npm ci
+        run: npm ci
 
       - name: Run tests
-        run: |
-          npm run test:ci
+        run: npm run test:ci -- --coverage
+
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@6004246f47ab62d32be025ce173b241cd84ac58e # https://github.com/codecov/codecov-action/releases/tag/v1.0.13
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
 
   browser-tests:
     strategy:
@@ -46,17 +61,26 @@ jobs:
     name: browser-tests
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@722adc63f1aa60a57ec37892e133b1d319cae598 # https://github.com/actions/checkout/releases/tag/v2.0.0
-
       - name: Setup Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@56899e050abffc08c2b3b61f3ec6a79a9dc3223d # https://github.com/actions/setup-node/releases/tag/v1.4.4
         with:
           node-version: ${{ matrix.node-version }}
 
+      - name: Checkout main repository
+        uses: actions/checkout@722adc63f1aa60a57ec37892e133b1d319cae598 # https://github.com/actions/checkout/releases/tag/v2.0.0
+
+      - name: Checkout hyperformula-tests repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          ssh-key: ${{ secrets.DEPLOY_TOKEN }}
+          repository: handsontable/hyperformula-tests
+          path: test/hyperformula-tests
+
+      - name: Fetch hyperformula-tests and sync branches
+        run: cd test && ./fetch-tests.sh
+
       - name: Install dependencies
-        run: |
-          npm ci
+        run: npm ci
 
       - name: Run tests
-        run: |
-          npm run test:browser
+        run: npm run test:browser

.gitignore

@@ -1,6 +1,7 @@
 .idea/
 .vscode
 /commonjs/
+/coverage/
 /dist/
 /doc/
 /docs/api/
@@ -21,3 +22,5 @@ node_modules/
 *.iml
 dev*.html
 .DS_Store
+
+/test/hyperformula-tests/

.nvmrc

@@ -1 +1 @@
-v16
+v18

CHANGELOG.md

@@ -7,6 +7,23 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [Unreleased]
 
+## [3.3.0] - 2026-05-20
+
+### Added
+
+- Added 12 database functions: DCOUNT, DSUM, DAVERAGE, DMAX, DMIN, DGET, DPRODUCT, DCOUNTA, DSTDEV, DSTDEVP, DVAR, DVARP. [#1652](https://github.com/handsontable/hyperformula/pull/1652)
+- Added new functions: PERCENTILE, PERCENTILE.INC, PERCENTILE.EXC, QUARTILE, QUARTILE.INC, QUARTILE.EXC. [#1650](https://github.com/handsontable/hyperformula/pull/1650)
+- Added `maxPendingLazyTransformations` configuration option to control memory usage by limiting accumulated transformations before cleanup. [#1629](https://github.com/handsontable/hyperformula/issues/1629)
+- Added a new function: TEXTJOIN. [#1640](https://github.com/handsontable/hyperformula/pull/1640)
+- Added a new function: SEQUENCE. [#1645](https://github.com/handsontable/hyperformula/pull/1645)
+
+### Fixed
+
+- Fixed a memory leak in `LazilyTransformingAstService` where the transformations array grew unboundedly, causing increasing memory usage over time. [#1629](https://github.com/handsontable/hyperformula/issues/1629)
+- Fixed a memory leak in `UndoRedo` where `oldData` entries for evicted undo stack entries were never cleaned up, causing increasing memory usage over time. [#1629](https://github.com/handsontable/hyperformula/issues/1629)
+- Fixed the IRR function returning `#NUM!` error when the initial investment significantly exceeds the sum of returns. [#1628](https://github.com/handsontable/hyperformula/issues/1628)
+- Fixed the ADDRESS function ignoring `defaultValue` when arguments are syntactically empty (e.g., `=ADDRESS(2,3,,FALSE())`). [#1632](https://github.com/handsontable/hyperformula/issues/1632)
+
 ## [3.2.0] - 2026-02-19
 
 ### Added

DEV_DOCS.md

@@ -2,6 +2,23 @@
 
 Random notes and things to know useful for maintainers and contributors.
 
+## Definition of Done for the code changes
+
+Each change to the production code (bugfixes, new features, improvements) must include these elements. They must be present in the pull request BEFORE requesting the code review.
+
+- changes to the production code
+  - including changes to all supported language packs in `src/i18n/languages` directory (if applicable)
+- automatic tests
+  - for bugfixes: at least one test reproducing the bug
+  - for new features: a set of tests describing the feature specification precisely
+  - pull requests from external contributors should include tests in `tests/` directory (they will be moved to the private repository by the internal team)
+  - internal team adds tests directly to the private repository (through a separate pull request)
+- updates to documentation related to the change
+  - for breaking changes: a section in the migration guide
+- technical documentation in the form of the jsdoc comments (high-level description of the concepts used in the more complex code fragments)
+- changelog entry
+- pull request description
+
 ## 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: