🚧 progress: Import existing sources and tests.

Author: make-github-pseudonymous-again

package.json

@@ -59,13 +59,17 @@
     "release": "np --message ':hatching_chick: release: Bumping to v%s.'",
     "test": "ava"
   },
-  "dependencies": {},
+  "dependencies": {
+    "@iterable-iterator/list": "^0.0.2"
+  },
   "devDependencies": {
+    "@aureooms/js-itertools": "^5.1.1",
     "@babel/core": "7.13.16",
     "@babel/preset-env": "7.13.15",
     "@babel/register": "7.13.16",
     "@commitlint/cli": "12.1.1",
     "@js-library/commitlint-config": "0.0.4",
+    "@total-order/primitive": "^0.0.2",
     "ava": "3.15.0",
     "babel-plugin-transform-remove-console": "6.9.4",
     "babel-plugin-unassert": "3.0.1",

src/index.js

@@ -1,2 +1 @@
-const answer = 42;
-export default answer;
+export {default as sorted} from './sorted.js';

src/sorted.js

@@ -0,0 +1,16 @@
+import {list} from '@iterable-iterator/list';
+
+/**
+ * Outputs an array containing the elements of the input iterable sorted
+ * according to a given comparison function.
+ *
+ * @param {Function} compare - The comparison function to use. This function
+ * must be 2-ary. It must return -1, 0, or 1 depending whether the first
+ * parameter is, respectively, less than, equal to, or greater than the second
+ * parameter.
+ * @param {Iterable} iterable - The input iterable.
+ * @returns {Array} - The input iterable, sorted.
+ */
+export default function sorted(compare, iterable) {
+	return list(iterable).sort(compare);
+}

test/src/api.js

@@ -0,0 +1,34 @@
+import test from 'ava';
+
+import {sorted} from '../../src/index.js';
+import * as primitive from '@total-order/primitive';
+import {tee} from '@aureooms/js-itertools';
+
+const increasing = (a, b) => primitive.increasing(a, b);
+const decreasing = (a, b) => primitive.decreasing(a, b);
+
+const macro = (t, compare, array) => {
+	const [reference, input] = tee(array, 2);
+
+	const output = sorted(compare, input);
+	const expected = Array.from(reference).sort(compare);
+
+	t.not(output, input, 'check that output is not the same object as input');
+	t.is(output.length, expected.length, 'length check');
+	t.deepEqual(output, expected, 'check that output is as expected');
+};
+
+macro.title = (title, compare, array) =>
+	title ?? `sorted(${compare.name}, ${JSON.stringify(array)})`;
+
+for (const compare of [increasing, decreasing]) {
+	const array = [];
+
+	const n = 100;
+
+	for (let i = n; i--; ) {
+		array.push(Math.random());
+	}
+
+	test(macro, compare, array);
+}