tiny-essentials 1.27.1 → 1.28.1

package/dist/v1/UltraRandomMsgGen.min.js

@@ -1 +1 @@
-(()=>{"use strict";const e={d:(n,t)=>{if(Array.isArray(t))for(var a=0;a<t.length;){var o=t[a++],r=t[a++];e.o(n,o)?0===r&&a++:0===r?Object.defineProperty(n,o,{enumerable:!0,value:t[a++]}):Object.defineProperty(n,o,{enumerable:!0,get:r})}else for(var o in t)e.o(t,o)&&!e.o(n,o)&&Object.defineProperty(n,o,{enumerable:!0,get:t[o]})},o:(e,n)=>Object.prototype.hasOwnProperty.call(e,n)};let n={};e.d(n,{UltraRandomMsgGen:()=>u});const t=["lorem","ipsum","dolor","sit","amet","consectetur","adipiscing","elit","sed","do","eiusmod","tempor","incididunt","ut","labore","et","dolore","magna","aliqua"],a=["😂","🌈","🤖","💥","🐸","🍕","🦄","🧠","🧬","🚀","🫠","💫","🍩","👾","🎉","🥴","🐙","🧃","🪐","🎈","🧸","👻","🥳","🍭","💖","😺","🌮","🪅","🎮","🥓","🍮"],o=["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."];class d{static#e=t;static#n=a;static#t=o;static#a=r;static#o=i;static#r=s;static#i(e,n){if(!Array.isArray(e))throw new TypeError(`${n} must be an array of strings`);if(!e.every(e=>"string"==typeof e))throw new TypeError(`${n} must contain only strings`);if(0===e.length)throw new Error(`${n} cannot be empty`)}static get defaultWords(){return[...this.#e]}static set defaultWords(e){this.#i(e,"defaultWords"),this.#e=[...e]}static get defaultEmojis(){return[...this.#n]}static set defaultEmojis(e){this.#i(e,"defaultEmojis"),this.#n=[...e]}static get defaultNouns(){return[...this.#t]}static set defaultNouns(e){this.#i(e,"defaultNouns"),this.#t=[...e]}static get defaultVerbs(){return[...this.#a]}static set defaultVerbs(e){this.#i(e,"defaultVerbs"),this.#a=[...e]}static get defaultAdjectives(){return[...this.#o]}static set defaultAdjectives(e){this.#i(e,"defaultAdjectives"),this.#o=[...e]}static get defaultTemplates(){return[...this.#r]}static set defaultTemplates(e){this.#i(e,"defaultTemplates"),this.#r=[...e]}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:t,readable:a,useEmojis:o,includeNumbers:r,includeSymbols:i,allowWeirdSpacing:s,emojiSet:u,wordSet:h,mode:l,grammar:g,repeatWords:m,emojiPlacement:b,paragraphs:c,line:f}=e;if(void 0!==n&&(!Number.isInteger(n)||n<1))throw new TypeError("config.minLength must be an integer >= 1");if(void 0!==t&&(!Number.isInteger(t)||t<1))throw new TypeError("config.maxLength must be an integer >= 1");if(void 0!==n&&void 0!==t&&n>t)throw new RangeError("config.minLength cannot be greater than config.maxLength");if(void 0!==a&&"boolean"!=typeof a)throw new TypeError("config.readable must be a boolean");if(void 0!==o&&"boolean"!=typeof o)throw new TypeError("config.useEmojis must be a boolean");if(void 0!==r&&"boolean"!=typeof r)throw new TypeError("config.includeNumbers must be a boolean");if(void 0!==i&&"boolean"!=typeof i)throw new TypeError("config.includeSymbols must be a boolean");if(void 0!==s&&"boolean"!=typeof s)throw new TypeError("config.allowWeirdSpacing must be a boolean");if(void 0!==u&&!Array.isArray(u))throw new TypeError("config.emojiSet must be an array of strings");if(void 0!==h&&!Array.isArray(h))throw new TypeError("config.wordSet must be an array of strings");if(void 0!==l&&!["mixed","readable","chaotic","natural"].includes(l))throw new RangeError('config.mode must be one of: "mixed", "readable", "chaotic", "natural');if(void 0!==g){if("object"!=typeof g||null===g)throw new TypeError("config.grammar must be an object");const{templates:e,nouns:n,verbs:t,adjectives:a}=g;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!==t&&!Array.isArray(t))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!==m&&"boolean"!=typeof m)throw new TypeError("config.repeatWords must be a boolean");if(void 0!==b&&!["inline","end","none"].includes(b))throw new RangeError('config.emojiPlacement must be one of: "inline", "end", "none"');if(void 0!==c){if("object"!=typeof c)throw new TypeError("config.paragraphs must be an object or null");const{min:e,max:n}=c;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!==f){if("object"!=typeof f||null===f)throw new TypeError("config.line must be an object");const{minLength:e,maxLength:n,emojiChance:t}=f;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!==t&&("number"!=typeof t||t<0||t>1))throw new RangeError("config.line.emojiChance must be a number between 0 and 1")}this.config.emojiSet=[...d.#n],this.config.wordSet=[...d.#e],this.config.grammar.templates=[...d.#r],this.config.grammar.nouns=[...d.#t],this.config.grammar.verbs=[...d.#a],this.config.grammar.adjectives=[...d.#o],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:t,includeSymbols:a,useEmojis:o,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)),t&&d.push(Math.floor(99999*Math.random()).toString()),a&&d.push(this._getRandomItem(this.symbols)),"inline"===s&&o&&n.length&&d.push(this._getRandomItem(n)),this._getRandomItem(d)}_generateNaturalSentence(){const{templates:e,nouns:n,verbs:t,adjectives:a}=this.config.grammar;return this._getRandomItem(e).replace(/{noun}/g,()=>this._getRandomItem(n)).replace(/{verb}/g,()=>this._getRandomItem(t)).replace(/{adj}/g,()=>this._getRandomItem(a))}_generateLine(e,n){const{allowWeirdSpacing:t,repeatWords:a,readable:o,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),t&&(Math.random()<.1&&(e="\n"+e),Math.random()<.1&&(e="   "+e),Math.random()<.05&&(e=e.toUpperCase())),u.push(e))}let h=u.join(o?" ":"");return"end"===s&&i&&r.length&&Math.random()<(d?.emojiChance||0)&&(h+=" "+this._getRandomItem(r)),h}_generateParagraphLines(e){const{line:n}=this.config,t=[],a=new Set;let o=0;for(;o<e;){const r=Math.floor(Math.random()*(n.maxLength-n.minLength+1)+n.minLength),i=Math.min(r,e-o);t.push(this._generateLine(i,a)),o+=i}return t}generate(){const{minLength:e,maxLength:n,paragraphs:t}=this.config,a=Math.floor(Math.random()*(n-e+1))+e;if(t&&"object"==typeof t){const e=Math.floor(Math.random()*(t.max-t.min+1))+t.min,n=Math.floor(a/e),o=[];for(let t=0;t<e;t++){const e=this._generateParagraphLines(n);o.push(e.join("\n"))}return o.join("\n\n")}return this._generateParagraphLines(a).join("\n")}}const u=d;window.UltraRandomMsgGen=n.UltraRandomMsgGen})();
+(()=>{"use strict";const e={d:(n,t)=>{if(Array.isArray(t))for(var a=0;a<t.length;){var o=t[a++],r=t[a++];e.o(n,o)?0===r&&a++:0===r?Object.defineProperty(n,o,{enumerable:!0,value:t[a++]}):Object.defineProperty(n,o,{enumerable:!0,get:r})}else for(var o in t)e.o(t,o)&&!e.o(n,o)&&Object.defineProperty(n,o,{enumerable:!0,get:t[o]})},o:(e,n)=>Object.prototype.hasOwnProperty.call(e,n)};let n={};e.d(n,{UltraRandomMsgGen:()=>h});const t=e=>{if(e)throw new Error("This UltraRandomMsgGen instance has been destroyed and can no longer be used.")};const a=["lorem","ipsum","dolor","sit","amet","consectetur","adipiscing","elit","sed","do","eiusmod","tempor","incididunt","ut","labore","et","dolore","magna","aliqua"],o=["😂","🌈","🤖","💥","🐸","🍕","🦄","🧠","🧬","🚀","🫠","💫","🍩","👾","🎉","🥴","🐙","🧃","🪐","🎈","🧸","👻","🥳","🍭","💖","😺","🌮","🪅","🎮","🥓","🍮","🍬","🍓","🍒","🥝","🥑","🍄","🌊","☁️","🌟","🌙","🧚","🐾","🐥","🐼","🐨","🐳","✨","🧁","🌸","🍃","💎","🎐","🎀","🫧","☄️","🛸","🔮"],r=["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"],i=["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"],s=["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"],d=["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.","In the glow of the {adj} moon, the {noun} began to {verb}.","A sprinkle of {adj} dust made the {noun} {verb} through the air.","The {noun} whispered a {adj} secret that made everyone {verb}.","Everything felt {adj} and {adj}, especially when the {noun} {verb}ed.","The {noun} is {verb}ing! The {noun} is {verb}ing! AAAAA!","Glitch in the {noun}: the {adj} {noun} just {verb}ed out of existence.","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."];class u{static#e=a;static#n=o;static#t=r;static#a=i;static#o=s;static#r=d;static#i(e,n){if(!Array.isArray(e))throw new TypeError(`${n} must be an array of strings`);if(!e.every(e=>"string"==typeof e))throw new TypeError(`${n} must contain only strings`);if(0===e.length)throw new Error(`${n} cannot be empty`)}static get defaultWords(){return[...this.#e]}static set defaultWords(e){this.#i(e,"defaultWords"),this.#e=[...e]}static get defaultEmojis(){return[...this.#n]}static set defaultEmojis(e){this.#i(e,"defaultEmojis"),this.#n=[...e]}static get defaultNouns(){return[...this.#t]}static set defaultNouns(e){this.#i(e,"defaultNouns"),this.#t=[...e]}static get defaultVerbs(){return[...this.#a]}static set defaultVerbs(e){this.#i(e,"defaultVerbs"),this.#a=[...e]}static get defaultAdjectives(){return[...this.#o]}static set defaultAdjectives(e){this.#i(e,"defaultAdjectives"),this.#o=[...e]}static get defaultTemplates(){return[...this.#r]}static set defaultTemplates(e){this.#i(e,"defaultTemplates"),this.#r=[...e]}#s=!1;get destroyed(){return this.#s}#d={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}};get config(){return t(this.#s),structuredClone(this.#d)}#u="!@#$%^&*()-_=+[]{}|;:,.<>?/\\~".split("");get symbols(){return t(this.#s),structuredClone(this.#u)}constructor(e={}){const{minLength:n,maxLength:t,readable:a,useEmojis:o,includeNumbers:r,includeSymbols:i,allowWeirdSpacing:s,emojiSet:d,wordSet:h,mode:l,grammar:g,repeatWords:m,emojiPlacement:b,paragraphs:c,line:f}=e;if(void 0!==n&&(!Number.isInteger(n)||n<1))throw new TypeError("config.minLength must be an integer >= 1");if(void 0!==t&&(!Number.isInteger(t)||t<1))throw new TypeError("config.maxLength must be an integer >= 1");if(void 0!==n&&void 0!==t&&n>t)throw new RangeError("config.minLength cannot be greater than config.maxLength");if(void 0!==a&&"boolean"!=typeof a)throw new TypeError("config.readable must be a boolean");if(void 0!==o&&"boolean"!=typeof o)throw new TypeError("config.useEmojis must be a boolean");if(void 0!==r&&"boolean"!=typeof r)throw new TypeError("config.includeNumbers must be a boolean");if(void 0!==i&&"boolean"!=typeof i)throw new TypeError("config.includeSymbols must be a boolean");if(void 0!==s&&"boolean"!=typeof s)throw new TypeError("config.allowWeirdSpacing must be a boolean");if(void 0!==d&&!Array.isArray(d))throw new TypeError("config.emojiSet must be an array of strings");if(void 0!==h&&!Array.isArray(h))throw new TypeError("config.wordSet must be an array of strings");if(void 0!==l&&!["mixed","readable","chaotic","natural"].includes(l))throw new RangeError('config.mode must be one of: "mixed", "readable", "chaotic", "natural');if(void 0!==g){if("object"!=typeof g||null===g)throw new TypeError("config.grammar must be an object");const{templates:e,nouns:n,verbs:t,adjectives:a}=g;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!==t&&!Array.isArray(t))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!==m&&"boolean"!=typeof m)throw new TypeError("config.repeatWords must be a boolean");if(void 0!==b&&!["inline","end","none"].includes(b))throw new RangeError('config.emojiPlacement must be one of: "inline", "end", "none"');if(void 0!==c){if("object"!=typeof c)throw new TypeError("config.paragraphs must be an object or null");const{min:e,max:n}=c;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!==f){if("object"!=typeof f||null===f)throw new TypeError("config.line must be an object");const{minLength:e,maxLength:n,emojiChance:t}=f;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!==t&&("number"!=typeof t||t<0||t>1))throw new RangeError("config.line.emojiChance must be a number between 0 and 1")}this.#d.emojiSet=[...u.#n],this.#d.wordSet=[...u.#e],this.#d.grammar.templates=[...u.#r],this.#d.grammar.nouns=[...u.#t],this.#d.grammar.verbs=[...u.#a],this.#d.grammar.adjectives=[...u.#o],Object.assign(this.#d,e)}configure(e={}){return t(this.#s),Object.assign(this.#d,e),this}setGrammarTemplates(...e){return t(this.#s),this.#d.grammar.templates=e.flat(),this}addGrammarTemplates(...e){return t(this.#s),this.#d.grammar.templates.push(...e.flat()),this}setGrammarNouns(...e){return t(this.#s),this.#d.grammar.nouns=e.flat(),this}addGrammarNouns(...e){return t(this.#s),this.#d.grammar.nouns.push(...e.flat()),this}setGrammarVerbs(...e){return t(this.#s),this.#d.grammar.verbs=e.flat(),this}addGrammarVerbs(...e){return t(this.#s),this.#d.grammar.verbs.push(...e.flat()),this}setGrammarAdjectives(...e){return t(this.#s),this.#d.grammar.adjectives=e.flat(),this}addGrammarAdjectives(...e){return t(this.#s),this.#d.grammar.adjectives.push(...e.flat()),this}removeGrammarTemplates(...e){t(this.#s);const n=new Set(e.flat());return this.#d.grammar.templates=this.#d.grammar.templates.filter(e=>!n.has(e)),this}removeGrammarNouns(...e){t(this.#s);const n=new Set(e.flat());return this.#d.grammar.nouns=this.#d.grammar.nouns.filter(e=>!n.has(e)),this}removeGrammarVerbs(...e){t(this.#s);const n=new Set(e.flat());return this.#d.grammar.verbs=this.#d.grammar.verbs.filter(e=>!n.has(e)),this}removeGrammarAdjectives(...e){t(this.#s);const n=new Set(e.flat());return this.#d.grammar.adjectives=this.#d.grammar.adjectives.filter(e=>!n.has(e)),this}setWords(...e){return t(this.#s),this.#d.wordSet=e.flat(),this}addWords(...e){return t(this.#s),this.#d.wordSet.push(...e.flat()),this}removeWords(...e){t(this.#s);const n=new Set(e.flat());return this.#d.wordSet=this.#d.wordSet.filter(e=>!n.has(e)),this}setEmojis(...e){return t(this.#s),this.#d.emojiSet=e.flat(),this}addEmojis(...e){return t(this.#s),this.#d.emojiSet.push(...e.flat()),this}removeEmojis(...e){t(this.#s);const n=new Set(e.flat());return this.#d.emojiSet=this.#d.emojiSet.filter(e=>!n.has(e)),this}_getRandomItem(e){return e[Math.floor(Math.random()*e.length)]}_generateChunk(){const{wordSet:e,emojiSet:n,includeNumbers:t,includeSymbols:a,useEmojis:o,readable:r,mode:i,emojiPlacement:s}=this.#d;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)),t&&d.push(Math.floor(99999*Math.random()).toString()),a&&d.push(this._getRandomItem(this.#u)),"inline"===s&&o&&n.length&&d.push(this._getRandomItem(n)),this._getRandomItem(d)}_generateNaturalSentence(){const{templates:e,nouns:n,verbs:t,adjectives:a}=this.#d.grammar;return this._getRandomItem(e).replace(/{noun}/g,()=>this._getRandomItem(n)).replace(/{verb}/g,()=>this._getRandomItem(t)).replace(/{adj}/g,()=>this._getRandomItem(a))}_generateLine(e,n){const{allowWeirdSpacing:t,repeatWords:a,readable:o,emojiSet:r,useEmojis:i,emojiPlacement:s,line:d}=this.#d,u=[];for(n??=new Set;u.join(" ").length<e;){let e=this._generateChunk();!a&&n.has(e)||(n.add(e),t&&(Math.random()<.1&&(e="\n"+e),Math.random()<.1&&(e="   "+e),Math.random()<.05&&(e=e.toUpperCase())),u.push(e))}let h=u.join(o?" ":"");return"end"===s&&i&&r.length&&Math.random()<(d?.emojiChance||0)&&(h+=" "+this._getRandomItem(r)),h}_generateParagraphLines(e){const{line:n}=this.#d,t=[],a=new Set;let o=0;for(;o<e;){const r=Math.floor(Math.random()*(n.maxLength-n.minLength+1)+n.minLength),i=Math.min(r,e-o);t.push(this._generateLine(i,a)),o+=i}return t}generate(){t(this.#s);const{minLength:e,maxLength:n,paragraphs:a}=this.#d,o=Math.floor(Math.random()*(n-e+1))+e;if(a&&"object"==typeof a){const e=Math.floor(Math.random()*(a.max-a.min+1))+a.min,n=Math.floor(o/e),t=[];for(let a=0;a<e;a++){const e=this._generateParagraphLines(n);t.push(e.join("\n"))}return t.join("\n\n")}return this._generateParagraphLines(o).join("\n")}destroy(){this.destroyed||(this.#u=[],this.#d.emojiSet=[],this.#d.wordSet=[],this.#d.grammar.templates=[],this.#d.grammar.nouns=[],this.#d.grammar.verbs=[],this.#d.grammar.adjectives=[],this.#s=!0)}}const h=u;window.UltraRandomMsgGen=n.UltraRandomMsgGen})();

package/dist/v1/basics/array.cjs

@@ -13,6 +13,10 @@
  * @returns {T} The same array instance, now shuffled in place.
  */
 function shuffleArray(items) {
+  if (!Array.isArray(items)) {
+    throw new TypeError("Argument 'items' must be an array.");
+  }
+
   let currentIndex = items.length,
     randomIndex;
 
@@ -32,16 +36,29 @@ function shuffleArray(items) {
 /**
  * Generates an array with repeated phases according to counts.
  *
- * @param {any[]} phases - Array of phase names, e.g., ['Full', 'Half1', 'Half2', 'New'].
+ * @template {any} BlockValue
+ * @param {BlockValue[]} phases - Array of phase names, e.g., ['Full', 'Half1', 'Half2', 'New'].
  * @param {number[]} counts - Array of integers specifying how many times to repeat each phase, e.g., [4,5,5,4].
- * @returns {any[]} - Flattened array containing phases repeated according to counts, concatenated in order.
+ * @returns {BlockValue[]} - Flattened array containing phases repeated according to counts, concatenated in order.
  */
 function multiplyArrayBlocks(phases, counts) {
-  // phases: array de strings, cada fase (ex: ['Full', 'Half1', 'Half2', 'New'])
-  // counts: array de inteiros, quantas vezes repetir cada fase (ex: [4,5,5,4])
+  if (!Array.isArray(phases)) {
+    throw new TypeError("Argument 'phases' must be an array.");
+  }
+  if (!Array.isArray(counts)) {
+    throw new TypeError("Argument 'counts' must be an array.");
+  }
+
+  if (phases.length !== counts.length) {
+    throw new RangeError("The 'phases' and 'counts' arrays must have the same length.");
+  }
 
   const result = [];
   for (let i = 0; i < phases.length; i++) {
+    if (typeof counts[i] !== 'number' || Number.isNaN(counts[i])) {
+      throw new TypeError(`Element at counts[${i}] must be a valid number.`);
+    }
+
     for (let j = 0; j < counts[i]; j++) {
       result.push(phases[i]);
     }
@@ -49,12 +66,28 @@ function multiplyArrayBlocks(phases, counts) {
   return result;
 }
 
+/**
+ * @template T
+ * @typedef {Object} DiffArrayListData
+ * @property {T[]} added - Items that only exist in the new array.
+ * @property {T[]} removed - Items that only existed in the old array.
+ */
+
 /**
  * Diff two class lists.
- * @param {any[]} oldItems
- * @param {any[]} newItems
+ * @template T
+ * @param {T[]} oldItems - The original/old array for comparison.
+ * @param {T[]} newItems - The new array for comparison.
+ * @returns {DiffArrayListData<T>} An object containing arrays of added and removed items.
  */
 function diffArrayList(oldItems, newItems) {
+  if (!Array.isArray(oldItems)) {
+    throw new TypeError("Argument 'oldItems' must be an array.");
+  }
+  if (!Array.isArray(newItems)) {
+    throw new TypeError("Argument 'newItems' must be an array.");
+  }
+
   const removed = oldItems.filter((c) => !newItems.includes(c));
   const added = newItems.filter((c) => !oldItems.includes(c));
   return { added, removed };
@@ -63,7 +96,7 @@ function diffArrayList(oldItems, newItems) {
 /**
  * Generates a comparator function to sort an array of objects by a given key.
  *
- * @param {string} item - The object key to sort by.
+ * @param {string|null} [item] - The object key to sort by.
  * @param {boolean} [isReverse=false] - If `true`, the sorting will be in descending order.
  * @returns {(a: Object<string|number, *>, b: Object<string|number, *>) => number} Comparator function compatible with Array.prototype.sort().
  *
@@ -76,13 +109,28 @@ function diffArrayList(oldItems, newItems) {
  * arr.sort(arraySortPositions('pos', true)); // Descending: [{pos: 3}, {pos: 2}, {pos: 1}]
  */
 function arraySortPositions(item, isReverse = false) {
+  if (item !== undefined && item !== null && typeof item !== 'string') {
+    throw new TypeError("Argument 'item' must be a string or null.");
+  }
+  if (typeof isReverse !== 'boolean') {
+    throw new TypeError("Argument 'isReverse' must be a boolean.");
+  }
+
   if (!isReverse) {
     return function (a, b) {
-      return a[item] < b[item] ? -1 : a[item] > b[item] ? 1 : 0;
+      return (item ? a[item] : a) < (item ? b[item] : b)
+        ? -1
+        : (item ? a[item] : a) > (item ? b[item] : b)
+          ? 1
+          : 0;
     };
   } else {
     return function (a, b) {
-      return a[item] > b[item] ? -1 : a[item] < b[item] ? 1 : 0;
+      return (item ? a[item] : a) > (item ? b[item] : b)
+        ? -1
+        : (item ? a[item] : a) < (item ? b[item] : b)
+          ? 1
+          : 0;
     };
   }
 }

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

@@ -12,24 +12,30 @@ export function shuffleArray<T extends any[]>(items: T): T;
 /**
  * Generates an array with repeated phases according to counts.
  *
- * @param {any[]} phases - Array of phase names, e.g., ['Full', 'Half1', 'Half2', 'New'].
+ * @template {any} BlockValue
+ * @param {BlockValue[]} phases - Array of phase names, e.g., ['Full', 'Half1', 'Half2', 'New'].
  * @param {number[]} counts - Array of integers specifying how many times to repeat each phase, e.g., [4,5,5,4].
- * @returns {any[]} - Flattened array containing phases repeated according to counts, concatenated in order.
+ * @returns {BlockValue[]} - Flattened array containing phases repeated according to counts, concatenated in order.
+ */
+export function multiplyArrayBlocks<BlockValue extends unknown>(phases: BlockValue[], counts: number[]): BlockValue[];
+/**
+ * @template T
+ * @typedef {Object} DiffArrayListData
+ * @property {T[]} added - Items that only exist in the new array.
+ * @property {T[]} removed - Items that only existed in the old array.
  */
-export function multiplyArrayBlocks(phases: any[], counts: number[]): any[];
 /**
  * Diff two class lists.
- * @param {any[]} oldItems
- * @param {any[]} newItems
+ * @template T
+ * @param {T[]} oldItems - The original/old array for comparison.
+ * @param {T[]} newItems - The new array for comparison.
+ * @returns {DiffArrayListData<T>} An object containing arrays of added and removed items.
  */
-export function diffArrayList(oldItems: any[], newItems: any[]): {
-    added: any[];
-    removed: any[];
-};
+export function diffArrayList<T>(oldItems: T[], newItems: T[]): DiffArrayListData<T>;
 /**
  * Generates a comparator function to sort an array of objects by a given key.
  *
- * @param {string} item - The object key to sort by.
+ * @param {string|null} [item] - The object key to sort by.
  * @param {boolean} [isReverse=false] - If `true`, the sorting will be in descending order.
  * @returns {(a: Object<string|number, *>, b: Object<string|number, *>) => number} Comparator function compatible with Array.prototype.sort().
  *
@@ -41,5 +47,15 @@ export function diffArrayList(oldItems: any[], newItems: any[]): {
  * const arr = [{ pos: 2 }, { pos: 1 }, { pos: 3 }];
  * arr.sort(arraySortPositions('pos', true)); // Descending: [{pos: 3}, {pos: 2}, {pos: 1}]
  */
-export function arraySortPositions(item: string, isReverse?: boolean): (a: any, b: any) => number;
+export function arraySortPositions(item?: string | null, isReverse?: boolean): (a: any, b: any) => number;
+export type DiffArrayListData<T> = {
+    /**
+     * - Items that only exist in the new array.
+     */
+    added: T[];
+    /**
+     * - Items that only existed in the old array.
+     */
+    removed: T[];
+};
 //# sourceMappingURL=array.d.mts.map

package/dist/v1/basics/array.mjs

@@ -10,6 +10,9 @@
  * @returns {T} The same array instance, now shuffled in place.
  */
 export function shuffleArray(items) {
+    if (!Array.isArray(items)) {
+        throw new TypeError("Argument 'items' must be an array.");
+    }
     let currentIndex = items.length, randomIndex;
     // While there remain elements to shuffle...
     while (currentIndex !== 0) {
@@ -24,27 +27,52 @@ export function shuffleArray(items) {
 /**
  * Generates an array with repeated phases according to counts.
  *
- * @param {any[]} phases - Array of phase names, e.g., ['Full', 'Half1', 'Half2', 'New'].
+ * @template {any} BlockValue
+ * @param {BlockValue[]} phases - Array of phase names, e.g., ['Full', 'Half1', 'Half2', 'New'].
  * @param {number[]} counts - Array of integers specifying how many times to repeat each phase, e.g., [4,5,5,4].
- * @returns {any[]} - Flattened array containing phases repeated according to counts, concatenated in order.
+ * @returns {BlockValue[]} - Flattened array containing phases repeated according to counts, concatenated in order.
  */
 export function multiplyArrayBlocks(phases, counts) {
-    // phases: array de strings, cada fase (ex: ['Full', 'Half1', 'Half2', 'New'])
-    // counts: array de inteiros, quantas vezes repetir cada fase (ex: [4,5,5,4])
+    if (!Array.isArray(phases)) {
+        throw new TypeError("Argument 'phases' must be an array.");
+    }
+    if (!Array.isArray(counts)) {
+        throw new TypeError("Argument 'counts' must be an array.");
+    }
+    if (phases.length !== counts.length) {
+        throw new RangeError("The 'phases' and 'counts' arrays must have the same length.");
+    }
     const result = [];
     for (let i = 0; i < phases.length; i++) {
+        if (typeof counts[i] !== 'number' || Number.isNaN(counts[i])) {
+            throw new TypeError(`Element at counts[${i}] must be a valid number.`);
+        }
         for (let j = 0; j < counts[i]; j++) {
             result.push(phases[i]);
         }
     }
     return result;
 }
+/**
+ * @template T
+ * @typedef {Object} DiffArrayListData
+ * @property {T[]} added - Items that only exist in the new array.
+ * @property {T[]} removed - Items that only existed in the old array.
+ */
 /**
  * Diff two class lists.
- * @param {any[]} oldItems
- * @param {any[]} newItems
+ * @template T
+ * @param {T[]} oldItems - The original/old array for comparison.
+ * @param {T[]} newItems - The new array for comparison.
+ * @returns {DiffArrayListData<T>} An object containing arrays of added and removed items.
  */
 export function diffArrayList(oldItems, newItems) {
+    if (!Array.isArray(oldItems)) {
+        throw new TypeError("Argument 'oldItems' must be an array.");
+    }
+    if (!Array.isArray(newItems)) {
+        throw new TypeError("Argument 'newItems' must be an array.");
+    }
     const removed = oldItems.filter((c) => !newItems.includes(c));
     const added = newItems.filter((c) => !oldItems.includes(c));
     return { added, removed };
@@ -52,7 +80,7 @@ export function diffArrayList(oldItems, newItems) {
 /**
  * Generates a comparator function to sort an array of objects by a given key.
  *
- * @param {string} item - The object key to sort by.
+ * @param {string|null} [item] - The object key to sort by.
  * @param {boolean} [isReverse=false] - If `true`, the sorting will be in descending order.
  * @returns {(a: Object<string|number, *>, b: Object<string|number, *>) => number} Comparator function compatible with Array.prototype.sort().
  *
@@ -65,14 +93,28 @@ export function diffArrayList(oldItems, newItems) {
  * arr.sort(arraySortPositions('pos', true)); // Descending: [{pos: 3}, {pos: 2}, {pos: 1}]
  */
 export function arraySortPositions(item, isReverse = false) {
+    if (item !== undefined && item !== null && typeof item !== 'string') {
+        throw new TypeError("Argument 'item' must be a string or null.");
+    }
+    if (typeof isReverse !== 'boolean') {
+        throw new TypeError("Argument 'isReverse' must be a boolean.");
+    }
     if (!isReverse) {
         return function (a, b) {
-            return a[item] < b[item] ? -1 : a[item] > b[item] ? 1 : 0;
+            return (item ? a[item] : a) < (item ? b[item] : b)
+                ? -1
+                : (item ? a[item] : a) > (item ? b[item] : b)
+                    ? 1
+                    : 0;
         };
     }
     else {
         return function (a, b) {
-            return a[item] > b[item] ? -1 : a[item] < b[item] ? 1 : 0;
+            return (item ? a[item] : a) > (item ? b[item] : b)
+                ? -1
+                : (item ? a[item] : a) < (item ? b[item] : b)
+                    ? 1
+                    : 0;
         };
     }
 }

package/dist/v1/basics/clock.cjs

@@ -4,33 +4,43 @@
  * Calculates the time duration between the current time and a given time offset.
  *
  * @param {Date} timeData - The target time as a Date object.
- * @param {string} [durationType='asSeconds'] - The type of duration to return. Can be 'asMilliseconds', 'asSeconds', 'asMinutes', 'asHours', 'asDays'.
+ * @param {'asMilliseconds'|'asSeconds'|'asMinutes'|'asHours'|'asDays'} [durationType='asSeconds'] - The type of duration to return.
  * @param {Date|null} [now=null] - The current time as a Date object. Defaults to the current date and time if not provided.
  * @returns {number|null} The calculated duration in the specified unit, or `null` if `timeData` is not provided.
  */
 function getTimeDuration(timeData = new Date(), durationType = 'asSeconds', now = null) {
-  if (timeData instanceof Date) {
-    const currentTime = now instanceof Date ? now : new Date();
-    /** @type {number} */
-    const diffMs = timeData.getTime() - currentTime.getTime();
-
-    switch (durationType) {
-      case 'asMilliseconds':
-        return diffMs;
-      case 'asSeconds':
-        return diffMs / 1000;
-      case 'asMinutes':
-        return diffMs / (1000 * 60);
-      case 'asHours':
-        return diffMs / (1000 * 60 * 60);
-      case 'asDays':
-        return diffMs / (1000 * 60 * 60 * 24);
-      default:
-        return diffMs / 1000; // default to seconds
-    }
+  if (!(timeData instanceof Date)) {
+    throw new TypeError("The 'timeData' argument must be an instance of Date.");
+  }
+  if (typeof durationType !== 'string') {
+    throw new TypeError("The 'durationType' argument must be a string.");
+  }
+  const validDurationTypes = ['asMilliseconds', 'asSeconds', 'asMinutes', 'asHours', 'asDays'];
+  if (!validDurationTypes.includes(durationType)) {
+    throw new RangeError(`The 'durationType' must be one of: ${validDurationTypes.join(', ')}.`);
+  }
+  if (now !== null && !(now instanceof Date)) {
+    throw new TypeError("The 'now' argument must be an instance of Date or null.");
   }
 
-  return null;
+  const currentTime = now instanceof Date ? now : new Date();
+  /** @type {number} */
+  const diffMs = timeData.getTime() - currentTime.getTime();
+
+  switch (durationType) {
+    case 'asMilliseconds':
+      return diffMs;
+    case 'asSeconds':
+      return diffMs / 1000;
+    case 'asMinutes':
+      return diffMs / (1000 * 60);
+    case 'asHours':
+      return diffMs / (1000 * 60 * 60);
+    case 'asDays':
+      return diffMs / (1000 * 60 * 60 * 24);
+    default:
+      return diffMs / 1000; // default to seconds
+  }
 }
 
 /**
@@ -43,9 +53,21 @@ function getTimeDuration(timeData = new Date(), durationType = 'asSeconds', now
  * @returns {string} The formatted timer string.
  */
 function formatCustomTimer(totalSeconds, level = 'seconds', format = '{time}') {
-  totalSeconds = Math.max(0, Math.floor(totalSeconds));
-
+  if (typeof totalSeconds !== 'number' || Number.isNaN(totalSeconds)) {
+    throw new TypeError("The 'totalSeconds' argument must be a valid number.");
+  }
+  if (typeof level !== 'string') {
+    throw new TypeError("The 'level' argument must be a string.");
+  }
   const levels = ['seconds', 'minutes', 'hours', 'days', 'months', 'years'];
+  if (!levels.includes(level)) {
+    throw new RangeError(`The 'level' must be one of: ${levels.join(', ')}.`);
+  }
+  if (typeof format !== 'string') {
+    throw new TypeError("The 'format' argument must be a string.");
+  }
+
+  totalSeconds = Math.max(0, Math.floor(totalSeconds));
   const index = levels.indexOf(level);
 
   const include = {
@@ -59,13 +81,13 @@ function formatCustomTimer(totalSeconds, level = 'seconds', format = '{time}') {
 
   /**
    * @type {{
-   *   years: number|NaN,
-   *   months: number|NaN,
-   *   days: number|NaN,
-   *   hours: number|NaN,
-   *   minutes: number|NaN,
-   *   seconds: number|NaN,
-   *   total: number|NaN
+   * years: number|NaN,
+   * months: number|NaN,
+   * days: number|NaN,
+   * hours: number|NaN,
+   * minutes: number|NaN,
+   * seconds: number|NaN,
+   * total: number|NaN
    * }}
    */
   const parts = {
@@ -144,6 +166,16 @@ function formatCustomTimer(totalSeconds, level = 'seconds', format = '{time}') {
     parts.seconds = remaining;
   }
 
+  // Calculate total
+  /** const totalMap = {
+    seconds: include.seconds ? totalSeconds : NaN,
+    minutes: include.minutes ? totalSeconds / 60 : NaN,
+    hours: include.hours ? totalSeconds / 3600 : NaN,
+    days: include.days ? totalSeconds / 86400 : NaN,
+    months: include.months ? parts.years * 12 + parts.months + (parts.days || 0) / 30 : NaN,
+    years: include.years ? parts.years + (parts.months || 0) / 12 + (parts.days || 0) / 365 : NaN,
+  }; */
+
   parts.total = +totalSeconds.toFixed(2).replace(/\.00$/, '');
 
   /**
@@ -186,6 +218,9 @@ function formatCustomTimer(totalSeconds, level = 'seconds', format = '{time}') {
  * @returns {string} The formatted timer string in "HH:MM:SS" format.
  */
 function formatTimer(seconds) {
+  if (typeof seconds !== 'number' || Number.isNaN(seconds)) {
+    throw new TypeError("The 'seconds' argument must be a valid number.");
+  }
   return formatCustomTimer(seconds, 'hours', '{hours}:{minutes}:{seconds}');
 }
 
@@ -198,6 +233,9 @@ function formatTimer(seconds) {
  * @returns {string} The formatted timer string in "Xd HH:MM:SS" format.
  */
 function formatDayTimer(seconds) {
+  if (typeof seconds !== 'number' || Number.isNaN(seconds)) {
+    throw new TypeError("The 'seconds' argument must be a valid number.");
+  }
   return formatCustomTimer(seconds, 'days', '{days}d {hours}:{minutes}:{seconds}');
 }
 
@@ -207,20 +245,29 @@ function formatDayTimer(seconds) {
  * @param {number} totalMs - The total duration in milliseconds.
  * @param {'milliseconds'|'seconds'|'minutes'|'hours'|'days'|'months'|'years'} [level='milliseconds'] - The highest level to calculate and display.
  * @returns {{
- *   years: number|NaN,
- *   months: number|NaN,
- *   days: number|NaN,
- *   hours: number|NaN,
- *   minutes: number|NaN,
- *   seconds: number|NaN,
- *   milliseconds: number|NaN,
- *   total: number|NaN
+ * years: number|NaN,
+ * months: number|NaN,
+ * days: number|NaN,
+ * hours: number|NaN,
+ * minutes: number|NaN,
+ * seconds: number|NaN,
+ * milliseconds: number|NaN,
+ * total: number|NaN
  * }}
  */
 function breakdownDuration(totalMs, level = 'milliseconds') {
-  totalMs = Math.max(0, Math.floor(totalMs));
-
+  if (typeof totalMs !== 'number' || Number.isNaN(totalMs)) {
+    throw new TypeError("The 'totalMs' argument must be a valid number.");
+  }
+  if (typeof level !== 'string') {
+    throw new TypeError("The 'level' argument must be a string.");
+  }
   const levels = ['milliseconds', 'seconds', 'minutes', 'hours', 'days', 'months', 'years'];
+  if (!levels.includes(level)) {
+    throw new RangeError(`The 'level' must be one of: ${levels.join(', ')}.`);
+  }
+
+  totalMs = Math.max(0, Math.floor(totalMs));
   const index = levels.indexOf(level);
 
   const include = {
@@ -316,10 +363,15 @@ function breakdownDuration(totalMs, level = 'milliseconds') {
   }
 
   // Totals
-  ({
+  /** const totalMap = {
+    milliseconds: include.milliseconds ? totalMs : NaN,
+    seconds: include.seconds ? totalMs / 1000 : NaN,
+    minutes: include.minutes ? totalMs / 60000 : NaN,
+    hours: include.hours ? totalMs / 3600000 : NaN,
+    days: include.days ? totalMs / 86400000 : NaN,
     months: include.months ? parts.years * 12 + parts.months + (parts.days || 0) / 30 : NaN,
     years: include.years ? parts.years + (parts.months || 0) / 12 + (parts.days || 0) / 365 : NaN,
-  });
+  }; */
 
   parts.total = +totalMs;
 

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

@@ -2,11 +2,11 @@
  * Calculates the time duration between the current time and a given time offset.
  *
  * @param {Date} timeData - The target time as a Date object.
- * @param {string} [durationType='asSeconds'] - The type of duration to return. Can be 'asMilliseconds', 'asSeconds', 'asMinutes', 'asHours', 'asDays'.
+ * @param {'asMilliseconds'|'asSeconds'|'asMinutes'|'asHours'|'asDays'} [durationType='asSeconds'] - The type of duration to return.
  * @param {Date|null} [now=null] - The current time as a Date object. Defaults to the current date and time if not provided.
  * @returns {number|null} The calculated duration in the specified unit, or `null` if `timeData` is not provided.
  */
-export function getTimeDuration(timeData?: Date, durationType?: string, now?: Date | null): number | null;
+export function getTimeDuration(timeData?: Date, durationType?: "asMilliseconds" | "asSeconds" | "asMinutes" | "asHours" | "asDays", now?: Date | null): number | null;
 /**
  * Formats a custom timer string based on total seconds and a detail level.
  * Includes proper reallocation of lower units into higher ones, ensuring consistent hierarchy.
@@ -41,14 +41,14 @@ export function formatDayTimer(seconds: number): string;
  * @param {number} totalMs - The total duration in milliseconds.
  * @param {'milliseconds'|'seconds'|'minutes'|'hours'|'days'|'months'|'years'} [level='milliseconds'] - The highest level to calculate and display.
  * @returns {{
- *   years: number|NaN,
- *   months: number|NaN,
- *   days: number|NaN,
- *   hours: number|NaN,
- *   minutes: number|NaN,
- *   seconds: number|NaN,
- *   milliseconds: number|NaN,
- *   total: number|NaN
+ * years: number|NaN,
+ * months: number|NaN,
+ * days: number|NaN,
+ * hours: number|NaN,
+ * minutes: number|NaN,
+ * seconds: number|NaN,
+ * milliseconds: number|NaN,
+ * total: number|NaN
  * }}
  */
 export function breakdownDuration(totalMs: number, level?: "milliseconds" | "seconds" | "minutes" | "hours" | "days" | "months" | "years"): {