Distribute package in ES module format exclusively

Changes the default module format of this package to ES module. Import it using `import getReverseIteratingArray from 'get-reverse-iterating-array'`.

Removes the `get-reverse-iterating-array/dist/cjs/get-reverse-iterating-array.js` and `get-reverse-iterating-array/dist/esm/get-reverse-iterating-array.mjs` module
 specifiers.

Migrates test suite from Ava to Jest.

Introduces Rollup for bundling.

Author: kleinfreund

.gitignore

@@ -1,2 +1,2 @@
 node_modules
-.nyc_output
+coverage

README.md

@@ -1,8 +1,10 @@
 # get-reverse-iterating-array
 
-This function reverses an array’s default iteration direction. By default, the [iteration protocols](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols) are defined to iterate on an iterable object’s elements according to their insertion order.
+A function returning an array whose iteration direction is reversed without affecting the original array or affecting the iteration direction of any other arrays.
 
-The function `getReverseIteratingArray` returns a new [`Proxy`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy) object with the array as its target. The array’s `[Symbol.iterator]` property is trapped in order to define custom iteration behaviour. This has the advantage of not changing the implementation of [`Array.prototype[Symbol.iterator]`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/@@iterator) directly which would cause the iteration direction of _all_ arrays to be reversed. Using a proxy also avoids unnecessarily copying an array for reverse iteration like [`Array.prototype.reverse()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/reverse) would.
+By default, the [iteration protocols](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols) are defined to iterate on an iterable object’s elements according to their insertion order.
+
+The function `getReverseIteratingArray` returns a new [`Proxy`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy) object with the array being its target. The array’s `[Symbol.iterator]` property is trapped in order to define custom iteration behaviour. This has the advantage of not changing the implementation of [`Array.prototype[Symbol.iterator]`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/@@iterator) directly which would cause the iteration direction of _all_ arrays to be reversed. Using a proxy also avoids unnecessarily copying an array for reverse iteration like [`Array.prototype.reverse()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/reverse) would.
 
 If you require to iterate over an array in _both_ forwards and backwards direction, have a look at [`ReverseIterableArray`](https://www.npmjs.com/package/reverse-iterable-array).
 
@@ -21,73 +23,40 @@ See also:
 
 ## Table of contents
 
-- [Installation & usage](#installation--usage)
+- [Installation](#installation)
+- [Usage](#usage)
 - [Examples](#examples)
 - [Tests](#tests)
 - [Documentation](#documentation)
 
 
 
-## Installation & usage
-
-### Browser
-
-Download the ES module file …
+## Installation
 
 ```sh
-curl -O https://raw.githubusercontent.com/kleinfreund/get-reverse-iterating-array/main/dist/esm/get-reverse-iterating-array.mjs
+npm install get-reverse-iterating-array
 ```
 
-… and import it like this:
 
-```js
-import getReverseIteratingArray from 'get-reverse-iterating-array.mjs';
-
-const array = getReverseIteratingArray([1, 2, 3]);
-```
 
-### Node
+## Usage
 
-Install the node package as a dependency …
+```js
+import getReverseIteratingArray from 'get-reverse-iterating-array';
 
-```sh
-npm install --save get-reverse-iterating-array
+const array = getReverseIteratingArray([1, 2, 3]);
 ```
 
-… and import it like this:
-
-- CommonJS module
-
-  ```node
-  const getReverseIteratingArray = require('get-reverse-iterating-array').default;
-
-  const array = getReverseIteratingArray([1, 2, 3]);
-  ```
-
-- ES module
-
-  ```js
-  import getReverseIteratingArray from 'get-reverse-iterating-array/dist/esm/get-reverse-iterating-array.mjs';
-
-  const array = getReverseIteratingArray([1, 2, 3]);
-  ```
-
-- TypeScript module
-
-  ```ts
-  import getReverseIteratingArray from 'get-reverse-iterating-array/src/get-reverse-iterating-array';
-
-  const array = getReverseIteratingArray([1, 2, 3]);
-  ```
-
 
 
 ## Examples
 
 For some live usage examples, clone the repository and run the following:
 
 ```sh
-npm install && npm run examples
+npm install
+npm run build
+npm start
 ```
 
 Then, open [localhost:8080/examples](http://127.0.0.1:8080/examples) in a browser.
@@ -99,7 +68,8 @@ Then, open [localhost:8080/examples](http://127.0.0.1:8080/examples) in a browse
 In order to run the tests, clone the repository and run the following:
 
 ```sh
-npm install && npm test
+npm install
+npm test
 ```
 
 

dist/cjs/get-reverse-iterating-array.js

@@ -1,17 +1,19 @@
-import getReverseIteratingArray from '../dist/esm/get-reverse-iterating-array.mjs';
+import getReverseIteratingArray from '../dist/get-reverse-iterating-array.js';
+
+Object.defineProperty(window, 'getReverseIteratingArray', { value: getReverseIteratingArray });
 
 /**
- * @param {String} command
+ * @param {string} command
  */
 function printCommand(command) {
   printCodeBlock(command, 'command');
 }
 
 /**
- * @param {Array} args
+ * @param {any[]} args
  */
 function printOutput(...args) {
-  const output = args.map(arg => stringify(arg));
+  const output = args.map((arg) => stringify(arg));
   printCodeBlock(output.join(' '), 'output');
 }
 
@@ -47,7 +49,7 @@ function printCodeBlock(content, ...classNames) {
  */
 function stringify(input) {
   if (Array.isArray(input)) {
-    return `[ ${input.map(element => stringify(element)).join(', ')} ]`;
+    return `[ ${input.map((element) => stringify(element)).join(', ')} ]`;
   } else if (typeof input === 'string') {
     return `"${input}"`;
   }
@@ -59,23 +61,22 @@ function printExamples() {
   printCommand('const regularIteratingArray = [5, 4, 1, 2, 3];')
   const regularIteratingArray = [5, 4, 1, 2, 3];
   printOutput(regularIteratingArray);
+  printCommand('Array.from(regularIteratingArray)');
+  printOutput(Array.from(regularIteratingArray));
 
   printCommand('const reverseIteratingArray = getReverseIteratingArray([5, 4, 1, 2, 3]);')
   const reverseIteratingArray = getReverseIteratingArray([5, 4, 1, 2, 3]);
   printOutput(reverseIteratingArray);
-
-  printCommand('Array.from(regularIteratingArray)');
-  printOutput(Array.from(regularIteratingArray));
   printCommand('Array.from(reverseIteratingArray)');
   printOutput(Array.from(reverseIteratingArray));
 
   printCommand('regularIteratingArray.sort((a, b) => b - a)');
   printOutput(regularIteratingArray.sort((a, b) => b - a));
-  printCommand('reverseIteratingArray.sort((a, b) => b - a)');
-  printOutput(reverseIteratingArray.sort((a, b) => b - a));
-
   printCommand('Array.from(regularIteratingArray)');
   printOutput(Array.from(regularIteratingArray));
+
+  printCommand('reverseIteratingArray.sort((a, b) => b - a)');
+  printOutput(reverseIteratingArray.sort((a, b) => b - a));
   printCommand('Array.from(reverseIteratingArray)');
   printOutput(Array.from(reverseIteratingArray));
 }

dist/esm/get-reverse-iterating-array.mjs

@@ -1,13 +1,12 @@
 <!DOCTYPE html>
 <html lang="en">
+
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
   <title>getReverseIteratingArray Examples</title>
 
-  <script type="module" src="examples.mjs"></script>
-
   <style>
     body {
       font-size: 1.25em;
@@ -38,7 +37,7 @@
     .command code:not(:first-child)::before,
     .output code:not(:first-child)::before,
     .log code::before {
-      content: "\A0" "\A0";
+      content: "  ";
     }
 
     .command {
@@ -58,6 +57,7 @@
     }
   </style>
 </head>
+
 <body>
 
   <p>Hey, beautiful. :)</p>
@@ -77,5 +77,8 @@
 
   <hr>
 
+  <script type="module" src="examples.js"></script>
+
 </body>
+
 </html>

dist/get-reverse-iterating-array.js

@@ -0,0 +1,8 @@
+/** @type {import('@jest/types').Config.InitialOptions} */ const config = {
+  preset: 'ts-jest',
+  testEnvironment: 'jsdom',
+  collectCoverage: true,
+  collectCoverageFrom: ['src/**/*.ts', '!**/node_modules/**'],
+}
+
+export default config