@zushah/chalkboard 1.5.0 → 1.7.0

package/CHANGELOG.md

@@ -1,9 +1,65 @@
 # Chalkboard changelog
 All notable changes of every update of the Chalkboard library are recorded in this file.
 
-## [v1.5.0](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.5.0) - 12/18/2023
+## [v1.7.0 Descartes](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.7.0) - 01/01/2024
+The ninth release of the Chalkboard library.
+Commits: [`v1.6.0...v1.7.0`](https://www.github.com/Zushah/Chalkboard/compare/v1.6.0...v1.7.0)
+- Added tensors (multidimensional multidimensional matrices, or n-dimensional arrays) with 29 commands in the new `tens` category
+- Added 12 more matrix commands: copying, resizing, five new primitive matrices (exchange, shift, binomial, Hilbert, Lehmer), concatenating, multiplying with vectors, Kronecker sum, Kronecker product, and converting to a tensor
+- Added `.copy` commands for complex numbers, quaternions, and vectors
+- Added `stat.toTensor` to convert an array to a tensor
+- Added quaternion division with `quat.div`
+- Added `PARSEPREFIX` as a Chalkboard global which makes it easier to add custom functions to Chalkboard functions than the `init` parameter in `real.parse` and `comp.parse`
+- Added `CONTEXT` as a Chalkboard global to replace the removed `plot.CONTEXT`
+- Removed `plot.CONTEXT`
+- Changed all of the `plot` commands, `LOGO`, and `geom.line3D` to use the new `CONTEXT` constant instead of `plot.CONTEXT`
+- Changed all of the `plot` commands to use `config.x` and `config.y` to determine their position on the canvas instead of `config.origin`
+- Changed all of the `plot` commands' initialization of the `config` parameter to be two less lines long
+- Changed `matr.plot` to have a `config.domain` option
+- Changed `real.parse` and `comp.parse` to no longer have an `init` parameter
+- Changed many of the `comp` and `quat` commands to accept regular numbers (not just complex numbers and quaternions) as inputs
+- Changed `comp.new` and `quat.new` to be able to accept only one argument as the real part and fill the imaginary part(s) with zeroes
+- Changed `stat.eq`, `stat.ineq`, `stat.lt`, and `stat.gt` to use `Array.isArray` instead of `.constructor === Array`
+- Changed `stat.toVector` to have an `index` parameter to change the index of the array to start at when defining a vector
+- Changed all of the integration commands (`calc.fxdx`, `calc.fxydxdy`, `calc.fds`, `calc.frds`, `calc.fnds`, and `calc.fzdz`) to use `inf` and `sup` for the bounds in their parameters instead of `a`, `b`, `c`, and `d`
+- Changed `matr.new` to accept one array of arrays (already-constructed matrix) as an input instead of only multiple arrays (to use as rows to construct a matrix)
+- Changed the order of `matr.random`'s parameters
+- Changed `matr.fill`, `matr.empty`, and `matr.random` to make square matrices with the size inputted into the `rows` parameter if nothing is inputted into the `cols` parameter
+- Changed `matr.LUdecomp` and `matr.QRdecomp` to use `matr.fill` instead of `matr.zero` composed with `matr.empty`
+- Fixed `plot.matr` which hadn't been working for who knows how long because of a critical misspelling (`vec2.plot` instead of `plot.vec2`)
+- Fixed (rewrote) `numb.binomial` which kept giving "callstack size exceeded" errors for some reason
+- Fixed (rewrote) `matr.QRdecomp` thanks to [@JentGent](https://www.github.com/JentGent)'s [implementation](https://www.github.com/JentGent/linalg/blob/main/linalg.js#L519)
+
+
+## [v1.6.0 Fermat](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.6.0) - 12/25/2023
+The eighth release of the Chalkboard library.
+Commits: [`v1.5.0...v1.6.0`](https://www.github.com/Zushah/Chalkboard/compare/v1.5.0...v1.6.0)
+- Added a new type of function: the inverse function (`type` of `"inve"`)
+- Added `stat.regression` to calculate different types of statistical regression models (linear, polynomial, exponential, etc.)
+- Added `plot.CONTEXT` which determines the `CanvasRenderingContext2D` to use for plots
+- Added LU decomposition and QR decomposition for matrices with `matr.LUdecomp` and `matr.QRdecomp`
+- Added `matr.push` and `matr.pull` to add or remove rows or columns from matrices
+- Added `matr.fill` to create a new matrix with a single value for all of the elements
+- Added more commands for generating random numbers: `numb.exponential`, `numb.Bernoullian`, and `numb.Poissonian`
+- Added `numb.Goldbach` to return an even number as a sum of two prime numbers
+- Added `numb.Euler` to calculate Euler's totient function on a number
+- Added `stat.shuffle` to randomly shuffle an array and `stat.subsets` to return all of the possible subsets of an array
+- Changed all of the `plot` commands to use an optional `config` object parameter to configure their customizations (size, color, domain, etc.) instead of separate parameters for each of them
+- Changed `real.function`, `real.val`, `calc.dfdx`, `calc.d2fdx2`, and `calc.fxdx` to accomodate the new `"inve"` function type
+- Changed all of the `plot` commands, the `LOGO` command, and the `geom.line3D` command to use the new `plot.CONTEXT` value instead of `ctx` and `canvas`
+- Changed `matr.empty` and `matr.random` to use `rows` and `cols` as parameters for the size of the matrix instead of `dimension`, and renamed the `dimension` parameter for `matr.identity` to `size`
+- Changed `real.nrt` to be renamed as `real.root` (so `stat.mean` had to be changed since it was used there), and changed the `n` parameter in `comp.root` to be renamed as `index`
+- Changed `numb.random` to use its default values only if the parameters are undefined instead of if the parameters are falsy
+- Changed `matr.new` to use its `matrix` parameter instead of leaving it as declared but unused
+- Changed `comp.d2fdz2` which was incorrectly named as `comp.df2dz2`
+- Fixed (rewrote) `numb.Gaussian` which basically didn't work at all
+- Fixed `real.pow` which returned `NaN` for 0 raised to the power of 0
+- Fixed the default domain for `plot.function` which was incorrectly using the domain for domain colorings instead of normal graphs
+
+
+## [v1.5.0 Cauchy](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.5.0) - 12/18/2023
 The seventh release of the Chalkboard library.
-Commits: [`v1.4.0...v1.5.0`](https://github.com/Zushah/Chalkboard/compare/v1.4.0...v1.5.0)
+Commits: [`v1.4.0...v1.5.0`](https://www.github.com/Zushah/Chalkboard/compare/v1.4.0...v1.5.0)
 - Added Chalkboard as an npm package, so now it can be used on the server-side just like the client side
 - Added `comp.function`, `comp.parse`, and `comp.val` to define, parse, and evaluate complex functions
 - Added `calc.dfdz`, `calc.d2fdz2`, and `calc.fzdz` to calculate the first derivatives, second derivatives, and antiderivatives of complex functions
@@ -23,9 +79,9 @@ Commits: [`v1.4.0...v1.5.0`](https://github.com/Zushah/Chalkboard/compare/v1.4.0
 - Fixed the error messages in `calc.dfdrt` which were misspelled
 - Fixed `plot.field` to include the upper bounds in its domain
 
-## [v1.4.0](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.4.0) - 12/11/2023
+## [v1.4.0 Herschel](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.4.0) - 12/11/2023
 The sixth release of the Chalkboard library.
-Commits: [`v1.3.1...v1.4.0`](https://github.com/Zushah/Chalkboard/compare/v1.3.1...v1.4.0)
+Commits: [`v1.3.1...v1.4.0`](https://www.github.com/Zushah/Chalkboard/compare/v1.3.1...v1.4.0)
 - Added many new commands for arrays: creating an array of random numbers, calculating different types of the norm (and the squared norm) of an array, calculating the normalized array, calculating the array that has the numbers that are equal to, greater than (or equal to), less than (or equal to), or some compound inequality of another number or array, calculating the skewness and kurtosis of an array, calculating the different quartiles of an array, and converting an array to a vector, matrix, object, string, or printing it in the console
 - Added `plot.barplot`, `plot.lineplot`, and `plot.scatterplot` to plot arrays of data
 - Added `.constrain` commands for numbers, arrays, complex numbers, quaternions, vectors, and matrices to constrain their values within a range
@@ -43,16 +99,16 @@ Commits: [`v1.3.1...v1.4.0`](https://github.com/Zushah/Chalkboard/compare/v1.3.1
 - Changed `calc.frdt` to also work for three-dimensional (instead of only two-dimensional) vector fields and parametric curves
 - Fixed `calc.dfrdt` which didn't work due to a slight misspelling in an `if()` statement
 
-## [v1.3.1](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.3.1) - 12/04/2023
+## [v1.3.1 Heaviside Patch](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.3.1) - 12/04/2023
 The fifth release of the Chalkboard library.
-Commits: [`v1.3.0...v1.3.1`](https://github.com/Zushah/Chalkboard/compare/v1.3.0...v1.3.1)
+Commits: [`v1.3.0...v1.3.1`](https://www.github.com/Zushah/Chalkboard/compare/v1.3.0...v1.3.1)
 - Fixed `matr.translator` which was misspelled
 - Fixed `matr.rotator` which didn't work for two-dimensional rotations and was also misspelled
 - Fixed `calc.grad` which didn't work for vector fields because of another misspelling
 
-## [v1.3.0](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.3.0) - 12/04/2023
+## [v1.3.0 Heaviside](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.3.0) - 12/04/2023
 The fourth release of the Chalkboard library.
-Commits: [`v1.2.0...v1.3.0`](https://github.com/Zushah/Chalkboard/compare/v1.2.0...v1.3.0)
+Commits: [`v1.2.0...v1.3.0`](https://www.github.com/Zushah/Chalkboard/compare/v1.2.0...v1.3.0)
 - Added multivariable calculus, with commands for directional differentiation, multivariable chain rule, gradient (partial differentiation), double gradient (second-order partial differentiation), divergence, curl, double integration, line/surface integration, arc length, surface area, and curvature
 - Added second-order differentiation with `calc.d2fdx2`, unit tangent vectors for parametric curves with `calc.tangent`, unit normal vectors with `calc.normal`, and unit binormal vectors with `calc.binormal`
 - Functions that previously had the `type` property of `"para"` should now be changed to `"curv"`
@@ -71,11 +127,11 @@ Commits: [`v1.2.0...v1.3.0`](https://github.com/Zushah/Chalkboard/compare/v1.2.0
 - Changed all `plot` commands so they can now optionally have their opacity changed with the `rgba` parameter (which previously used to only be `rgb`)
 - Changed `numb.Gaussian` to use `for(;;)` instead of `while(typeof x === "undefined")`
 - Changed the name of `calc.average` to `calc.mean`
-- Fixed `matr.invert` returning `NaN` values when `0` is on the diagonal of a matrix, thanks to [@bhavjitChauhan](https://github.com/bhavjitChauhan).
+- Fixed `matr.invert` returning `NaN` values when `0` is on the diagonal of a matrix, thanks to [@bhavjitChauhan](https://www.github.com/bhavjitChauhan).
 
-## [v1.2.0](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.2.0) - 11/27/2023
+## [v1.2.0 Cayley](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.2.0) - 11/27/2023
 The third release of the Chalkboard library.
-Commits: [`v1.1.0...v1.2.0`](https://github.com/Zushah/Chalkboard/compare/v1.1.0...v1.2.0)
+Commits: [`v1.1.0...v1.2.0`](https://www.github.com/Zushah/Chalkboard/compare/v1.1.0...v1.2.0)
 - Added new matrix commands for the trace of a matrix, the row space of a matrix, the column space, and null space, the exponentation, the row Echelon form (Gaussian elimination), solving systems of linear equations, and conversion of a matrix to an object
 - Added `plot.comp`, `plot.vec2`, `plot.vec3`, and `plot.matr` to replace `comp.display`, `vec2.display`, `vec3.display`, and `matr.display`
 - Added `numb.binomial` to calculate binomial coefficients
@@ -87,9 +143,9 @@ Commits: [`v1.1.0...v1.2.0`](https://github.com/Zushah/Chalkboard/compare/v1.1.0
 - Changed `numb.Gaussian` to use `while(typeof x === "undefined")` instead of `while(true)`
 - Fixed the `vec2.magset` and `vec3.magset` commands which would return vectors in the wrong dimensions
 
-## [v1.1.0](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.1.0) - 11/13/2023
+## [v1.1.0 Riemann](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.1.0) - 11/13/2023
 The second release of the Chalkboard library.
-Commits: [`v1.0.0...v1.1.0`](https://github.com/Zushah/Chalkboard/compare/v1.0.0...v1.1.0)
+Commits: [`v1.0.0...v1.1.0`](https://www.github.com/Zushah/Chalkboard/compare/v1.0.0...v1.1.0)
 - Added `numb.prime` to calculate the nth prime number, `numb.nextPrime` to calculate the next prime number, and `numb.primeGap` to calculate the prime gap with an interval
 - Added `numb.factors` to calculate the prime factorization of a number and `numb.divisors` to calculate the divisors of a number
 - Added `numb.Gaussian` to calculate a random number based on a Gaussian distribution
@@ -106,6 +162,6 @@ Commits: [`v1.0.0...v1.1.0`](https://github.com/Zushah/Chalkboard/compare/v1.0.0
 - Changed the name of the `position` parameter in `stat.Gaussian` to `mean`
 - Changed the name of `numb.prime` (the command that checks if a number is prime) to `numb.isPrime`, so parts of `numb.primeArr` and `prime.compositeArr` had to be changed, too
 
-## [v1.0.0](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.0.0) - 11/06/2023
+## [v1.0.0 Euclid](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.0.0) - 11/06/2023
 The first release of the Chalkboard library.
-Commits: [`v1.0.0...main`](https://github.com/Zushah/Chalkboard/compare/v1.0.0...main)
+Commits: [`v1.0.0...main`](https://www.github.com/Zushah/Chalkboard/compare/v1.0.0...main)

package/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 Zushah
+Copyright (c) 2023-2024 Zushah
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,10 +1,12 @@
 <p align="center"><a href="https://www.github.com/Zushah/Chalkboard"><img src="./assets/Chalkboard-logo.png" width="50%"></a></p>
 <p align="center">
-    <a href="https://www.github.com/Zushah/Chalkboard/releases/tag/v1.5.0"><img src="https://img.shields.io/github/v/release/Zushah/Chalkboard" alt="Latest release"></a>
-    <a href="https://www.codefactor.io/repository/github/zushah/chalkboard"><img src="https://www.codefactor.io/repository/github/zushah/chalkboard/badge" alt="CodeFactor grade"></a>
-    <a href="https://www.npmjs.com/package/@zushah/chalkboard"><img src="https://img.shields.io/badge/node-v20.10.0-limegreen" alt="Node.js support"></a>
-    <a href="https://github.com/Zushah/Chalkboard/blob/main/LICENSE.md"><img src="https://img.shields.io/badge/license-MIT-yellow" alt="MIT License"></a>
-    <a href="https://www.jsdelivr.com/package/gh/Zushah/Chalkboard"><img src="https://data.jsdelivr.com/v1/package/gh/Zushah/Chalkboard/badge" alt="JSDelivr requests"></a> 
+    <a href="https://www.github.com/Zushah/Chalkboard/releases/tag/v1.7.0"><img src="https://img.shields.io/badge/release-v1.7.0_Descartes-blueviolet?logo=github&logoColor=white" alt="Latest release"></a>
+    <a href="https://www.codefactor.io/repository/github/zushah/chalkboard"><img src="https://img.shields.io/codefactor/grade/github/Zushah/Chalkboard?color=blue&logo=codefactor&logoColor=white" alt="CodeFactor grade"></a>
+    <a href="https://bundlephobia.com/package/@zushah/chalkboard@1.7.0"><img src="https://img.shields.io/bundlephobia/min/%40zushah/chalkboard?color=darkgreen&logo=files&logoColor=white" alt="Minified size"></a>
+    <a href="https://www.npmjs.com/package/@zushah/chalkboard"><img src="https://img.shields.io/npm/dm/%40zushah/chalkboard?logo=npm&logoColor=white" alt="npm downloads"></a>
+    <a href="https://www.github.com/Zushah/Chalkboard/blob/main/LICENSE.md"><img src="https://img.shields.io/github/license/Zushah/Chalkboard?color=yellow&logo=opensourceinitiative&logoColor=white" alt="MIT License"></a>
+    <a href="https://en.wikipedia.org/wiki/JavaScript"><img src="https://img.shields.io/github/languages/top/Zushah/Chalkboard?color=orange&logo=javascript&logoColor=white" alt="Written in JavaScript"></a>
+    <a href="https://www.jsdelivr.com/package/gh/Zushah/Chalkboard"><img src="https://img.shields.io/jsdelivr/gh/hm/Zushah/Chalkboard?color=crimson&logo=jsdelivr&logoColor=white" alt="jsDelivr requests"></a> 
     <br>
     <a href="https://zushah.github.io/Chalkboard/home.html">https://zushah.github.io/Chalkboard/home.html</a>
 </p>
@@ -21,28 +23,28 @@
 </ol>
 
 # About
-The Chalkboard library is a JavaScript namespace that provides a plethora of both practical and abstract mathematical functionalities for its user. It was developed by [Zushah](https://www.github.com/Zushah) during 2022 and 2023 and then [released](https://github.com/Zushah/Chalkboard/releases/tag/v1.0.0) on November 6, 2023. As per the latest release of [v1.5.0](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.5.0), Chalkboard has 431 different commands. The library is available for regular JavaScript on both the client-side and the server-side as well as [Proccesing.js](https://www.processing.org/) (fully compatible with [Khan Academy](https://www.khanacademy.org/cs/chalkboard/6708642430369792)). Chalkboard's website can be visited [here](https://zushah.github.io/Chalkboard/home.html).
+The Chalkboard library is a JavaScript namespace that provides a plethora of both practical and abstract mathematical functionalities for its user. It was developed by [Zushah](https://www.github.com/Zushah) during 2022 and 2023 and then [released](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.0.0) on November 6, 2023. As per the latest release of [v1.7.0 Descartes](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.7.0), Chalkboard has 492 different commands. The library is available for regular JavaScript on both the client-side and the server-side as well as [Proccesing.js](https://www.processing.org/) (fully compatible with [Khan Academy](https://www.khanacademy.org/cs/chalkboard/6708642430369792)). Chalkboard's website can be visited [here](https://zushah.github.io/Chalkboard/home.html).
 
 # Installation
 If your JavaScript project is being run on the client-side within a webpage, you can install Chalkboard with this HTML tag:
 ```html
-<script type="text/javascript" src="https://cdn.jsdelivr.net/gh/Zushah/Chalkboard@1.5.0/src/Chalkboard.min.js"></script>
+<script src="https://cdn.jsdelivr.net/gh/Zushah/Chalkboard@1.7.0/src/Chalkboard.min.js"></script>
 ```
 If your JavaScript project is being run on the server-side within the [Node.js](https://nodejs.org/en) environment, you can install Chalkboard with this console command:
 ```bash
-npm install @zushah/chalkboard@1.5.0
+npm install @zushah/chalkboard@1.7.0
 ```
-Alternatively, you can simply download the [latest release](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.5.0) and put the relevant files in your project's directory.
+Alternatively, you can simply download the [latest release](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.7.0) and put the relevant files in your project's directory.
 
 More methods and details about installing Chalkboard can be read [here](https://zushah.github.io/Chalkboard/installation.html).
 
 # Documentation
-These are all thirteen Chalkboard categories with a brief description of what they're mostly about, and listed in the order they appear in the source code:
+These are all fourteen Chalkboard categories with a brief description of what they're mostly about, and listed in the order they appear in the source code:
 - `numb` - Number-theory-related operations
 - `real` - Real number and real function operations
 - `comp` - Complex number and complex function operations
 - `quat` - Quaternion operations
-- `plot` - Plotting functions, complex numbers, vectors, matrices, and statistical graphs
+- `plot` - Plotting real and complex functions, complex numbers, vectors, matrices, and statistical graphs
 - `geom` - Geometric formulae operations
 - `trig` - Trigonometric function operations
 - `stat` - Statistical array operations
@@ -50,13 +52,16 @@ These are all thirteen Chalkboard categories with a brief description of what th
 - `vec3` - Three-dimensional vector operations
 - `vec4` - Four-dimensional vector operations
 - `matr` - Multidimensional matrix operations
-- `calc` - Several-variable calculus operations
+- `tens` - Tensor (multidimensional multidimensional matrix) operations
+- `calc` - Single/multi-variable real/complex-valued calculus operations
 
-There are also four "global" commands in Chalkboard, which are:
+There are also six "global" commands and constants in Chalkboard, which are:
 - `README()` - Prints basic information about Chalkboard in the console
 - `LOGO()` - Draws the Chalkboard logo
-- `PI()` - Computes the number pi
+- `PI()` - Computes the number π
 - `E()` - Computes the number e
+- `CONTEXT` - The JavaScript canvas rendering context to use for plotting
+- `PARSEPREFIX` - Used for adding custom functions to the Chalkboard parser
 
 The comprehensive Chalkboard documentation can be visited [here](https://zushah.github.io/Chalkboard/documentation.html).
 
@@ -67,12 +72,11 @@ Chalkboard.category.command(parameters);
 ```
 Here is some code that shows off only a few features of Chalkboard:
 ```js
-const cb = Chalkboard; // Chalkboard is a nice name but it's also long
-/*
-Note that this code is written on the client-side
-You can write all the same code on the server-side, too, but you would have to replace the line above with:
-const cb = require("@zushah/chalkboard@1.5.0");
-*/
+const cb = Chalkboard; // Initialize in a browser
+// or
+const cb = require("@zushah/chalkboard"); // Initialize in Node with CommonJS
+// or
+import cb from "@zushah/chalkboard"; // Initiialize in Node with ES Modules
 
 let f = cb.real.function("Math.cos(2 * x)"); // f(x) = cos(2x)
 let dfdx = cb.calc.dfdx(f, 2); // Derivative of f at x = 0
@@ -85,16 +89,16 @@ let fnds = cb.calc.fnds(f, r, cb.PI(-1/2), cb.PI(1/2), 0, cb.PI(2)); // Flux of
 
 let primes = cb.numb.primeArr(0, 100); // Array of prime numbers between 0 and 100
 let midPrime = cb.stat.median(primes); // Median number in the primes array
-cb.plot.barplot(primes, cb.stat.array(0, 100, 11), 5, [[0, 0, 0], [0, 0, 255]]); // Barplot of the primes array with a bin size of 10, a scale of 2, a stroke color of black, and a fill color of blue
+cb.plot.barplot(primes, cb.stat.array(0, 100, 11), {size: 5, strokeStyle: "black", fillStyle: "blue"}); // Barplot of the primes array with a bin size of 10, a scale of 2, a stroke color of black, and a fill color of blue
 
 let z = cb.comp.new(1, 1); // z = 1 + i
 let zsqsqrt = cb.comp.sqrt(cb.comp.sq(z)); // The square root of z squared equals z
-let f = cb.comp.function("a*a - b*b + 1", "2*a*b"); // f(z) = z^2 + 1 for z = a + bi (a complex-valued function)
+let f = cb.comp.function("a*a - b*b + 1", "2*a*b"); // f(z) = z^2 + 1
 cb.plot.function(f); // Plots the domain coloring of f
 
 let r = cb.real.function(["Math.cos(t)", "Math.sin(t)"], "curv"); // r(t) = (cos(t), sin(t))
-cb.plot.xyplane(2); // Draws the Cartesian coordinate plane
-cb.plot.function(r, 2, [255, 0, 0] [0, cb.PI(1/2)]); // Plots r(t) colored red from t = 0 to t = π/2
+cb.plot.xyplane({size: 2}); // Draws the Cartesian coordinate plane scaled by 2
+cb.plot.function(r, {size: 2, strokeStyle: "rgb(255, 100, 100)", domain: [0, cb.PI(2)]}); // Plots r(t) scaled by 2 colored light red from t = 0 to t = π/2
 
 let a = cb.vec3.new(1, 2, 3); // Vector a = (1, 2, 3)
 let b = cb.vec3.new(4, 5, 6); // Vector b = (4, 5, 6)
@@ -110,8 +114,14 @@ let m = cb.matr.new([0, 1, 1, 1, 1],  // m is a 5x5 matrix
 let mi = cb.matr.invert(m); // mi is the inverse of m
 let mmi = cb.matr.mul(m, mi); // mmi is the product of m and mi
 cb.matr.print(mmi); // Prints mmi in the console
+
+let t = cb.tens.new([[1, 2], [3, 4]],  // t is a 2x2x2 (rank-3) tensor
+                    [[5, 6], [7, 8]]);
+let tt = cb.tens.mul(t, t); // tt is a 2x2x2x2x2x2 (rank-6) tensor
+let ttm = cb.tens.resize(tt, 8, 8); // ttm is an 8x8 matrix (or rank-2 tensor)
+cb.tens.print(tt); // Prints tt in the console just to see what it looks like for fun
 ```
-More examples that are more interesting can be seen [here](https://zushah.github.io/Chalkboard/examples.html) with their source code [here](https://github.com/Zushah/Chalkboard/tree/main/examples).
+More examples that are more interesting can be seen [here](https://zushah.github.io/Chalkboard/examples.html) with their source code [here](https://www.github.com/Zushah/Chalkboard/tree/main/examples).
 
 # Contributing
 <ol>
@@ -121,13 +131,14 @@ More examples that are more interesting can be seen [here](https://zushah.github
     <li>Open a pull request. It will be reviewed soon and then merged to the main branch.</li>
 </ol>
 
-The changelog can be read [here](https://github.com/Zushah/Chalkboard/blob/main/CHANGELOG.md).
+The changelog can be read [here](https://www.github.com/Zushah/Chalkboard/blob/main/CHANGELOG.md).
 
-The Chalkboard library is available under the [MIT License](https://github.com/Zushah/Chalkboard/blob/main/LICENSE.md).
+The Chalkboard library is available under the [MIT License](https://www.github.com/Zushah/Chalkboard/blob/main/LICENSE.md).
 
-# Acknowledgements
-Thanks to [Bhavjit Chauhan](https://github.com/bhavjitChauhan) for his [contribution](https://www.github.com/Zushah/Chalkboard/pull/1) to [v1.3.0](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.3.0).\
-Thanks to [G. Yang](https://www.github.com/gyang0) for his [contribution](https://www.github.com/Zushah/zushah.github.io/pull/1) to the [documentation](https://www.github.com/Zushah/zushah.github.io/tree/main/Chalkboard).
+# Acknowledgments
+Thanks to [Bhavjit Chauhan](https://www.github.com/bhavjitChauhan) for his [contribution](https://www.github.com/Zushah/Chalkboard/pull/1) to [v1.3.0 Heaviside](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.3.0).\
+Thanks to [G. Yang](https://www.github.com/gyang0) for his [contribution](https://www.github.com/Zushah/zushah.github.io/pull/1) to the [documentation](https://www.github.com/Zushah/zushah.github.io/tree/main/Chalkboard).\
+Thanks to [JentGent](https://www.github.com/JentGent) for his [implementation](https://www.github.com/JentGent/linalg/blob/main/linalg.js#L519) for calculating QR decomposition which was [adapted](https://www.github.com/Zushah/Chalkboard/commit/1dce0dbac82b38f9a550dd496bc878c402a92442) into [v1.7.0 Descartes](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.7.0).
 
 # Contact
 [GitHub](https://www.github.com/Zushah)\

package/docs/README.md

@@ -1,2 +1,2 @@
 # Chalkboard documentation
-The documentation for [Chalkboard v1.5.0](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.5.0) can be visited [here](https://zushah.github.io/Chalkboard/documentation.html/). Its source code is located [here](https://github.com/Zushah/zushah.github.io/blob/main/Chalkboard/documentation.html).
+The documentation for [Chalkboard v1.7.0 Descartes](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.7.0) can be visited [here](https://zushah.github.io/Chalkboard/documentation.html/). Its source code is located [here](https://www.github.com/Zushah/zushah.github.io/blob/main/Chalkboard/documentation.html).

package/examples/README.md

@@ -1,5 +1,5 @@
 # Chalkboard examples
-Six basic programs made by Zushah that utilize [Chalkboard v1.5.0](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.5.0) are located in this directory.
+Six basic programs made by Zushah that utilize [Chalkboard v1.7.0 Descartes](https://www.github.com/Zushah/Chalkboard/releases/tag/v1.7.0) are located in this directory.
 
 They can be viewed in action here:
 - [fluid.js](https://zushah.github.io/Chalkboard/examples/fluid.html)

package/examples/fluid.js

@@ -1,6 +1,6 @@
 /*
     The Chalkboard Library ===> https://www.github.com/Zushah/Chalkboard
-    Version 1.5.0 Example Program: Fluid Flow
+    Version 1.7.0 Descartes Example Program: Fluid Flow
     Authored by Zushah ===> https://www.github.com/Zushah
 */
 

package/examples/hyperbolics.js

@@ -1,6 +1,6 @@
 /*
     The Chalkboard Library ===> https://www.github.com/Zushah/Chalkboard
-    Version 1.5.0 Example Program: Hyperbolic Functions
+    Version 1.7.0 Descartes Example Program: Hyperbolic Functions
     Authored by Zushah ===> https://www.github.com/Zushah
 */
 
@@ -15,12 +15,12 @@ var theta = 0;
 function main() {
     ctx.fillStyle = "rgb(255, 255, 255)";
     ctx.fillRect(0, 0, canvas.width, canvas.height);
-    cb.plot.xyplane(1, [0, 0, 0], [canvas.width / 2, canvas.height / 2], 2);
+    cb.plot.xyplane({lineWidth: 2});
 
     // Plot the unit hyperbola with a parametric function (see: https://en.wikipedia.org/wiki/Hyperbola)
     var f = cb.real.function(["(t * t + 1) / (2 * t)", "(t * t - 1) / (2 * t)"], "curv");
-    cb.plot.function(f, 1, [100, 100, 255], [0, 10], [canvas.width / 2, canvas.height / 2], 4);
-    cb.plot.function(f, 1, [100, 100, 255], [-10, 0], [canvas.width / 2, canvas.height / 2], 4);
+    cb.plot.function(f, {strokeStyle: "rgb(100, 100, 255)", domain: [0, 10], lineWidth: 4});
+    cb.plot.function(f, {strokeStyle: "rgb(100, 100, 255)", domain: [-10, 0], lineWidth: 4});
 
     // The two main hyperbolic trigonometric functions, hyperbolic sine (sinh) and hyperbolic cosine (cosh)
     var x = cb.trig.cosh(theta);

package/examples/mandelbrot.js

@@ -1,6 +1,6 @@
 /*
     The Chalkboard Library ===> https://www.github.com/Zushah/Chalkboard
-    Version 1.5.0 Example Program: Mandelbrot Set
+    Version 1.7.0 Descartes Example Program: Mandelbrot Set
     Authored by Zushah ===> https://www.github.com/Zushah
 */
 

package/examples/matr-donut.js

@@ -1,6 +1,6 @@
 /*
     The Chalkboard Library ===> https://www.github.com/Zushah/Chalkboard
-    Version 1.5.0 Example Program: Matrix Donut
+    Version 1.7.0 Descartes Example Program: Matrix Donut
     Authored by Zushah ===> https://www.github.com/Zushah
 */
 
@@ -11,7 +11,7 @@ canvas.height = window.innerHeight;
 
 var cb = Chalkboard; // Initialize Chalkboard as cb
 
-// Generate the donut's points with a parametric function (see: https://en.wikipedia.org/wiki/Torus)
+// Generate the donut's points with parametric equations (see: https://en.wikipedia.org/wiki/Torus)
 var points = [];
 for(var u = 0; u < cb.PI(2); u += cb.PI(1/16)) {
     for(var v = 0; v < cb.PI(2); v += cb.PI(1/6)) {
@@ -41,9 +41,7 @@ function main() {
     // Make the donut rotate with a rotation matrix
     var r = cb.matr.rotator(cb.trig.toRad(1), cb.trig.toRad(1), cb.trig.toRad(1));
     for(var i = 0; i < points.length; i++) {
-        var buffer = cb.vec3.toMatrix(points[i]);      // Create a buffer matrix which has the donut's points
-        var rbuffer = cb.matr.mul(r, buffer);          // Multiply the rotation matrix with the buffer matrix
-        points[i] = cb.matr.toVector(rbuffer, "vec3"); // Reassign the values of the donut's points to the new rotated points
+        points[i] = cb.matr.mulvec(r, points[i]); // Multiply the rotation matrix with the points' vectors
     }
 
     window.requestAnimationFrame(main);

package/examples/newton.js

@@ -1,6 +1,6 @@
 /*
     The Chalkboard Library ===> https://www.github.com/Zushah/Chalkboard
-    Version 1.5.0 Example Program: Newton's Method
+    Version 1.7.0 Descartes Example Program: Newton's Method
     Authored by Zushah ===> https://www.github.com/Zushah
 */
 
@@ -26,10 +26,10 @@ var y = cb.real.function(cb.calc.dfdx(f, root) + " * (x - " + root + ") + " + cb
 function main() {
     ctx.fillStyle = "rgb(255, 255, 255)";
     ctx.fillRect(0, 0, canvas.width, canvas.height);
-    cb.plot.xyplane(1, [0, 0, 0], [canvas.width / 2, canvas.height / 2], 2);
+    cb.plot.xyplane({lineWidth: 2});
 
     // Draw the polynomial
-    cb.plot.function(f, 1, [100, 100, 255], [-10, 10], [canvas.width / 2, canvas.height / 2], 4);
+    cb.plot.function(f, {strokeStyle: "rgb(100, 100, 255)", lineWidth: 4});
     ctx.fillStyle = "rgb(0, 0, 0)";
     ctx.font = "50px Times New Roman";
     ctx.fillText("f(x) = " + c1.toFixed(2) + "x⁴ + " + c2.toFixed(2) + "x³ + " + c3.toFixed(2) + "x² + " + c4.toFixed(2) + "x + " + c5.toFixed(2), 20, 70);
@@ -38,7 +38,7 @@ function main() {
     if(cb.real.val(f, root).toFixed(1) == 0) {
         ctx.fillText("y = " + cb.calc.dfdx(f, root).toFixed(2) + "x - " + (cb.calc.dfdx(f, root) * root).toFixed(2), 20, 120);
         ctx.fillText("A possible root is at x = " + root.toFixed(2), 20, 170);
-        cb.plot.function(y, 1, [255, 100, 100], [-10, 10], [canvas.width / 2, canvas.height / 2], 4);
+        cb.plot.function(y, {strokeStyle: "rgb(255, 100, 100)", lineWidth: 4});
         ctx.save();
         ctx.translate(canvas.width / 2, canvas.height / 2);
         ctx.beginPath();

package/examples/quat-donut.js

@@ -1,6 +1,6 @@
 /*
     The Chalkboard Library ===> https://www.github.com/Zushah/Chalkboard
-    Version 1.5.0 Example Program: Quaternion Donut
+    Version 1.7.0 Descartes Example Program: Quaternion Donut
     Authored by Zushah ===> https://www.github.com/Zushah
 */
 
@@ -11,7 +11,7 @@ canvas.height = window.innerHeight;
 
 var cb = Chalkboard; // Initialize Chalkboard as cb
 
-// Generate the donut's points with a parametric function (see: https://en.wikipedia.org/wiki/Torus)
+// Generate the donut's points with parametric equations (see: https://en.wikipedia.org/wiki/Torus)
 var points = [];
 for(var u = 0; u < cb.PI(2); u += cb.PI(1/16)) {
     for(var v = 0; v < cb.PI(2); v += cb.PI(1/6)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zushah/chalkboard",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "The Chalkboard library provides a plethora of mathematical functionalities for its user.",
   "main": "src/Chalkboard.js",
   "scripts": {
@@ -20,5 +20,8 @@
   "bugs": {
     "url": "https://github.com/Zushah/Chalkboard/issues"
   },
-  "homepage": "https://zushah.github.io/Chalkboard/home.html"
+  "homepage": "https://zushah.github.io/Chalkboard/home.html",
+  "publishConfig": {
+    "access": "public"
+  }
 }