[TMP] Release/3.4.0

.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

@@ -24,5 +24,6 @@ lib
 script
 test-jasmine
 test-jest
+test-utils/snippets
 typedoc
 typings

.eslintrc.js

@@ -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/lint.yml

@@ -28,7 +28,18 @@ jobs:
         with:
           node-version: ${{ matrix.node-version }}
 
-      - uses: actions/checkout@722adc63f1aa60a57ec37892e133b1d319cae598 # https://github.com/actions/checkout/releases/tag/v2.0.0
+      - 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

.gitignore

@@ -24,3 +24,10 @@ dev*.html
 .DS_Store
 
 /test/hyperformula-tests/
+
+# Doc snippets are regenerated from the docs before every test run
+# (the `test:*` scripts run `snippets:extract` first), so they are never committed.
+/test-utils/snippets/*.generated.ts
+
+# Generated at docs:build from built-in-functions.tmpl.md (HF-249 single-source); do not commit.
+docs/guide/built-in-functions.md

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

@@ -7,6 +7,24 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [Unreleased]
 
+## [3.4.0] - 2026-08-10
+
+### Added
+
+- Added the `getAvailableFunctions()` and `getFunctionDetails()` methods (both static and instance) 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

CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

CONTRIBUTING.md

@@ -0,0 +1 @@
+docs/guide/contributing.md