HF-20: rename iterative-calculation config options to match sequba's own review request (#1541)

.cursor/rules/main.mdc

@@ -0,0 +1,6 @@
+---
+description: Project-wide guidance for AI agents working in this repository
+alwaysApply: true
+---
+
+All guidance for AI agents working in this repository lives in [AGENTS.md](mdc:AGENTS.md) at the repository root. Read it first.

.cursor/settings.json

@@ -0,0 +1,7 @@
+{
+  "plugins": {
+    "superpowers": {
+      "enabled": true
+    }
+  }
+}

.eslintignore

@@ -11,7 +11,12 @@ src/interpreter/plugin/3rdparty
 *.config.js
 karma.*
 doc
-test/unit/_setupFiles/*.js
+test/_setupFiles/*.js
+
+# Private tests repo, checked out by CI under test/hyperformula-tests. Not part of
+# tsconfig.json's "include" (src only), so type-aware rules have no project to run
+# against here -- linting it is the private repo's own job, not this workflow's.
+test/hyperformula-tests
 
 # Auto-generated directories
 commonjs

.eslintrc.js

@@ -15,7 +15,7 @@ module.exports = {
   },
   parserOptions: {
     tsconfigRootDir: __dirname,
-    project: './tsconfig.test.json',
+    project: './tsconfig.json',
     createDefaultProgram: true,
   },
   extends: [
@@ -148,6 +148,6 @@ module.exports = {
       rules: {
         '@typescript-eslint/no-non-null-assertion': 'off',
       }
-    }
+    },
   ],
 }

.github/ISSUE_TEMPLATE/config.yml

@@ -1,4 +1,4 @@
 contact_links:
   - name: Feature requests and questions
-    url: https://github.com/handsontable/hyperformula/discussions
+    url: https://forum.handsontable.com/t/about-the-hyperformula-category/9073
     about: Start a new discussion about your idea.

.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,26 @@ 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 }}
 
+      - 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 linter
-        run: |
-          npm run lint
+        run: npm run lint

.github/workflows/performance.yml

@@ -24,27 +24,34 @@ jobs:
         with:
           node-version: ${{ matrix.node-version }}
 
-      - name: (base) Checkout
+      - 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
+        run: npm ci
 
       - name: (base) Run performance tests
-        run: |
-          npm run benchmark:write-to-file base.json
+        run: npm run benchmark:write-to-file base.json
 
-      - name: (head) Checkout
+      - 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
+        run: npm ci
 
       - name: (head) Run performance tests
         run: |

.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,30 @@ 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:unit.ci -- --coverage
+        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
@@ -51,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

@@ -22,3 +22,12 @@ node_modules/
 *.iml
 dev*.html
 .DS_Store
+
+/test/hyperformula-tests/
+
+# Generated at docs:build from built-in-functions.tmpl.md (HF-249 single-source); do not commit.
+docs/guide/built-in-functions.md
+
+# Wrangler (Cloudflare Workers) local state
+.wrangler
+.dev.vars*

.nvmrc

@@ -1 +1 @@
-v16
+22

AGENTS.md

@@ -0,0 +1,44 @@
+# AGENTS.md
+
+Instructions for AI coding agents (Cursor, Claude Code, Codex, Aider, and any other AI tool) working in this repository.
+
+## Start here
+
+Whatever you do, start by reading entire [DEV_DOCS.md](DEV_DOCS.md). Only then proceed to your task.
+
+## Other important resources
+
+- the repository [README.md](README.md) — high-level project description and quick install/usage
+- the markdown files in [`docs/guide/`](docs/guide/) — user-facing guides (installation, configuration, built-in functions, custom functions, integrations, etc.)
+- the markdown files in [`docs/api/`](docs/api/) — API reference (generated from JSDoc; run `npm run docs:build` if the folder is missing)
+
+Prefer reading these local files over fetching the rendered documentation from the web.
+
+## Response style
+
+- Be concise by default. Use as few words as possible unless the user asks for more detail.
+- When the user asks for specific content, lead the response with the requested information.
+- Structure answers with bullet lists, numbered lists, tables, or code blocks where useful.
+- Ask clarifying questions when the request is ambiguous rather than guessing.
+- If you do not know something, say so and ask for help.
+- When answering from project documentation, quote the exact relevant fragments to support your claim.
+
+## Common ways agents fail
+
+This section is maintained by the team. Whenever an AI agent makes a mistake worth flagging, an item is added here describing what the agent did wrong and what it should have done instead. Read this list before starting any non-trivial task.
+
+<!-- Add new items to the top of the list. Use the format:
+- **Short title** &mdash; What the agent did wrong. What it should have done instead.
+-->
+
+1. Often pull request descriptions becomes obsolete. Remember to update it as you work.
+
+## Skills, MCPs, and other agent tools
+
+This section is maintained by the team. Skills, MCP servers, and other tools vetted as useful for AI agents working on this codebase are listed here.
+
+<!-- Add new items here. Use the format:
+- **Name** &mdash; What it provides and when to use it.
+-->
+
+_No items yet._

CHANGELOG.md

@@ -10,6 +10,46 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 ### Added
 
 - Added iterative calculation support for circular references. [#1545](https://github.com/handsontable/hyperformula/issues/1545)
+
+## [3.4.0] - 2026-08-10
+
+### Added
+
+- Added the `getAvailableFunctions()` and `getFunctionDetails()` instance methods for retrieving function metadata. [#1692](https://github.com/handsontable/hyperformula/pull/1692)
+- Added new functions: VSTACK, HSTACK. [#1698](https://github.com/handsontable/hyperformula/pull/1698)
+- Added a new function: `XIRR`. [#1701](https://github.com/handsontable/hyperformula/pull/1701)
+- Added the UNIQUE function. [#1708](https://github.com/handsontable/hyperformula/pull/1708)
+- Added the SORT function. [#1707](https://github.com/handsontable/hyperformula/pull/1707)
+- Added an Indonesian (Bahasa Indonesia) language pack. [#1674](https://github.com/handsontable/hyperformula/pull/1674)
+- Added a `stringifyCurrency` config option that lets you plug in a custom currency formatter for the `TEXT` function. [#1145](https://github.com/handsontable/hyperformula/issues/1145)
+
+### Fixed
+
+- Fixed the behavior of `MATCH`, `VLOOKUP`, `HLOOKUP`, and `XLOOKUP` functions when the search range contained empty cells. [#1697](https://github.com/handsontable/hyperformula/pull/1697)
+- Fixed the `VLOOKUP`, `HLOOKUP`, and `XLOOKUP` functions to return `0` instead of an empty value when the matched cell in the result range is empty. [#1697](https://github.com/handsontable/hyperformula/pull/1697)
+- Fixed the page freezing when entering a long string of digits containing a non-digit character near the end (e.g. `012...789a` or `012...789 123`) into a cell. [#1520](https://github.com/handsontable/hyperformula/issues/1520)
+
+## [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
+
 - Added a new function: IRR. [#1591](https://github.com/handsontable/hyperformula/issues/1591)
 - Added a new function: N. [#1585](https://github.com/handsontable/hyperformula/issues/1585)
 - Added a new function: VALUE. [#1592](https://github.com/handsontable/hyperformula/issues/1592)