Add SEQUENCE built-in function (#1645)

## Problem

HyperFormula was missing the SEQUENCE dynamic array function for
generating sequential number arrays.

## Fix

Implements `SEQUENCE(rows, [cols], [start], [step])` as a new
`SequencePlugin`:

- Returns a rows×cols array of sequential numbers, filled row-major
- Parse-time array size prediction via `sequenceArraySize()` — handles
NUMBER and STRING literals; non-literal args (cell refs, formulas)
return `#VALUE!` (architectural limitation: array size must be known at
parse time)
- Error types match Excel: negative dims → `#VALUE!`, zero dims →
`#NUM!` (mapped from Excel's `#CALC!`)
- `emptyAsDefault: true` on optional params — empty args like
`=SEQUENCE(3,,,)` use declared defaults
- i18n for all 17 languages with proper Excel-localized names

## Changed files

| File | Change |
|------|--------|
| `src/interpreter/plugin/SequencePlugin.ts` | New plugin: `sequence()`
+ `sequenceArraySize()` |
| `src/interpreter/plugin/index.ts` | Plugin registration |
| `src/i18n/languages/*.ts` (17 files) | SEQUENCE translations |
| `docs/guide/built-in-functions.md` | SEQUENCE row in Array functions
table |
| `docs/guide/release-notes.md` | Unreleased section |
| `CHANGELOG.md` | Added entry |
| `test/smoke.spec.ts` | 3 smoke tests |
| `test/fetch-tests.sh` | Robustness fix for `git pull` |

## Tests

Regression tests in `handsontable/hyperformula-tests` (branch
`feature/SEQUENCE`):

| Group | Tests | Coverage |
|-------|-------|----------|
| Core sanity | #1–#8 | Basic usage, MS docs examples |
| Default parameters | #9–#13 | Omitted cols/start/step |
| Empty args | #14–#21 | emptyAsDefault behavior |
| Step variants | #22–#28 | Zero, negative, fractional step |
| Truncation | #29–#35 | Fractional dims, trunc-to-zero |
| Error conditions | #36–#48 | Zero/negative dims, text, arity,
propagation |
| Type coercion | #49–#59 | Booleans, strings, cell refs, empty cells |
| Large sequences | #60–#63 | 100×100, 1000×1, 1×1000 |
| Fill order | #64–#69 | Row-major verification |
| Function combos | #70–#74 | SUM, AVERAGE, MAX, MIN, COUNT |
| Behavioral | #75–#80 | Max dims, spill |
| Dynamic args | #81–#82 | Architectural limitation (cell ref → #VALUE!)
|

- 82/82 PASS confirmed in Excel desktop (Microsoft 365)
- 3 smoke tests in `test/smoke.spec.ts`



<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Medium Risk**
> Adds a new array-producing built-in (`SEQUENCE`) with parse-time size
prediction rules; mistakes here can affect array vertex creation and
spill/error behavior across formulas. Remaining changes are
documentation/i18n updates plus a minor test script tweak.
> 
> **Overview**
> Adds the `SEQUENCE(rows, [cols], [start], [step])` built-in via a new
`SequencePlugin`, generating row-major numeric arrays and enforcing
dimension/max-sheet limits with appropriate errors.
> 
> Introduces parse-time result sizing (`sequenceArraySize`) that only
accepts literal `rows`/`cols` (non-literal dimensions now yield
`#VALUE!` due to unknown output size), and wires the plugin into the
interpreter exports.
> 
> Updates changelog and docs to list `SEQUENCE`, adds function name
translations across all language packs, and adjusts
`test/fetch-tests.sh` to pull explicitly from `origin` for the current
branch.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
b08cd79. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: marcin-kordas-hoc

CHANGELOG.md

@@ -11,6 +11,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 - 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
 

docs/guide/built-in-functions.md

@@ -58,6 +58,7 @@ Total number of functions: **{{ $page.functionsCount }}**
 | ARRAYFORMULA    | Enables the array arithmetic mode for a single formula.          | ARRAYFORMULA(Formula)                                      |
 | FILTER          | Filters an array, based on multiple conditions (boolean arrays). | FILTER(SourceArray, BoolArray1, BoolArray2, ...BoolArrayN) |
 | ARRAY_CONSTRAIN | Truncates an array to given dimensions.                          | ARRAY_CONSTRAIN(Array, Height, Width)                      |
+| SEQUENCE        | Returns an array of sequential numbers.                          | SEQUENCE(Rows, [Cols], [Start], [Step])                    |
 
 ### Date and time
 

docs/guide/known-limitations.md

@@ -37,3 +37,4 @@ you can't compare the arguments in a formula like this:
 * For certain inputs, the RATE function might have no solutions, or have multiple solutions. Our implementation uses an iterative algorithm (Newton's method) to find an approximation for one of the solutions to within 1e-7. If the approximation is not found after 50 iterations, the RATE function returns the `#NUM!` error.
 * The INDEX function doesn't support returning whole rows or columns of the source range – it always returns the contents of a single cell.
 * The FILTER function accepts either single rows of equal width or single columns of equal height. In other words, all arrays passed to the FILTER function must have equal dimensions, and at least one of those dimensions must be 1.
+* Array-producing functions (e.g., SEQUENCE, FILTER) require their output dimensions to be determinable at parse time. Passing cell references or formulas as dimension arguments (e.g., `=SEQUENCE(A1)`) results in a `#VALUE!` error, because the output size cannot be resolved before evaluation.

docs/guide/list-of-differences.md

@@ -99,3 +99,4 @@ To remove the differences, create [custom implementations](custom-functions.md)
 | DEVSQ         | =DEVSQ(A2, A3)                                                 |       0.0000 |        0.0000 |             NUM |
 | NORMSDIST     | =NORMSDIST(0, TRUE())                                          |          0.5 |  Wrong number |    Wrong number |
 | ADDRESS       | =ADDRESS(1,1,4, TRUE(), "")                                    |          !A1 |         ''!A1 |             !A1 |
+| SEQUENCE      | =SEQUENCE(0)                                                   |        VALUE |           N/A |           CALC  |

src/i18n/languages/csCZ.ts

@@ -188,6 +188,7 @@ const dictionary: RawTranslationPackage = {
     SEC: 'SEC',
     SECH: 'SECH',
     SECOND: 'SEKUNDA',
+    SEQUENCE: 'SEQUENCE',
     SHEET: 'SHEET',
     SHEETS: 'SHEETS',
     SIN: 'SIN',

src/i18n/languages/daDK.ts

@@ -188,6 +188,7 @@ const dictionary: RawTranslationPackage = {
     SEC: 'SEC',
     SECH: 'SECH',
     SECOND: 'SEKUND',
+    SEQUENCE: 'SEKVENS',
     SHEET: 'ARK',
     SHEETS: 'ARK.FLERE',
     SIN: 'SIN',

src/i18n/languages/deDE.ts

@@ -188,6 +188,7 @@ const dictionary: RawTranslationPackage = {
     SEC: 'SEC',
     SECH: 'SECHYP',
     SECOND: 'SEKUNDE',
+    SEQUENCE: 'SEQUENZ',
     SHEET: 'BLATT',
     SHEETS: 'BLÄTTER',
     SIN: 'SIN',

src/i18n/languages/enGB.ts

@@ -190,6 +190,7 @@ const dictionary: RawTranslationPackage = {
     SEC: 'SEC',
     SECH: 'SECH',
     SECOND: 'SECOND',
+    SEQUENCE: 'SEQUENCE',
     SHEET: 'SHEET',
     SHEETS: 'SHEETS',
     SIN: 'SIN',

src/i18n/languages/esES.ts

@@ -188,6 +188,7 @@ export const dictionary: RawTranslationPackage = {
     SEC: 'SEC',
     SECH: 'SECH',
     SECOND: 'SEGUNDO',
+    SEQUENCE: 'SECUENCIA',
     SHEET: 'HOJA',
     SHEETS: 'HOJAS',
     SIN: 'SENO',

src/i18n/languages/fiFI.ts

@@ -188,6 +188,7 @@ const dictionary: RawTranslationPackage = {
     SEC: 'SEK',
     SECH: 'SEKH',
     SECOND: 'SEKUNNIT',
+    SEQUENCE: 'JAKSO',
     SHEET: 'TAULUKKO',
     SHEETS: 'TAULUKOT',
     SIN: 'SIN',