@ezez/utils 1.0.0 → 1.2.0

package/esm/isNumericString.js

@@ -0,0 +1,58 @@
+const NOT_FOUND = -1;
+const isNumericString = (string, options = {}) => {
+    if (typeof string !== "string") {
+        throw new TypeError("Expected a string");
+    }
+    if (options.allowNaN && string === "NaN") {
+        return true;
+    }
+    if (options.allowInfinity && (string === "Infinity" || string === "-Infinity")) {
+        return true;
+    }
+    let normalized = string.toLowerCase();
+    if (normalized.startsWith("-")) {
+        normalized = normalized.slice(1);
+    }
+    const parts = normalized.split(".");
+    if (parts.length > (options.allowFloats ? 2 : 1)) {
+        return false;
+    }
+    const expParts = parts[parts.length - 1].split("e");
+    if (!options.allowExponents) {
+        if (expParts.length > 1) {
+            return false;
+        }
+    }
+    else {
+        if (expParts.length > 2) {
+            return false;
+        }
+    }
+    const hasPlusAt = normalized.indexOf("+");
+    if (hasPlusAt > NOT_FOUND) {
+        if (!options.allowExponents) {
+            return false;
+        }
+        if (hasPlusAt !== normalized.lastIndexOf("+")) {
+            return false;
+        }
+        if (hasPlusAt !== normalized.indexOf("e") + 1) {
+            return false;
+        }
+    }
+    const hasMinusAt = normalized.indexOf("-");
+    if (hasMinusAt > NOT_FOUND) {
+        if (!options.allowExponents) {
+            return false;
+        }
+        if (hasMinusAt !== normalized.lastIndexOf("-")) {
+            return false;
+        }
+        if (hasMinusAt !== normalized.indexOf("e") + 1) {
+            return false;
+        }
+    }
+    return Boolean(/^[\de.+-]+$/.exec(normalized));
+};
+export { isNumericString, };
+//# sourceMappingURL=isNumericString.js.map

package/esm/isNumericString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isNumericString.js","sourceRoot":"","sources":["../src/isNumericString.ts"],"names":[],"mappings":"AAOA,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC;AAYrB,MAAM,eAAe,GAAG,CAAC,MAAc,EAAE,UAAmB,EAAE,EAAE,EAAE;IAC9D,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC5B,MAAM,IAAI,SAAS,CAAC,mBAAmB,CAAC,CAAC;KAC5C;IAED,IAAI,OAAO,CAAC,QAAQ,IAAI,MAAM,KAAK,KAAK,EAAE;QACtC,OAAO,IAAI,CAAC;KACf;IAED,IAAI,OAAO,CAAC,aAAa,IAAI,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,WAAW,CAAC,EAAE;QAC5E,OAAO,IAAI,CAAC;KACf;IAED,IAAI,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACtC,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;QAC5B,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACpC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAGpC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;QAC9C,OAAO,KAAK,CAAC;KAChB;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEpD,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE;QACzB,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;YACrB,OAAO,KAAK,CAAC;SAChB;KACJ;SACI;QAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;YACrB,OAAO,KAAK,CAAC;SAChB;KACJ;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,SAAS,GAAG,SAAS,EAAE;QACvB,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE;YACzB,OAAO,KAAK,CAAC;SAChB;QACD,IAAI,SAAS,KAAK,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE;YAC3C,OAAO,KAAK,CAAC;SAChB;QACD,IAAI,SAAS,KAAK,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YAC3C,OAAO,KAAK,CAAC;SAChB;KACJ;IAED,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,UAAU,GAAG,SAAS,EAAE;QACxB,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE;YACzB,OAAO,KAAK,CAAC;SAChB;QACD,IAAI,UAAU,KAAK,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE;YAC5C,OAAO,KAAK,CAAC;SAChB;QACD,IAAI,UAAU,KAAK,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YAC5C,OAAO,KAAK,CAAC;SAChB;KACJ;IAED,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF,OAAO,EACH,eAAe,GAClB,CAAC"}

package/esm/occurrences.d.ts

@@ -0,0 +1,7 @@
+interface Options {
+    overlap?: boolean;
+}
+declare const occurrences: (string: string, search: string, { overlap }?: Options) => number;
+export { occurrences, };
+export type { Options as OccurencesOptions, };
+//# sourceMappingURL=occurrences.d.ts.map

package/esm/occurrences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"occurrences.d.ts","sourceRoot":"","sources":["../src/occurrences.ts"],"names":[],"mappings":"AAAA,UAAU,OAAO;IAIb,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAeD,QAAA,MAAM,WAAW,WAAY,MAAM,UAAU,MAAM,gBAAe,OAAO,WAwBxE,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC;AAEF,YAAY,EACR,OAAO,IAAI,iBAAiB,GAC/B,CAAC"}

package/esm/occurrences.js

@@ -0,0 +1,24 @@
+const NOT_FOUND = -1;
+const occurrences = (string, search, { overlap } = {}) => {
+    if (typeof string !== "string") {
+        throw new TypeError("Expected a string");
+    }
+    if (typeof search !== "string") {
+        throw new TypeError("Expected a string");
+    }
+    if (search.length === 0) {
+        return 0;
+    }
+    let n = 0, i = 0;
+    while (true) {
+        i = string.indexOf(search, i);
+        if (i === NOT_FOUND) {
+            break;
+        }
+        n++;
+        i += overlap ? 1 : search.length;
+    }
+    return n;
+};
+export { occurrences, };
+//# sourceMappingURL=occurrences.js.map

package/esm/occurrences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"occurrences.js","sourceRoot":"","sources":["../src/occurrences.ts"],"names":[],"mappings":"AAOA,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC;AAarB,MAAM,WAAW,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,EAAE,OAAO,KAAc,EAAE,EAAE,EAAE;IAC9E,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC5B,MAAM,IAAI,SAAS,CAAC,mBAAmB,CAAC,CAAC;KAC5C;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC5B,MAAM,IAAI,SAAS,CAAC,mBAAmB,CAAC,CAAC;KAC5C;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;QACrB,OAAO,CAAC,CAAC;KACZ;IACD,IAAI,CAAC,GAAG,CAAC,EACL,CAAC,GAAG,CAAC,CAAC;IAGV,OAAO,IAAI,EAAE;QACT,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAE9B,IAAI,CAAC,KAAK,SAAS,EAAE;YACjB,MAAM;SACT;QACD,CAAC,EAAE,CAAC;QACJ,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;KACpC;IACD,OAAO,CAAC,CAAC;AACb,CAAC,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC"}

package/esm/stripPrefix.d.ts

@@ -0,0 +1,3 @@
+declare const stripPrefix: (from: string, prefix: string) => string;
+export { stripPrefix, };
+//# sourceMappingURL=stripPrefix.d.ts.map

package/esm/stripPrefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripPrefix.d.ts","sourceRoot":"","sources":["../src/stripPrefix.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,WAAW,SAAU,MAAM,UAAU,MAAM,KAAG,MAKnD,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC"}

package/esm/stripPrefix.js

@@ -0,0 +1,8 @@
+const stripPrefix = (from, prefix) => {
+    if (from.startsWith(prefix)) {
+        return from.slice(prefix.length);
+    }
+    return from;
+};
+export { stripPrefix, };
+//# sourceMappingURL=stripPrefix.js.map

package/esm/stripPrefix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripPrefix.js","sourceRoot":"","sources":["../src/stripPrefix.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,MAAc,EAAU,EAAE;IACzD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;KACpC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC"}

package/esm/stripSuffix.d.ts

@@ -0,0 +1,3 @@
+declare const stripSuffix: (from: string, suffix: string) => string;
+export { stripSuffix, };
+//# sourceMappingURL=stripSuffix.d.ts.map

package/esm/stripSuffix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripSuffix.d.ts","sourceRoot":"","sources":["../src/stripSuffix.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,WAAW,SAAU,MAAM,UAAU,MAAM,KAAG,MAKnD,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC"}

package/esm/stripSuffix.js

@@ -0,0 +1,8 @@
+const stripSuffix = (from, suffix) => {
+    if (from.endsWith(suffix)) {
+        return from.slice(0, -suffix.length);
+    }
+    return from;
+};
+export { stripSuffix, };
+//# sourceMappingURL=stripSuffix.js.map

package/esm/stripSuffix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripSuffix.js","sourceRoot":"","sources":["../src/stripSuffix.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,MAAc,EAAU,EAAE;IACzD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;KACxC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ezez/utils",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "repository": "https://github.com/dzek69/bottom-line.git",
   "author": "Jacek Nowacki @dzek69 <git-public@dzek.eu>",
   "license": "MIT",

package/src/ensureDate.spec.ts

@@ -0,0 +1,13 @@
+import { ensureDate } from "./ensureDate.js";
+
+describe("ensureDate", function() {
+    it("should convert timestamps to date instances", function() {
+        ensureDate(123456789).must.be.instanceOf(Date);
+        ensureDate(123456789).getTime().must.equal(123456789);
+    });
+
+    it("should return the same date instance", function() {
+        const date = new Date(123456789);
+        ensureDate(date).must.equal(date);
+    });
+});

package/src/ensureDate.ts

@@ -0,0 +1,18 @@
+/**
+ * Ensure that the date value is a Date instance
+ *
+ * @example ensureDate(123456789); // Date(123456789)
+ * @example ensureDate(new Date(123456789)); // Date(123456789) -- same instance as given
+ * @see {@link ensureTimestamp}
+ * @param {Date | number} date - date value
+ */
+const ensureDate = (date: Date | number): Date => {
+    if (typeof date === "number") {
+        return new Date(date);
+    }
+    return date;
+};
+
+export {
+    ensureDate,
+};

package/src/ensurePrefix.spec.ts

@@ -0,0 +1,11 @@
+import { ensurePrefix } from "./ensurePrefix.js";
+
+describe("ensure prefix", function() {
+    it("adds prefix", function() {
+        ensurePrefix("1234bbcc", "0x").must.equal("0x1234bbcc");
+    });
+
+    it("doesn't add prefix if already present", function() {
+        ensurePrefix("0x1234bbcc", "0x").must.equal("0x1234bbcc");
+    });
+});

package/src/ensurePrefix.ts

@@ -0,0 +1,18 @@
+/**
+ * Add prefix to string if it doesn't already have it
+ *
+ * @example ensurePrefix("1234bbcc", "0x") -> "0x1234bbcc"
+ * @example ensurePrefix("0x1234bbcc", "0x") -> "0x1234bbcc"
+ * @param {string} string - string to add prefix to
+ * @param {string} prefix - prefix to add
+ */
+const ensurePrefix = (string: string, prefix: string) => {
+    if (string.startsWith(prefix)) {
+        return string;
+    }
+    return prefix + string;
+};
+
+export {
+    ensurePrefix,
+};

package/src/ensureSuffix.spec.ts

@@ -0,0 +1,11 @@
+import { ensureSuffix } from "./ensureSuffix.js";
+
+describe("ensure suffix", function() {
+    it("adds suffix to a string", function() {
+        ensureSuffix("hello world", ".").must.equal("hello world.");
+    });
+
+    it("doesn't add suffix if already present", function() {
+        ensureSuffix("hello world.", ".").must.equal("hello world.");
+    });
+});

package/src/ensureSuffix.ts

@@ -0,0 +1,18 @@
+/**
+ * Add suffix to string if it does not already end with it
+ *
+ * @example ensureSuffix("hello world", ".") -> "hello world."
+ * @example ensureSuffix("hello world.", ".") -> "hello world."
+ * @param {string} string - string to add suffix to
+ * @param {string} suffix - suffix to add
+ */
+const ensureSuffix = (string: string, suffix: string) => {
+    if (string.endsWith(suffix)) {
+        return string;
+    }
+    return string + suffix;
+};
+
+export {
+    ensureSuffix,
+};

package/src/ensureTimestamp.spec.ts

@@ -0,0 +1,11 @@
+import { ensureTimestamp } from "./ensureTimestamp.js";
+
+describe("ensure timestamp", function() {
+    it("returns number if number given", function() {
+        ensureTimestamp(123456789).must.equal(123456789);
+    });
+
+    it("returns number if date given", function() {
+        ensureTimestamp(new Date(123456789)).must.equal(123456789);
+    });
+});

package/src/ensureTimestamp.ts

@@ -0,0 +1,18 @@
+/**
+ * Ensures that the given date value is a numeric timestamp.
+ *
+ * @example ensureTimestamp(123456789); // 123456789
+ * @example ensureTimestamp(new Date(123456789)); // 123456789
+ * @see {@link ensureDate}
+ * @param {Date | number} date - date value
+ */
+const ensureTimestamp = (date: Date | number): number => {
+    if (typeof date === "number") {
+        return date;
+    }
+    return date.getTime();
+};
+
+export {
+    ensureTimestamp,
+};

package/src/index.ts

@@ -1,13 +1,18 @@
 /* eslint-disable import/max-dependencies */
+export * from "./ensurePrefix.js";
+export * from "./ensureSuffix.js";
 export * from "./cap.js";
 export * from "./capitalize.js";
 export * from "./coalesce.js";
 export * from "./ensureArray.js";
+export * from "./ensureDate.js";
 export * from "./ensureError.js";
+export * from "./ensureTimestamp.js";
 export * from "./get.js";
 export * from "./getMultiple.js";
 export * from "./insertSeparator.js";
 export * from "./isEmpty.js";
+export * from "./isNumericString.js";
 export * from "./isPlainObject.js";
 export * from "./last.js";
 export * from "./mapAsync.js";
@@ -16,6 +21,7 @@ export * from "./match.js";
 export * from "./merge.js";
 export * from "./mostFrequent.js";
 export * from "./noop.js";
+export * from "./occurrences.js";
 export * from "./omit.js";
 export * from "./pick.js";
 export * from "./pull.js";
@@ -26,6 +32,8 @@ export * from "./seq.js";
 export * from "./set.js";
 export * from "./setImmutable.js";
 export * from "./sortBy.js";
+export * from "./stripPrefix.js";
+export * from "./stripSuffix.js";
 export * from "./throttle.js";
 export * from "./truthy.js";
 export * from "./wait.js";

package/src/isEmpty.ts

@@ -33,7 +33,7 @@ const isEmpty = (obj: unknown) => {
         return true;
     }
     if (typeof obj !== "object") {
-        throw new Error("isEmpty cannot be used on primitives");
+        throw new TypeError("isEmpty cannot be used on primitives");
     }
     if (Array.isArray(obj)) {
         return !Object.keys(obj).length;

package/src/isNumericString.spec.ts

@@ -0,0 +1,100 @@
+import { isNumericString } from "./isNumericString.js";
+
+describe("isNumericString", function() {
+    it("crashes on non-strings", function() {
+        (() => isNumericString(1)).must.throw(TypeError);
+        (() => isNumericString({})).must.throw(TypeError);
+        (() => isNumericString([])).must.throw(TypeError);
+        (() => isNumericString(true)).must.throw(TypeError);
+        (() => isNumericString(() => null)).must.throw(TypeError);
+        (() => isNumericString(null)).must.throw(TypeError);
+        (() => isNumericString([1])).must.throw(TypeError);
+        (() => isNumericString(NaN)).must.throw(TypeError);
+    });
+
+    it("returns true for basic numeric strings", function() {
+        isNumericString("1").must.be.true();
+        isNumericString("0").must.be.true();
+        isNumericString("-1").must.be.true();
+        isNumericString("123").must.be.true();
+    });
+
+    it("only allows floats when requested", function() {
+        isNumericString("1.2", { allowFloats: true }).must.be.true();
+        isNumericString("1.2", { allowFloats: false }).must.be.false();
+        isNumericString("1.2").must.be.false();
+
+        isNumericString(".2", { allowFloats: true }).must.be.true();
+        isNumericString("2.", { allowFloats: true }).must.be.true();
+    });
+
+    it("only allow exponents when requested", function() {
+        isNumericString("1e2", { allowExponents: true }).must.be.true();
+        isNumericString("1e2", { allowExponents: false }).must.be.false();
+        isNumericString("1e2").must.be.false();
+
+        isNumericString("1e+2", { allowExponents: true }).must.be.true();
+        isNumericString("1e-2", { allowExponents: true }).must.be.true();
+        isNumericString("1e2", { allowExponents: true }).must.be.true();
+        isNumericString("1E-2", { allowExponents: true }).must.be.true();
+        isNumericString("1E+2", { allowExponents: true }).must.be.true();
+        isNumericString("1E2", { allowExponents: true }).must.be.true();
+
+        isNumericString("1e+2").must.be.false();
+        isNumericString("1e-2").must.be.false();
+        isNumericString("1e2").must.be.false();
+        isNumericString("1E-2").must.be.false();
+        isNumericString("1E+2").must.be.false();
+        isNumericString("1E2").must.be.false();
+    });
+
+    it("only allows expotents with floats when requested", function() {
+        isNumericString("1.3e2", { allowExponents: true, allowFloats: true }).must.be.true();
+        isNumericString("1.3e2", { allowExponents: false, allowFloats: true }).must.be.false();
+        isNumericString("1.3e2", { allowExponents: true, allowFloats: false }).must.be.false();
+
+        isNumericString(".3e2", { allowExponents: true, allowFloats: true }).must.be.true();
+    });
+
+    it("returns false for non-numeric strings", function() {
+        isNumericString("+5").must.be.false();
+        isNumericString("a").must.be.false();
+        isNumericString("1a").must.be.false();
+        isNumericString("a1").must.be.false();
+        isNumericString("1e").must.be.false();
+        isNumericString("1e-+1").must.be.false();
+        isNumericString("1e+-1").must.be.false();
+        isNumericString("1e--1").must.be.false();
+        isNumericString("1e++1").must.be.false();
+        isNumericString("1e10e2").must.be.false();
+        isNumericString("1.2.3").must.be.false();
+        isNumericString("1.2e3.4").must.be.false();
+        isNumericString("1.2e-3.4").must.be.false();
+        isNumericString("1.2e+3.4").must.be.false();
+        isNumericString("NaN").must.be.false();
+        isNumericString("12e20-2").must.be.false();
+        isNumericString("12e20+2").must.be.false();
+        isNumericString("12+e202").must.be.false();
+        isNumericString("12-e202").must.be.false();
+        isNumericString("1+2e202").must.be.false();
+        isNumericString("1-2e202").must.be.false();
+    });
+
+    it("allows NaN when requeted", function() {
+        isNumericString("NaN", { allowNaN: true }).must.be.true();
+        isNumericString("NaN", { allowNaN: false }).must.be.false();
+
+        isNumericString("-NaN", { allowNaN: false }).must.be.false();
+        isNumericString("+NaN", { allowNaN: false }).must.be.false();
+    });
+
+    it("allows positive and negative Infinity when requested", function() {
+        isNumericString("Infinity", { allowInfinity: true }).must.be.true();
+        isNumericString("Infinity", { allowInfinity: false }).must.be.false();
+        isNumericString("-Infinity", { allowInfinity: true }).must.be.true();
+        isNumericString("-Infinity", { allowInfinity: false }).must.be.false();
+
+        // plus is still not allowed
+        isNumericString("+Infinity", { allowInfinity: true }).must.be.false();
+    });
+});

package/src/isNumericString.ts

@@ -0,0 +1,94 @@
+interface Options {
+    allowFloats?: boolean;
+    allowExponents?: boolean;
+    allowInfinity?: boolean;
+    allowNaN?: boolean;
+}
+
+const NOT_FOUND = -1;
+
+/**
+ * Checks if a string is a numeric string. By default, it allows only integers. Floats and exponents can be enabled with
+ * options. Optionally allow NaN and Infinity.
+ * @param {string} string - String to check
+ * @param {object} [options] - Options object
+ * @param {boolean} [options.allowFloats=false] - Allow floats
+ * @param {boolean} [options.allowExponents=false] - Allow exponents
+ * @param {boolean} [options.allowInfinity=false] - Allow Initity and -Infinity (casing matters)
+ * @param {boolean} [options.allowNaN=false] - Allow NaN (casing matters)
+ */
+const isNumericString = (string: string, options: Options = {}) => { // eslint-disable-line max-statements, max-lines-per-function, max-len
+    if (typeof string !== "string") {
+        throw new TypeError("Expected a string");
+    }
+
+    if (options.allowNaN && string === "NaN") {
+        return true;
+    }
+
+    if (options.allowInfinity && (string === "Infinity" || string === "-Infinity")) {
+        return true;
+    }
+
+    let normalized = string.toLowerCase();
+    if (normalized.startsWith("-")) {
+        normalized = normalized.slice(1);
+    }
+
+    const parts = normalized.split(".");
+
+    // eslint-disable-next-line @typescript-eslint/no-magic-numbers
+    if (parts.length > (options.allowFloats ? 2 : 1)) {
+        return false;
+    }
+
+    const expParts = parts[parts.length - 1].split("e");
+
+    if (!options.allowExponents) {
+        if (expParts.length > 1) {
+            return false;
+        }
+    }
+    else {
+        // eslint-disable-next-line @typescript-eslint/no-magic-numbers
+        if (expParts.length > 2) {
+            return false;
+        }
+    }
+
+    const hasPlusAt = normalized.indexOf("+");
+    if (hasPlusAt > NOT_FOUND) {
+        if (!options.allowExponents) {
+            return false;
+        }
+        if (hasPlusAt !== normalized.lastIndexOf("+")) {
+            return false;
+        }
+        if (hasPlusAt !== normalized.indexOf("e") + 1) {
+            return false;
+        }
+    }
+
+    const hasMinusAt = normalized.indexOf("-");
+    if (hasMinusAt > NOT_FOUND) {
+        if (!options.allowExponents) {
+            return false;
+        }
+        if (hasMinusAt !== normalized.lastIndexOf("-")) {
+            return false;
+        }
+        if (hasMinusAt !== normalized.indexOf("e") + 1) {
+            return false;
+        }
+    }
+
+    return Boolean(/^[\de.+-]+$/.exec(normalized));
+};
+
+export {
+    isNumericString,
+};
+
+export type {
+    Options as IsNumericStringOptions,
+};

package/src/occurrences.spec.ts

@@ -0,0 +1,20 @@
+import { occurrences } from "./occurrences.js";
+
+describe("occurrences", function() {
+    it("returns zero for empty search string", function() {
+        occurrences("test string", "").must.equal(0);
+    });
+
+    it("returns count of occurences for typical use cases", function() {
+        occurrences("hello beautiful world, hello bees and hello sun", "hello").must.equal(3);
+        occurrences("hello beautiful world, hello bees and hello sun", "o").must.equal(4);
+    });
+
+    it("allows counting overlaps too", function() {
+        occurrences("aaaa", "aa", { overlap: true }).must.equal(3);
+        occurrences("aaaa", "aa", { overlap: false }).must.equal(2);
+
+        occurrences("aaaaaa", "aa", { overlap: true }).must.equal(5);
+        occurrences("aaaaaa", "aa", { overlap: false }).must.equal(3);
+    });
+});

package/src/occurrences.ts

@@ -0,0 +1,53 @@
+interface Options {
+    /**
+     * Allow overlapping matches, ie. "aa" in "aaa" will return 2 instead of 1
+     */
+    overlap?: boolean;
+}
+
+const NOT_FOUND = -1;
+
+/**
+ * Count the number of occurrences of a substring in a string
+ *
+ * @example occurrences("aaa", "a"); // 3
+ * @example occurrences("aaaa", "aa", { overlap: false }); // 2
+ * @example occurrences("aaaa", "aa", { overlap: true }); // 3
+ * @param {string} string - string to search in
+ * @param {string} search - string to search for
+ * @param {object} [options] - options
+ * @param {boolean} [options.overlap=false] - allow overlapping matches, ie "aa" in "aaa" will return 2 instead of 1
+ */
+const occurrences = (string: string, search: string, { overlap }: Options = {}) => {
+    if (typeof string !== "string") {
+        throw new TypeError("Expected a string");
+    }
+    if (typeof search !== "string") {
+        throw new TypeError("Expected a string");
+    }
+    if (search.length === 0) {
+        return 0;
+    }
+    let n = 0,
+        i = 0;
+
+    // eslint-disable-next-line no-constant-condition,@typescript-eslint/no-unnecessary-condition
+    while (true) {
+        i = string.indexOf(search, i);
+
+        if (i === NOT_FOUND) {
+            break;
+        }
+        n++;
+        i += overlap ? 1 : search.length;
+    }
+    return n;
+};
+
+export {
+    occurrences,
+};
+
+export type {
+    Options as OccurencesOptions,
+};

package/src/stripPrefix.spec.ts

@@ -0,0 +1,13 @@
+import { stripPrefix } from "./stripPrefix.js";
+
+describe("strip prefix", function() {
+    it("should strip prefix if string has it", function() {
+        stripPrefix("abc", "a").must.equal("bc");
+        stripPrefix("hello world", "hello").must.equal(" world");
+    });
+
+    it("should keep the string as it is when string don't have specified prefix", function() {
+        stripPrefix("abc", "b").must.equal("abc");
+        stripPrefix("hello world", "world").must.equal("hello world");
+    });
+});

package/src/stripPrefix.ts

@@ -0,0 +1,15 @@
+/**
+ * Strip a prefix from a string.
+ * @param {string} from - string to strip prefix from
+ * @param {string} prefix - prefix to strip
+ */
+const stripPrefix = (from: string, prefix: string): string => {
+    if (from.startsWith(prefix)) {
+        return from.slice(prefix.length);
+    }
+    return from;
+};
+
+export {
+    stripPrefix,
+};

package/src/stripSuffix.spec.ts

@@ -0,0 +1,13 @@
+import { stripSuffix } from "./stripSuffix.js";
+
+describe("strip suffix", function() {
+    it("should strip suffix if string has it", function() {
+        stripSuffix("abc", "c").must.equal("ab");
+        stripSuffix("hello world", "world").must.equal("hello ");
+    });
+
+    it("should keep the string as it is when string don't have specified suffix", function() {
+        stripSuffix("abc", "b").must.equal("abc");
+        stripSuffix("hello world", "hello").must.equal("hello world");
+    });
+});