Merge branch 'release/2.2.0'

Author: sequba

.config/webpack/languages.js

@@ -11,8 +11,6 @@ const WebpackOnBuildPlugin = require('on-build-webpack');
 const fs  = require('fs');
 const fsExtra  = require('fs-extra');
 
-const PACKAGE_FILENAME = process.env.HOT_FILENAME;
-
 function getEntryJsFiles() {
   const entryObject = {};
   const filesInLanguagesDirectory = fs.readdirSync(SOURCE_LANGUAGES_DIRECTORY);

.eslintrc.js

@@ -4,6 +4,7 @@ module.exports = {
   plugins: [
     '@typescript-eslint',
     'license-header',
+    'jsdoc',
   ],
   parserOptions: {
     tsconfigRootDir: __dirname,
@@ -67,6 +68,42 @@ module.exports = {
     '@typescript-eslint/no-unused-vars': ['warn', { 'argsIgnorePattern': '^_' }],
     '@typescript-eslint/no-explicit-any': 'warn',
     '@typescript-eslint/interface-name-prefix': 'warn',
+
+    "jsdoc/check-access": 'warn',
+    "jsdoc/check-alignment": 'warn',
+    "jsdoc/check-param-names": 'warn',
+    "jsdoc/check-property-names": 'warn',
+    "jsdoc/check-tag-names": 'warn',
+    "jsdoc/check-types": 'warn',
+    "jsdoc/empty-tags": 'warn',
+    "jsdoc/implements-on-classes": 'warn',
+    "jsdoc/multiline-blocks": 'warn',
+    "jsdoc/newline-after-description": 'warn',
+    "jsdoc/no-multi-asterisks": 'warn',
+    "jsdoc/no-undefined-types": 'warn',
+    "jsdoc/require-param-description": 'warn',
+    "jsdoc/require-param-name": 'warn',
+    "jsdoc/require-param-type": 'warn',
+    "jsdoc/require-property-description": 'warn',
+    "jsdoc/require-property-name": 'warn',
+    "jsdoc/require-property-type": 'warn',
+    "jsdoc/require-returns-check": 'warn',
+    "jsdoc/require-returns-description": 'warn',
+    "jsdoc/require-returns-type": 'warn',
+    "jsdoc/require-yields": 'warn',
+    "jsdoc/require-yields-check": 'warn',
+    "jsdoc/tag-lines": 'warn',
+    "jsdoc/valid-types": 'warn',
+    "jsdoc/require-jsdoc": ['warn', {
+      require: {
+        ArrowFunctionExpression: true,
+        ClassDeclaration: true,
+        ClassExpression: true,
+        FunctionDeclaration: true,
+        FunctionExpression: true,
+        MethodDefinition: true,
+      }
+    }],
   },
   overrides: [
     {

.github/workflows/publish.yml

@@ -35,3 +35,4 @@ jobs:
           publish_dir: docs/.vuepress/dist
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_branch: gh-pages
+          cname: hyperformula.handsontable.com # as in https://github.com/peaceiris/actions-gh-pages/blob/ba0b7df03e25ff29c924be8149041119e9421ea6/README.md#%EF%B8%8F-cname

.gitignore

@@ -1,23 +1,23 @@
 .idea/
-commonjs/
-coverage/
-dist/
-doc/
-docs/api/
-docs/functions/
-docs/.vuepress/dist/
-docs/.vuepress/api-sidebar-relative.json
-docs/.vuepress/api-sidebar.json
-typedoc/
-es/
-languages/
-lib/
-test-jasmine/
-test-jest/
+.vscode
+/commonjs/
+/coverage/
+/dist/
+/doc/
+/docs/api/
+/docs/functions/
+/docs/.vuepress/dist/
+/docs/.vuepress/api-sidebar-relative.json
+/docs/.vuepress/api-sidebar.json
+/typedoc/
+/es/
+/languages/
+/lib/
+/test-jasmine/
+/test-jest/
 node_modules/
-typings/
+/typings/
 
 *.iml
 dev*.html
-yarn-error.log
 .DS_Store

CHANGELOG.md

@@ -6,6 +6,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.2.0] - 2022-11-17
+
+### Added
+- Added an American English (`enUS`) language pack. It's a convenience alias: it contains the same translations as the existing British English (`enGB`) language pack. [#1025](https://github.com/handsontable/hyperformula/issues/1025)
+
+### Fixed
+- Fixed functions VLOOKUP and HLOOKUP to handle duplicates in the way specified by the [OpenDocument](https://docs.oasis-open.org/office/OpenDocument/v1.3/os/part4-formula/OpenDocument-v1.3-os-part4-formula.html#HLOOKUP) standard. [#1072](https://github.com/handsontable/hyperformula/issues/1072)
+- Fixed the MATCH function to handle descending ranges in the way specified by the [OpenDocument](https://docs.oasis-open.org/office/OpenDocument/v1.3/os/part4-formula/OpenDocument-v1.3-os-part4-formula.html#MATCH) standard. [#1063](https://github.com/handsontable/hyperformula/issues/1063)
+
 ## [2.1.0] - 2022-09-08
 
 ### Added

README.md

@@ -25,7 +25,8 @@
 
 HyperFormula is a headless spreadsheet built on top of TypeScript. It is a parser and evaluator of Excel formulas for web applications. You can use it in a browser or as a service, with Node.js as your back-end technology.
 - High-speed Excel formula parsing and evaluating
-- A library of [380+ built-in functions](https://hyperformula.handsontable.com/guide/built-in-functions.html) available in 16 languages
+- A library of nearly [400 built-in functions](https://hyperformula.handsontable.com/guide/built-in-functions.html)
+- Support for [internationalization](https://hyperformula.handsontable.com/guide/i18n-features.html) with 17 built-in languages
 - Support for [custom functions](https://hyperformula.handsontable.com/guide/custom-functions.html)
 - Function syntax compatible with [Microsoft Excel](https://hyperformula.handsontable.com/guide/compatibility-with-microsoft-excel.html) and [Google Sheets](https://hyperformula.handsontable.com/guide/compatibility-with-google-sheets.html)
 - [Support for Node.js](https://hyperformula.handsontable.com/guide/server-side-installation.html#install-with-npm-or-yarn)

circle.yml

@@ -203,6 +203,7 @@ module.exports = {
           title: 'Internationalization',
           collapsable: false,
           children: [
+            ['/guide/i18n-features', 'Internationalization features'],
             ['/guide/localizing-functions', 'Localizing functions'],
             ['/guide/date-and-time-handling', 'Date and time handling'],
           ]
@@ -226,6 +227,7 @@ module.exports = {
             ['/guide/custom-functions', 'Custom functions'],
             ['/guide/performance', 'Performance'],
             ['/guide/known-limitations', 'Known limitations'],
+            ['/guide/file-import', 'File import'],
           ]
         },
         {

docs/.vuepress/config.js

@@ -14,7 +14,7 @@ This section contains information about the class for creating HyperFormula inst
 The snippet shows an example how to use `buildFromArray` which is one of [three static methods](/api/classes/hyperformula.html#factories) for creating an instance of HyperFormula:
 ```javascript
 const sheetData = [
-  ['0', '=SUM(1,2,3)', '52'],
+  ['0', '=SUM(1, 2, 3)', '52'],
   ['=SUM(A1:C1)', '', '=A1'],
   ['2', '=SUM(A1:C1)', '91'],
 ];

docs/api-template.md

@@ -122,7 +122,7 @@ console.log(winningTeam)
 ## Demo
 
 <iframe
-     src="https://codesandbox.io/embed/github/handsontable/hyperformula-demos/tree/2.1.x/advanced-usage?autoresize=1&fontsize=11&hidenavigation=1&theme=light&view=preview"
+     src="https://codesandbox.io/embed/github/handsontable/hyperformula-demos/tree/2.2.x/advanced-usage?autoresize=1&fontsize=11&hidenavigation=1&theme=light&view=preview"
      style="width:100%; height:500px; border:0; border-radius: 4px; overflow:hidden;"
      title="handsontable/hyperformula-demos: advanced-usage"
      allow="accelerometer; ambient-light-sensor; camera; encrypted-media; geolocation; gyroscope; hid; microphone; midi; payment; usb; vr; xr-spatial-tracking"