✨ feat: Add convenience api functions empty and from.

Also add static method empty. Still need to figure out what is the best
approach between static methods and external helper functions.

Author: make-github-pseudonymous-again

src/api/empty.js

@@ -0,0 +1,8 @@
+import RedBlackTree from '../types/RedBlackTree.js';
+
+/**
+ * Same as {@link RedBlackTree.empty}.
+ * @function empty
+ */
+const empty = RedBlackTree.empty;
+export default empty;

src/api/from.js

@@ -0,0 +1,8 @@
+import RedBlackTree from '../types/RedBlackTree.js';
+
+/**
+ * Same as {@link RedBlackTree.from}.
+ * @function from
+ */
+const from = RedBlackTree.from;
+export default from;

src/index.js

@@ -1,3 +1,5 @@
+export {default as empty} from './api/empty.js';
+export {default as from} from './api/from.js';
 export {default as BLACK} from './color/BLACK.js';
 export {default as RED} from './color/RED.js';
 export {default as _debug} from './debug/_debug.js';

src/types/RedBlackTree.js

@@ -165,6 +165,16 @@ export default class RedBlackTree {
 		return this.items();
 	}
 
+	/**
+	 * Constructs an empty red-black tree.
+	 *
+	 * @param {Function} compare - The comparison function to use.
+	 * @returns {RedBlackTree}
+	 */
+	static empty(compare) {
+		return new RedBlackTree(compare);
+	}
+
 	/**
 	 * Constructs a red-black tree from an input iterable.
 	 *