tiny-essentials 1.8.3 → 1.8.5

package/dist/legacy/libs/percentage.cjs

@@ -1,7 +1,5 @@
 'use strict';
 
-// @ts-nocheck
-
 /**
  * Simple utility to calculate percentage values.
  * @namespace percentageBase

package/dist/legacy/libs/percentage.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Simple utility to calculate percentage values.
  * @namespace percentageBase

package/dist/legacy/libs/regex/getLetter.cjs

@@ -1,7 +1,5 @@
 'use strict';
 
-// @ts-nocheck
-
 /**
  * Matches exactly one letter (lowercase or uppercase).
  * @param {string} [type='g'] - The flag for the regular expression (default is 'g').

package/dist/legacy/libs/regex/getLetter.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Matches exactly one letter (lowercase or uppercase).
  * @param {string} [type='g'] - The flag for the regular expression (default is 'g').

package/dist/legacy/libs/rule3.cjs

@@ -1,7 +1,5 @@
 'use strict';
 
-// @ts-nocheck
-
 /**
  * Rule of Three utility.
  * Performs direct or inverse proportional calculation.

package/dist/legacy/libs/rule3.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Rule of Three utility.
  * Performs direct or inverse proportional calculation.

package/dist/legacy/momentjs/getAge.cjs

@@ -2,9 +2,6 @@
 
 var moment = require('moment');
 
-// @ts-nocheck
-
-
 /**
  * Calculates the age based on the given date.
  *

package/dist/legacy/momentjs/getAge.d.mts

@@ -6,4 +6,5 @@
  * @returns {number|null} The age in years, or null if `timeData` is not provided.
  */
 export default function getAge(timeData?: number | string, now?: moment.Moment | null): number | null;
+import moment from 'moment';
 //# sourceMappingURL=getAge.d.mts.map

package/dist/legacy/momentjs/getAge.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 import moment from 'moment';
 /**
  * Calculates the age based on the given date.

package/dist/legacy/momentjs/index.cjs

@@ -3,7 +3,7 @@
 var timeDuration = require('./timeDuration.cjs');
 var getAge = require('./getAge.cjs');
 
-// @ts-nocheck
+
 
 exports.timeDuration = timeDuration;
 exports.getAge = getAge;

package/dist/legacy/momentjs/index.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 import timeDuration from './timeDuration.mjs';
 import getAge from './getAge.mjs';
 export { timeDuration, getAge };

package/dist/legacy/momentjs/timeDuration.cjs

@@ -2,9 +2,6 @@
 
 var moment = require('moment');
 
-// @ts-nocheck
-
-
 /**
  * Calculates the time duration between the current time and a given time offset.
  *
@@ -19,6 +16,7 @@ function timeDuration(timeData = 0, durationType = 'asSeconds', now = null) {
     if (!now) now = moment();
 
     var duration = moment.duration(now.clone().add(timeData, 'milliseconds').diff(now.clone()));
+    // @ts-ignore
     const result = duration[durationType]();
 
     // Complete

package/dist/legacy/momentjs/timeDuration.d.mts

@@ -7,4 +7,5 @@
  * @returns {number|null} The calculated duration in the specified unit (default: seconds), or `null` if `timeData` is not provided.
  */
 export default function timeDuration(timeData?: number, durationType?: string, now?: moment.Moment | null): number | null;
+import moment from 'moment';
 //# sourceMappingURL=timeDuration.d.mts.map

package/dist/legacy/momentjs/timeDuration.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 import moment from 'moment';
 /**
  * Calculates the time duration between the current time and a given time offset.
@@ -14,6 +13,7 @@ export default function timeDuration(timeData = 0, durationType = 'asSeconds', n
         if (!now)
             now = moment();
         var duration = moment.duration(now.clone().add(timeData, 'milliseconds').diff(now.clone()));
+        // @ts-ignore
         const result = duration[durationType]();
         // Complete
         return result;

package/dist/legacy/socket.io/antiFlood/index.cjs

@@ -3,7 +3,7 @@
 var install = require('./install.cjs');
 var verify = require('./verify.cjs');
 
-// @ts-nocheck
+
 
 exports.install = install;
 exports.verify = verify;

package/dist/legacy/socket.io/antiFlood/index.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 import install from './install.mjs';
 import verify from './verify.mjs';
 export { verify, install };

package/dist/legacy/socket.io/antiFlood/install.cjs

@@ -2,21 +2,19 @@
 
 var userIP = require('../../http/userIP.cjs');
 
-// @ts-nocheck
-
-
 /**
  * Installs the authorization middleware for socket connections.
  *
  * This middleware checks the user's IP address and allows or denies the socket connection based on whether
  * the IP is in the block list or not.
  *
- * @param {Record<string, any>} io - The Socket.IO server instance.
- * @param {Record<string, any>} ioCache - The cache object containing blocked IPs.
+ * @param {*} io - The Socket.IO server instance.
+ * @param {Object} ioCache - The cache object containing blocked IPs.
  * @param {Array<*>} ioCache.blocklick - The list of blocked IP addresses.
  * @returns {void} This function does not return a value, it just sets the authorization logic for socket connections.
  */
 function install(io, ioCache) {
+  // @ts-ignore
   io.set('authorization', function (socket, callback) {
     // Get User IP
     const ip = userIP(socket.handshake);

package/dist/legacy/socket.io/antiFlood/install.d.mts

@@ -4,10 +4,12 @@
  * This middleware checks the user's IP address and allows or denies the socket connection based on whether
  * the IP is in the block list or not.
  *
- * @param {Record<string, any>} io - The Socket.IO server instance.
- * @param {Record<string, any>} ioCache - The cache object containing blocked IPs.
+ * @param {*} io - The Socket.IO server instance.
+ * @param {Object} ioCache - The cache object containing blocked IPs.
  * @param {Array<*>} ioCache.blocklick - The list of blocked IP addresses.
  * @returns {void} This function does not return a value, it just sets the authorization logic for socket connections.
  */
-export default function install(io: Record<string, any>, ioCache: Record<string, any>): void;
+export default function install(io: any, ioCache: {
+    blocklick: Array<any>;
+}): void;
 //# sourceMappingURL=install.d.mts.map

package/dist/legacy/socket.io/antiFlood/install.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 import userIp from '../../http/userIP.mjs';
 /**
  * Installs the authorization middleware for socket connections.
@@ -6,12 +5,13 @@ import userIp from '../../http/userIP.mjs';
  * This middleware checks the user's IP address and allows or denies the socket connection based on whether
  * the IP is in the block list or not.
  *
- * @param {Record<string, any>} io - The Socket.IO server instance.
- * @param {Record<string, any>} ioCache - The cache object containing blocked IPs.
+ * @param {*} io - The Socket.IO server instance.
+ * @param {Object} ioCache - The cache object containing blocked IPs.
  * @param {Array<*>} ioCache.blocklick - The list of blocked IP addresses.
  * @returns {void} This function does not return a value, it just sets the authorization logic for socket connections.
  */
 export default function install(io, ioCache) {
+    // @ts-ignore
     io.set('authorization', function (socket, callback) {
         // Get User IP
         const ip = userIp(socket.handshake);

package/dist/legacy/socket.io/antiFlood/verify.cjs

@@ -2,10 +2,14 @@
 
 var userIP = require('../../http/userIP.cjs');
 
-// @ts-nocheck
+/** @typedef {Record<string, { timeout: number, tries: number }>} FloodTimeout */
 
+/**
+ * Panel
+ *
+ * @type {FloodTimeout}
+ */
 
-// Panel
 const floodPanel = {};
 
 /**
@@ -27,14 +31,14 @@ setInterval(function () {
  * If the attempts exceed a threshold, the IP is temporarily banned and disconnected.
  *
  * @param {Record<string, any>} socket - The socket object representing the connection.
- * @param {Record<string, any>} ioCache - The cache object that holds the blocklist and flood panel data.
+ * @param {Object} ioCache - The cache object that holds the blocklist and flood panel data.
  * @param {Array<*>} ioCache.blocklick - The list of blocked IPs.
- * @param {Record<string, any>} floodPanel - The object tracking flooding attempts and timeouts for each IP.
  * @returns {void} This function does not return anything, it modifies the floodPanel and blocklist.
  */
 function verify(socket, ioCache) {
   // Get User IP
-  const ip = userIP(socket.handshake);
+  const ipData = userIP(socket.handshake);
+  const ip = ipData.value ? ipData.value[0] : '';
 
   /**
    * Verifies the IP for flooding attempts and manages timeout and blocklist.
@@ -71,7 +75,7 @@ function verify(socket, ioCache) {
 
   // Catch-all Event Listener
   var onevent = socket.onevent;
-  socket.onevent = function (packet) {
+  socket.onevent = function (/** @type {{ data: string[]; }} */ packet) {
     var args = packet.data || [];
     onevent.call(this, packet); // original call
     packet.data = ['*'].concat(args);

package/dist/legacy/socket.io/antiFlood/verify.d.mts

@@ -5,10 +5,15 @@
  * If the attempts exceed a threshold, the IP is temporarily banned and disconnected.
  *
  * @param {Record<string, any>} socket - The socket object representing the connection.
- * @param {Record<string, any>} ioCache - The cache object that holds the blocklist and flood panel data.
+ * @param {Object} ioCache - The cache object that holds the blocklist and flood panel data.
  * @param {Array<*>} ioCache.blocklick - The list of blocked IPs.
- * @param {Record<string, any>} floodPanel - The object tracking flooding attempts and timeouts for each IP.
  * @returns {void} This function does not return anything, it modifies the floodPanel and blocklist.
  */
-export default function verify(socket: Record<string, any>, ioCache: Record<string, any>): void;
+export default function verify(socket: Record<string, any>, ioCache: {
+    blocklick: Array<any>;
+}): void;
+export type FloodTimeout = Record<string, {
+    timeout: number;
+    tries: number;
+}>;
 //# sourceMappingURL=verify.d.mts.map

package/dist/legacy/socket.io/antiFlood/verify.mjs

@@ -1,6 +1,10 @@
-// @ts-nocheck
 import userIp from '../../http/userIP.mjs';
-// Panel
+/** @typedef {Record<string, { timeout: number, tries: number }>} FloodTimeout */
+/**
+ * Panel
+ *
+ * @type {FloodTimeout}
+ */
 const floodPanel = {};
 /**
  * Periodically decrements the timeout for each IP in the flood panel and removes expired entries.
@@ -21,14 +25,14 @@ setInterval(function () {
  * If the attempts exceed a threshold, the IP is temporarily banned and disconnected.
  *
  * @param {Record<string, any>} socket - The socket object representing the connection.
- * @param {Record<string, any>} ioCache - The cache object that holds the blocklist and flood panel data.
+ * @param {Object} ioCache - The cache object that holds the blocklist and flood panel data.
  * @param {Array<*>} ioCache.blocklick - The list of blocked IPs.
- * @param {Record<string, any>} floodPanel - The object tracking flooding attempts and timeouts for each IP.
  * @returns {void} This function does not return anything, it modifies the floodPanel and blocklist.
  */
 export default function verify(socket, ioCache) {
     // Get User IP
-    const ip = userIp(socket.handshake);
+    const ipData = userIp(socket.handshake);
+    const ip = ipData.value ? ipData.value[0] : '';
     /**
      * Verifies the IP for flooding attempts and manages timeout and blocklist.
      */
@@ -59,7 +63,7 @@ export default function verify(socket, ioCache) {
     }
     // Catch-all Event Listener
     var onevent = socket.onevent;
-    socket.onevent = function (packet) {
+    socket.onevent = function (/** @type {{ data: string[]; }} */ packet) {
         var args = packet.data || [];
         onevent.call(this, packet); // original call
         packet.data = ['*'].concat(args);

package/dist/legacy/socket.io/cookie-session.cjs

@@ -1,7 +1,5 @@
 'use strict';
 
-// @ts-nocheck
-
 /**
  * Handles the cookie session for a socket connection by simulating an Express request and response.
  * This function uses the provided session module to manage session data for the socket connection.
@@ -13,6 +11,7 @@
 function cookieSession(socket, sessionModule) {
   return new Promise((resolve) => {
     // Express Simulator
+    /** @type {Record<*,*>} */
     let req = {
       connection: { encrypted: false },
       headers: { cookie: socket.request.headers.cookie },

package/dist/legacy/socket.io/cookie-session.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Handles the cookie session for a socket connection by simulating an Express request and response.
  * This function uses the provided session module to manage session data for the socket connection.
@@ -10,6 +9,7 @@
 export default function cookieSession(socket, sessionModule) {
     return new Promise((resolve) => {
         // Express Simulator
+        /** @type {Record<*,*>} */
         let req = {
             connection: { encrypted: false },
             headers: { cookie: socket.request.headers.cookie },

package/dist/legacy/socket.io/discord.cjs

@@ -2,9 +2,6 @@
 
 var getUser = require('../firebase/discord/api/getUser.cjs');
 
-// @ts-nocheck
-
-
 /**
  * Handles the Discord OAuth2 authentication for a user, stores user data in an in-memory cache,
  * and manages the user's socket connection and disconnection events.

package/dist/legacy/socket.io/discord.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 import getUser from '../firebase/discord/api/getUser.mjs';
 /**
  * Handles the Discord OAuth2 authentication for a user, stores user data in an in-memory cache,

package/dist/legacy/socket.io/index.cjs

@@ -4,9 +4,6 @@ var index = require('./antiFlood/index.cjs');
 var discord = require('./discord.cjs');
 var cookieSession = require('./cookie-session.cjs');
 
-// @ts-nocheck
-
-
 const socketIo = {
   antiFlood: index,
   'cookie-session': cookieSession,

package/dist/legacy/socket.io/index.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 import * as antiFlood from './antiFlood/index.mjs';
 import discord from './discord.mjs';
 import cookieSession from './cookie-session.mjs';

package/dist/v1/basics/index.cjs

@@ -1,5 +1,6 @@
 'use strict';
 
+var arraySortPositions = require('../../legacy/libs/arraySortPositions.cjs');
 var replaceAsync = require('../../legacy/libs/replaceAsync.cjs');
 var array = require('./array.cjs');
 var clock = require('./clock.cjs');
@@ -9,6 +10,7 @@ var text = require('./text.cjs');
 
 
 
+exports.arraySortPositions = arraySortPositions;
 exports.asyncReplace = replaceAsync;
 exports.shuffleArray = array.shuffleArray;
 exports.formatCustomTimer = clock.formatCustomTimer;
@@ -20,6 +22,7 @@ exports.countObj = objFilter.countObj;
 exports.extendObjType = objFilter.extendObjType;
 exports.objType = objFilter.objType;
 exports.reorderObjTypeOrder = objFilter.reorderObjTypeOrder;
+exports.formatBytes = simpleMath.formatBytes;
 exports.getAge = simpleMath.getAge;
 exports.getSimplePerc = simpleMath.getSimplePerc;
 exports.ruleOfThree = simpleMath.ruleOfThree;

package/dist/v1/basics/index.d.mts

@@ -1,3 +1,5 @@
+import arraySortPositions from '../../legacy/libs/arraySortPositions.mjs';
+import { formatBytes } from './simpleMath.mjs';
 import { addAiMarkerShortcut } from './text.mjs';
 import { extendObjType } from './objFilter.mjs';
 import { reorderObjTypeOrder } from './objFilter.mjs';
@@ -15,5 +17,5 @@ import { getTimeDuration } from './clock.mjs';
 import { shuffleArray } from './array.mjs';
 import { toTitleCase } from './text.mjs';
 import { toTitleCaseLowerFirst } from './text.mjs';
-export { addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+export { arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
 //# sourceMappingURL=index.d.mts.map

package/dist/v1/basics/index.mjs

@@ -1,7 +1,8 @@
+import arraySortPositions from '../../legacy/libs/arraySortPositions.mjs';
 import asyncReplace from '../../legacy/libs/replaceAsync.mjs';
 import { shuffleArray } from './array.mjs';
 import { formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration } from './clock.mjs';
 import { countObj, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, } from './objFilter.mjs';
-import { getAge, getSimplePerc, ruleOfThree } from './simpleMath.mjs';
+import { formatBytes, getAge, getSimplePerc, ruleOfThree } from './simpleMath.mjs';
 import { addAiMarkerShortcut, toTitleCase, toTitleCaseLowerFirst } from './text.mjs';
-export { addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+export { arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/dist/v1/index.cjs

@@ -2,6 +2,7 @@
 
 var replaceAsync = require('../legacy/libs/replaceAsync.cjs');
 var userLevel = require('../legacy/libs/userLevel.cjs');
+var arraySortPositions = require('../legacy/libs/arraySortPositions.cjs');
 var array = require('./basics/array.cjs');
 var clock = require('./basics/clock.cjs');
 var objFilter = require('./basics/objFilter.cjs');
@@ -14,6 +15,7 @@ var TinyPromiseQueue = require('./libs/TinyPromiseQueue.cjs');
 
 exports.asyncReplace = replaceAsync;
 exports.TinyLevelUp = userLevel;
+exports.arraySortPositions = arraySortPositions;
 exports.shuffleArray = array.shuffleArray;
 exports.formatCustomTimer = clock.formatCustomTimer;
 exports.formatDayTimer = clock.formatDayTimer;
@@ -25,6 +27,7 @@ exports.countObj = objFilter.countObj;
 exports.extendObjType = objFilter.extendObjType;
 exports.objType = objFilter.objType;
 exports.reorderObjTypeOrder = objFilter.reorderObjTypeOrder;
+exports.formatBytes = simpleMath.formatBytes;
 exports.getAge = simpleMath.getAge;
 exports.getSimplePerc = simpleMath.getSimplePerc;
 exports.ruleOfThree = simpleMath.ruleOfThree;

package/dist/v1/index.d.mts

@@ -1,6 +1,8 @@
 import ColorSafeStringify from './libs/ColorSafeStringify.mjs';
 import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
 import TinyLevelUp from '../legacy/libs/userLevel.mjs';
+import arraySortPositions from '../legacy/libs/arraySortPositions.mjs';
+import { formatBytes } from './basics/simpleMath.mjs';
 import { addAiMarkerShortcut } from './basics/text.mjs';
 import { extendObjType } from './basics/objFilter.mjs';
 import { reorderObjTypeOrder } from './basics/objFilter.mjs';
@@ -19,5 +21,5 @@ import { getTimeDuration } from './basics/clock.mjs';
 import { shuffleArray } from './basics/array.mjs';
 import { toTitleCase } from './basics/text.mjs';
 import { toTitleCaseLowerFirst } from './basics/text.mjs';
-export { ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+export { ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
 //# sourceMappingURL=index.d.mts.map

package/dist/v1/index.mjs

@@ -1,10 +1,11 @@
 import asyncReplace from '../legacy/libs/replaceAsync.mjs';
 import TinyLevelUp from '../legacy/libs/userLevel.mjs';
+import arraySortPositions from '../legacy/libs/arraySortPositions.mjs';
 import { shuffleArray } from './basics/array.mjs';
 import { formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, } from './basics/clock.mjs';
 import { countObj, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, checkObj, } from './basics/objFilter.mjs';
-import { getAge, getSimplePerc, ruleOfThree } from './basics/simpleMath.mjs';
+import { formatBytes, getAge, getSimplePerc, ruleOfThree } from './basics/simpleMath.mjs';
 import { addAiMarkerShortcut, toTitleCase, toTitleCaseLowerFirst } from './basics/text.mjs';
 import ColorSafeStringify from './libs/ColorSafeStringify.mjs';
 import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
-export { ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+export { ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/docs/basics/array.md

@@ -44,3 +44,64 @@ You can find the original discussion here:
 
 - **items** — An array of strings to shuffle.
 - **Returns** — The same array instance, but now shuffled.
+
+---
+
+# 📦 `arraySortPositions`
+
+🔧 **Generates a comparator function** to sort an array of objects by a specified key, with optional reverse order.
+
+---
+
+## 📌 Function Signature
+
+```js
+arraySortPositions(item: string, isReverse?: boolean): (a: Object<string|number, *>, b: Object<string|number, *>) => number
+```
+
+---
+
+## 🧠 Parameters
+
+| Name        | Type      | Default | Description                                                |
+| ----------- | --------- | ------- | ---------------------------------------------------------- |
+| `item`      | `string`  | —       | 🔑 The key to sort the objects by.                         |
+| `isReverse` | `boolean` | `false` | 🔄 If `true`, the sorting will be in **descending** order. |
+
+---
+
+## 🎯 Returns
+
+🧩 A **comparator function** compatible with `Array.prototype.sort()`:
+
+```js
+(a, b) => number
+```
+
+It compares two objects based on the specified `item` key.
+
+---
+
+## 💡 Examples
+
+```js
+const arr = [{ pos: 2 }, { pos: 1 }, { pos: 3 }];
+arr.sort(arraySortPositions('pos'));
+// 🔼 Ascending: [{ pos: 1 }, { pos: 2 }, { pos: 3 }]
+```
+
+```js
+const arr = [{ pos: 2 }, { pos: 1 }, { pos: 3 }];
+arr.sort(arraySortPositions('pos', true));
+// 🔽 Descending: [{ pos: 3 }, { pos: 2 }, { pos: 1 }]
+```
+
+---
+
+## 🛠️ Use Case
+
+Great for situations where you need to **dynamically sort objects** by one of their keys, such as:
+
+* Sorting users by age
+* Ordering tasks by priority
+* Displaying leaderboard scores

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.8.3",
+  "version": "1.8.5",
   "description": "Collection of small, essential scripts designed to be used across various projects. These simple utilities are crafted for speed, ease of use, and versatility.",
   "scripts": {
     "test": "npm run test:mjs && npm run test:cjs && npm run test:js",
@@ -71,10 +71,16 @@
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.1",
     "@rollup/plugin-typescript": "^12.1.2",
+    "@types/lodash": "^4.17.16",
+    "@types/md5": "^2.3.5",
+    "@types/node-fetch": "^2.6.12",
+    "@types/tinycolor2": "^1.4.6",
     "babel-preset-es2015": "^6.24.1",
     "byte-length": "^1.0.2",
     "clone": "^2.1.2",
     "compare-versions": "^6.1.1",
+    "express": "^5.1.0",
+    "firebase": "^11.7.1",
     "firebase-functions": "^6.3.2",
     "latest-version": "^9.0.0",
     "lodash": "^4.17.21",
@@ -82,7 +88,7 @@
     "moment": "^2.30.1",
     "moment-timezone": "^0.5.48",
     "mysql": "^2.18.1",
-    "node-fetch": "2.7.0",
+    "node-fetch": "^2.7.0",
     "node-polyfill-webpack-plugin": "^4.1.0",
     "object-hash": "^3.0.0",
     "prettier": "3.5.3",