💥 refactor(api)!: Rename reflect to inverse.

BREAKING CHANGE: API change.

Author: make-github-pseudonymous-again

README.md

@@ -9,9 +9,9 @@ Parent is [js-library](https://github.com/make-github-pseudonymous-again/js-libr
 import {constant} from '@iterable-iterator/mapping' ;
 constant('ab', 1); // ['a', 1] ['b', 1]
 
-import {reflect} from '@iterable-iterator/mapping' ;
+import {inverse} from '@iterable-iterator/mapping' ;
 import {enumerate} from '@iterable-iterator/zip';
-reflect(enumerate('ab')); // ['a', 0] ['b', 1]
+inverse(enumerate('ab')); // ['a', 0] ['b', 1]
 
 // You can convert to and from Object and Map
 import {toObject, fromObject, toMap, fromMap} from '@iterable-iterator/mapping' ;

src/index.js

@@ -1,6 +1,6 @@
 export {default as constant} from './constant.js';
 export {default as fromMap} from './fromMap.js';
 export {default as fromObject} from './fromObject.js';
-export {default as reflect} from './reflect.js';
+export {default as inverse} from './inverse.js';
 export {default as toMap} from './toMap.js';
 export {default as toObject} from './toObject.js';

src/inverse.js

@@ -0,0 +1,9 @@
+/**
+ * Inverse a mapping.
+ *
+ * @param {Iterable} mapping The input mapping.
+ * @return {IterableIterator} The output mapping.
+ */
+export default function* inverse(mapping) {
+	for (const [key, value] of mapping) yield [value, key];
+}

src/reflect.js

@@ -2,13 +2,13 @@ import test from 'ava';
 
 import {enumerate} from '@iterable-iterator/zip';
 
-import {reflect} from '../../src/index.js';
+import {inverse} from '../../src/index.js';
 
-test('reflect', (t) => {
-	t.deepEqual([...reflect(enumerate(''))], []);
+test('inverse', (t) => {
+	t.deepEqual([...inverse(enumerate(''))], []);
 
 	t.deepEqual(
-		[...reflect(enumerate('abcde'))],
+		[...inverse(enumerate('abcde'))],
 		[
 			['a', 0],
 			['b', 1],