Deploy docs to staging (HF release 3.0.1)

.config/babel/add-import-extension.js

@@ -0,0 +1,90 @@
+// Based on https://github.com/handsontable/handsontable/blob/bd7628544ff83d6e74a9cc949e2c3c38fef74d76/handsontable/.config/plugin/babel/add-import-extension.js
+
+const { existsSync, lstatSync } = require('fs');
+const { dirname, resolve } = require('path');
+const { types } = require('@babel/core');
+const { declare } = require('@babel/helper-plugin-utils');
+
+const VALID_EXTENSIONS = ['js', 'mjs'];
+
+const hasExtension = moduleName => VALID_EXTENSIONS.some(ext => moduleName.endsWith(`.${ext}`));
+const isCoreJSPolyfill = moduleName => moduleName.startsWith('core-js');
+const isLocalModule = moduleName => moduleName.startsWith('.');
+const isProcessableModule = (moduleName) => {
+    return !hasExtension(moduleName) && (isCoreJSPolyfill(moduleName) || isLocalModule(moduleName));
+};
+
+const createVisitor = ({ declaration, origArgs, extension = 'js' }) => {
+    return (path, { file }) => {
+        const { node: { source, exportKind, importKind } } = path;
+        const { opts: { filename } } = file;
+        const isTypeOnly = exportKind === 'type' || importKind === 'type';
+
+        if (!source || isTypeOnly || !isProcessableModule(source.value)) {
+            return;
+        }
+
+        const { value: moduleName } = source;
+        const absoluteFilePath = resolve(dirname(filename), moduleName);
+        const finalExtension = isCoreJSPolyfill(moduleName) ? 'js' : extension;
+
+        let newModulePath;
+
+        // Resolves a case where "import" points to a module name which exists as a file and
+        // as a directory. For example in this case:
+        // ```
+        // import { registerPlugin } from 'plugins';
+        // ```
+        // and with this directory structure:
+        //   |- editors
+        //   |- plugins
+        //     |- filters/
+        //     |- ...
+        //     +- index.js
+        //   |- plugins.js
+        //   |- ...
+        //   +- index.js
+        //
+        // the plugin will rename import declaration to point to the `plugins.js` file.
+        if (existsSync(`${absoluteFilePath}.js`)) {
+            newModulePath = `${moduleName}.${finalExtension}`;
+
+            // In a case when the file doesn't exist and the module is a directory it will
+            // rename to `plugins/index.js`.
+        } else if (existsSync(absoluteFilePath) && lstatSync(absoluteFilePath).isDirectory()) {
+            newModulePath = `${moduleName}/index.${finalExtension}`;
+
+            // And for other cases it simply put the extension on the end of the module path
+        } else {
+            newModulePath = `${moduleName}.${finalExtension}`;
+        }
+
+        path.replaceWith(declaration(...origArgs(path), types.stringLiteral(newModulePath)));
+    };
+};
+
+module.exports = declare((api, options) => {
+    api.assertVersion(7);
+
+    return {
+        name: 'add-import-extension',
+        visitor: {
+            // It covers default and named imports
+            ImportDeclaration: createVisitor({
+                extension: options.extension,
+                declaration: types.importDeclaration,
+                origArgs: ({ node: { specifiers } }) => [specifiers],
+            }),
+            ExportNamedDeclaration: createVisitor({
+                extension: options.extension,
+                declaration: types.exportNamedDeclaration,
+                origArgs: ({ node: { declaration, specifiers } }) => [declaration, specifiers],
+            }),
+            ExportAllDeclaration: createVisitor({
+                extension: options.extension,
+                declaration: types.exportAllDeclaration,
+                origArgs: () => [],
+            }),
+        }
+    };
+});

.config/karma/base.js

@@ -58,6 +58,9 @@ module.exports.create = function(config) {
     // how many browser should be started simultaneous
     concurrency: Infinity,
 
+    // Extending timeout fixes https://github.com/handsontable/hyperformula/issues/1430
+    browserDisconnectTimeout : 60000,
+
     // Webpack's configuration for Karma
     webpack: (function() {
       // Take the second config from an array - full HF build.

.config/source-license-header.js

@@ -1,4 +1,4 @@
 /**
  * @license
- * Copyright (c) 2024 Handsoncode. All rights reserved.
+ * Copyright (c) 2025 Handsoncode. All rights reserved.
  */

.github/workflows/audit.yml

@@ -1,4 +1,6 @@
 name: Security
+permissions:
+  contents: read
 
 on:
   pull_request:

.github/workflows/build-docs.yml

@@ -1,4 +1,6 @@
 name: Build docs
+permissions:
+  contents: read
 
 on:
   pull_request:

.github/workflows/build.yml

@@ -1,4 +1,6 @@
 name: Build on various envs
+permissions:
+  contents: read
 
 on:
   pull_request:

.github/workflows/codeql.yml

@@ -1,4 +1,7 @@
 name: "CodeQL"
+permissions:
+  contents: read
+  pull-requests: write
 
 on:
   pull_request:

.github/workflows/lint.yml

@@ -1,4 +1,6 @@
 name: Lint
+permissions:
+  contents: read
 
 on:
   pull_request:

.github/workflows/performance.yml

@@ -1,4 +1,7 @@
 name: Performance
+permissions:
+  contents: read
+  pull-requests: write
 
 on:
   pull_request:

.github/workflows/publish.yml

@@ -1,4 +1,7 @@
 name: Publish
+permissions:
+  contents: read
+  pages: write
 
 on:
   push:

.github/workflows/test.yml

@@ -1,4 +1,6 @@
 name: Test
+permissions:
+  contents: read
 
 on:
   pull_request:
@@ -38,6 +40,8 @@ jobs:
 
       - 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:

.typedoc.ts

@@ -1,9 +1,4 @@
 module.exports = {
-  "inputFiles": [
-    "./src/HyperFormula.ts",
-    "./src/ConfigParams.ts",
-    "./src/Emitter.ts",
-  ],
   "exclude": [
     "./test/**",
     "./src/interpreter/**",

CHANGELOG.md

@@ -7,6 +7,30 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [Unreleased]
 
+## [3.0.1] - 2025-08-11
+
+### Fixed
+
+- Fixed `Edge does not exist` error when a named expression is used twice in the same formula. [#1102](https://github.com/handsontable/hyperformula/issues/1102)
+- Fixed typos in the built-in functions guide. [#1517](https://github.com/handsontable/hyperformula/issues/1517)
+- Fixed an issue where named expressions added on engine initialization were not updated on changes. [#1501](https://github.com/handsontable/hyperformula/issues/1501)
+
+## [3.0.0] - 2025-01-14
+
+### Added
+
+- Added a new function: XLOOKUP. [#1458](https://github.com/handsontable/hyperformula/issues/1458)
+
+### Changed
+
+- **Breaking change**: Changed ES module build to use `mjs` files and `exports` property in `package.json` to make importing language files possible in Node environment. [#1344](https://github.com/handsontable/hyperformula/issues/1344)
+- **Breaking change**: Changed the default value of the `precisionRounding` configuration option to `10`. [#1300](https://github.com/handsontable/hyperformula/issues/1300)
+- Make methods `simpleCellAddressToString` and `simpleCellRangeToString` more logical and easier to use. [#1151](https://github.com/handsontable/hyperformula/issues/1151)
+
+### Removed
+
+- **Breaking change**: Removed the `binarySearchThreshold` configuration option. [#1439](https://github.com/handsontable/hyperformula/issues/1439)
+
 ## [2.7.1] - 2024-07-18
 
 ### Fixed

README.md

@@ -46,7 +46,8 @@ HyperFormula doesn't assume any existing user interface, making it a general-pur
 - [Support for named expressions](https://hyperformula.handsontable.com/guide/named-expressions.html)
 - [Support for data sorting](https://hyperformula.handsontable.com/guide/sorting-data.html)
 - [Support for formula localization with 17 built-in languages](https://hyperformula.handsontable.com/guide/i18n-features.html)
-- GPLv3 license
+- Easy integration with any front-end or back-end application
+- GPLv3 or a [commercial license](https://handsontable.com/get-a-quote)
 - Maintained by the team that stands behind the [Handsontable](https://handsontable.com/) data grid
 
 ## Documentation
@@ -97,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 CodeSandbox](https://codesandbox.io/p/sandbox/github/handsontable/hyperformula-demos/tree/2.7.x/mortgage-calculator)
+[Run this code in StackBlitz](https://stackblitz.com/github/handsontable/hyperformula-demos/tree/3.0.x/mortgage-calculator)
 
 ## Contributing
 

babel.config.js

@@ -9,7 +9,7 @@ module.exports = {
         ['@babel/preset-env', {
           modules: false,
           useBuiltIns: 'usage',
-          corejs: '3.23',
+          corejs: '3.39.0',
         }]
       ],
       plugins: [
@@ -18,7 +18,7 @@ module.exports = {
           helpers: false,
           regenerator: false,
           useESModules: false,
-          version: '^7.18.9',
+          version: '^7.25.9',
         }],
         ['@babel/plugin-transform-modules-commonjs', { loose: true }]
       ]
@@ -31,7 +31,9 @@ module.exports = {
     },
     // Environment for transpiling files to be compatible with ES Modules.
     es: {
-      plugins: [],
+      plugins: [
+        ['./.config/babel/add-import-extension.js', { extension: 'mjs' }],
+      ],
     },
   },
 };

docs/.vuepress/config.js

@@ -12,12 +12,12 @@ module.exports = {
   title: 'HyperFormula (v' + HyperFormula.version + ')',
   description: 'HyperFormula is an open-source, high-performance calculation engine for spreadsheets and web applications.',
   head: [
-    // Robots for staging: noindex, nofollow
-    ['meta', {name: 'robots', content: 'noindex, nofollow'}],
+    // Robots for staging: noindex, nofollow 
+    ['meta', {name: 'robots', content: 'noindex, nofollow'}], 
     // Import HF (required for the examples)
     [ 'script', { src: 'https://cdn.jsdelivr.net/npm/hyperformula/dist/hyperformula.full.min.js' } ],
-    [ 'script', { src: 'https://cdn.jsdelivr.net/npm/hyperformula@2.7.1/dist/languages/enUS.js' } ],
-    [ 'script', { src: 'https://cdn.jsdelivr.net/npm/hyperformula@2.7.1/dist/languages/frFR.js' } ],
+    [ 'script', { src: 'https://cdn.jsdelivr.net/npm/hyperformula/dist/languages/enUS.js' } ],
+    [ 'script', { src: 'https://cdn.jsdelivr.net/npm/hyperformula/dist/languages/frFR.js' } ],
     // Import moment (required for the examples)
     [ 'script', { src: 'https://cdn.jsdelivr.net/npm/moment/moment.min.js' } ],
     // Google Tag Manager, an extra element within the `ssr.html` file.
@@ -175,6 +175,7 @@ module.exports = {
           title: 'Overview',
           collapsable: false,
           children: [
+            ['/guide/quality', 'Quality'],
             ['/guide/supported-browsers', 'Supported browsers'],
             ['/guide/dependencies', 'Dependencies'],
             ['/guide/licensing', 'Licensing'],
@@ -267,7 +268,8 @@ module.exports = {
           children: [
             ['/guide/release-notes', 'Release notes'],
             ['/guide/migration-from-0.6-to-1.0', 'Migrating from 0.6 to 1.0'],
-            ['/guide/migration-from-1.0-to-2.0', 'Migrating from 1.x to 2.0'],
+            ['/guide/migration-from-1.x-to-2.0', 'Migrating from 1.x to 2.0'],
+            ['/guide/migration-from-2.x-to-3.0', 'Migrating from 2.x to 3.0'],
           ]
         },
         {

docs/examples/advanced-usage/example1.css

@@ -3,7 +3,7 @@
   color: #606c76;
   font-family: sans-serif;
   font-size: 14px;
-  font-weight: 300;
+  font-weight: 400;
   letter-spacing: .01em;
   line-height: 1.6;
   -webkit-box-sizing: border-box;

docs/examples/advanced-usage/example1.js

@@ -3,7 +3,7 @@ import HyperFormula from 'hyperformula';
 
 console.log(
   `%c Using HyperFormula ${HyperFormula.version}`,
-  'color: blue; font-weight: bold'
+  'color: blue; font-weight: bold',
 );
 
 /* end:skip-in-compilation */
@@ -67,7 +67,7 @@ hf.setSheetContent(hf.getSheetId(sheetInfo.formulas.sheetName), formulasData);
 function renderTable(sheetName) {
   const sheetId = hf.getSheetId(sheetName);
   const tbodyDOM = document.querySelector(
-    `.example #${sheetName}-container tbody`
+    `.example #${sheetName}-container tbody`,
   );
 
   const { height, width } = hf.getSheetDimensions(sheetId);
@@ -101,7 +101,7 @@ function renderResult() {
   const resultOutputDOM = document.querySelector('.example #output');
   const cellAddress = hf.simpleCellAddressFromString(
     `${sheetInfo.formulas.sheetName}!A1`,
-    hf.getSheetId(sheetInfo.formulas.sheetName)
+    hf.getSheetId(sheetInfo.formulas.sheetName),
   );
 
   resultOutputDOM.innerHTML = `<span>

docs/examples/advanced-usage/example1.ts

@@ -3,7 +3,7 @@ import HyperFormula from 'hyperformula';
 
 console.log(
   `%c Using HyperFormula ${HyperFormula.version}`,
-  'color: blue; font-weight: bold'
+  'color: blue; font-weight: bold',
 );
 /* end:skip-in-compilation */
 
@@ -69,7 +69,7 @@ hf.setSheetContent(hf.getSheetId(sheetInfo.formulas.sheetName), formulasData);
 function renderTable(sheetName) {
   const sheetId = hf.getSheetId(sheetName);
   const tbodyDOM = document.querySelector(
-    `.example #${sheetName}-container tbody`
+    `.example #${sheetName}-container tbody`,
   );
 
   const { height, width } = hf.getSheetDimensions(sheetId);
@@ -103,7 +103,7 @@ function renderResult() {
   const resultOutputDOM = document.querySelector('.example #output');
   const cellAddress = hf.simpleCellAddressFromString(
     `${sheetInfo.formulas.sheetName}!A1`,
-    hf.getSheetId(sheetInfo.formulas.sheetName)
+    hf.getSheetId(sheetInfo.formulas.sheetName),
   );
 
   resultOutputDOM.innerHTML = `<span>

docs/examples/basic-operations/example1.css

@@ -3,7 +3,7 @@
   color: #606c76;
   font-family: sans-serif;
   font-size: 14px;
-  font-weight: 300;
+  font-weight: 400;
   letter-spacing: .01em;
   line-height: 1.6;
   -webkit-box-sizing: border-box;