feat: Extend Array/String prototypes

src/globals/prototypes.ts

@@ -0,0 +1,116 @@
+export = {};
+
+declare global {
+	interface Array<T> {
+		random (): T;
+		random (amount: number): T[];
+		remove (...toRemove: T[]): T[];
+		shuffle (): T[];
+		filterMap<X> (cb: (element: T, index: number, thisArray: T[]) => X | undefined): X | undefined;
+	}
+
+	interface String {
+		lazySplit (match: string | RegExp, cases: number): string[];
+		gsub (match: RegExp, replace: string | ((arg: string, ...captures: string[]) => string)): string;
+	}
+}
+
+Object.defineProperties(Array.prototype, {
+	filterMap: {
+		enumerable: false,
+		writable: false,
+		configurable: false,
+		value: function<T, X> (callback: (element: T, index: number, thisArray: T[]) => X | undefined): X | undefined {
+			for (let i = 0; i < this.length; i++) {
+				const result = callback(this[i], i, this);
+				if (result === undefined) continue;
+				return result;
+			}
+		}
+	},
+	remove: {
+		enumerable: false,
+		writable: false,
+		configurable: false,
+		value: function  (...terms) {
+			let out = true;
+			terms.forEach(term => {
+				if (this.indexOf(term) >= 0) this.splice(this.indexOf(term), 1);
+				else out = false;
+			});
+			return out;
+		}
+	},
+	random: {
+		enumerable: false,
+		writable: false,
+		configurable: false,
+		value: function (amount: number) {
+			if (amount === undefined) return this[Math.floor(Math.random() * this.length)];
+			const sample = Array.from(this), out = [];
+			let i = 0;
+			while (sample.length && i++ < amount) {
+				const term = sample[Math.floor(Math.random() * sample.length)];
+				out.push(term);
+				sample.remove(term);
+			}
+			return out;
+		}
+	},
+	shuffle: {
+		enumerable: false,
+		writable: false,
+		configurable: false,
+		value: function () {
+			for (let i = this.length - 1; i > 0; i--) {
+				const j = Math.floor(Math.random() * (i + 1));
+				[this[i], this[j]] = [this[j], this[i]];
+			}
+			return Array.from(this);
+		}
+	}
+});
+
+Object.defineProperties(String.prototype, {
+	lazySplit: {
+		enumerable: false,
+		writable: false,
+		configurable: false,
+		value: function (delim: string | RegExp, amount?: number): string[] {
+			if (typeof amount !== 'number') amount = 1;
+			const out: string[] = [];
+			let input = this.toString();
+			if (delim instanceof RegExp) delim = new RegExp(delim, delim.flags.replace('g', ''));
+			for (let i = 0; i < amount; i++) {
+				if (delim instanceof RegExp) {
+					const match = input.match(delim);
+					if (!match) return [...out, input];
+					const m = match[0];
+					out.push(input.slice(0, match.index));
+					input = input.slice(match.index + m.length);
+					for (let j = 1; j < match.length; j++) out.push(match[j]);
+				} else {
+					const match = input.indexOf(delim);
+					if (match < 0) return [...out, input];
+					out.push(input.slice(0, match));
+					input = input.slice(match + delim.length);
+				}
+			}
+			out.push(input);
+			return out;
+		}
+	},
+	gsub: {
+		enumerable: false,
+		writable: false,
+		configurable: false,
+		value: function (match: RegExp, replace: string | ((arg: string) => string)): string {
+			// let latestMatch: RegExpExecArray;
+			// do {
+			// 	latestMatch = match.exec()
+			// } while (latestMatch);
+			// TODO
+			return 'FIXME';
+		}
+	},
+});

src/index.ts

@@ -1,6 +1,7 @@
 import * as dotenv from 'dotenv';
 dotenv.config();
 
+import 'globals/prototypes';
 import 'globals';
 
 import PS from 'ps';