@almighty-shogun/prototype-extensions 1.0.1

package/README.md

@@ -0,0 +1,27 @@
+# Prototype Extensions
+
+A small package that adds extensions to existing prototypes like string, array, etc.
+
+## 📃 Prerequisites
+- **[Node.js](https://nodejs.org/en/)**: >= v23.11.1
+
+## 💻 Installation
+
+### Step 1
+Install the package using your package manager of choice.
+```shell
+bun add @almighty-shogun/prototype-extensions
+yarn add @almighty-shogun/prototype-extensions
+npm install @almighty-shogun/prototype-extensions
+pnpm install @almighty-shogun/prototype-extensions
+```
+
+### Step 2
+Import the package in the main file of your project.
+```ts
+import '@almighty-shogun/prototype-extensions'
+```
+
+## 📦 Building
+- Use the command `bun install` in the root directory to install the required dependencies.
+- Run `bun --cwd packages/prototype-extensions build` to build the package.

package/dist/array.d.ts

@@ -0,0 +1,12 @@
+declare global {
+    interface Array<T> {
+        first(): T;
+        last(): T;
+        delete(index: number): T[];
+        removeDuplicates(this: Array<string | number>): (string | number)[];
+        addOrRemove(this: Array<string | number>, value: string | number): (string | number)[];
+        isEmpty(): boolean;
+    }
+}
+export {};
+//# sourceMappingURL=array.d.ts.map

package/dist/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../src/array.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,KAAK,CAAC,CAAC;QACb,KAAK,IAAI,CAAC,CAAC;QACX,IAAI,IAAI,CAAC,CAAC;QACV,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,GAAC,MAAM,CAAC,EAAE,CAAC;QAClE,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAC,MAAM,CAAC,EAAE,CAAC;QAErF,OAAO,IAAI,OAAO,CAAC;KACtB;CACJ;AA8BD,OAAO,EAAE,CAAC"}

package/dist/array.js

@@ -0,0 +1,22 @@
+Array.prototype.first = function () {
+    return this[0];
+};
+Array.prototype.last = function () {
+    return this[this.length - 1];
+};
+Array.prototype.delete = function (index) {
+    return this.toSpliced(index, 1);
+};
+Array.prototype.removeDuplicates = function () {
+    return Array.from(new Set(this).values());
+};
+Array.prototype.addOrRemove = function (value) {
+    if (this.includes(value)) {
+        return this.delete(this.indexOf(value));
+    }
+    return [...this, value];
+};
+Array.prototype.isEmpty = function () {
+    return this.length === 0;
+};
+export {};

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import './array';
+import './string';
+import './number';
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,CAAA;AAChB,OAAO,UAAU,CAAA;AACjB,OAAO,UAAU,CAAA;AAEjB,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+import './array';
+import './string';
+import './number';

package/dist/number.d.ts

@@ -0,0 +1,8 @@
+declare global {
+    interface Number {
+        equals(value: number): boolean;
+        isInRange(min: number, max: number): boolean;
+    }
+}
+export {};
+//# sourceMappingURL=number.d.ts.map

package/dist/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../src/number.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAC/B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KAChD;CACJ;AAUD,OAAO,EAAE,CAAC"}

package/dist/number.js

@@ -0,0 +1,7 @@
+Number.prototype.equals = function (value) {
+    return this === value;
+};
+Number.prototype.isInRange = function (min, max) {
+    return this >= min && this <= max;
+};
+export {};

package/dist/string.d.ts

@@ -0,0 +1,12 @@
+declare global {
+    interface String {
+        toSlug(): string;
+        append(value: string): string;
+        limit(length: number, appending: string | null): string;
+        toNumber(): number;
+        isEmpty(): boolean;
+        equals(value: string): boolean;
+    }
+}
+export {};
+//# sourceMappingURL=string.d.ts.map

package/dist/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,MAAM,IAAI,MAAM,CAAC;QACjB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAC9B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAC,IAAI,GAAG,MAAM,CAAC;QAEtD,QAAQ,IAAI,MAAM,CAAC;QACnB,OAAO,IAAI,OAAO,CAAC;QACnB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;KAClC;CACJ;AA6BD,OAAO,EAAE,CAAC"}

package/dist/string.js

@@ -0,0 +1,22 @@
+String.prototype.toSlug = function () {
+    return this.trim().toLowerCase()
+        .replace(/[^\w\s-]+/g, "")
+        .replace(/[\s_-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+};
+String.prototype.toNumber = function () {
+    return Number(this);
+};
+String.prototype.isEmpty = function () {
+    return this.length === 0;
+};
+String.prototype.equals = function (value) {
+    return this === value;
+};
+String.prototype.append = function (value) {
+    return this + value;
+};
+String.prototype.limit = function (length, appending = null) {
+    return this.length > length ? this.substring(0, length) + appending : this;
+};
+export {};

package/package.json

@@ -0,0 +1,38 @@
+{
+    "name": "@almighty-shogun/prototype-extensions",
+    "description": "A small package that adds extensions to existing prototypes like string, array, etc.",
+    "version": "1.0.1",
+    "type": "module",
+    "license": "MIT",
+    "scripts": {
+        "build": "tsc"
+    },
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    },
+    "author": {
+        "name": "Almighty-Shogun",
+        "email": "alm1ghtyshogun1998@gmail.com",
+        "url": "https://shogun.ms"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/Almighty-Shogun/packages.git",
+        "directory": "packages/prototype-extensions"
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "typings": "./dist/index.d.ts",
+    "sideEffects": false,
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "src",
+        "dist"
+    ]
+}

package/src/array.ts

@@ -0,0 +1,41 @@
+declare global {
+    interface Array<T> {
+        first(): T;
+        last(): T;
+        delete(index: number): T[];
+        removeDuplicates(this: Array<string | number>): (string|number)[];
+        addOrRemove(this: Array<string | number>, value: string | number): (string|number)[];
+
+        isEmpty(): boolean;
+    }
+}
+
+Array.prototype.first = function<T> (this: T[]): T {
+    return this[0];
+}
+
+Array.prototype.last = function<T> (this: T[]): T {
+    return this[this.length - 1];
+}
+
+Array.prototype.delete = function<T> (this: T[], index: number): T[] {
+    return this.toSpliced(index, 1);
+}
+
+Array.prototype.removeDuplicates = function (this: (string|number)[]): (string|number)[] {
+    return Array.from(new Set(this).values());
+}
+
+Array.prototype.addOrRemove = function (this: (string|number)[], value: string|number): (string|number)[] {
+    if (this.includes(value)) {
+        return this.delete(this.indexOf(value));
+    }
+
+    return [...this, value];
+}
+
+Array.prototype.isEmpty = function<T> (this: T[]): boolean {
+    return this.length === 0;
+}
+
+export {};

package/src/index.ts

@@ -0,0 +1,5 @@
+import './array'
+import './string'
+import './number'
+
+export {};

package/src/number.ts

@@ -0,0 +1,16 @@
+declare global {
+    interface Number {
+        equals(value: number): boolean;
+        isInRange(min: number, max: number): boolean;
+    }
+}
+
+Number.prototype.equals = function (this: number, value: number): boolean {
+    return this === value;
+}
+
+Number.prototype.isInRange = function (this: number, min: number, max: number): boolean {
+    return this >= min && this <= max;
+}
+
+export {};

package/src/string.ts

@@ -0,0 +1,40 @@
+declare global {
+    interface String {
+        toSlug(): string;
+        append(value: string): string;
+        limit(length: number, appending: string|null): string;
+
+        toNumber(): number;
+        isEmpty(): boolean;
+        equals(value: string): boolean;
+    }
+}
+
+String.prototype.toSlug = function (this: string): string {
+    return this.trim().toLowerCase()
+        .replace(/[^\w\s-]+/g, "")
+        .replace(/[\s_-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+
+String.prototype.toNumber = function (this: string): number {
+    return Number(this);
+}
+
+String.prototype.isEmpty = function (this: string): boolean {
+    return this.length === 0;
+}
+
+String.prototype.equals = function (this: string, value: string): boolean {
+    return this === value;
+}
+
+String.prototype.append = function (this: string, value: string): string {
+    return this + value;
+}
+
+String.prototype.limit = function (this: string, length: number, appending: string|null = null): string {
+    return this.length > length ? this.substring(0, length) + appending : this;
+}
+
+export {};