tiny-essentials 1.16.1 → 1.17.0

package/dist/v1/UltraRandomMsgGen.min.js

@@ -0,0 +1 @@
+(()=>{"use strict";var e={d:(n,o)=>{for(var a in o)e.o(o,a)&&!e.o(n,a)&&Object.defineProperty(n,a,{enumerable:!0,get:o[a]})},o:(e,n)=>Object.prototype.hasOwnProperty.call(e,n)},n={};e.d(n,{UltraRandomMsgGen:()=>d});const o=["lorem","ipsum","dolor","sit","amet","consectetur","adipiscing","elit","sed","do","eiusmod","tempor","incididunt","ut","labore","et","dolore","magna","aliqua"],a=["😂","🌈","🤖","💥","🐸","🍕","🦄","🧠","🧬","🚀","🫠","💫","🍩","👾","🎉","🥴","🐙","🧃","🪐","🎈","🧸","👻","🥳","🍭","💖","😺","🌮","🪅","🎮","🥓","🍮"],t=["pudding","bean","snuggle","bloop","jelly","unicorn","floof","giggle","bubble","muffin","puff","pickle","goblin","waffle","sprinkle","cupcake","fizzle","marshmallow","duckling","sock","cloud","teacup","nugget","gnome","hug","moonbean","crayon","jiggle","glitter","carrot","goober"],r=["wiggles","bounces","flies","splats","scoots","giggles","wigglesnacks","twirls","boops","pops","sings","hugs","floats","glows","flaps","mlems","dances","puddles","nomnoms","wigglejumps","sniffs","tumbles","slides","chirps","burps","sparkles","waddles","rambles","blinks","mews"],i=["fluffy","silly","yummy","squishy","wobbly","magical","tiny","sleepy","wiggly","bubbly","glittery","fuzzy","jiggly","sparkly","giggly","crunchy","goofy","soft","mushy","sweet","loopy","floaty","bonkers","chewy","ticklish","dreamy","pastel","cozy","teensy","grumbly"],s=["Boop!","Wiggle achieved.","Oops, {noun} everywhere!","Tiny {adj} {noun}, big {adj} {noun}.","Snuggle initiated with a {adj} {noun}.","{adj} vibes only, powered by {noun}.","No {noun}, no {noun}.","Bounce first, {verb} later.","Mlem. {verb}. {noun}.","{noun} go brrr and {verb}.","Why not? {noun} did. Then {noun} followed.","A {adj} {noun} just {verb} near the {adj} window.","That {adj} {noun} stole my {noun}!","Look, a {adj} {noun} trying to {verb} again!","Every {noun} deserves a {adj} nap.","The {adj} {noun} is my {adj} spirit animal.","Someone call the {noun}, it’s {verb}ing and {verb}ing again!","Don’t touch the {adj} {noun}. It {verb}s loudly.","{noun} forgot how {noun}s work and just {verb}ed.","There once was a {adj} {noun} who loved to {verb} with a {adj} {noun} all day.","Apparently, {noun}s are banned from {verb}ing and {verb}ing in the {noun} library.","That {adj} noise? Just a {noun} learning to {verb} on a {adj} {noun}.","I saw a {adj} {noun} {verb} so hard, it became a {adj} muffin.","The {adj} {noun} met a {adj} pickle and everything {verb}ed.","{noun}s are like {noun}: {adj}, unpredictable, and wiggly.","Don’t judge a {adj} {noun} by its ability to {verb}, or by its {adj} hat.","All I wanted was peace, but a {adj} {noun} with a {adj} {noun} had other plans.","One {adj} morning, a {adj} {noun} decided it was finally time to {verb}, but halfway through, it tripped on a {noun} and turned into a {adj} marshmallow.","I tried to be {adj} today, but then a {noun} {verb}ed across my {noun} and typed “asdfgh{noun}” repeatedly.","If you think you’ve seen everything, wait until a {adj} {noun} {verb}s on a {noun} wearing {adj} socks with tiny {noun}s.","No one ever believed the stories about the ancient {adj} {noun} who could {verb} with such {adj} grace that entire {noun}s turned pink out of embarrassment.","A curious {adj} {noun} wandered into a {noun} shop, not knowing that its destiny involved twelve {adj} {noun}s, one rubber {noun}, and a suspiciously quiet {adj} llama.","In a land where every {adj} {noun} was made of pudding and the sky was {adj} whipped cream, one brave {adj} {noun} set out to discover the legendary Spoon of {noun}s, facing obstacles like bouncing {noun}s, sassy {noun}s, and the Great Wobble of the {noun}.","Once upon a {adj} time, long before the {noun}s learned to {verb}, there existed a tiny {adj} {noun} who dreamed of swimming in a pool made entirely of {adj} glitter pudding while {verb}ing off-key lullabies to passing {noun}s with monocles.","The Council of {noun}s gathered in {adj} secret when the sacred {adj} {noun} started to {verb} uncontrollably, threatening the entire {adj} dessert-based civilization with spontaneous {noun} jiggles and uncontainable {noun} fits across the {noun}.","Hey... do you ever wonder if {noun}s dream of {noun}s?","Okay but hear me out: what if the {adj} {noun} could actually {verb} backwards?","Can we talk about the {noun} that just {verb}ed and vanished?","So I was talking to a {noun}, and it told me to stop being {adj}. Rude.","Not to alarm you, but there’s a {adj} {noun} behind you doing the {verb}.","Why does this {noun} keep staring at me like I owe it pudding?","Is this a safe space to admit I accidentally {verb}ed a {noun}?","I just walked into the room and someone shouted “{adj} {noun}!” — what did I miss?","Wait... we were supposed to bring a {noun}? No one told me!","Okay but what if the {adj} {noun} has feelings too?","Be honest, do I look like a {noun} that forgot how to {verb}?",'If I say "oops", do I still have to explain why the {noun} is glowing?',"I don’t know what’s going on but I brought snacks and a confused {noun}.","Do you think pudding knows it’s pudding? Just a thought.","Is this about the time I {verb}ed the {adj} {noun} by accident? Because I can explain.","Wait, are we talking about {noun}s or am I on the wrong chat again?",'What is this group even about? I just saw "pudding" and joined.',"Hi! I have no idea what’s happening but I’m here and I brought a {noun}.","I blinked and now there’s a {adj} {noun} in charge of everything.","Can someone please explain why the {noun} is floating and chanting?","Okay who gave the {noun} access to glitter and emotional support pickles?","I came for a calm discussion and now there’s a {adj} battle between {noun}s.","Not sure if I’m early, late, or inside a {noun} dream.","I was gone for 3 minutes and now someone’s riding a {noun} into the pudding realm.","This isn’t the pudding appreciation group, is it? ...oh no.","So... who summoned the {adj} {noun} this time? Be honest.","I came here for vibes and stayed for the {noun}s.","Does anyone else hear faint giggling or is that just the {adj} {noun} again?","I feel like I missed step one, two, and also three of this conversation.","All I asked was “what’s up?” and now I’m emotionally attached to a {noun}.",'Me: "I’ll be normal today." Also me: *{verb}s into a meeting riding a {adj} {noun}*','"It’s just pudding," they said. "It can’t hurt you," they said. They were wrong.',"I said one nice thing to a {noun} and now it follows me everywhere.","Can we take a moment to appreciate how the {adj} {noun} is just vibing?","Who put a tiny hat on the {noun}? Because that’s adorable.","My life has been different ever since the {noun} started {verb}ing.","Raise your hand if you’ve ever been personally attacked by a {adj} {noun}.",'"Don’t be weird," they said. So I became a {noun} instead.',"Do {noun}s have feelings? Asking for a {adj} friend.","I trusted the {noun} and all I got was a glitter-covered sock.","Plot twist: the {adj} {noun} was inside us all along.","The {adj} {noun} {verb} and {verb} all over the {adj} {noun}!","Oops! {noun}s {verb}ed into the {adj} {noun} while {verb}ing crazily.","{adj}, {adj}, and more {adj} {noun}s just {verb}ed by!","Why does the {adj} {noun} keep {verb}ing and {verb}ing without stopping?","Look! A {adj} {noun}, a {adj} {noun}, and a {noun} all {verb}ing together!","Sometimes, the {noun} just {verb}s, then {verb}s again, and never stops being {adj}.","{noun}, {noun}, and {noun} — all {verb}ing and {verb}ing in a {adj} {noun}.","I saw a {adj} {noun} {verb}, then another {noun} {verb}ing with a {adj} {noun}.","The {noun} {verb}s {verb} while the {adj} {noun} {verb}s and the {noun} just {verb}s.","Can a {adj} {noun} {verb} {verb} without a {adj} {noun} watching?","Whoa! The {adj} {noun} just {verb}ed... and then {verb}ed again!","Hey... did you see that {adj} {noun} {verb} over there?","Umm, the {noun} is {verb}ing but also {verb}ing and {verb}ing!","Lol! {noun}s {verb} so {adj}ly, it’s impossible not to giggle.",'"Hey! What’s up?" asked the {adj} {noun}, who {verb}ed loudly.','"I’m just a {adj} {noun} trying to {verb}, you know?"','"Did you see the {adj} {noun} that just {verb}ed in the pudding?"','"No way! The {noun} {verb}s better than me!"','"Wait, the {adj} {noun} said it would {verb}, but it {verb}ed instead!"',"Once upon a {adj} {noun}, a group of {adj} {noun}s {verb}ed through the {adj} forest, singing {adj} songs and eating {noun}s made of pudding.","The legend tells of a {adj} {noun} who could {verb} faster than any {noun} ever seen, leaving trails of {adj} sparkles behind.","Every day, the {adj} {noun} would {verb} around the {adj} meadow, trying to convince the {noun}s to join the grand pudding party.","No one knows why the {adj} {noun} suddenly {verb}ed and then {verb}ed again, but everyone agrees it was the cutest thing they ever saw.","In the kingdom of {adj} {noun}s, only the bravest {noun} dared to {verb} the giant pudding monster, armed with nothing but {adj} smiles and jellybeans.","{adj} {noun} {verb} {verb} {verb} {noun} {verb} {adj} {noun} {verb} {noun}!","{noun} {noun} {verb} {adj} {noun} and then {verb} {verb} the {adj} {noun}.","{verb} the {adj} {noun}, then {verb} the {noun} while {verb}ing {adj}ly.","Can the {adj} {noun} {verb} and {verb} the {adj} {noun} at the same time?","{noun} {verb} {noun} {verb}, but the {adj} {noun} {verb}s better.","Boop! The {adj} {noun} just {verb}ed in the pudding.","Bloop bloop, the {noun} is {verb}ing all over again!","Mlem mlem, a {adj} {noun} {verb}s quietly in the corner.","Splat! {noun} {verb}ed right on the {adj} {noun}.","Yum! A {adj} {noun} just {verb}ed in my mouth.","Do {noun}s really {verb} when nobody’s watching?","Why does the {adj} {noun} always {verb} at midnight?","Can a {noun} be too {adj} to {verb} properly?","Is it normal for a {adj} {noun} to {verb} three times in a row?","Who taught the {noun} to {verb} like that?","Wait, did the {adj} {noun} just {verb} itself?","I can’t believe the {noun} {verb}ed into a {adj} {noun}!","Suddenly, a {adj} {noun} appeared and started to {verb} wildly.","That {noun} was {verb}ing so {adj}ly it broke the pudding meter.","Everyone’s talking about the {adj} {noun} that {verb}ed out of nowhere."],d=class{static defaultWords=o;static defaultEmojis=a;static defaultNouns=t;static defaultVerbs=r;static defaultAdjectives=i;static defaultTemplates=s;config={minLength:10,maxLength:300,readable:!0,useEmojis:!0,includeNumbers:!0,includeSymbols:!0,allowWeirdSpacing:!1,emojiSet:[],wordSet:[],mode:"mixed",grammar:{templates:[],nouns:[],verbs:[],adjectives:[]},repeatWords:!0,emojiPlacement:"inline",line:{minLength:20,maxLength:120,emojiChance:.3}};constructor(e={}){this.symbols="!@#$%^&*()-_=+[]{}|;:,.<>?/\\~".split("");const{minLength:n,maxLength:d,readable:u,useEmojis:h,includeNumbers:l,includeSymbols:g,allowWeirdSpacing:m,emojiSet:b,wordSet:c,mode:f,grammar:v,repeatWords:p,emojiPlacement:w,paragraphs:j,line:y}=e;if(void 0!==n&&(!Number.isInteger(n)||n<1))throw new TypeError("config.minLength must be an integer >= 1");if(void 0!==d&&(!Number.isInteger(d)||d<1))throw new TypeError("config.maxLength must be an integer >= 1");if(void 0!==n&&void 0!==d&&n>d)throw new RangeError("config.minLength cannot be greater than config.maxLength");if(void 0!==u&&"boolean"!=typeof u)throw new TypeError("config.readable must be a boolean");if(void 0!==h&&"boolean"!=typeof h)throw new TypeError("config.useEmojis must be a boolean");if(void 0!==l&&"boolean"!=typeof l)throw new TypeError("config.includeNumbers must be a boolean");if(void 0!==g&&"boolean"!=typeof g)throw new TypeError("config.includeSymbols must be a boolean");if(void 0!==m&&"boolean"!=typeof m)throw new TypeError("config.allowWeirdSpacing must be a boolean");if(void 0!==b&&!Array.isArray(b))throw new TypeError("config.emojiSet must be an array of strings");if(void 0!==c&&!Array.isArray(c))throw new TypeError("config.wordSet must be an array of strings");if(void 0!==f&&!["mixed","readable","chaotic","natural"].includes(f))throw new RangeError('config.mode must be one of: "mixed", "readable", "chaotic", "natural');if(void 0!==v){if("object"!=typeof v||null===v)throw new TypeError("config.grammar must be an object");const{templates:e,nouns:n,verbs:o,adjectives:a}=v;if(void 0!==e&&!Array.isArray(e))throw new TypeError("config.grammar.templates must be an array of strings");if(void 0!==n&&!Array.isArray(n))throw new TypeError("config.grammar.nouns must be an array of strings");if(void 0!==o&&!Array.isArray(o))throw new TypeError("config.grammar.verbs must be an array of strings");if(void 0!==a&&!Array.isArray(a))throw new TypeError("config.grammar.adjectives must be an array of strings")}if(void 0!==p&&"boolean"!=typeof p)throw new TypeError("config.repeatWords must be a boolean");if(void 0!==w&&!["inline","end","none"].includes(w))throw new RangeError('config.emojiPlacement must be one of: "inline", "end", "none"');if(void 0!==j){if("object"!=typeof j)throw new TypeError("config.paragraphs must be an object or null");const{min:e,max:n}=j;if(void 0!==e&&(!Number.isInteger(e)||e<1))throw new TypeError("config.paragraphs.min must be an integer >= 1");if(void 0!==n&&(!Number.isInteger(n)||n<1))throw new TypeError("config.paragraphs.max must be an integer >= 1");if(void 0!==e&&void 0!==n&&e>n)throw new RangeError("config.paragraphs.min cannot be greater than config.paragraphs.max")}if(void 0!==y){if("object"!=typeof y||null===y)throw new TypeError("config.line must be an object");const{minLength:e,maxLength:n,emojiChance:o}=y;if(void 0!==e&&(!Number.isInteger(e)||e<1))throw new TypeError("config.line.minLength must be an integer >= 1");if(void 0!==n&&(!Number.isInteger(n)||n<1))throw new TypeError("config.line.maxLength must be an integer >= 1");if(void 0!==e&&void 0!==n&&e>n)throw new RangeError("config.line.minLength cannot be greater than config.line.maxLength");if(void 0!==o&&("number"!=typeof o||o<0||o>1))throw new RangeError("config.line.emojiChance must be a number between 0 and 1")}this.config.emojiSet=[...a],this.config.wordSet=[...o],this.config.grammar.templates=[...s],this.config.grammar.nouns=[...t],this.config.grammar.verbs=[...r],this.config.grammar.adjectives=[...i],Object.assign(this.config,e)}configure(e={}){return Object.assign(this.config,e),this}setGrammarTemplates(...e){return this.config.grammar.templates=e.flat(),this}addGrammarTemplates(...e){return this.config.grammar.templates.push(...e.flat()),this}setGrammarNouns(...e){return this.config.grammar.nouns=e.flat(),this}addGrammarNouns(...e){return this.config.grammar.nouns.push(...e.flat()),this}setGrammarVerbs(...e){return this.config.grammar.verbs=e.flat(),this}addGrammarVerbs(...e){return this.config.grammar.verbs.push(...e.flat()),this}setGrammarAdjectives(...e){return this.config.grammar.adjectives=e.flat(),this}addGrammarAdjectives(...e){return this.config.grammar.adjectives.push(...e.flat()),this}removeGrammarTemplates(...e){const n=new Set(e.flat());return this.config.grammar.templates=this.config.grammar.templates.filter((e=>!n.has(e))),this}removeGrammarNouns(...e){const n=new Set(e.flat());return this.config.grammar.nouns=this.config.grammar.nouns.filter((e=>!n.has(e))),this}removeGrammarVerbs(...e){const n=new Set(e.flat());return this.config.grammar.verbs=this.config.grammar.verbs.filter((e=>!n.has(e))),this}removeGrammarAdjectives(...e){const n=new Set(e.flat());return this.config.grammar.adjectives=this.config.grammar.adjectives.filter((e=>!n.has(e))),this}setWords(...e){return this.config.wordSet=e.flat(),this}addWords(...e){return this.config.wordSet.push(...e.flat()),this}removeWords(...e){const n=new Set(e.flat());return this.config.wordSet=this.config.wordSet.filter((e=>!n.has(e))),this}setEmojis(...e){return this.config.emojiSet=e.flat(),this}addEmojis(...e){return this.config.emojiSet.push(...e.flat()),this}removeEmojis(...e){const n=new Set(e.flat());return this.config.emojiSet=this.config.emojiSet.filter((e=>!n.has(e))),this}_getRandomItem(e){return e[Math.floor(Math.random()*e.length)]}_generateChunk(){const{wordSet:e,emojiSet:n,includeNumbers:o,includeSymbols:a,useEmojis:t,readable:r,mode:i,emojiPlacement:s}=this.config;if("natural"===i)return this._generateNaturalSentence();const d=[];return(r||"readable"===i||"mixed"===i)&&d.push(this._getRandomItem(e)),"chaotic"!==i&&"mixed"!==i||d.push(Math.random().toString(36).slice(2)),o&&d.push(Math.floor(99999*Math.random()).toString()),a&&d.push(this._getRandomItem(this.symbols)),"inline"===s&&t&&n.length&&d.push(this._getRandomItem(n)),this._getRandomItem(d)}_generateNaturalSentence(){const{templates:e,nouns:n,verbs:o,adjectives:a}=this.config.grammar;return this._getRandomItem(e).replace(/{noun}/g,(()=>this._getRandomItem(n))).replace(/{verb}/g,(()=>this._getRandomItem(o))).replace(/{adj}/g,(()=>this._getRandomItem(a)))}_generateLine(e,n){const{allowWeirdSpacing:o,repeatWords:a,readable:t,emojiSet:r,useEmojis:i,emojiPlacement:s,line:d}=this.config,u=[];for(n??=new Set;u.join(" ").length<e;){let e=this._generateChunk();!a&&n.has(e)||(n.add(e),o&&(Math.random()<.1&&(e="\n"+e),Math.random()<.1&&(e="   "+e),Math.random()<.05&&(e=e.toUpperCase())),u.push(e))}let h=u.join(t?" ":"");return"end"===s&&i&&r.length&&Math.random()<(d?.emojiChance||0)&&(h+=" "+this._getRandomItem(r)),h}_generateParagraphLines(e){const{line:n}=this.config,o=[],a=new Set;let t=0;for(;t<e;){const r=Math.floor(Math.random()*(n.maxLength-n.minLength+1)+n.minLength),i=Math.min(r,e-t);o.push(this._generateLine(i,a)),t+=i}return o}generate(){const{minLength:e,maxLength:n,paragraphs:o}=this.config,a=Math.floor(Math.random()*(n-e+1))+e;if(o&&"object"==typeof o){const e=Math.floor(Math.random()*(o.max-o.min+1))+o.min,n=Math.floor(a/e),t=[];for(let o=0;o<e;o++){const e=this._generateParagraphLines(n);t.push(e.join("\n"))}return t.join("\n\n")}return this._generateParagraphLines(a).join("\n")}};window.UltraRandomMsgGen=n.UltraRandomMsgGen})();

package/dist/v1/basics/html.cjs

@@ -127,20 +127,22 @@ function saveJsonFile(filename, data, spaces = 2) {
 }
 
 /**
- * Loads and parses a JSON from a remote URL using Fetch API.
- *
- * @param {string} url - The full URL to fetch JSON from.
- * @param {Object} [options] - Optional settings.
- * @param {string} [options.method="GET"] - HTTP method to use (GET, POST, etc.).
- * @param {any} [options.body] - Request body (only for methods like POST, PUT).
- * @param {number} [options.timeout=0] - Timeout in milliseconds (ignored if signal is provided).
- * @param {number} [options.retries=0] - Number of retry attempts (ignored if signal is provided).
- * @param {Headers|Record<string, *>} [options.headers={}] - Additional headers.
- * @param {AbortSignal|null} [options.signal] - External AbortSignal; disables timeout and retries.
- * @returns {Promise<*>} Parsed JSON object.
- * @throws {Error} Throws if fetch fails, times out, or returns invalid JSON.
+ * @typedef {Object} FetchTemplateOptions
+ * @property {string} [method="GET"] - HTTP method to use (GET, POST, etc.).
+ * @property {any} [body] - Request body (only for methods like POST, PUT).
+ * @property {number} [timeout=0] - Timeout in milliseconds (ignored if signal is provided).
+ * @property {number} [retries=0] - Number of retry attempts (ignored if signal is provided).
+ * @property {Headers|Record<string, *>} [headers={}] - Additional headers.
+ * @property {AbortSignal|null} [signal] - External AbortSignal; disables timeout and retries.
  */
-async function fetchJson(
+
+/**
+ * @param {string} url - The full URL to fetch data from.
+ * @param {FetchTemplateOptions} [options] - Optional settings.
+ * @returns {Promise<Response>} Result data.
+ * @throws {Error} Throws if fetch fails, times out.
+ */
+async function fetchTemplate(
   url,
   { method = 'GET', body, timeout = 0, retries = 0, headers = {}, signal = null } = {},
 ) {
@@ -199,17 +201,7 @@ async function fetchJson(
       if (timer) clearTimeout(timer);
 
       if (!response.ok) throw new Error(`HTTP error: ${response.status} ${response.statusText}`);
-
-      const contentType = response.headers.get('content-type') || '';
-      if (!contentType.includes('application/json'))
-        throw new Error(`Unexpected content-type: ${contentType}`);
-
-      const data = await response.json();
-
-      if (!Array.isArray(data) && !objFilter.isJsonObject(data))
-        throw new Error('Received invalid data instead of valid JSON.');
-
-      return data;
+      return response;
     } catch (err) {
       lastError = /** @type {Error} */ (err);
       if (signal) break; // if an external signal came, it does not retry
@@ -223,6 +215,63 @@ async function fetchJson(
   );
 }
 
+/**
+ * Loads and parses a JSON from a remote URL using Fetch API.
+ *
+ * @param {string} url - The full URL to fetch JSON from.
+ * @param {Object} [options] - Optional settings.
+ * @returns {Promise<any[] | Record<string | number | symbol, unknown>>} Parsed JSON object.
+ * @throws {Error} Throws if fetch fails, times out, or returns invalid JSON.
+ */
+async function fetchJson(url, options) {
+  return new Promise((resolve, reject) => {
+    fetchTemplate(url, options)
+      .then(async (res) => {
+        const contentType = res.headers.get('content-type') || '';
+        if (!contentType.includes('application/json'))
+          throw new Error(`Unexpected content-type: ${contentType}`);
+
+        const data = await res.json();
+
+        if (!Array.isArray(data) && !objFilter.isJsonObject(data))
+          throw new Error('Received invalid data instead of valid JSON.');
+
+        return resolve(data);
+      })
+      .catch(reject);
+  });
+}
+
+/**
+ * Loads a remote file as a Blob using Fetch API.
+ *
+ * @param {string} url - The full URL to fetch the file from.
+ * @param {Object} [options] - Optional fetch options.
+ * @param {string[]} [allowedMimeTypes] - Optional list of accepted MIME types (e.g., ['image/jpeg']).
+ * @returns {Promise<Blob>} - The fetched file as a Blob.
+ * @throws {Error} Throws if fetch fails, response is not ok, or MIME type is not allowed.
+ */
+async function fetchBlob(url, allowedMimeTypes, options) {
+  return new Promise((resolve, reject) => {
+    fetchTemplate(url, options)
+      .then(async (res) => {
+        const contentType = res.headers.get('content-type') || '';
+
+        if (
+          Array.isArray(allowedMimeTypes) &&
+          allowedMimeTypes.length > 0 &&
+          !allowedMimeTypes.some((type) => contentType.includes(type))
+        ) {
+          throw new Error(`Blocked MIME type: ${contentType}`);
+        }
+
+        const data = await res.blob();
+        return resolve(data);
+      })
+      .catch(reject);
+  });
+}
+
 ///////////////////////////////////////////////////////////////////////////////
 
 /**
@@ -348,6 +397,7 @@ function installWindowHiddenScript({
   return uninstall;
 }
 
+exports.fetchBlob = fetchBlob;
 exports.fetchJson = fetchJson;
 exports.installWindowHiddenScript = installWindowHiddenScript;
 exports.readBase64Blob = readBase64Blob;

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

@@ -50,23 +50,20 @@ export function saveJsonFile(filename: string, data: any, spaces?: number): void
  *
  * @param {string} url - The full URL to fetch JSON from.
  * @param {Object} [options] - Optional settings.
- * @param {string} [options.method="GET"] - HTTP method to use (GET, POST, etc.).
- * @param {any} [options.body] - Request body (only for methods like POST, PUT).
- * @param {number} [options.timeout=0] - Timeout in milliseconds (ignored if signal is provided).
- * @param {number} [options.retries=0] - Number of retry attempts (ignored if signal is provided).
- * @param {Headers|Record<string, *>} [options.headers={}] - Additional headers.
- * @param {AbortSignal|null} [options.signal] - External AbortSignal; disables timeout and retries.
- * @returns {Promise<*>} Parsed JSON object.
+ * @returns {Promise<any[] | Record<string | number | symbol, unknown>>} Parsed JSON object.
  * @throws {Error} Throws if fetch fails, times out, or returns invalid JSON.
  */
-export function fetchJson(url: string, { method, body, timeout, retries, headers, signal }?: {
-    method?: string | undefined;
-    body?: any;
-    timeout?: number | undefined;
-    retries?: number | undefined;
-    headers?: Headers | Record<string, any> | undefined;
-    signal?: AbortSignal | null | undefined;
-}): Promise<any>;
+export function fetchJson(url: string, options?: Object): Promise<any[] | Record<string | number | symbol, unknown>>;
+/**
+ * Loads a remote file as a Blob using Fetch API.
+ *
+ * @param {string} url - The full URL to fetch the file from.
+ * @param {Object} [options] - Optional fetch options.
+ * @param {string[]} [allowedMimeTypes] - Optional list of accepted MIME types (e.g., ['image/jpeg']).
+ * @returns {Promise<Blob>} - The fetched file as a Blob.
+ * @throws {Error} Throws if fetch fails, response is not ok, or MIME type is not allowed.
+ */
+export function fetchBlob(url: string, allowedMimeTypes?: string[], options?: Object): Promise<Blob>;
 /**
  * Installs a script that toggles CSS classes on a given element
  * based on the page's visibility or focus state, and optionally
@@ -88,4 +85,30 @@ export function installWindowHiddenScript({ element, hiddenClass, visibleClass,
     onVisible?: (() => void) | undefined;
     onHidden?: (() => void) | undefined;
 }): () => void;
+export type FetchTemplateOptions = {
+    /**
+     * - HTTP method to use (GET, POST, etc.).
+     */
+    method?: string | undefined;
+    /**
+     * - Request body (only for methods like POST, PUT).
+     */
+    body?: any;
+    /**
+     * - Timeout in milliseconds (ignored if signal is provided).
+     */
+    timeout?: number | undefined;
+    /**
+     * - Number of retry attempts (ignored if signal is provided).
+     */
+    retries?: number | undefined;
+    /**
+     * - Additional headers.
+     */
+    headers?: Headers | Record<string, any> | undefined;
+    /**
+     * - External AbortSignal; disables timeout and retries.
+     */
+    signal?: AbortSignal | null | undefined;
+};
 //# sourceMappingURL=html.d.mts.map

package/dist/v1/basics/html.mjs

@@ -115,20 +115,21 @@ export function saveJsonFile(filename, data, spaces = 2) {
     URL.revokeObjectURL(url);
 }
 /**
- * Loads and parses a JSON from a remote URL using Fetch API.
- *
- * @param {string} url - The full URL to fetch JSON from.
- * @param {Object} [options] - Optional settings.
- * @param {string} [options.method="GET"] - HTTP method to use (GET, POST, etc.).
- * @param {any} [options.body] - Request body (only for methods like POST, PUT).
- * @param {number} [options.timeout=0] - Timeout in milliseconds (ignored if signal is provided).
- * @param {number} [options.retries=0] - Number of retry attempts (ignored if signal is provided).
- * @param {Headers|Record<string, *>} [options.headers={}] - Additional headers.
- * @param {AbortSignal|null} [options.signal] - External AbortSignal; disables timeout and retries.
- * @returns {Promise<*>} Parsed JSON object.
- * @throws {Error} Throws if fetch fails, times out, or returns invalid JSON.
+ * @typedef {Object} FetchTemplateOptions
+ * @property {string} [method="GET"] - HTTP method to use (GET, POST, etc.).
+ * @property {any} [body] - Request body (only for methods like POST, PUT).
+ * @property {number} [timeout=0] - Timeout in milliseconds (ignored if signal is provided).
+ * @property {number} [retries=0] - Number of retry attempts (ignored if signal is provided).
+ * @property {Headers|Record<string, *>} [headers={}] - Additional headers.
+ * @property {AbortSignal|null} [signal] - External AbortSignal; disables timeout and retries.
  */
-export async function fetchJson(url, { method = 'GET', body, timeout = 0, retries = 0, headers = {}, signal = null } = {}) {
+/**
+ * @param {string} url - The full URL to fetch data from.
+ * @param {FetchTemplateOptions} [options] - Optional settings.
+ * @returns {Promise<Response>} Result data.
+ * @throws {Error} Throws if fetch fails, times out.
+ */
+async function fetchTemplate(url, { method = 'GET', body, timeout = 0, retries = 0, headers = {}, signal = null } = {}) {
     if (typeof url !== 'string' ||
         (!url.startsWith('../') &&
             !url.startsWith('./') &&
@@ -171,13 +172,7 @@ export async function fetchJson(url, { method = 'GET', body, timeout = 0, retrie
                 clearTimeout(timer);
             if (!response.ok)
                 throw new Error(`HTTP error: ${response.status} ${response.statusText}`);
-            const contentType = response.headers.get('content-type') || '';
-            if (!contentType.includes('application/json'))
-                throw new Error(`Unexpected content-type: ${contentType}`);
-            const data = await response.json();
-            if (!Array.isArray(data) && !isJsonObject(data))
-                throw new Error('Received invalid data instead of valid JSON.');
-            return data;
+            return response;
         }
         catch (err) {
             lastError = /** @type {Error} */ (err);
@@ -189,6 +184,54 @@ export async function fetchJson(url, { method = 'GET', body, timeout = 0, retrie
     }
     throw new Error(`Failed to fetch JSON from "${url}"${lastError ? `: ${lastError.message}` : '.'}`);
 }
+/**
+ * Loads and parses a JSON from a remote URL using Fetch API.
+ *
+ * @param {string} url - The full URL to fetch JSON from.
+ * @param {Object} [options] - Optional settings.
+ * @returns {Promise<any[] | Record<string | number | symbol, unknown>>} Parsed JSON object.
+ * @throws {Error} Throws if fetch fails, times out, or returns invalid JSON.
+ */
+export async function fetchJson(url, options) {
+    return new Promise((resolve, reject) => {
+        fetchTemplate(url, options)
+            .then(async (res) => {
+            const contentType = res.headers.get('content-type') || '';
+            if (!contentType.includes('application/json'))
+                throw new Error(`Unexpected content-type: ${contentType}`);
+            const data = await res.json();
+            if (!Array.isArray(data) && !isJsonObject(data))
+                throw new Error('Received invalid data instead of valid JSON.');
+            return resolve(data);
+        })
+            .catch(reject);
+    });
+}
+/**
+ * Loads a remote file as a Blob using Fetch API.
+ *
+ * @param {string} url - The full URL to fetch the file from.
+ * @param {Object} [options] - Optional fetch options.
+ * @param {string[]} [allowedMimeTypes] - Optional list of accepted MIME types (e.g., ['image/jpeg']).
+ * @returns {Promise<Blob>} - The fetched file as a Blob.
+ * @throws {Error} Throws if fetch fails, response is not ok, or MIME type is not allowed.
+ */
+export async function fetchBlob(url, allowedMimeTypes, options) {
+    return new Promise((resolve, reject) => {
+        fetchTemplate(url, options)
+            .then(async (res) => {
+            const contentType = res.headers.get('content-type') || '';
+            if (Array.isArray(allowedMimeTypes) &&
+                allowedMimeTypes.length > 0 &&
+                !allowedMimeTypes.some((type) => contentType.includes(type))) {
+                throw new Error(`Blocked MIME type: ${contentType}`);
+            }
+            const data = await res.blob();
+            return resolve(data);
+        })
+            .catch(reject);
+    });
+}
 ///////////////////////////////////////////////////////////////////////////////
 /**
  * Installs a script that toggles CSS classes on a given element

package/dist/v1/build/TinySmartScroller.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var TinySmartScroller = require('../libs/TinySmartScroller.cjs');
+
+
+
+exports.TinySmartScroller = TinySmartScroller;

package/dist/v1/build/TinySmartScroller.d.mts

@@ -0,0 +1,3 @@
+export { TinySmartScroller };
+import TinySmartScroller from '../libs/TinySmartScroller.mjs';
+//# sourceMappingURL=TinySmartScroller.d.mts.map

package/dist/v1/build/TinySmartScroller.mjs

@@ -0,0 +1,2 @@
+import TinySmartScroller from '../libs/TinySmartScroller.mjs';
+export { TinySmartScroller };

package/dist/v1/build/UltraRandomMsgGen.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var UltraRandomMsgGen = require('../libs/UltraRandomMsgGen.cjs');
+
+
+
+exports.UltraRandomMsgGen = UltraRandomMsgGen;

package/dist/v1/build/UltraRandomMsgGen.d.mts

@@ -0,0 +1,3 @@
+export { UltraRandomMsgGen };
+import UltraRandomMsgGen from '../libs/UltraRandomMsgGen.mjs';
+//# sourceMappingURL=UltraRandomMsgGen.d.mts.map

package/dist/v1/build/UltraRandomMsgGen.mjs

@@ -0,0 +1,2 @@
+import UltraRandomMsgGen from '../libs/UltraRandomMsgGen.mjs';
+export { UltraRandomMsgGen };

package/dist/v1/index.cjs

@@ -25,6 +25,8 @@ var TinyNotifications = require('./libs/TinyNotifications.cjs');
 var collision = require('./basics/collision.cjs');
 var TinyHtml = require('./libs/TinyHtml.cjs');
 var TinyAfterScrollWatcher = require('./libs/TinyAfterScrollWatcher.cjs');
+var UltraRandomMsgGen = require('./libs/UltraRandomMsgGen.cjs');
+var TinySmartScroller = require('./libs/TinySmartScroller.cjs');
 
 
 
@@ -129,3 +131,5 @@ exports.getElsRelativeCenterOffset = collision.getElsRelativeCenterOffset;
 exports.getRectCenter = collision.getRectCenter;
 exports.TinyHtml = TinyHtml;
 exports.TinyAfterScrollWatcher = TinyAfterScrollWatcher;
+exports.UltraRandomMsgGen = UltraRandomMsgGen;
+exports.TinySmartScroller = TinySmartScroller;

package/dist/v1/index.d.mts

@@ -1,3 +1,5 @@
+import TinySmartScroller from './libs/TinySmartScroller.mjs';
+import UltraRandomMsgGen from './libs/UltraRandomMsgGen.mjs';
 import TinyAfterScrollWatcher from './libs/TinyAfterScrollWatcher.mjs';
 import TinyHtml from './libs/TinyHtml.mjs';
 import TinyNotifications from './libs/TinyNotifications.mjs';
@@ -99,5 +101,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 { TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, isInViewport, isScrolledIntoView, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+export { TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, isInViewport, isScrolledIntoView, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, 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

@@ -23,4 +23,6 @@ import TinyNotifications from './libs/TinyNotifications.mjs';
 import { areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, } from './basics/collision.mjs';
 import TinyHtml from './libs/TinyHtml.mjs';
 import TinyAfterScrollWatcher from './libs/TinyAfterScrollWatcher.mjs';
-export { TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, isInViewport, isScrolledIntoView, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+import UltraRandomMsgGen from './libs/UltraRandomMsgGen.mjs';
+import TinySmartScroller from './libs/TinySmartScroller.mjs';
+export { TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, isInViewport, isScrolledIntoView, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/dist/v1/libs/TinyAfterScrollWatcher.cjs

@@ -19,8 +19,8 @@ class TinyAfterScrollWatcher {
   /** @type {Element|Window} */
   #scrollTarget;
 
-  /** @type {number} */
-  lastScrollTime = 0;
+  /** @type {null|NodeJS.Timeout} */
+  #lastScrollTime = null;
 
   /** @type {FnData[]} */
   #afterScrollQueue = [];
@@ -31,6 +31,9 @@ class TinyAfterScrollWatcher {
   /** @type {Set<OnScrollFunc>} */
   #externalScrollListeners = new Set();
 
+  /** @type {Set<FnData>} */
+  #onStopListeners = new Set();
+
   /** @type {boolean} */
   #destroyed = false;
 
@@ -44,16 +47,20 @@ class TinyAfterScrollWatcher {
     if (!(scrollTarget instanceof Element) && !(scrollTarget instanceof Window))
       throw new TypeError('scrollTarget must be an Element or the Window object.');
     this.#scrollTarget = scrollTarget;
+    this._checkTimer = this._checkTimer.bind(this);
 
-    this._onScroll = this._onScroll.bind(this);
-    this._checkQueue = this._checkQueue.bind(this);
-
-    this.#scrollTarget.addEventListener('scroll', this._onScroll);
+    this.#scrollTarget.addEventListener('scroll', this._checkTimer);
     this.#inactivityTime = inactivityTime;
-
-    requestAnimationFrame(this._checkQueue);
   }
 
+  _checkTimer = () => {
+    if (this.#lastScrollTime) clearTimeout(this.#lastScrollTime);
+    this.#lastScrollTime = setTimeout(() => {
+      this.#lastScrollTime = null;
+      this.#checkQueue();
+    }, this.#inactivityTime);
+  };
+
   /**
    * Gets the current inactivity time in milliseconds.
    * @returns {number}
@@ -74,29 +81,21 @@ class TinyAfterScrollWatcher {
     this.#inactivityTime = value;
   }
 
-  /**
-   * Internal handler for scroll events.
-   * Updates the last scroll timestamp.
-   * @private
-   */
-  _onScroll() {
-    this.lastScrollTime = Date.now();
-  }
-
   /**
    * Continuously checks whether the user has stopped scrolling,
    * and if so, runs all queued functions.
-   * @private
    */
-  _checkQueue() {
+  #checkQueue() {
     if (this.#destroyed) return;
-    requestAnimationFrame(this._checkQueue);
+    // Runs all onStop first listeners
+    for (const fn of this.#onStopListeners) {
+      if (typeof fn === 'function') fn();
+    }
 
-    if (Date.now() - this.lastScrollTime > this.#inactivityTime) {
-      while (this.#afterScrollQueue.length) {
-        const fn = this.#afterScrollQueue.pop();
-        if (typeof fn === 'function') fn();
-      }
+    // Then execute the queue afterScrollQueue
+    while (this.#afterScrollQueue.length) {
+      const fn = this.#afterScrollQueue.pop();
+      if (typeof fn === 'function') fn();
     }
   }
 
@@ -113,6 +112,29 @@ class TinyAfterScrollWatcher {
     this.#afterScrollQueue.push(fn);
   }
 
+  /**
+   * Registers a function to run once after scrolling has stopped,
+   * before any afterScrollQueue functions.
+   *
+   * @param {FnData} fn - A function to execute after scroll stop.
+   * @throws {TypeError} If the argument is not a function.
+   */
+  onStop(fn) {
+    if (typeof fn !== 'function') throw new TypeError('Argument must be a function.');
+    this.#onStopListeners.add(fn);
+  }
+
+  /**
+   * Removes a previously registered onStop function.
+   *
+   * @param {FnData} fn - The function to remove.
+   * @throws {TypeError} If the argument is not a function.
+   */
+  offStop(fn) {
+    if (typeof fn !== 'function') throw new TypeError('Argument must be a function.');
+    this.#onStopListeners.delete(fn);
+  }
+
   /**
    * Registers an external scroll listener on the tracked element.
    *
@@ -146,11 +168,12 @@ class TinyAfterScrollWatcher {
     if (this.#destroyed) return;
     this.#destroyed = true;
 
-    this.#scrollTarget.removeEventListener('scroll', this._onScroll);
+    this.#scrollTarget.removeEventListener('scroll', this._checkTimer);
     for (const fn of this.#externalScrollListeners)
       this.#scrollTarget.removeEventListener('scroll', fn);
 
     this.#externalScrollListeners.clear();
+    this.#onStopListeners.clear();
   }
 }
 

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

@@ -29,20 +29,7 @@ declare class TinyAfterScrollWatcher {
      * @throws {TypeError} If inactivityTime is not a positive number
      */
     constructor(scrollTarget?: Element | Window, inactivityTime?: number);
-    /** @type {number} */
-    lastScrollTime: number;
-    /**
-     * Internal handler for scroll events.
-     * Updates the last scroll timestamp.
-     * @private
-     */
-    private _onScroll;
-    /**
-     * Continuously checks whether the user has stopped scrolling,
-     * and if so, runs all queued functions.
-     * @private
-     */
-    private _checkQueue;
+    _checkTimer: () => void;
     /**
      * Sets a new inactivity time.
      * Must be a positive number (in milliseconds).
@@ -63,6 +50,22 @@ declare class TinyAfterScrollWatcher {
      * @throws {TypeError} If the argument is not a function.
      */
     doAfterScroll(fn: () => void): void;
+    lastScrollTime: number | undefined;
+    /**
+     * Registers a function to run once after scrolling has stopped,
+     * before any afterScrollQueue functions.
+     *
+     * @param {FnData} fn - A function to execute after scroll stop.
+     * @throws {TypeError} If the argument is not a function.
+     */
+    onStop(fn: FnData): void;
+    /**
+     * Removes a previously registered onStop function.
+     *
+     * @param {FnData} fn - The function to remove.
+     * @throws {TypeError} If the argument is not a function.
+     */
+    offStop(fn: FnData): void;
     /**
      * Registers an external scroll listener on the tracked element.
      *