tiny-essentials 1.5.1 → 1.7.0

package/dist/TinyPromiseQueue.js

@@ -45,6 +45,7 @@ class TinyPromiseQueue {
    * @property {(value: any) => any} resolve - The resolve function from the Promise.
    * @property {(reason?: any) => any} reject - The reject function from the Promise.
    * @property {string|undefined} [id] - Optional identifier for the task.
+   * @property {string|null|undefined} [marker] - Optional marker for the task.
    * @property {number|null|undefined} [delay] - Optional delay (in ms) before the task is executed.
    */
 
@@ -66,15 +67,13 @@ class TinyPromiseQueue {
   }
 
   /**
-   * Processes the next task in the queue if not already running.
-   * Ensures tasks are executed in order, one at a time.
+   * Processes the a normal task.
+   *
+   * @param {QueuedTask} data
    *
    * @returns {Promise<void>}
    */
-  async #processQueue() {
-    if (this.#running || this.#queue.length === 0) return;
-    this.#running = true;
-    const data = this.#queue.shift();
+  async #normalProcessQueue(data) {
     if (
       data &&
       typeof data.task === 'function' &&
@@ -83,6 +82,14 @@ class TinyPromiseQueue {
     ) {
       const { task, resolve, reject, delay, id } = data;
       try {
+        if (id && this.#blacklist.has(id)) {
+          reject(new Error('The function was canceled on TinyPromiseQueue.'));
+          this.#blacklist.delete(id);
+          this.#running = false;
+          this.#processQueue();
+          return;
+        }
+
         if (delay && id) {
           await new Promise((resolveDelay) => {
             const timeoutId = setTimeout(() => {
@@ -93,14 +100,6 @@ class TinyPromiseQueue {
           });
         }
 
-        if (id && this.#blacklist.has(id)) {
-          reject(new Error('The function was canceled on TinyPromiseQueue.'));
-          this.#blacklist.delete(id);
-          this.#running = false;
-          this.#processQueue();
-          return;
-        }
-
         const result = await task();
         resolve(result);
       } catch (error) {
@@ -112,6 +111,61 @@ class TinyPromiseQueue {
     }
   }
 
+  /**
+   * Processes a group task.
+   *
+   * @returns {Promise<void>}
+   */
+  async #groupProcessQueue() {
+    /** @type {Array<QueuedTask>} */
+    const grouped = [];
+    while (this.#queue.length && this.#queue[0]?.marker === 'POINT_MARKER') {
+      // @ts-ignore
+      grouped.push(this.#queue.shift());
+    }
+
+    if (grouped.length === 0) {
+      this.#running = false;
+      this.#processQueue();
+      return;
+    }
+
+    await Promise.all(
+      grouped.map(
+        ({ task, resolve, reject, id }) =>
+          new Promise(async (pResolve) => {
+            if (id && this.#blacklist.has(id)) {
+              this.#blacklist.delete(id);
+              reject(new Error('The function was canceled on TinyPromiseQueue.'));
+              pResolve(true);
+              return;
+            }
+            await task().then(resolve).catch(reject);
+            pResolve(true);
+          }),
+      ),
+    );
+
+    this.#running = false;
+    this.#processQueue();
+  }
+
+  /**
+   * Processes the next task in the queue if not already running.
+   * Ensures tasks are executed in order, one at a time.
+   *
+   * @returns {Promise<void>}
+   */
+  async #processQueue() {
+    if (this.#running || this.#queue.length === 0) return;
+    this.#running = true;
+    if (typeof this.#queue[0]?.marker !== 'string' || this.#queue[0]?.marker !== 'POINT_MARKER') {
+      const data = this.#queue.shift();
+      // @ts-ignore
+      this.#normalProcessQueue(data);
+    } else this.#groupProcessQueue();
+  }
+
   /**
    * Returns the index of a task by its ID.
    *
@@ -154,6 +208,22 @@ class TinyPromiseQueue {
     this.#queue.splice(toIndex, 0, item);
   }
 
+  /**
+   * Inserts a point in the queue where subsequent tasks will be grouped and executed together in a Promise.all.
+   * If the queue is currently empty, behaves like a regular promise.
+   *
+   * @param {(...args: any[]) => Promise<any>|Promise<any>} task A function that returns a Promise.
+   * @param {string} [id] Optional ID to identify the task in the queue.
+   * @returns {Promise<any>} A Promise that resolves or rejects with the result of the task once it's processed.
+   */
+  async enqueuePoint(task, id) {
+    if (!this.#running) return task();
+    return new Promise((resolve, reject) => {
+      this.#queue.push({ marker: 'POINT_MARKER', task, resolve, reject, id });
+      this.#processQueue();
+    });
+  }
+
   /**
    * Adds a new async task to the queue and ensures it runs in order after previous tasks.
    * Optionally, a delay can be added before the task is executed.
@@ -192,7 +262,8 @@ class TinyPromiseQueue {
 
     const index = this.getIndexById(id);
     if (index !== -1) {
-      this.#queue.splice(index, 1);
+      const [removed] = this.#queue.splice(index, 1);
+      removed?.reject?.(new Error('The function was canceled on TinyPromiseQueue.'));
       cancelled = true;
     }
 

package/dist/TinyPromiseQueue.min.js

@@ -1 +1 @@
-(()=>{"use strict";var e={d:(t,i)=>{for(var s in i)e.o(i,s)&&!e.o(t,s)&&Object.defineProperty(t,s,{enumerable:!0,get:i[s]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t)},t={};e.d(t,{TinyPromiseQueue:()=>i});const i=class{#e=[];#t=!1;#i={};#s=new Set;isRunning(){return this.#t}async#u(){if(this.#t||0===this.#e.length)return;this.#t=!0;const e=this.#e.shift();if(e&&"function"==typeof e.task&&"function"==typeof e.resolve&&"function"==typeof e.reject){const{task:t,resolve:i,reject:s,delay:u,id:n}=e;try{if(u&&n&&await new Promise((e=>{const t=setTimeout((()=>{delete this.#i[n],e(null)}),u);this.#i[n]=t})),n&&this.#s.has(n))return s(new Error("The function was canceled on TinyPromiseQueue.")),this.#s.delete(n),this.#t=!1,void this.#u();i(await t())}catch(e){s(e)}finally{this.#t=!1,this.#u()}}}getIndexById(e){return this.#e.findIndex((t=>t.id===e))}getQueuedIds(){return this.#e.map(((e,t)=>({index:t,id:e.id}))).filter((e=>"string"==typeof e.id))}reorderQueue(e,t){if("number"!=typeof e||"number"!=typeof t||e<0||t<0||e>=this.#e.length||t>=this.#e.length)return;const[i]=this.#e.splice(e,1);this.#e.splice(t,0,i)}enqueue(e,t,i){return new Promise(((s,u)=>{this.#e.push({task:e,resolve:s,reject:u,id:i,delay:t}),this.#u()}))}cancelTask(e){if(!e)return!1;let t=!1;e in this.#i&&(clearTimeout(this.#i[e]),delete this.#i[e],t=!0);const i=this.getIndexById(e);return-1!==i&&(this.#e.splice(i,1),t=!0),t&&this.#s.add(e),t}};window.TinyPromiseQueue=t.TinyPromiseQueue})();
+(()=>{"use strict";var e={d:(t,s)=>{for(var i in s)e.o(s,i)&&!e.o(t,i)&&Object.defineProperty(t,i,{enumerable:!0,get:s[i]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t)},t={};e.d(t,{TinyPromiseQueue:()=>s});const s=class{#e=[];#t=!1;#s={};#i=new Set;isRunning(){return this.#t}async#u(e){if(e&&"function"==typeof e.task&&"function"==typeof e.resolve&&"function"==typeof e.reject){const{task:t,resolve:s,reject:i,delay:u,id:n}=e;try{if(n&&this.#i.has(n))return i(new Error("The function was canceled on TinyPromiseQueue.")),this.#i.delete(n),this.#t=!1,void this.#n();u&&n&&await new Promise((e=>{const t=setTimeout((()=>{delete this.#s[n],e(null)}),u);this.#s[n]=t})),s(await t())}catch(e){i(e)}finally{this.#t=!1,this.#n()}}}async#r(){const e=[];for(;this.#e.length&&"POINT_MARKER"===this.#e[0]?.marker;)e.push(this.#e.shift());if(0===e.length)return this.#t=!1,void this.#n();await Promise.all(e.map((({task:e,resolve:t,reject:s,id:i})=>new Promise((async u=>{if(i&&this.#i.has(i))return this.#i.delete(i),s(new Error("The function was canceled on TinyPromiseQueue.")),void u(!0);await e().then(t).catch(s),u(!0)}))))),this.#t=!1,this.#n()}async#n(){if(!this.#t&&0!==this.#e.length)if(this.#t=!0,"string"!=typeof this.#e[0]?.marker||"POINT_MARKER"!==this.#e[0]?.marker){const e=this.#e.shift();this.#u(e)}else this.#r()}getIndexById(e){return this.#e.findIndex((t=>t.id===e))}getQueuedIds(){return this.#e.map(((e,t)=>({index:t,id:e.id}))).filter((e=>"string"==typeof e.id))}reorderQueue(e,t){if("number"!=typeof e||"number"!=typeof t||e<0||t<0||e>=this.#e.length||t>=this.#e.length)return;const[s]=this.#e.splice(e,1);this.#e.splice(t,0,s)}async enqueuePoint(e,t){return this.#t?new Promise(((s,i)=>{this.#e.push({marker:"POINT_MARKER",task:e,resolve:s,reject:i,id:t}),this.#n()})):e()}enqueue(e,t,s){return new Promise(((i,u)=>{this.#e.push({task:e,resolve:i,reject:u,id:s,delay:t}),this.#n()}))}cancelTask(e){if(!e)return!1;let t=!1;e in this.#s&&(clearTimeout(this.#s[e]),delete this.#s[e],t=!0);const s=this.getIndexById(e);if(-1!==s){const[e]=this.#e.splice(s,1);e?.reject?.(new Error("The function was canceled on TinyPromiseQueue.")),t=!0}return t&&this.#i.add(e),t}};window.TinyPromiseQueue=t.TinyPromiseQueue})();

package/dist/aiMarker.css

@@ -0,0 +1,4 @@
+body .detect-made-by-ai .made-by-ai {
+  color: yellow;
+  text-shadow: -1px -1px 0 #000, 1px -1px 0 #000, -1px 1px 0 #000, 1px 1px 0 #000;
+}

package/dist/aiMarker.min.css

@@ -0,0 +1 @@
+body .detect-made-by-ai .made-by-ai{color:#ff0;text-shadow:-1px -1px 0 #000,1px -1px 0 #000,-1px 1px 0 #000,1px 1px 0 #000}

package/dist/v1/basics/index.cjs

@@ -23,5 +23,6 @@ exports.reorderObjTypeOrder = objFilter.reorderObjTypeOrder;
 exports.getAge = simpleMath.getAge;
 exports.getSimplePerc = simpleMath.getSimplePerc;
 exports.ruleOfThree = simpleMath.ruleOfThree;
+exports.addAiMarkerShortcut = text.addAiMarkerShortcut;
 exports.toTitleCase = text.toTitleCase;
 exports.toTitleCaseLowerFirst = text.toTitleCaseLowerFirst;

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

@@ -1,3 +1,4 @@
+import { addAiMarkerShortcut } from './text.mjs';
 import { extendObjType } from './objFilter.mjs';
 import { reorderObjTypeOrder } from './objFilter.mjs';
 import { cloneObjTypeOrder } from './objFilter.mjs';
@@ -14,5 +15,5 @@ import { getTimeDuration } from './clock.mjs';
 import { shuffleArray } from './array.mjs';
 import { toTitleCase } from './text.mjs';
 import { toTitleCaseLowerFirst } from './text.mjs';
-export { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+export { 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

@@ -3,5 +3,5 @@ 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 { toTitleCase, toTitleCaseLowerFirst } from './text.mjs';
-export { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+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, };

package/dist/v1/basics/text.cjs

@@ -30,5 +30,64 @@ function toTitleCaseLowerFirst(str) {
   return titleCased.charAt(0).toLowerCase() + titleCased.slice(1);
 }
 
+/**
+ * Enables a keyboard shortcut to toggle a CSS class on the document body.
+ *
+ * This function listens for a specific key combination: `Ctrl + Alt + [key]`.
+ * When triggered, it prevents the default behavior and toggles the
+ * `detect-made-by-ai` class on the `<body>`, which can be used to apply visual
+ * indicators or filters on AI-generated content.
+ *
+ * If executed outside of a browser environment (e.g., in Node.js), the function logs an error and exits.
+ * If the `<body>` is not available at the moment the shortcut is triggered, a warning is logged.
+ *
+ * @param {string} [key='a'] - The lowercase character key to be used in combination with Ctrl and Alt.
+ */
+function addAiMarkerShortcut(key = 'a') {
+  if (typeof HTMLElement === 'undefined') {
+    console.error(
+      '[AiMarkerShortcut] Environment does not support the DOM. This function must be run in a browser.',
+    );
+    return;
+  }
+  document.addEventListener('keydown', function (event) {
+    if (event.ctrlKey && event.altKey && event.key.toLowerCase() === key) {
+      event.preventDefault(); // Prevent any default behavior
+      if (!document.body) {
+        console.warn(
+          '[AiMarkerShortcut] <body> element not found. Cannot toggle class. Ensure the DOM is fully loaded when using the shortcut.',
+        );
+        return;
+      }
+      document.body.classList.toggle('detect-made-by-ai');
+    }
+  });
+}
+
+/*
+import { useEffect } from "react";
+
+function KeyPressHandler() {
+    useEffect(() => {
+        const handleKeyDown = (event) => {
+            if (event.ctrlKey && event.altKey && event.key.toLowerCase() === "a") {
+                event.preventDefault();
+                document.body.classList.toggle("detect-made-by-ai");
+            }
+        };
+        
+        document.addEventListener("keydown", handleKeyDown);
+        return () => {
+            document.removeEventListener("keydown", handleKeyDown);
+        };
+    }, []);
+
+    return null;
+}
+
+export default KeyPressHandler;
+*/
+
+exports.addAiMarkerShortcut = addAiMarkerShortcut;
 exports.toTitleCase = toTitleCase;
 exports.toTitleCaseLowerFirst = toTitleCaseLowerFirst;

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

@@ -18,4 +18,18 @@ export function toTitleCase(str: string): string;
  * @returns {string} The string converted to title case with the first letter in lowercase.
  */
 export function toTitleCaseLowerFirst(str: string): string;
+/**
+ * Enables a keyboard shortcut to toggle a CSS class on the document body.
+ *
+ * This function listens for a specific key combination: `Ctrl + Alt + [key]`.
+ * When triggered, it prevents the default behavior and toggles the
+ * `detect-made-by-ai` class on the `<body>`, which can be used to apply visual
+ * indicators or filters on AI-generated content.
+ *
+ * If executed outside of a browser environment (e.g., in Node.js), the function logs an error and exits.
+ * If the `<body>` is not available at the moment the shortcut is triggered, a warning is logged.
+ *
+ * @param {string} [key='a'] - The lowercase character key to be used in combination with Ctrl and Alt.
+ */
+export function addAiMarkerShortcut(key?: string): void;
 //# sourceMappingURL=text.d.mts.map

package/dist/v1/basics/text.mjs

@@ -23,3 +23,55 @@ export function toTitleCaseLowerFirst(str) {
     const titleCased = str.replace(/\w\S*/g, (txt) => txt.charAt(0).toUpperCase() + txt.substr(1).toLowerCase());
     return titleCased.charAt(0).toLowerCase() + titleCased.slice(1);
 }
+/**
+ * Enables a keyboard shortcut to toggle a CSS class on the document body.
+ *
+ * This function listens for a specific key combination: `Ctrl + Alt + [key]`.
+ * When triggered, it prevents the default behavior and toggles the
+ * `detect-made-by-ai` class on the `<body>`, which can be used to apply visual
+ * indicators or filters on AI-generated content.
+ *
+ * If executed outside of a browser environment (e.g., in Node.js), the function logs an error and exits.
+ * If the `<body>` is not available at the moment the shortcut is triggered, a warning is logged.
+ *
+ * @param {string} [key='a'] - The lowercase character key to be used in combination with Ctrl and Alt.
+ */
+export function addAiMarkerShortcut(key = 'a') {
+    if (typeof HTMLElement === 'undefined') {
+        console.error('[AiMarkerShortcut] Environment does not support the DOM. This function must be run in a browser.');
+        return;
+    }
+    document.addEventListener('keydown', function (event) {
+        if (event.ctrlKey && event.altKey && event.key.toLowerCase() === key) {
+            event.preventDefault(); // Prevent any default behavior
+            if (!document.body) {
+                console.warn('[AiMarkerShortcut] <body> element not found. Cannot toggle class. Ensure the DOM is fully loaded when using the shortcut.');
+                return;
+            }
+            document.body.classList.toggle('detect-made-by-ai');
+        }
+    });
+}
+/*
+import { useEffect } from "react";
+
+function KeyPressHandler() {
+    useEffect(() => {
+        const handleKeyDown = (event) => {
+            if (event.ctrlKey && event.altKey && event.key.toLowerCase() === "a") {
+                event.preventDefault();
+                document.body.classList.toggle("detect-made-by-ai");
+            }
+        };
+        
+        document.addEventListener("keydown", handleKeyDown);
+        return () => {
+            document.removeEventListener("keydown", handleKeyDown);
+        };
+    }, []);
+
+    return null;
+}
+
+export default KeyPressHandler;
+*/

package/dist/v1/index.cjs

@@ -27,6 +27,7 @@ exports.reorderObjTypeOrder = objFilter.reorderObjTypeOrder;
 exports.getAge = simpleMath.getAge;
 exports.getSimplePerc = simpleMath.getSimplePerc;
 exports.ruleOfThree = simpleMath.ruleOfThree;
+exports.addAiMarkerShortcut = text.addAiMarkerShortcut;
 exports.toTitleCase = text.toTitleCase;
 exports.toTitleCaseLowerFirst = text.toTitleCaseLowerFirst;
 exports.TinyPromiseQueue = TinyPromiseQueue;

package/dist/v1/index.d.mts

@@ -1,5 +1,6 @@
 import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
 import TinyLevelUp from '../legacy/libs/userLevel.mjs';
+import { addAiMarkerShortcut } from './basics/text.mjs';
 import { extendObjType } from './basics/objFilter.mjs';
 import { reorderObjTypeOrder } from './basics/objFilter.mjs';
 import { cloneObjTypeOrder } from './basics/objFilter.mjs';
@@ -17,5 +18,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 { TinyPromiseQueue, TinyLevelUp, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+export { TinyPromiseQueue, TinyLevelUp, 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

@@ -4,6 +4,6 @@ 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 { toTitleCase, toTitleCaseLowerFirst } from './basics/text.mjs';
+import { addAiMarkerShortcut, toTitleCase, toTitleCaseLowerFirst } from './basics/text.mjs';
 import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
-export { TinyPromiseQueue, TinyLevelUp, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+export { TinyPromiseQueue, TinyLevelUp, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/dist/v1/libs/TinyPromiseQueue.cjs

@@ -15,6 +15,7 @@ class TinyPromiseQueue {
    * @property {(value: any) => any} resolve - The resolve function from the Promise.
    * @property {(reason?: any) => any} reject - The reject function from the Promise.
    * @property {string|undefined} [id] - Optional identifier for the task.
+   * @property {string|null|undefined} [marker] - Optional marker for the task.
    * @property {number|null|undefined} [delay] - Optional delay (in ms) before the task is executed.
    */
 
@@ -36,15 +37,13 @@ class TinyPromiseQueue {
   }
 
   /**
-   * Processes the next task in the queue if not already running.
-   * Ensures tasks are executed in order, one at a time.
+   * Processes the a normal task.
+   *
+   * @param {QueuedTask} data
    *
    * @returns {Promise<void>}
    */
-  async #processQueue() {
-    if (this.#running || this.#queue.length === 0) return;
-    this.#running = true;
-    const data = this.#queue.shift();
+  async #normalProcessQueue(data) {
     if (
       data &&
       typeof data.task === 'function' &&
@@ -53,6 +52,14 @@ class TinyPromiseQueue {
     ) {
       const { task, resolve, reject, delay, id } = data;
       try {
+        if (id && this.#blacklist.has(id)) {
+          reject(new Error('The function was canceled on TinyPromiseQueue.'));
+          this.#blacklist.delete(id);
+          this.#running = false;
+          this.#processQueue();
+          return;
+        }
+
         if (delay && id) {
           await new Promise((resolveDelay) => {
             const timeoutId = setTimeout(() => {
@@ -63,14 +70,6 @@ class TinyPromiseQueue {
           });
         }
 
-        if (id && this.#blacklist.has(id)) {
-          reject(new Error('The function was canceled on TinyPromiseQueue.'));
-          this.#blacklist.delete(id);
-          this.#running = false;
-          this.#processQueue();
-          return;
-        }
-
         const result = await task();
         resolve(result);
       } catch (error) {
@@ -82,6 +81,61 @@ class TinyPromiseQueue {
     }
   }
 
+  /**
+   * Processes a group task.
+   *
+   * @returns {Promise<void>}
+   */
+  async #groupProcessQueue() {
+    /** @type {Array<QueuedTask>} */
+    const grouped = [];
+    while (this.#queue.length && this.#queue[0]?.marker === 'POINT_MARKER') {
+      // @ts-ignore
+      grouped.push(this.#queue.shift());
+    }
+
+    if (grouped.length === 0) {
+      this.#running = false;
+      this.#processQueue();
+      return;
+    }
+
+    await Promise.all(
+      grouped.map(
+        ({ task, resolve, reject, id }) =>
+          new Promise(async (pResolve) => {
+            if (id && this.#blacklist.has(id)) {
+              this.#blacklist.delete(id);
+              reject(new Error('The function was canceled on TinyPromiseQueue.'));
+              pResolve(true);
+              return;
+            }
+            await task().then(resolve).catch(reject);
+            pResolve(true);
+          }),
+      ),
+    );
+
+    this.#running = false;
+    this.#processQueue();
+  }
+
+  /**
+   * Processes the next task in the queue if not already running.
+   * Ensures tasks are executed in order, one at a time.
+   *
+   * @returns {Promise<void>}
+   */
+  async #processQueue() {
+    if (this.#running || this.#queue.length === 0) return;
+    this.#running = true;
+    if (typeof this.#queue[0]?.marker !== 'string' || this.#queue[0]?.marker !== 'POINT_MARKER') {
+      const data = this.#queue.shift();
+      // @ts-ignore
+      this.#normalProcessQueue(data);
+    } else this.#groupProcessQueue();
+  }
+
   /**
    * Returns the index of a task by its ID.
    *
@@ -124,6 +178,22 @@ class TinyPromiseQueue {
     this.#queue.splice(toIndex, 0, item);
   }
 
+  /**
+   * Inserts a point in the queue where subsequent tasks will be grouped and executed together in a Promise.all.
+   * If the queue is currently empty, behaves like a regular promise.
+   *
+   * @param {(...args: any[]) => Promise<any>|Promise<any>} task A function that returns a Promise.
+   * @param {string} [id] Optional ID to identify the task in the queue.
+   * @returns {Promise<any>} A Promise that resolves or rejects with the result of the task once it's processed.
+   */
+  async enqueuePoint(task, id) {
+    if (!this.#running) return task();
+    return new Promise((resolve, reject) => {
+      this.#queue.push({ marker: 'POINT_MARKER', task, resolve, reject, id });
+      this.#processQueue();
+    });
+  }
+
   /**
    * Adds a new async task to the queue and ensures it runs in order after previous tasks.
    * Optionally, a delay can be added before the task is executed.
@@ -162,7 +232,8 @@ class TinyPromiseQueue {
 
     const index = this.getIndexById(id);
     if (index !== -1) {
-      this.#queue.splice(index, 1);
+      const [removed] = this.#queue.splice(index, 1);
+      removed?.reject?.(new Error('The function was canceled on TinyPromiseQueue.'));
       cancelled = true;
     }
 

package/dist/v1/libs/TinyPromiseQueue.d.mts

@@ -37,6 +37,15 @@ declare class TinyPromiseQueue {
      * @param {number} toIndex The index where the task should be placed.
      */
     reorderQueue(fromIndex: number, toIndex: number): void;
+    /**
+     * Inserts a point in the queue where subsequent tasks will be grouped and executed together in a Promise.all.
+     * If the queue is currently empty, behaves like a regular promise.
+     *
+     * @param {(...args: any[]) => Promise<any>|Promise<any>} task A function that returns a Promise.
+     * @param {string} [id] Optional ID to identify the task in the queue.
+     * @returns {Promise<any>} A Promise that resolves or rejects with the result of the task once it's processed.
+     */
+    enqueuePoint(task: (...args: any[]) => Promise<any> | Promise<any>, id?: string): Promise<any>;
     /**
      * Adds a new async task to the queue and ensures it runs in order after previous tasks.
      * Optionally, a delay can be added before the task is executed.