Merge branch 'release/0.5.0'

Author: jansiegel

.config/source-license-header.js

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

.editorconfig

@@ -0,0 +1,2 @@
+[source-license-header.js]
+insert_final_newline = false

.github/ISSUE_TEMPLATE/documentation.md

@@ -3,7 +3,6 @@ name: Documentation
 about: A general template for documentation requests and suggestions
 title: ''
 labels: Documentation
-assignees: scarletfog
 
 ---
 ### Description

CHANGELOG.md

@@ -6,6 +6,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2021-04-15
+
+### Changed
+- **Breaking change**: A change to the type of value returned via serialization methods. (#617)
+- An input value should be preserved through serialization more precisely. (#617)
+- GPU.js constructor needs to be provided directly to engine configuration. (#355)
+- A deprecated config option vlookupThreshold has been removed. (#620)
+
+### Added
+- Added support for row and column reordering. (#343)
+- Added type inferrence for subtypes for number. (#313)
+- Added parsing of number literals containing '%' or currency symbol (default '$'). (#590)
+- Added ability to fallback to plain CPU implementation for functions that uses GPU.js (#355)
+
+### Fixed
+- Fixed minor issue. (#631)
+- Fixed a bug with serialization of some addresses after CRUDs. (#587)
+- Fixed a bug with MEDIAN function implementation. (#601)
+- Fixed a bug with copy-paste operation that could cause out of scope references (#591)
+- Fixed a bug with date parsing. (#614)
+- Fixed a bug where accent/case sensitivity was ignored for LOOKUPs. (#621)
+- Fixed a bug with handling of no time format/no date format scenarios. (#616)
+
 ## [0.4.0] - 2020-12-17
 
 ### Changed

README.md

@@ -123,9 +123,23 @@ in all your non-commercial projects. There is also a
 [commercial license](https://handsontable.github.io/hyperformula/guide/contact.html),
 and support services available.
 
+## Acknowledgements
+
+You should know that this project wouldn’t exist without co-financing from European Union funds under the European Regional Development Funds as a part of the Smart Growth Operational Programme. Project implemented as a part of the Polish National Centre for Research and Development: “Fast Track”.
+
+- Name of the programme: Smart Growth Operational Programme 2014-2020
+- Project name: “Development of the high-performance calculation engine for processing tabular data of the significant size on mobile devices and workstations using parallel computing and GPU.”
+- Project number: POIR.01.01.01-00-0223/18-00
+- Beneficiary: Handsoncode sp. z o.o.
+- Total budget: PLN 1 121 375.00 (USD ~295 000)
+- Amount of grant: PLN 774 742.00 (USD ~204 000)
+- Duration: 2018-2019
+
+![eu-funds](docs/.vuepress/public/eu-logos.png)
+
 ## Authors
 
 Created by [Handsontable](https://handsontable.com), [NavAlgo](https://www.navalgo.com/en/),
 and [Contributors](https://github.com/handsontable/hyperformula/graphs/contributors).
 
-© 2020 Handsoncode
+© 2021 Handsoncode

docs/guide/built-in-functions.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.5.0
+**Release date: April 15, 2021**
+
+### Changed
+- **Breaking change**: A change to the type of value returned via serialization methods. [#617](https://github.com/handsontable/hyperformula/issues/617)
+- An input value should be preserved through serialization more precisely. [#617](https://github.com/handsontable/hyperformula/issues/617)
+- GPU.js constructor needs to be provided directly to engine configuration. [#355](https://github.com/handsontable/hyperformula/issues/355)
+- A deprecated config option vlookupThreshold has been removed. [#620](https://github.com/handsontable/hyperformula/issues/620)
+
+### Added
+- Added support for row and column reordering. [#343](https://github.com/handsontable/hyperformula/issues/343)
+- Added type inferrence for subtypes for number. [#313](https://github.com/handsontable/hyperformula/issues/313)
+- Added parsing of number literals containing '%' or currency symbol (default '$'). [#590](https://github.com/handsontable/hyperformula/issues/590)
+- Added ability to fallback to plain CPU implementation for functions that uses GPU.js [#355](https://github.com/handsontable/hyperformula/issues/355)
+
+### Fixed
+- Fixed minor issue. [#631](https://github.com/handsontable/hyperformula/issues/631)
+- Fixed a bug with serialization of some addresses after CRUDs. [#587](https://github.com/handsontable/hyperformula/issues/587)
+- Fixed a bug with MEDIAN function implementation. [#601](https://github.com/handsontable/hyperformula/issues/601)
+- Fixed a bug with copy-paste operation that could cause out of scope references [#591](https://github.com/handsontable/hyperformula/issues/591)
+- Fixed a bug with date parsing. [#614](https://github.com/handsontable/hyperformula/issues/614)
+- Fixed a bug where accent/case sensitivity was ignored for LOOKUPs. [#621](https://github.com/handsontable/hyperformula/issues/621)
+- Fixed a bug with handling of no time format/no date format scenarios. [#616](https://github.com/handsontable/hyperformula/issues/616)
+
 ## 0.4.0
 **Release date: December 17, 2020**
 

docs/guide/changelog.md

@@ -8,13 +8,13 @@ following command:
 
 **npm:**
 
-```
+```bash
 $ npm install hyperformula
 ```
 
 **Yarn:**
 
-```
+```bash
 $ yarn add hyperformula
 ```
 
@@ -36,10 +36,21 @@ Alternatively, you can load HyperFormula from
 `<script>` tag. This way you will make it accessible in the project as
 a `HyperFormula` global variable.
 
-```javascript
+Full build will include all the required dependencies:
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/hyperformula/dist/hyperformula.full.min.js"></script>
+```
+
+Or you may load just a minimal build and add the dependencies on your own:
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/chevrotain@6/lib/chevrotain.js"></script>
 <script src="https://cdn.jsdelivr.net/npm/hyperformula/dist/hyperformula.min.js"></script>
 ```
 
+A useful option when you already use some of them and there is no need to duplicate the dependencies. You can read more about the dependencies of HyperFormula on a dedicated [Dependencies](/guide/dependencies.md) page.
+
 ## Clone from GitHub
 
 If you choose to clone the project or download it from GitHub you
@@ -49,19 +60,19 @@ descriptions.
 
 ### Clone with HTTPS
 
-```javascript
-https://github.com/handsontable/hyperformula.git
+```bash
+git clone https://github.com/handsontable/hyperformula.git
 ```
 
 ### Clone with SSH
 
-```javascript
-git@github.com:handsontable/hyperformula.git
+```bash
+git clone git@github.com:handsontable/hyperformula.git
 ```
 
 ## Download from GitHub
 
 You can download all resources as a ZIP archive directly from the
 [GitHub repository](https://github.com/handsontable/hyperformula).
 Then, you can use one of the above-mentioned methods to install the
-library.
+library.

docs/guide/client-side-installation.md

@@ -0,0 +1,19 @@
+# Enabling GPU acceleration.
+
+Currently, GPU.js uses ES6 features and does not provide proper ES5 package. 
+Therefore, to allow the engine to run on browsers like Internet Explorer, it is not bundled with the engine.
+
+In order to take advantage of the GPU acceleration, the GPU.js constructor has to be passed to the engine configuration 
+(supported version of GPU.js is 2.3.0):
+
+```javascript
+import GPU from 'gpu.js'
+
+// define options 
+const options = {
+    gpujs: GPU.GPU ?? GPU
+};
+
+// call the static method to build a new instance
+const hfInstance = HyperFormula.buildEmpty(options);
+```

docs/guide/enabling-gpu-acceleration.md

@@ -3,17 +3,12 @@
 Here are the shortcomings of HyperFormula in its current development
 stage:
 
-* The number of built-in functions is growing fast but is still far
-from what is offered by the most popular spreadsheet software on the
-market (~450 functions on average).
 * Node.js versions older than 13 don't properly compare
 culture-insensitive strings. HyperFormula requires the full
 International Components for Unicode (ICU) to be supported.
 [Learn more](https://nodejs.org/api/intl.html#intl_embed_the_entire_icu_full_icu)
-* GPU acceleration is used only by matrix functions: MMULT,
-TRANSPOSE, MEDIANPOOL, MAXPOOL.
-* Sorting and filtering are not natively supported. However,
-we simulate sorting using the move operations.
+* GPU acceleration is used only by matrix functions: MMULT, MEDIANPOOL, MAXPOOL.
+* GPU.js works only in browsers that support ES6. [Learn more](enabling-gpu-acceleration.md)
 * Multiple workbooks are not supported. One instance of HyperFormula
 can handle only one workbook with multiple worksheets at a time.
 * For cycle detection, all possible dependencies between cells are
@@ -28,12 +23,10 @@ you can't compare the arguments in a formula like this:
 * There is no relative referencing in named ranges.
 * The library doesn't offer (at least not yet) the following features:
   * 3D references
-  * Complex numbers
   * Constant arrays
   * Dynamic arrays
   * Asynchronous functions
   * Structured references ("Tables")
-  * Currency data type
   * Relative named expressions
   * Functions cannot use UI metadata (e.g. hidden rows for SUBTOTAL).