http proof of concept api

3 files changed, 47 insertions, 8 deletions

diff --git a/util/array.ts b/util/array.ts
index 76e2a9e..5b8c512 100644
--- a/util/array.ts
+++ b/util/array.ts
@@ -1,17 +1,23 @@
 declare global {
 	interface Array<T> {
+		/** @summary check if any of the elements of `arr2` are included in `this` */
 		anyOf(arr2: Array<T>): boolean;
+		/** @summary return last element of array without removing it */
 		peek(): T;
+		/** @summary create Set from this array */
+		set(): Set<T>;
 	}
 }
 
-/** @summary check if any of the elements of `arr2` are included in `this` */
 Array.prototype.anyOf = function(arr2) {
 	return !!this.filter(e => arr2.includes(e)).length;
 };
 
-/** @summary return last element of array without removing it */
 Array.prototype.peek = function() {
 	return this[this.length - 1];
 };
 
+Array.prototype.set = function() {
+	return new Set(this);
+}
+
diff --git a/util/set.ts b/util/set.ts
index 9790682..1b4eb19 100644
--- a/util/set.ts
+++ b/util/set.ts
@@ -1,16 +1,16 @@
 declare global {
 	interface Set<T> {
+		/** @summary check if any of the elements of `arr2` are included in `this` */
 		anyOf(arr2: Array<T>): boolean;
+		/** @summary return set items as array */
 		arr(): Array<T>;
 	}
 }
 
-/** @summary return set items as array */
 Set.prototype.arr = function() {
 	return Array.from(this);
 }
 
-/** @summary check if any of the elements of `arr2` are included in `this` */
 Set.prototype.anyOf = function(arr2) {
 	return !!this.arr().filter(e => arr2.includes(e)).length;
 };
diff --git a/util/string.ts b/util/string.ts
index e0cc5eb..16d8f0a 100644
--- a/util/string.ts
+++ b/util/string.ts
@@ -4,12 +4,33 @@ import JapaneseString from "../language/japanese.ts";
 declare global {
 	/** @summary extended String prototype functions */
 	interface String {
+		/** @summary get UnicodeRange for character at index 0 */
 		range(): UnicodeRange;
+		/** @summary create a RangeTally object for counting used unicode ranges in string */
 		rangeTally(): RangeTally;
 
+		/** @summary get JapaneseString from this string */
 		jp(): JapaneseString;
 
+		/** @summary parse concatenated tag string to TokenTags */
 		parseTags(): TokenTags;
+
+		/**
+		 * @summary Remove all instances of a substring in a string, using a regular expression or search string
+		 * @param searchValue  A string to search for
+		 */
+		removeAll(searchValue: string | RegExp): string;
+
+		/**
+		 * @summary parse string as JSON, with optional fallback value
+		 *
+		 * fallback is undefined by default. if fallback is specified, it will be
+		 * returned if JSON.parse throws any error. if fallback is not specified,
+		 * no errors will be caught.
+		 *
+		 * @argument fallback  return this value if parsing fails
+		 */
+		json(fallback?: any): any;
 	}
 }
 
@@ -27,7 +48,6 @@ export enum UnicodeRange {
 
 type RangeTally = Record<UnicodeRange, number>;
 
-/** @summary get UnicodeRange for character at index 0 */
 String.prototype.range = function() {
 	var code = this.charCodeAt(0);
 
@@ -46,20 +66,33 @@ String.prototype.range = function() {
 	return UnicodeRange.Unknown;
 }
 
-/** @summary create a RangeTally object for counting used unicode ranges in string */
 String.prototype.rangeTally = function() {
 	var tally = Object.keys(UnicodeRange).reduce((a: any,c) => (a[c] = 0, a), {}) as RangeTally;
 	for (var char of this) tally[char.range()]++;
 	return tally;
 };
 
-/** @summary get JapaneseString from this string */
 String.prototype.jp = function() {
 	return new JapaneseString(this);
 }
 
-/** @summary parse concatenated tag string to TokenTags */
 String.prototype.parseTags = function() {
 	return parseTags(this as string);
 }
 
+String.prototype.removeAll = function(searchValue: string | RegExp) {
+	return this.replaceAll(searchValue, "");
+}
+
+String.prototype.json = function(fallback?: any) {
+	if (fallback) {
+		try {
+			return JSON.parse(this as string);
+		} catch {
+			return fallback;
+		}
+	} else {
+		return JSON.parse(this as string);
+	}
+}
+