tsu 2.9.1 → 2.10.1

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";var d=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var N=Object.getOwnPropertyNames;var U=Object.prototype.hasOwnProperty;var E=(e,n)=>{for(var t in n)d(e,t,{get:n[t],enumerable:!0})},M=(e,n,t,r)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of N(n))!U.call(e,o)&&o!==t&&d(e,o,{get:()=>n[o],enumerable:!(r=C(n,o))||r.enumerable});return e};var S=e=>M(d({},"__esModule",{value:!0}),e);var Le={};E(Le,{capitalise:()=>ke,ceil:()=>F,chars:()=>Oe,clamp:()=>I,clone:()=>m,copyToClipboard:()=>de,debounce:()=>he,deepMerge:()=>O,drop:()=>te,floor:()=>L,groupsOf:()=>re,head:()=>oe,init:()=>ie,isArray:()=>l,isBlank:()=>Ae,isBoolean:()=>_,isBrowser:()=>p,isDefined:()=>$,isEmpty:()=>Ce,isEmptyArray:()=>z,isEmptyObject:()=>J,isEven:()=>q,isFunction:()=>K,isNull:()=>c,isNumber:()=>x,isObject:()=>a,isObjectLike:()=>f,isOdd:()=>R,isString:()=>b,isTouchDevice:()=>Y,isUndefined:()=>Z,isWindow:()=>G,last:()=>ue,max:()=>V,memoize:()=>we,min:()=>D,noop:()=>Q,once:()=>ve,partition:()=>le,product:()=>B,randomChance:()=>P,randomNumber:()=>s,range:()=>se,replaceChar:()=>Ne,round:()=>W,scroll:()=>xe,shuffle:()=>ce,sleep:()=>ee,splitAt:()=>ae,splitStrAt:()=>Ue,sum:()=>X,tail:()=>fe,take:()=>me,throttle:()=>je,toArray:()=>pe,toCamel:()=>Ee,toKebab:()=>Me,toNumber:()=>Se,toOrdinal:()=>Fe,toRomanNumerals:()=>H,truncate:()=>Ie,uniq:()=>T,uuid:()=>ne});module.exports=S(Le);function F(e,n=1){let t=e/n;return Math.ceil(t)*n}function I(e,n,t){return Math.min(t,Math.max(n,e))}function L(e,n=1){let t=e/n;return Math.floor(t)*n}function q(e){return e%2===0}function R(e){return e%2!==0}function V(...e){let n;return e.length===1&&Array.isArray(e[0])?n=e[0]:n=e,Math.max(...n)}function D(...e){let n;return e.length===1&&Array.isArray(e[0])?n=e[0]:n=e,Math.min(...n)}function B(e){let n=1;for(let t=0;t<e.length;t++)n*=e[t];return n}function P(e){return s(e)===0}function s(...e){let n,t;return e.length===1?(n=0,t=e[0]):(n=e[0],t=e[1]),Math.floor(Math.random()*(t-n))+n}function W(e,n=1){let t=e/n;return Math.round(t)*n}function X(e){let n=0;for(let t=0;t<e.length;t++)n+=e[t];return n}var j={1:"I",4:"IV",5:"V",9:"IX",10:"X",40:"XL",50:"L",90:"XC",100:"C",400:"CD",500:"D",900:"CM",1e3:"M"};function H(e,n=!1){let t=e,r="",o=Object.keys(j).map(Number).sort((i,u)=>u-i);for(let i of o)for(;t>=i;)r+=j[i],t-=i;return n?r.toLowerCase():r}function l(e){return Array.isArray(e)}function _(e){return typeof e=="boolean"}function p(){return typeof window<"u"}function $(e){return typeof e<"u"}function z(e){return l(e)&&e.length===0}function J(e){if(!a(e))return!1;for(let n in e)return!1;return!0}function K(e){return typeof e=="function"}function c(e){return Object.prototype.toString.call(e)==="[object Null]"}function x(e){return typeof e=="number"}function a(e){return Object.prototype.toString.call(e)==="[object Object]"}function f(e){return typeof e=="object"}function b(e){return typeof e=="string"}function Y(){return"ontouchstart"in window||navigator.maxTouchPoints>0}function Z(e){return typeof e>"u"}function G(e){return p()&&Object.prototype.toString.call(e)==="[object Window]"}function m(e){if(l(e)){let n=[];for(let t=0;t<e.length;t++)f(e[t])&&!c(e[t])?n[t]=m(e[t]):n[t]=e[t];return n}if(f(e)&&!c(e)){let n={};for(let t in e)f(e[t])&&!c(e[t])?n[t]=m(e[t]):n[t]=e[t];return n}return e}function Q(){}async function ee(e){return e<0&&console.warn("[tsu] warning: a sleep duration less than 0ms will be treated as 0ms."),new Promise(n=>{setTimeout(n,e)})}var k="useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";function ne(e=16){let n=k.length,t=e,r="";for(;t--;)r+=k[s(n)];return r}function te(e,n){return e<=0?[...n]:n.slice(e)}function re(e,n){if(e<=0)throw new Error("[tsu] Invalid group size. Is it greater than 0?");if(e>=n.length)return[[...n]];let t=[];for(let r=0;r<n.length;r+=e)t.push(n.slice(r,r+e));return t}function oe(e){return e[0]}function ie(e){return e.slice(0,e.length-1)}function ue(e){return e[e.length-1]}function le(e,n){let t=[],r=[];for(let o=0;o<e.length;o++){let i=e[o];n(i,o,e)?t.push(i):r.push(i)}return[t,r]}function se(...e){let n,t,r;e.length===1?(t=e[0],n=0,r=1):(n=e[0],t=e[1],r=e[2]||1),r<=0&&(console.warn("[tsu] warning: a step less than or equal to 0 will be set to 1."),r=1);let o=[],i=n;for(;i<t;)o.push(i),i+=r||1;return o}function ce(e){let n=m(e),t,r,o;for(t=n.length;t;t-=1)r=s(t),o=n[t-1],n[t-1]=n[r],n[r]=o;return n}function ae(e,n){return e<=0?[[],[...n]]:e>n.length?[[...n],[]]:[n.slice(0,e),n.slice(e)]}function fe(e){return e.slice(1)}function me(e,n){return e<=0?[]:n.slice(0,e)}function pe(e){return e?Array.isArray(e)?e:[e]:[]}function T(e){return Array.from(new Set(e))}function be(e){let n=document.createElement("textarea");n.value=e??"",n.style.position="absolute",n.style.opacity="0",document.body.appendChild(n),n.select(),document.execCommand("copy"),n.remove()}function de(e){p()&&(window.navigator&&"clipboard"in window.navigator?navigator.clipboard.writeText(e):be(e))}function xe({to:e,offset:n=0,duration:t=1e3,container:r=null}){let o=b(e)?document.querySelector(e):e,i=b(r)?document.querySelector(r):r,u=i?.scrollTop||window?.pageYOffset||0,g=(x(o)?o:ye(o,u))+n,A=Date.now();function y(){let h=Date.now()-A,w=h<t,v=w?ge(u,g,h,t):g;w&&requestAnimationFrame(y),i?i.scrollTop=v:window.scrollTo(0,v)}y()}function Te(e){return e<.5?4*Math.pow(e,3):(e-1)*(2*e-2)*(2*e-2)+1}function ge(e,n,t,r){return e+(n-e)*Te(t/r)}function ye(e,n){return e.nodeName==="HTML"?-n:e.getBoundingClientRect().top+n}function he(e,n){n<0&&console.warn("[tsu] warning: a debounce delay less than 0ms will be treated as 0ms.");let t;return function(...r){clearTimeout(t),t=setTimeout(()=>{clearTimeout(t),e(...r)},n)}}function we(e){let n={};return function(...t){let r=JSON.stringify(t);if(r in n)return n[r];let o=e(...t);return n[r]=o,o}}function ve(e){let n=!1;return(...t)=>{n||(e(...t),n=!0)}}function je(e,n){n<0&&console.warn("[tsu] warning: a throttle limit less than 0ms will be treated as 0ms.");let t=!1;return function(...r){t||(e(...r),t=!0,setTimeout(()=>{t=!1},n))}}function O(...e){let n={};for(let t=0;t<e.length;t++){let r=e[t],o=Object.keys(r);for(let i=0;i<o.length;i++){let u=o[i];l(n[u])&&l(r[u])?n[u]=T(n[u].concat(r[u])):a(n[u])&&a(r[u])?n[u]=O(n[u],r[u]):n[u]=r[u]}}return n}function ke(e,n=!1,t=" "){return n?e.split(t).map(r=>r.charAt(0).toUpperCase()+r.slice(1)).join(t):e.charAt(0).toUpperCase()+e.slice(1)}function Oe(e){return e.split("")}function Ae(e){return e.trim().length===0}function Ce(e){return e.length===0}function Ne(e,n,t){return n<0||n>e.length-1?e:e.slice(0,n)+t+e.slice(n+1)}function Ue(e,n){return n<=0?["",e]:n>e.length?[e,""]:[e.slice(0,n),e.slice(n)]}function Ee(e){let n=/-(\w)/g;return e.replace(n,(t,r)=>r?r.toUpperCase():"")}function Me(e){let n=/\B([A-Z])/g;return e.replace(n,"-$1").toLowerCase()}function Se(e){return e.length?Number(e.replace(/[#£€$,%]/g,"")):NaN}function Fe(e){let t=["st","nd","rd"][(e/10%10^1&&e%10)-1]||"th";return`${e}${t}`}function Ie(e,n,t="..."){return n<=0?t:e.slice(0,n)+t}0&&(module.exports={capitalise,ceil,chars,clamp,clone,copyToClipboard,debounce,deepMerge,drop,floor,groupsOf,head,init,isArray,isBlank,isBoolean,isBrowser,isDefined,isEmpty,isEmptyArray,isEmptyObject,isEven,isFunction,isNull,isNumber,isObject,isObjectLike,isOdd,isString,isTouchDevice,isUndefined,isWindow,last,max,memoize,min,noop,once,partition,product,randomChance,randomNumber,range,replaceChar,round,scroll,shuffle,sleep,splitAt,splitStrAt,sum,tail,take,throttle,toArray,toCamel,toKebab,toNumber,toOrdinal,toRomanNumerals,truncate,uniq,uuid});
+"use strict";var x=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var M=Object.getOwnPropertyNames;var F=Object.prototype.hasOwnProperty;var S=(e,r)=>{for(var t in r)x(e,t,{get:r[t],enumerable:!0})},U=(e,r,t,n)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of M(r))!F.call(e,o)&&o!==t&&x(e,o,{get:()=>r[o],enumerable:!(n=E(r,o))||n.enumerable});return e};var L=e=>U(x({},"__esModule",{value:!0}),e);var We={};S(We,{average:()=>W,capitalise:()=>N,capitalize:()=>Me,ceil:()=>X,chars:()=>Fe,clamp:()=>d,clone:()=>p,copyToClipboard:()=>ge,debounce:()=>ve,drop:()=>D,es:()=>me,floor:()=>z,groups:()=>R,head:()=>q,init:()=>B,isArray:()=>f,isBlank:()=>Se,isBoolean:()=>ee,isBrowser:()=>m,isDefined:()=>re,isEmpty:()=>Ue,isEmptyArray:()=>te,isEmptyObject:()=>ne,isEven:()=>H,isFunction:()=>oe,isNull:()=>s,isNumber:()=>g,isObject:()=>T,isObjectLike:()=>l,isOdd:()=>_,isString:()=>a,isTouchDevice:()=>ie,isUndefined:()=>ue,isWindow:()=>fe,ks:()=>se,last:()=>I,max:()=>V,memoise:()=>k,memoize:()=>ke,min:()=>J,noop:()=>Ae,once:()=>Oe,partition:()=>$,product:()=>K,randomChance:()=>Y,randomNumber:()=>u,range:()=>P,replaceChar:()=>Le,round:()=>Z,scroll:()=>je,shuffle:()=>pe,sleep:()=>Ce,splitArray:()=>ce,splitString:()=>De,sum:()=>b,tail:()=>ae,take:()=>xe,throttle:()=>Ne,toArray:()=>be,toCamel:()=>Re,toDp:()=>G,toKebab:()=>qe,toNumber:()=>Q,toOrdinal:()=>Be,toRomanNumerals:()=>Ie,truncate:()=>$e,unchars:()=>Pe,uniq:()=>de,uuid:()=>Ee,vs:()=>le});module.exports=L(We);function D(e,r){return e<=0?[...r]:r.slice(e)}function R(e,r){if(r<=0)throw new Error("[tsu] Invalid group size. Is it greater than 0?");if(r>=e.length)return[[...e]];let t=[];for(let n=0;n<e.length;n+=r)t.push(e.slice(n,n+r));return t}function q(e){return e[0]}function B(e){return e.slice(0,e.length-1)}function I(e){return e[e.length-1]}function $(e,r){let t=[],n=[];for(let o=0;o<e.length;o++){let i=e[o];r(i,o,e)?t.push(i):n.push(i)}return[t,n]}function P(...e){let r,t,n;e.length===1?(t=e[0],r=0,n=1):(r=e[0],t=e[1],n=e[2]||1),n<=0&&(console.warn("[tsu] warning: a step less than or equal to 0 will be set to 1."),n=1);let o=[],i=r;for(;i<t;)o.push(i),i+=n||1;return o}function W(e){return e.length<1?0:b(e)/e.length}function X(e,r=1){let t=e/r;return Math.ceil(t)*r}function d(e,r,t){return Math.min(t,Math.max(r,e))}function z(e,r=1){let t=e/r;return Math.floor(t)*r}function H(e){return e%2===0}function _(e){return e%2!==0}function V(...e){let r;return e.length===1&&Array.isArray(e[0])?r=e[0]:r=e,Math.max(...r)}function J(...e){let r;return e.length===1&&Array.isArray(e[0])?r=e[0]:r=e,Math.min(...r)}function K(e){if(e.length<1)return 0;let r=1;for(let t=0;t<e.length;t++)r*=e[t];return r}function u(...e){let r,t;return e.length===1?(r=0,t=e[0]):(r=e[0],t=e[1]),Math.floor(Math.random()*(t-r))+r}function Y(e){return u(e)===0}function Z(e,r=1){let t=e/r;return Math.round(t)*r}function b(e){let r=0;for(let t=0;t<e.length;t++)r+=e[t];return r}function G(e,r=0){r<0&&console.warn("[tsu] warning: decimalPlaces less than 0 are set to 0."),r>100&&console.warn("[tsu] warning: decimalPlaces greater than 100 are set to 100.");let t=d(r,0,100);return Number(e.toFixed(t))}function Q(e,r=[]){if(!e.length)return NaN;let t=["#","\xA3","\u20AC","$","%",",",...r],n=new RegExp(`[${t.join("")}]`,"g");return Number(e.replace(n,""))}function f(e){return Array.isArray(e)}function ee(e){return typeof e=="boolean"}function m(){return typeof window<"u"}function re(e){return typeof e<"u"}function te(e){return f(e)&&e.length===0}function ne(e){if(!T(e))return!1;for(let r in e)return!1;return!0}function oe(e){return typeof e=="function"}function s(e){return Object.prototype.toString.call(e)==="[object Null]"}function g(e){return typeof e=="number"}function T(e){return Object.prototype.toString.call(e)==="[object Object]"}function l(e){return typeof e=="object"}function a(e){return typeof e=="string"}function ie(){return"ontouchstart"in window||navigator.maxTouchPoints>0}function ue(e){return typeof e>"u"}function fe(e){return m()&&Object.prototype.toString.call(e)==="[object Window]"}function p(e){if(f(e)){let r=[];for(let t=0;t<e.length;t++)l(e[t])&&!s(e[t])?r[t]=p(e[t]):r[t]=e[t];return r}if(l(e)&&!s(e)){let r={};for(let t in e)l(e[t])&&!s(e[t])?r[t]=p(e[t]):r[t]=e[t];return r}return e}function me(e){return Object.entries(e)}function se(e){return Object.keys(e)}function le(e){return Object.values(e)}function pe(e){let r=p(e),t,n,o;for(t=r.length;t;t-=1)n=u(t),o=r[t-1],r[t-1]=r[n],r[n]=o;return r}function ce(e,r){return r<=0?[[],[...e]]:r>e.length?[[...e],[]]:[e.slice(0,r),e.slice(r)]}function ae(e){return e.slice(1)}function xe(e,r){return e<=0?[]:r.slice(0,e)}function be(e){return e?Array.isArray(e)?e:[e]:[]}function de(e){return Array.from(new Set(e))}function Te(e){let r=document.createElement("textarea");r.value=e??"",r.style.position="absolute",r.style.opacity="0",document.body.appendChild(r),r.select(),document.execCommand("copy"),r.remove()}function ge(e){m()&&(window.navigator&&"clipboard"in window.navigator?navigator.clipboard.writeText(e):Te(e))}function ye(e){return e<.5?4*Math.pow(e,3):(e-1)*(2*e-2)*(2*e-2)+1}function he(e,r,t,n){return e+(r-e)*ye(t/n)}function we(e,r){return e.nodeName==="HTML"?-r:e.getBoundingClientRect().top+r}function je({to:e,offset:r=0,duration:t=1e3,container:n=null}){let o=a(e)?document.querySelector(e):e,i=a(n)?document.querySelector(n):n,c=i?.scrollTop||window?.pageYOffset||0,y=(g(o)?o:we(o,c))+r,C=Date.now();function h(){let w=Date.now()-C,j=w<t,v=j?he(c,y,w,t):y;j&&requestAnimationFrame(h),i?i.scrollTop=v:window.scrollTo(0,v)}h()}function ve(e,r){r<0&&console.warn("[tsu] warning: debounce delays less than 0 will be set to 0.");let t;return function(...n){clearTimeout(t),t=setTimeout(()=>{clearTimeout(t),e(...n)},r)}}function k(e){let r={};return function(...t){let n=JSON.stringify(t);if(n in r)return r[n];let o=e(...t);return r[n]=o,o}}var ke=k;function Oe(e){let r=!1;return(...t)=>{r||(e(...t),r=!0)}}function Ne(e,r){r<0&&console.warn("[tsu] warning: throttle limits less than 0 will be set to 0.");let t=!1;return function(...n){t||(e(...n),t=!0,setTimeout(()=>{t=!1},r))}}function Ae(){}async function Ce(e){return e<0&&console.warn("[tsu] warning: sleep durations less than 0 are set to 0."),new Promise(r=>{setTimeout(r,e)})}var O="useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";function Ee(e=16){let r=O.length,t=e,n="";for(;t--;)n+=O[u(r)];return n}function N(e,r=!1,t=" "){return r?e.split(t).map(n=>n.charAt(0).toUpperCase()+n.slice(1)).join(t):e.charAt(0).toUpperCase()+e.slice(1)}var Me=N;function Fe(e){return e.split("")}function Se(e){return e.trim().length===0}function Ue(e){return e.length===0}function Le(e,r,t){return r<0||r>e.length-1?e:e.slice(0,r)+t+e.slice(r+1)}function De(e,r){return r<=0?["",e]:r>e.length?[e,""]:[e.slice(0,r),e.slice(r)]}function Re(e){let r=/-(\w)/g;return e.replace(r,(t,n)=>n?n.toUpperCase():"")}function qe(e){let r=/\B([A-Z])/g;return e.replace(r,"-$1").toLowerCase()}function Be(e){let t=["st","nd","rd"][(Math.abs(e)/10%10^1&&Math.abs(e)%10)-1]||"th";return`${e}${t}`}var A={1:"I",4:"IV",5:"V",9:"IX",10:"X",40:"XL",50:"L",90:"XC",100:"C",400:"CD",500:"D",900:"CM",1e3:"M"};function Ie(e,r=!1){let t=e,n="",o=Object.keys(A).map(Number).sort((i,c)=>c-i);for(let i of o)for(;t>=i;)n+=A[i],t-=i;return r?n.toLowerCase():n}function $e(e,r,t="..."){return r<=0?t:e.slice(0,r)+t}function Pe(e){return e.join("")}0&&(module.exports={average,capitalise,capitalize,ceil,chars,clamp,clone,copyToClipboard,debounce,drop,es,floor,groups,head,init,isArray,isBlank,isBoolean,isBrowser,isDefined,isEmpty,isEmptyArray,isEmptyObject,isEven,isFunction,isNull,isNumber,isObject,isObjectLike,isOdd,isString,isTouchDevice,isUndefined,isWindow,ks,last,max,memoise,memoize,min,noop,once,partition,product,randomChance,randomNumber,range,replaceChar,round,scroll,shuffle,sleep,splitArray,splitString,sum,tail,take,throttle,toArray,toCamel,toDp,toKebab,toNumber,toOrdinal,toRomanNumerals,truncate,unchars,uniq,uuid,vs});

package/dist/index.d.cts

@@ -1,9 +1,3 @@
-type Arrayable<T> = T | Array<T>;
-type Nullable<T> = T | null | undefined;
-type Fn<T = any> = (...args: any[]) => T;
-type VoidFn = Fn<void>;
-type Obj<V = unknown> = Record<string | symbol | number, V>;
-
 /**
  * Removes the first `n` items of an array.
  *
@@ -12,14 +6,16 @@ type Obj<V = unknown> = Record<string | symbol | number, V>;
  * @returns The remaining items.
  */
 declare function drop<T>(n: number, array: readonly T[]): T[];
+
 /**
  * Splits an array into groups of equal size.
  *
- * @param s - The size of each group.
  * @param array - The array.
+ * @param n - The size of each group.
  * @returns The array split into groups.
  */
-declare function groupsOf<T>(s: number, array: readonly T[]): T[][];
+declare function groups<T>(array: readonly T[], n: number): T[][];
+
 /**
  * Returns the first item of an array.
  *
@@ -28,6 +24,7 @@ declare function groupsOf<T>(s: number, array: readonly T[]): T[][];
  */
 declare function head(array: readonly []): undefined;
 declare function head<T>(array: readonly T[]): T;
+
 /**
  * Returns all but the last item of an array.
  *
@@ -35,6 +32,7 @@ declare function head<T>(array: readonly T[]): T;
  * @returns The array without the last item.
  */
 declare function init<T>(array: readonly T[]): T[];
+
 /**
  * Returns the last item of an array.
  *
@@ -43,6 +41,7 @@ declare function init<T>(array: readonly T[]): T[];
  */
 declare function last(array: readonly []): undefined;
 declare function last<T>(array: readonly T[]): T;
+
 /**
  * Splits an array into two based on a predicate function.
  *
@@ -51,6 +50,7 @@ declare function last<T>(array: readonly T[]): T;
  * @returns The tuple of values that satisfy the predicate and those that don't.
  */
 declare function partition<T, U = T>(array: readonly (T | U)[], filter: (current: T | U, idx: number, array: readonly (T | U)[]) => boolean): [T[], U[]];
+
 /**
  * Generates a range of numbers.
  *
@@ -61,6 +61,7 @@ declare function partition<T, U = T>(array: readonly (T | U)[], filter: (current
  */
 declare function range(stop: number): number[];
 declare function range(start: number, stop: number, step?: number): number[];
+
 /**
  * Randomly shuffles items in an array.
  *
@@ -68,14 +69,16 @@ declare function range(start: number, stop: number, step?: number): number[];
  * @returns A copy of the array with its items randomly shuffled.
  */
 declare function shuffle<T>(array: T[]): T[];
+
 /**
  * Splits an array into two at a specified index.
  *
- * @param i - The position to split at.
  * @param array - The array.
+ * @param i - The position to split at.
  * @returns The tuple of values before and after the split.
  */
-declare function splitAt<T>(i: number, array: readonly T[]): [T[], T[]];
+declare function splitArray<T>(array: readonly T[], i: number): [T[], T[]];
+
 /**
  * Returns all but the first item of an array.
  *
@@ -83,6 +86,7 @@ declare function splitAt<T>(i: number, array: readonly T[]): [T[], T[]];
  * @returns The array without the first item.
  */
 declare function tail<T>(array: readonly T[]): T[];
+
 /**
  * Returns the first `n` items of an array.
  *
@@ -91,6 +95,13 @@ declare function tail<T>(array: readonly T[]): T[];
  * @returns The first `n` items.
  */
 declare function take<T>(n: number, array: readonly T[]): T[];
+
+type Arrayable<T> = T | Array<T>;
+type Nullable<T> = T | null | undefined;
+type Fn<T = any> = (...args: any[]) => T;
+type VoidFn = Fn<void>;
+type Obj<V = unknown> = Record<string | symbol | number, V>;
+
 /**
  * Wraps a single value in an array, if not already an array.
  *
@@ -98,6 +109,7 @@ declare function take<T>(n: number, array: readonly T[]): T[];
  * @returns The item wrapped in an array, or the provided array.
  */
 declare function toArray<T>(maybeArray: Nullable<Arrayable<T>>): T[];
+
 /**
  * Removes duplicate primitive values from an array.
  *
@@ -112,6 +124,7 @@ declare function uniq<T>(array: readonly T[]): T[];
  * @param str - The string to be copied to the clipboard.
  */
 declare function copyToClipboard(str: string): void;
+
 interface ScrollConfig {
     to: Element | string | number;
     offset?: number;
@@ -136,21 +149,25 @@ declare function scroll({ to, offset, duration, container }: ScrollConfig): void
  * @param delay - The time period (in ms).
  * @returns The debounced function.
  */
-declare function debounce(fn: VoidFn, delay: number): VoidFn;
+declare function debounce(fn: Fn<void>, delay: number): Fn<void>;
+
 /**
  * Optimises subsequent calls of a function by caching return values.
  *
  * @param fn - The function.
- * @returns The memoized function.
+ * @returns The memoised function.
  */
-declare function memoize<T>(fn: Fn<T>): Fn<T>;
+declare function memoise<T>(fn: Fn<T>): Fn<T>;
+declare const memoize: typeof memoise;
+
 /**
  * Enforces that a function is only callable one time.
  *
  * @param fn - The function.
  * @returns The one-time callable function.
  */
-declare function once(fn: VoidFn): VoidFn;
+declare function once(fn: Fn<void>): Fn<void>;
+
 /**
  * Prevents function execution for a specified time period after it was last called.
  *
@@ -158,7 +175,7 @@ declare function once(fn: VoidFn): VoidFn;
  * @param limit - The time period.
  * @returns The throttled function.
  */
-declare function throttle(fn: VoidFn, limit: number): VoidFn;
+declare function throttle(fn: Fn<void>, limit: number): Fn<void>;
 
 /**
  * Identifies if a value is an array.
@@ -167,6 +184,7 @@ declare function throttle(fn: VoidFn, limit: number): VoidFn;
  * @returns If the value is an array.
  */
 declare function isArray(val: unknown): val is any[];
+
 /**
  * Identifies if a value is a boolean.
  *
@@ -174,12 +192,14 @@ declare function isArray(val: unknown): val is any[];
  * @returns If the value is a boolean.
  */
 declare function isBoolean(val: unknown): val is boolean;
+
 /**
  * Identifies if the code is being run in a browser.
  *
  * @returns If the code is being run in a browser.
  */
 declare function isBrowser(): boolean;
+
 /**
  * Identifies if a value is defined.
  *
@@ -187,6 +207,7 @@ declare function isBrowser(): boolean;
  * @returns If the value is defined.
  */
 declare function isDefined<T>(val: T): val is Exclude<T, null | undefined>;
+
 /**
  * Identifies if a value is an empty array.
  *
@@ -194,13 +215,15 @@ declare function isDefined<T>(val: T): val is Exclude<T, null | undefined>;
  * @returns If the value is an empty array.
  */
 declare function isEmptyArray(val: unknown): val is [];
+
 /**
  * Identifies if a value is an empty object.
  *
  * @param val - The value.
  * @returns If the value is an empty object.
  */
-declare function isEmptyObject(val: unknown): val is Record<string, never>;
+declare function isEmptyObject(val: unknown): val is Obj<never>;
+
 /**
  * Identifies if a value is a function.
  *
@@ -208,6 +231,7 @@ declare function isEmptyObject(val: unknown): val is Record<string, never>;
  * @returns If the value is a function.
  */
 declare function isFunction<T extends Fn>(val: unknown): val is T;
+
 /**
  * Identifies if a value is null.
  *
@@ -215,6 +239,7 @@ declare function isFunction<T extends Fn>(val: unknown): val is T;
  * @returns If the value is null.
  */
 declare function isNull(val: unknown): val is null;
+
 /**
  * Identifies if a value is a number.
  *
@@ -222,6 +247,7 @@ declare function isNull(val: unknown): val is null;
  * @returns If the value is a number.
  */
 declare function isNumber(val: unknown): val is number;
+
 /**
  * Identifies if a value is an object.
  *
@@ -229,6 +255,7 @@ declare function isNumber(val: unknown): val is number;
  * @returns If the value is an object.
  */
 declare function isObject(val: unknown): val is Obj;
+
 /**
  * Identifies if a value is an array, an object, a date, or null.
  *
@@ -236,6 +263,7 @@ declare function isObject(val: unknown): val is Obj;
  * @returns If the value is an array, an object, a date, or null.
  */
 declare function isObjectLike(val: unknown): val is object;
+
 /**
  * Identifies if a value is a string.
  *
@@ -243,12 +271,14 @@ declare function isObjectLike(val: unknown): val is object;
  * @returns If the value is a string.
  */
 declare function isString(val: unknown): val is string;
+
 /**
  * Identifies if the code is being run on a touch device.
  *
  * @returns If the code is being run on a touch device.
  */
 declare function isTouchDevice(): boolean;
+
 /**
  * Identifies if a value is undefined.
  *
@@ -256,6 +286,7 @@ declare function isTouchDevice(): boolean;
  * @returns If the value is undefined.
  */
 declare function isUndefined(val: unknown): val is undefined;
+
 /**
  * Identifies if a value is the global window.
  *
@@ -264,6 +295,37 @@ declare function isUndefined(val: unknown): val is undefined;
  */
 declare function isWindow(val: unknown): val is Window;
 
+/**
+ * Does nothing.
+ *
+ * @returns Nothing.
+ */
+declare function noop(): void;
+
+/**
+ * Halts thread execution for a specified time period.
+ *
+ * @param duration - The time period (in ms).
+ * @returns The halting promise.
+ */
+declare function sleep(duration: number): Promise<void>;
+
+/**
+ * Generates a random string of a specified length.
+ *
+ * @param length - The length of the randomly generated string.
+ * @returns The randomly generated string.
+ */
+declare function uuid(length?: number): string;
+
+/**
+ * Returns the average of a number array.
+ *
+ * @param ns - The number array.
+ * @returns The average.
+ */
+declare function average(ns: readonly number[]): number;
+
 /**
  * Rounds a number up to the nearest multiple of the specified factor.
  *
@@ -272,6 +334,7 @@ declare function isWindow(val: unknown): val is Window;
  * @returns The rounded number.
  */
 declare function ceil(n: number, factor?: number): number;
+
 /**
  * Restricts a number between two bounds.
  *
@@ -281,6 +344,7 @@ declare function ceil(n: number, factor?: number): number;
  * @returns The number restricted between the specified bounds.
  */
 declare function clamp(n: number, min: number, max: number): number;
+
 /**
  * Rounds a number down to the nearest multiple of the specified factor.
  *
@@ -289,6 +353,7 @@ declare function clamp(n: number, min: number, max: number): number;
  * @returns The rounded number.
  */
 declare function floor(n: number, factor?: number): number;
+
 /**
  * Identifies if a number is even.
  *
@@ -296,6 +361,7 @@ declare function floor(n: number, factor?: number): number;
  * @returns If the number is even.
  */
 declare function isEven(n: number): boolean;
+
 /**
  * Identifies if a number is odd.
  *
@@ -303,6 +369,7 @@ declare function isEven(n: number): boolean;
  * @returns If the number is odd.
  */
 declare function isOdd(n: number): boolean;
+
 /**
  * Returns the maximum number of provided numbers or array of numbers.
  *
@@ -310,6 +377,7 @@ declare function isOdd(n: number): boolean;
  * @returns The maximum number.
  */
 declare function max(...ns: number[] | [number[]]): number;
+
 /**
  * Returns the minimum number of provided numbers or array of numbers.
  *
@@ -317,6 +385,7 @@ declare function max(...ns: number[] | [number[]]): number;
  * @returns The minimum number.
  */
 declare function min(...ns: number[] | [number[]]): number;
+
 /**
  * Returns the product of a number array.
  *
@@ -324,6 +393,7 @@ declare function min(...ns: number[] | [number[]]): number;
  * @returns The product.
  */
 declare function product(ns: readonly number[]): number;
+
 /**
  * Rolls an n-sided die.
  *
@@ -331,6 +401,7 @@ declare function product(ns: readonly number[]): number;
  * @returns If the die roll was 0.
  */
 declare function randomChance(n: number): boolean;
+
 /**
  * Generates a random integer between bounds.
  *
@@ -340,6 +411,7 @@ declare function randomChance(n: number): boolean;
  */
 declare function randomNumber(max: number): number;
 declare function randomNumber(min: number, max: number): number;
+
 /**
  * Rounds a number to the nearest multiple of the specified factor.
  *
@@ -348,6 +420,7 @@ declare function randomNumber(min: number, max: number): number;
  * @returns The rounded number.
  */
 declare function round(n: number, factor?: number): number;
+
 /**
  * Returns the sum of a number array.
  *
@@ -355,14 +428,24 @@ declare function round(n: number, factor?: number): number;
  * @returns The sum.
  */
 declare function sum(ns: readonly number[]): number;
+
 /**
- * Converts a given number to Roman numerals.
+ * Rounds a number to a specified number of decimal places.
  *
- * @param n - The number to convert to Roman numerals.
- * @param lowerCase - If the numerals should be in lowercase.
- * @returns - The Roman numeral representation of the given number.
+ * @param n - The number to round.
+ * @param decimalPlaces - The number of decimal places to round to.
+ * @returns The rounded number.
  */
-declare function toRomanNumerals(n: number, lowerCase?: boolean): string;
+declare function toDp(n: number, decimalPlaces?: number): number;
+
+/**
+ * Converts a string which contains a number into the number itself.
+ *
+ * @param str - The string.
+ * @param extensions - Additional symbols to consider in the conversion.
+ * @returns The number.
+ */
+declare function toNumber(str: string, extensions?: string[]): number;
 
 /**
  * Deep clones an array or object.
@@ -371,35 +454,30 @@ declare function toRomanNumerals(n: number, lowerCase?: boolean): string;
  * @returns A deep clone of the input array or object.
  */
 declare function clone<T>(input: T): T;
+
 /**
- * Does nothing.
- *
- * @returns Nothing.
- */
-declare function noop(): void;
-/**
- * Halts thread execution for a specified time period.
+ * Strict-typed, shorthand `Object.entries`
  *
- * @param duration - The time period (in ms).
- * @returns The halting promise.
+ * @param obj - The object to extract the entries from.
+ * @returns The entries.
  */
-declare function sleep(duration: number): Promise<void>;
+declare function es<T extends object>(obj: T): [keyof T, T[keyof T]][];
+
 /**
- * Generates a random string of a specified length.
+ * Strict-typed, shorthand `Object.keys`
  *
- * @param length - The length of the randomly generated string.
- * @returns The randomly generated string.
+ * @param obj - The object to extract the keys from.
+ * @returns The keys.
  */
-declare function uuid(length?: number): string;
+declare function ks<T extends object>(obj: T): Array<`${keyof T & (string | number | boolean | null | undefined)}`>;
 
-type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
 /**
- * Recursively merges multiple objects into one.
+ * Shorthand `Object.values`
  *
- * @param objects - The objects to merge.
- * @returns The merged object.
+ * @param obj - The object to extract the values from.
+ * @returns The values.
  */
-declare function deepMerge<T extends Obj<any>[]>(...objects: T): UnionToIntersection<T[number]>;
+declare function vs<T>(obj: Obj<T>): T[];
 
 /**
  * Capitalises the first letter of one word, or all words, in a string.
@@ -410,6 +488,8 @@ declare function deepMerge<T extends Obj<any>[]>(...objects: T): UnionToIntersec
  * @returns The capitalised string.
  */
 declare function capitalise(str: string, allWords?: boolean, delimiter?: string): string;
+declare const capitalize: typeof capitalise;
+
 /**
  * Separates a string into an array of characters.
  *
@@ -417,6 +497,7 @@ declare function capitalise(str: string, allWords?: boolean, delimiter?: string)
  * @returns The string's characters.
  */
 declare function chars(str: string): string[];
+
 /**
  * Identifies strings which only contain whitespace.
  *
@@ -424,6 +505,7 @@ declare function chars(str: string): string[];
  * @returns If the string is blank.
  */
 declare function isBlank(str: string): boolean;
+
 /**
  * Identifies empty strings.
  *
@@ -431,15 +513,17 @@ declare function isBlank(str: string): boolean;
  * @returns If the string is empty.
  */
 declare function isEmpty(str: string): boolean;
+
 /**
  * Replaces a character at a specified index in a string with a new character.
  *
  * @param str - The string.
  * @param i - The index of the character to replace.
  * @param char - The character to replace with.
- * @returns - The modified string with the character replaced.
+ * @returns The modified string with the character replaced.
  */
 declare function replaceChar(str: string, i: number, char: string): string;
+
 /**
  * Splits a string into two at a specified index.
  *
@@ -447,7 +531,8 @@ declare function replaceChar(str: string, i: number, char: string): string;
  * @param i - The position to split at.
  * @returns The tuple of strings before and after the split.
  */
-declare function splitStrAt(str: string, i: number): [string, string];
+declare function splitString(str: string, i: number): [string, string];
+
 /**
  * Converts a kebab case string to camel case.
  *
@@ -455,6 +540,7 @@ declare function splitStrAt(str: string, i: number): [string, string];
  * @returns The camel case string.
  */
 declare function toCamel(str: string): string;
+
 /**
  * Converts a camel case string to kebab case.
  *
@@ -462,13 +548,7 @@ declare function toCamel(str: string): string;
  * @returns The kebab case string.
  */
 declare function toKebab(str: string): string;
-/**
- * Converts a string which contains a number into the number itself.
- *
- * @param str - The string.
- * @returns The number.
- */
-declare function toNumber(str: string): number;
+
 /**
  * Adds the respective ordinal suffix (-st, -nd, -rd or -th) to a number.
  *
@@ -476,6 +556,16 @@ declare function toNumber(str: string): number;
  * @returns The number with the ordinal suffix appended.
  */
 declare function toOrdinal(n: number): string;
+
+/**
+ * Converts a given number to Roman numerals.
+ *
+ * @param n - The number to convert to Roman numerals.
+ * @param lowerCase - If the numerals should be in lowercase.
+ * @returns The Roman numeral representation of the given number.
+ */
+declare function toRomanNumerals(n: number, lowerCase?: boolean): string;
+
 /**
  * Truncates a string to a provided length.
  *
@@ -486,4 +576,12 @@ declare function toOrdinal(n: number): string;
  */
 declare function truncate(str: string, length: number, suffix?: string): string;
 
-export { type Arrayable, type Fn, type Nullable, type Obj, type VoidFn, capitalise, ceil, chars, clamp, clone, copyToClipboard, debounce, deepMerge, drop, floor, groupsOf, head, init, isArray, isBlank, isBoolean, isBrowser, isDefined, isEmpty, isEmptyArray, isEmptyObject, isEven, isFunction, isNull, isNumber, isObject, isObjectLike, isOdd, isString, isTouchDevice, isUndefined, isWindow, last, max, memoize, min, noop, once, partition, product, randomChance, randomNumber, range, replaceChar, round, scroll, shuffle, sleep, splitAt, splitStrAt, sum, tail, take, throttle, toArray, toCamel, toKebab, toNumber, toOrdinal, toRomanNumerals, truncate, uniq, uuid };
+/**
+ * Joins an array of characters into a string.
+ *
+ * @param chars - The characters.
+ * @returns The string.
+ */
+declare function unchars(chars: string[]): string;
+
+export { type Arrayable, type Fn, type Nullable, type Obj, type VoidFn, average, capitalise, capitalize, ceil, chars, clamp, clone, copyToClipboard, debounce, drop, es, floor, groups, head, init, isArray, isBlank, isBoolean, isBrowser, isDefined, isEmpty, isEmptyArray, isEmptyObject, isEven, isFunction, isNull, isNumber, isObject, isObjectLike, isOdd, isString, isTouchDevice, isUndefined, isWindow, ks, last, max, memoise, memoize, min, noop, once, partition, product, randomChance, randomNumber, range, replaceChar, round, scroll, shuffle, sleep, splitArray, splitString, sum, tail, take, throttle, toArray, toCamel, toDp, toKebab, toNumber, toOrdinal, toRomanNumerals, truncate, unchars, uniq, uuid, vs };

package/dist/index.d.ts

@@ -1,9 +1,3 @@
-type Arrayable<T> = T | Array<T>;
-type Nullable<T> = T | null | undefined;
-type Fn<T = any> = (...args: any[]) => T;
-type VoidFn = Fn<void>;
-type Obj<V = unknown> = Record<string | symbol | number, V>;
-
 /**
  * Removes the first `n` items of an array.
  *
@@ -12,14 +6,16 @@ type Obj<V = unknown> = Record<string | symbol | number, V>;
  * @returns The remaining items.
  */
 declare function drop<T>(n: number, array: readonly T[]): T[];
+
 /**
  * Splits an array into groups of equal size.
  *
- * @param s - The size of each group.
  * @param array - The array.
+ * @param n - The size of each group.
  * @returns The array split into groups.
  */
-declare function groupsOf<T>(s: number, array: readonly T[]): T[][];
+declare function groups<T>(array: readonly T[], n: number): T[][];
+
 /**
  * Returns the first item of an array.
  *
@@ -28,6 +24,7 @@ declare function groupsOf<T>(s: number, array: readonly T[]): T[][];
  */
 declare function head(array: readonly []): undefined;
 declare function head<T>(array: readonly T[]): T;
+
 /**
  * Returns all but the last item of an array.
  *
@@ -35,6 +32,7 @@ declare function head<T>(array: readonly T[]): T;
  * @returns The array without the last item.
  */
 declare function init<T>(array: readonly T[]): T[];
+
 /**
  * Returns the last item of an array.
  *
@@ -43,6 +41,7 @@ declare function init<T>(array: readonly T[]): T[];
  */
 declare function last(array: readonly []): undefined;
 declare function last<T>(array: readonly T[]): T;
+
 /**
  * Splits an array into two based on a predicate function.
  *
@@ -51,6 +50,7 @@ declare function last<T>(array: readonly T[]): T;
  * @returns The tuple of values that satisfy the predicate and those that don't.
  */
 declare function partition<T, U = T>(array: readonly (T | U)[], filter: (current: T | U, idx: number, array: readonly (T | U)[]) => boolean): [T[], U[]];
+
 /**
  * Generates a range of numbers.
  *
@@ -61,6 +61,7 @@ declare function partition<T, U = T>(array: readonly (T | U)[], filter: (current
  */
 declare function range(stop: number): number[];
 declare function range(start: number, stop: number, step?: number): number[];
+
 /**
  * Randomly shuffles items in an array.
  *
@@ -68,14 +69,16 @@ declare function range(start: number, stop: number, step?: number): number[];
  * @returns A copy of the array with its items randomly shuffled.
  */
 declare function shuffle<T>(array: T[]): T[];
+
 /**
  * Splits an array into two at a specified index.
  *
- * @param i - The position to split at.
  * @param array - The array.
+ * @param i - The position to split at.
  * @returns The tuple of values before and after the split.
  */
-declare function splitAt<T>(i: number, array: readonly T[]): [T[], T[]];
+declare function splitArray<T>(array: readonly T[], i: number): [T[], T[]];
+
 /**
  * Returns all but the first item of an array.
  *
@@ -83,6 +86,7 @@ declare function splitAt<T>(i: number, array: readonly T[]): [T[], T[]];
  * @returns The array without the first item.
  */
 declare function tail<T>(array: readonly T[]): T[];
+
 /**
  * Returns the first `n` items of an array.
  *
@@ -91,6 +95,13 @@ declare function tail<T>(array: readonly T[]): T[];
  * @returns The first `n` items.
  */
 declare function take<T>(n: number, array: readonly T[]): T[];
+
+type Arrayable<T> = T | Array<T>;
+type Nullable<T> = T | null | undefined;
+type Fn<T = any> = (...args: any[]) => T;
+type VoidFn = Fn<void>;
+type Obj<V = unknown> = Record<string | symbol | number, V>;
+
 /**
  * Wraps a single value in an array, if not already an array.
  *
@@ -98,6 +109,7 @@ declare function take<T>(n: number, array: readonly T[]): T[];
  * @returns The item wrapped in an array, or the provided array.
  */
 declare function toArray<T>(maybeArray: Nullable<Arrayable<T>>): T[];
+
 /**
  * Removes duplicate primitive values from an array.
  *
@@ -112,6 +124,7 @@ declare function uniq<T>(array: readonly T[]): T[];
  * @param str - The string to be copied to the clipboard.
  */
 declare function copyToClipboard(str: string): void;
+
 interface ScrollConfig {
     to: Element | string | number;
     offset?: number;
@@ -136,21 +149,25 @@ declare function scroll({ to, offset, duration, container }: ScrollConfig): void
  * @param delay - The time period (in ms).
  * @returns The debounced function.
  */
-declare function debounce(fn: VoidFn, delay: number): VoidFn;
+declare function debounce(fn: Fn<void>, delay: number): Fn<void>;
+
 /**
  * Optimises subsequent calls of a function by caching return values.
  *
  * @param fn - The function.
- * @returns The memoized function.
+ * @returns The memoised function.
  */
-declare function memoize<T>(fn: Fn<T>): Fn<T>;
+declare function memoise<T>(fn: Fn<T>): Fn<T>;
+declare const memoize: typeof memoise;
+
 /**
  * Enforces that a function is only callable one time.
  *
  * @param fn - The function.
  * @returns The one-time callable function.
  */
-declare function once(fn: VoidFn): VoidFn;
+declare function once(fn: Fn<void>): Fn<void>;
+
 /**
  * Prevents function execution for a specified time period after it was last called.
  *
@@ -158,7 +175,7 @@ declare function once(fn: VoidFn): VoidFn;
  * @param limit - The time period.
  * @returns The throttled function.
  */
-declare function throttle(fn: VoidFn, limit: number): VoidFn;
+declare function throttle(fn: Fn<void>, limit: number): Fn<void>;
 
 /**
  * Identifies if a value is an array.
@@ -167,6 +184,7 @@ declare function throttle(fn: VoidFn, limit: number): VoidFn;
  * @returns If the value is an array.
  */
 declare function isArray(val: unknown): val is any[];
+
 /**
  * Identifies if a value is a boolean.
  *
@@ -174,12 +192,14 @@ declare function isArray(val: unknown): val is any[];
  * @returns If the value is a boolean.
  */
 declare function isBoolean(val: unknown): val is boolean;
+
 /**
  * Identifies if the code is being run in a browser.
  *
  * @returns If the code is being run in a browser.
  */
 declare function isBrowser(): boolean;
+
 /**
  * Identifies if a value is defined.
  *
@@ -187,6 +207,7 @@ declare function isBrowser(): boolean;
  * @returns If the value is defined.
  */
 declare function isDefined<T>(val: T): val is Exclude<T, null | undefined>;
+
 /**
  * Identifies if a value is an empty array.
  *
@@ -194,13 +215,15 @@ declare function isDefined<T>(val: T): val is Exclude<T, null | undefined>;
  * @returns If the value is an empty array.
  */
 declare function isEmptyArray(val: unknown): val is [];
+
 /**
  * Identifies if a value is an empty object.
  *
  * @param val - The value.
  * @returns If the value is an empty object.
  */
-declare function isEmptyObject(val: unknown): val is Record<string, never>;
+declare function isEmptyObject(val: unknown): val is Obj<never>;
+
 /**
  * Identifies if a value is a function.
  *
@@ -208,6 +231,7 @@ declare function isEmptyObject(val: unknown): val is Record<string, never>;
  * @returns If the value is a function.
  */
 declare function isFunction<T extends Fn>(val: unknown): val is T;
+
 /**
  * Identifies if a value is null.
  *
@@ -215,6 +239,7 @@ declare function isFunction<T extends Fn>(val: unknown): val is T;
  * @returns If the value is null.
  */
 declare function isNull(val: unknown): val is null;
+
 /**
  * Identifies if a value is a number.
  *
@@ -222,6 +247,7 @@ declare function isNull(val: unknown): val is null;
  * @returns If the value is a number.
  */
 declare function isNumber(val: unknown): val is number;
+
 /**
  * Identifies if a value is an object.
  *
@@ -229,6 +255,7 @@ declare function isNumber(val: unknown): val is number;
  * @returns If the value is an object.
  */
 declare function isObject(val: unknown): val is Obj;
+
 /**
  * Identifies if a value is an array, an object, a date, or null.
  *
@@ -236,6 +263,7 @@ declare function isObject(val: unknown): val is Obj;
  * @returns If the value is an array, an object, a date, or null.
  */
 declare function isObjectLike(val: unknown): val is object;
+
 /**
  * Identifies if a value is a string.
  *
@@ -243,12 +271,14 @@ declare function isObjectLike(val: unknown): val is object;
  * @returns If the value is a string.
  */
 declare function isString(val: unknown): val is string;
+
 /**
  * Identifies if the code is being run on a touch device.
  *
  * @returns If the code is being run on a touch device.
  */
 declare function isTouchDevice(): boolean;
+
 /**
  * Identifies if a value is undefined.
  *
@@ -256,6 +286,7 @@ declare function isTouchDevice(): boolean;
  * @returns If the value is undefined.
  */
 declare function isUndefined(val: unknown): val is undefined;
+
 /**
  * Identifies if a value is the global window.
  *
@@ -264,6 +295,37 @@ declare function isUndefined(val: unknown): val is undefined;
  */
 declare function isWindow(val: unknown): val is Window;
 
+/**
+ * Does nothing.
+ *
+ * @returns Nothing.
+ */
+declare function noop(): void;
+
+/**
+ * Halts thread execution for a specified time period.
+ *
+ * @param duration - The time period (in ms).
+ * @returns The halting promise.
+ */
+declare function sleep(duration: number): Promise<void>;
+
+/**
+ * Generates a random string of a specified length.
+ *
+ * @param length - The length of the randomly generated string.
+ * @returns The randomly generated string.
+ */
+declare function uuid(length?: number): string;
+
+/**
+ * Returns the average of a number array.
+ *
+ * @param ns - The number array.
+ * @returns The average.
+ */
+declare function average(ns: readonly number[]): number;
+
 /**
  * Rounds a number up to the nearest multiple of the specified factor.
  *
@@ -272,6 +334,7 @@ declare function isWindow(val: unknown): val is Window;
  * @returns The rounded number.
  */
 declare function ceil(n: number, factor?: number): number;
+
 /**
  * Restricts a number between two bounds.
  *
@@ -281,6 +344,7 @@ declare function ceil(n: number, factor?: number): number;
  * @returns The number restricted between the specified bounds.
  */
 declare function clamp(n: number, min: number, max: number): number;
+
 /**
  * Rounds a number down to the nearest multiple of the specified factor.
  *
@@ -289,6 +353,7 @@ declare function clamp(n: number, min: number, max: number): number;
  * @returns The rounded number.
  */
 declare function floor(n: number, factor?: number): number;
+
 /**
  * Identifies if a number is even.
  *
@@ -296,6 +361,7 @@ declare function floor(n: number, factor?: number): number;
  * @returns If the number is even.
  */
 declare function isEven(n: number): boolean;
+
 /**
  * Identifies if a number is odd.
  *
@@ -303,6 +369,7 @@ declare function isEven(n: number): boolean;
  * @returns If the number is odd.
  */
 declare function isOdd(n: number): boolean;
+
 /**
  * Returns the maximum number of provided numbers or array of numbers.
  *
@@ -310,6 +377,7 @@ declare function isOdd(n: number): boolean;
  * @returns The maximum number.
  */
 declare function max(...ns: number[] | [number[]]): number;
+
 /**
  * Returns the minimum number of provided numbers or array of numbers.
  *
@@ -317,6 +385,7 @@ declare function max(...ns: number[] | [number[]]): number;
  * @returns The minimum number.
  */
 declare function min(...ns: number[] | [number[]]): number;
+
 /**
  * Returns the product of a number array.
  *
@@ -324,6 +393,7 @@ declare function min(...ns: number[] | [number[]]): number;
  * @returns The product.
  */
 declare function product(ns: readonly number[]): number;
+
 /**
  * Rolls an n-sided die.
  *
@@ -331,6 +401,7 @@ declare function product(ns: readonly number[]): number;
  * @returns If the die roll was 0.
  */
 declare function randomChance(n: number): boolean;
+
 /**
  * Generates a random integer between bounds.
  *
@@ -340,6 +411,7 @@ declare function randomChance(n: number): boolean;
  */
 declare function randomNumber(max: number): number;
 declare function randomNumber(min: number, max: number): number;
+
 /**
  * Rounds a number to the nearest multiple of the specified factor.
  *
@@ -348,6 +420,7 @@ declare function randomNumber(min: number, max: number): number;
  * @returns The rounded number.
  */
 declare function round(n: number, factor?: number): number;
+
 /**
  * Returns the sum of a number array.
  *
@@ -355,14 +428,24 @@ declare function round(n: number, factor?: number): number;
  * @returns The sum.
  */
 declare function sum(ns: readonly number[]): number;
+
 /**
- * Converts a given number to Roman numerals.
+ * Rounds a number to a specified number of decimal places.
  *
- * @param n - The number to convert to Roman numerals.
- * @param lowerCase - If the numerals should be in lowercase.
- * @returns - The Roman numeral representation of the given number.
+ * @param n - The number to round.
+ * @param decimalPlaces - The number of decimal places to round to.
+ * @returns The rounded number.
  */
-declare function toRomanNumerals(n: number, lowerCase?: boolean): string;
+declare function toDp(n: number, decimalPlaces?: number): number;
+
+/**
+ * Converts a string which contains a number into the number itself.
+ *
+ * @param str - The string.
+ * @param extensions - Additional symbols to consider in the conversion.
+ * @returns The number.
+ */
+declare function toNumber(str: string, extensions?: string[]): number;
 
 /**
  * Deep clones an array or object.
@@ -371,35 +454,30 @@ declare function toRomanNumerals(n: number, lowerCase?: boolean): string;
  * @returns A deep clone of the input array or object.
  */
 declare function clone<T>(input: T): T;
+
 /**
- * Does nothing.
- *
- * @returns Nothing.
- */
-declare function noop(): void;
-/**
- * Halts thread execution for a specified time period.
+ * Strict-typed, shorthand `Object.entries`
  *
- * @param duration - The time period (in ms).
- * @returns The halting promise.
+ * @param obj - The object to extract the entries from.
+ * @returns The entries.
  */
-declare function sleep(duration: number): Promise<void>;
+declare function es<T extends object>(obj: T): [keyof T, T[keyof T]][];
+
 /**
- * Generates a random string of a specified length.
+ * Strict-typed, shorthand `Object.keys`
  *
- * @param length - The length of the randomly generated string.
- * @returns The randomly generated string.
+ * @param obj - The object to extract the keys from.
+ * @returns The keys.
  */
-declare function uuid(length?: number): string;
+declare function ks<T extends object>(obj: T): Array<`${keyof T & (string | number | boolean | null | undefined)}`>;
 
-type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
 /**
- * Recursively merges multiple objects into one.
+ * Shorthand `Object.values`
  *
- * @param objects - The objects to merge.
- * @returns The merged object.
+ * @param obj - The object to extract the values from.
+ * @returns The values.
  */
-declare function deepMerge<T extends Obj<any>[]>(...objects: T): UnionToIntersection<T[number]>;
+declare function vs<T>(obj: Obj<T>): T[];
 
 /**
  * Capitalises the first letter of one word, or all words, in a string.
@@ -410,6 +488,8 @@ declare function deepMerge<T extends Obj<any>[]>(...objects: T): UnionToIntersec
  * @returns The capitalised string.
  */
 declare function capitalise(str: string, allWords?: boolean, delimiter?: string): string;
+declare const capitalize: typeof capitalise;
+
 /**
  * Separates a string into an array of characters.
  *
@@ -417,6 +497,7 @@ declare function capitalise(str: string, allWords?: boolean, delimiter?: string)
  * @returns The string's characters.
  */
 declare function chars(str: string): string[];
+
 /**
  * Identifies strings which only contain whitespace.
  *
@@ -424,6 +505,7 @@ declare function chars(str: string): string[];
  * @returns If the string is blank.
  */
 declare function isBlank(str: string): boolean;
+
 /**
  * Identifies empty strings.
  *
@@ -431,15 +513,17 @@ declare function isBlank(str: string): boolean;
  * @returns If the string is empty.
  */
 declare function isEmpty(str: string): boolean;
+
 /**
  * Replaces a character at a specified index in a string with a new character.
  *
  * @param str - The string.
  * @param i - The index of the character to replace.
  * @param char - The character to replace with.
- * @returns - The modified string with the character replaced.
+ * @returns The modified string with the character replaced.
  */
 declare function replaceChar(str: string, i: number, char: string): string;
+
 /**
  * Splits a string into two at a specified index.
  *
@@ -447,7 +531,8 @@ declare function replaceChar(str: string, i: number, char: string): string;
  * @param i - The position to split at.
  * @returns The tuple of strings before and after the split.
  */
-declare function splitStrAt(str: string, i: number): [string, string];
+declare function splitString(str: string, i: number): [string, string];
+
 /**
  * Converts a kebab case string to camel case.
  *
@@ -455,6 +540,7 @@ declare function splitStrAt(str: string, i: number): [string, string];
  * @returns The camel case string.
  */
 declare function toCamel(str: string): string;
+
 /**
  * Converts a camel case string to kebab case.
  *
@@ -462,13 +548,7 @@ declare function toCamel(str: string): string;
  * @returns The kebab case string.
  */
 declare function toKebab(str: string): string;
-/**
- * Converts a string which contains a number into the number itself.
- *
- * @param str - The string.
- * @returns The number.
- */
-declare function toNumber(str: string): number;
+
 /**
  * Adds the respective ordinal suffix (-st, -nd, -rd or -th) to a number.
  *
@@ -476,6 +556,16 @@ declare function toNumber(str: string): number;
  * @returns The number with the ordinal suffix appended.
  */
 declare function toOrdinal(n: number): string;
+
+/**
+ * Converts a given number to Roman numerals.
+ *
+ * @param n - The number to convert to Roman numerals.
+ * @param lowerCase - If the numerals should be in lowercase.
+ * @returns The Roman numeral representation of the given number.
+ */
+declare function toRomanNumerals(n: number, lowerCase?: boolean): string;
+
 /**
  * Truncates a string to a provided length.
  *
@@ -486,4 +576,12 @@ declare function toOrdinal(n: number): string;
  */
 declare function truncate(str: string, length: number, suffix?: string): string;
 
-export { type Arrayable, type Fn, type Nullable, type Obj, type VoidFn, capitalise, ceil, chars, clamp, clone, copyToClipboard, debounce, deepMerge, drop, floor, groupsOf, head, init, isArray, isBlank, isBoolean, isBrowser, isDefined, isEmpty, isEmptyArray, isEmptyObject, isEven, isFunction, isNull, isNumber, isObject, isObjectLike, isOdd, isString, isTouchDevice, isUndefined, isWindow, last, max, memoize, min, noop, once, partition, product, randomChance, randomNumber, range, replaceChar, round, scroll, shuffle, sleep, splitAt, splitStrAt, sum, tail, take, throttle, toArray, toCamel, toKebab, toNumber, toOrdinal, toRomanNumerals, truncate, uniq, uuid };
+/**
+ * Joins an array of characters into a string.
+ *
+ * @param chars - The characters.
+ * @returns The string.
+ */
+declare function unchars(chars: string[]): string;
+
+export { type Arrayable, type Fn, type Nullable, type Obj, type VoidFn, average, capitalise, capitalize, ceil, chars, clamp, clone, copyToClipboard, debounce, drop, es, floor, groups, head, init, isArray, isBlank, isBoolean, isBrowser, isDefined, isEmpty, isEmptyArray, isEmptyObject, isEven, isFunction, isNull, isNumber, isObject, isObjectLike, isOdd, isString, isTouchDevice, isUndefined, isWindow, ks, last, max, memoise, memoize, min, noop, once, partition, product, randomChance, randomNumber, range, replaceChar, round, scroll, shuffle, sleep, splitArray, splitString, sum, tail, take, throttle, toArray, toCamel, toDp, toKebab, toNumber, toOrdinal, toRomanNumerals, truncate, unchars, uniq, uuid, vs };

package/dist/index.js

@@ -1 +1 @@
-function E(e,n=1){let t=e/n;return Math.ceil(t)*n}function M(e,n,t){return Math.min(t,Math.max(n,e))}function S(e,n=1){let t=e/n;return Math.floor(t)*n}function F(e){return e%2===0}function I(e){return e%2!==0}function L(...e){let n;return e.length===1&&Array.isArray(e[0])?n=e[0]:n=e,Math.max(...n)}function q(...e){let n;return e.length===1&&Array.isArray(e[0])?n=e[0]:n=e,Math.min(...n)}function R(e){let n=1;for(let t=0;t<e.length;t++)n*=e[t];return n}function V(e){return s(e)===0}function s(...e){let n,t;return e.length===1?(n=0,t=e[0]):(n=e[0],t=e[1]),Math.floor(Math.random()*(t-n))+n}function D(e,n=1){let t=e/n;return Math.round(t)*n}function B(e){let n=0;for(let t=0;t<e.length;t++)n+=e[t];return n}var h={1:"I",4:"IV",5:"V",9:"IX",10:"X",40:"XL",50:"L",90:"XC",100:"C",400:"CD",500:"D",900:"CM",1e3:"M"};function P(e,n=!1){let t=e,r="",o=Object.keys(h).map(Number).sort((i,u)=>u-i);for(let i of o)for(;t>=i;)r+=h[i],t-=i;return n?r.toLowerCase():r}function l(e){return Array.isArray(e)}function X(e){return typeof e=="boolean"}function p(){return typeof window<"u"}function H(e){return typeof e<"u"}function _(e){return l(e)&&e.length===0}function $(e){if(!a(e))return!1;for(let n in e)return!1;return!0}function z(e){return typeof e=="function"}function c(e){return Object.prototype.toString.call(e)==="[object Null]"}function w(e){return typeof e=="number"}function a(e){return Object.prototype.toString.call(e)==="[object Object]"}function f(e){return typeof e=="object"}function b(e){return typeof e=="string"}function J(){return"ontouchstart"in window||navigator.maxTouchPoints>0}function K(e){return typeof e>"u"}function Y(e){return p()&&Object.prototype.toString.call(e)==="[object Window]"}function m(e){if(l(e)){let n=[];for(let t=0;t<e.length;t++)f(e[t])&&!c(e[t])?n[t]=m(e[t]):n[t]=e[t];return n}if(f(e)&&!c(e)){let n={};for(let t in e)f(e[t])&&!c(e[t])?n[t]=m(e[t]):n[t]=e[t];return n}return e}function ee(){}async function ne(e){return e<0&&console.warn("[tsu] warning: a sleep duration less than 0ms will be treated as 0ms."),new Promise(n=>{setTimeout(n,e)})}var v="useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";function te(e=16){let n=v.length,t=e,r="";for(;t--;)r+=v[s(n)];return r}function ue(e,n){return e<=0?[...n]:n.slice(e)}function le(e,n){if(e<=0)throw new Error("[tsu] Invalid group size. Is it greater than 0?");if(e>=n.length)return[[...n]];let t=[];for(let r=0;r<n.length;r+=e)t.push(n.slice(r,r+e));return t}function se(e){return e[0]}function ce(e){return e.slice(0,e.length-1)}function ae(e){return e[e.length-1]}function fe(e,n){let t=[],r=[];for(let o=0;o<e.length;o++){let i=e[o];n(i,o,e)?t.push(i):r.push(i)}return[t,r]}function me(...e){let n,t,r;e.length===1?(t=e[0],n=0,r=1):(n=e[0],t=e[1],r=e[2]||1),r<=0&&(console.warn("[tsu] warning: a step less than or equal to 0 will be set to 1."),r=1);let o=[],i=n;for(;i<t;)o.push(i),i+=r||1;return o}function pe(e){let n=m(e),t,r,o;for(t=n.length;t;t-=1)r=s(t),o=n[t-1],n[t-1]=n[r],n[r]=o;return n}function be(e,n){return e<=0?[[],[...n]]:e>n.length?[[...n],[]]:[n.slice(0,e),n.slice(e)]}function de(e){return e.slice(1)}function xe(e,n){return e<=0?[]:n.slice(0,e)}function Te(e){return e?Array.isArray(e)?e:[e]:[]}function j(e){return Array.from(new Set(e))}function O(e){let n=document.createElement("textarea");n.value=e??"",n.style.position="absolute",n.style.opacity="0",document.body.appendChild(n),n.select(),document.execCommand("copy"),n.remove()}function he(e){p()&&(window.navigator&&"clipboard"in window.navigator?navigator.clipboard.writeText(e):O(e))}function we({to:e,offset:n=0,duration:t=1e3,container:r=null}){let o=b(e)?document.querySelector(e):e,i=b(r)?document.querySelector(r):r,u=i?.scrollTop||window?.pageYOffset||0,d=(w(o)?o:N(o,u))+n,k=Date.now();function x(){let T=Date.now()-k,g=T<t,y=g?C(u,d,T,t):d;g&&requestAnimationFrame(x),i?i.scrollTop=y:window.scrollTo(0,y)}x()}function A(e){return e<.5?4*Math.pow(e,3):(e-1)*(2*e-2)*(2*e-2)+1}function C(e,n,t,r){return e+(n-e)*A(t/r)}function N(e,n){return e.nodeName==="HTML"?-n:e.getBoundingClientRect().top+n}function je(e,n){n<0&&console.warn("[tsu] warning: a debounce delay less than 0ms will be treated as 0ms.");let t;return function(...r){clearTimeout(t),t=setTimeout(()=>{clearTimeout(t),e(...r)},n)}}function ke(e){let n={};return function(...t){let r=JSON.stringify(t);if(r in n)return n[r];let o=e(...t);return n[r]=o,o}}function Oe(e){let n=!1;return(...t)=>{n||(e(...t),n=!0)}}function Ae(e,n){n<0&&console.warn("[tsu] warning: a throttle limit less than 0ms will be treated as 0ms.");let t=!1;return function(...r){t||(e(...r),t=!0,setTimeout(()=>{t=!1},n))}}function U(...e){let n={};for(let t=0;t<e.length;t++){let r=e[t],o=Object.keys(r);for(let i=0;i<o.length;i++){let u=o[i];l(n[u])&&l(r[u])?n[u]=j(n[u].concat(r[u])):a(n[u])&&a(r[u])?n[u]=U(n[u],r[u]):n[u]=r[u]}}return n}function Me(e,n=!1,t=" "){return n?e.split(t).map(r=>r.charAt(0).toUpperCase()+r.slice(1)).join(t):e.charAt(0).toUpperCase()+e.slice(1)}function Se(e){return e.split("")}function Fe(e){return e.trim().length===0}function Ie(e){return e.length===0}function Le(e,n,t){return n<0||n>e.length-1?e:e.slice(0,n)+t+e.slice(n+1)}function qe(e,n){return n<=0?["",e]:n>e.length?[e,""]:[e.slice(0,n),e.slice(n)]}function Re(e){let n=/-(\w)/g;return e.replace(n,(t,r)=>r?r.toUpperCase():"")}function Ve(e){let n=/\B([A-Z])/g;return e.replace(n,"-$1").toLowerCase()}function De(e){return e.length?Number(e.replace(/[#£€$,%]/g,"")):NaN}function Be(e){let t=["st","nd","rd"][(e/10%10^1&&e%10)-1]||"th";return`${e}${t}`}function Pe(e,n,t="..."){return n<=0?t:e.slice(0,n)+t}export{Me as capitalise,E as ceil,Se as chars,M as clamp,m as clone,he as copyToClipboard,je as debounce,U as deepMerge,ue as drop,S as floor,le as groupsOf,se as head,ce as init,l as isArray,Fe as isBlank,X as isBoolean,p as isBrowser,H as isDefined,Ie as isEmpty,_ as isEmptyArray,$ as isEmptyObject,F as isEven,z as isFunction,c as isNull,w as isNumber,a as isObject,f as isObjectLike,I as isOdd,b as isString,J as isTouchDevice,K as isUndefined,Y as isWindow,ae as last,L as max,ke as memoize,q as min,ee as noop,Oe as once,fe as partition,R as product,V as randomChance,s as randomNumber,me as range,Le as replaceChar,D as round,we as scroll,pe as shuffle,ne as sleep,be as splitAt,qe as splitStrAt,B as sum,de as tail,xe as take,Ae as throttle,Te as toArray,Re as toCamel,Ve as toKebab,De as toNumber,Be as toOrdinal,P as toRomanNumerals,Pe as truncate,j as uniq,te as uuid};
+function S(e,r){return e<=0?[...r]:r.slice(e)}function L(e,r){if(r<=0)throw new Error("[tsu] Invalid group size. Is it greater than 0?");if(r>=e.length)return[[...e]];let t=[];for(let n=0;n<e.length;n+=r)t.push(e.slice(n,n+r));return t}function R(e){return e[0]}function B(e){return e.slice(0,e.length-1)}function $(e){return e[e.length-1]}function W(e,r){let t=[],n=[];for(let o=0;o<e.length;o++){let i=e[o];r(i,o,e)?t.push(i):n.push(i)}return[t,n]}function z(...e){let r,t,n;e.length===1?(t=e[0],r=0,n=1):(r=e[0],t=e[1],n=e[2]||1),n<=0&&(console.warn("[tsu] warning: a step less than or equal to 0 will be set to 1."),n=1);let o=[],i=r;for(;i<t;)o.push(i),i+=n||1;return o}function V(e){return e.length<1?0:y(e)/e.length}function K(e,r=1){let t=e/r;return Math.ceil(t)*r}function h(e,r,t){return Math.min(t,Math.max(r,e))}function G(e,r=1){let t=e/r;return Math.floor(t)*r}function ee(e){return e%2===0}function te(e){return e%2!==0}function oe(...e){let r;return e.length===1&&Array.isArray(e[0])?r=e[0]:r=e,Math.max(...r)}function ue(...e){let r;return e.length===1&&Array.isArray(e[0])?r=e[0]:r=e,Math.min(...r)}function me(e){if(e.length<1)return 0;let r=1;for(let t=0;t<e.length;t++)r*=e[t];return r}function u(...e){let r,t;return e.length===1?(r=0,t=e[0]):(r=e[0],t=e[1]),Math.floor(Math.random()*(t-r))+r}function ce(e){return u(e)===0}function xe(e,r=1){let t=e/r;return Math.round(t)*r}function y(e){let r=0;for(let t=0;t<e.length;t++)r+=e[t];return r}function ge(e,r=0){r<0&&console.warn("[tsu] warning: decimalPlaces less than 0 are set to 0."),r>100&&console.warn("[tsu] warning: decimalPlaces greater than 100 are set to 100.");let t=h(r,0,100);return Number(e.toFixed(t))}function he(e,r=[]){if(!e.length)return NaN;let t=["#","\xA3","\u20AC","$","%",",",...r],n=new RegExp(`[${t.join("")}]`,"g");return Number(e.replace(n,""))}function m(e){return Array.isArray(e)}function Ie(e){return typeof e=="boolean"}function s(){return typeof window<"u"}function We(e){return typeof e<"u"}function He(e){return m(e)&&e.length===0}function Je(e){if(!w(e))return!1;for(let r in e)return!1;return!0}function Ye(e){return typeof e=="function"}function l(e){return Object.prototype.toString.call(e)==="[object Null]"}function j(e){return typeof e=="number"}function w(e){return Object.prototype.toString.call(e)==="[object Object]"}function p(e){return typeof e=="object"}function a(e){return typeof e=="string"}function nr(){return"ontouchstart"in window||navigator.maxTouchPoints>0}function ir(e){return typeof e>"u"}function mr(e){return s()&&Object.prototype.toString.call(e)==="[object Window]"}function c(e){if(m(e)){let r=[];for(let t=0;t<e.length;t++)p(e[t])&&!l(e[t])?r[t]=c(e[t]):r[t]=e[t];return r}if(p(e)&&!l(e)){let r={};for(let t in e)p(e[t])&&!l(e[t])?r[t]=c(e[t]):r[t]=e[t];return r}return e}function Cr(e){return Object.entries(e)}function Mr(e){return Object.keys(e)}function Sr(e){return Object.values(e)}function Pr(e){let r=c(e),t,n,o;for(t=r.length;t;t-=1)n=u(t),o=r[t-1],r[t-1]=r[n],r[n]=o;return r}function Xr(e,r){return r<=0?[[],[...e]]:r>e.length?[[...e],[]]:[e.slice(0,r),e.slice(r)]}function Hr(e){return e.slice(1)}function Vr(e,r){return e<=0?[]:r.slice(0,e)}function Kr(e){return e?Array.isArray(e)?e:[e]:[]}function Zr(e){return Array.from(new Set(e))}function N(e){let r=document.createElement("textarea");r.value=e??"",r.style.position="absolute",r.style.opacity="0",document.body.appendChild(r),r.select(),document.execCommand("copy"),r.remove()}function xt(e){s()&&(window.navigator&&"clipboard"in window.navigator?navigator.clipboard.writeText(e):N(e))}function A(e){return e<.5?4*Math.pow(e,3):(e-1)*(2*e-2)*(2*e-2)+1}function C(e,r,t,n){return e+(r-e)*A(t/n)}function E(e,r){return e.nodeName==="HTML"?-r:e.getBoundingClientRect().top+r}function Tt({to:e,offset:r=0,duration:t=1e3,container:n=null}){let o=a(e)?document.querySelector(e):e,i=a(n)?document.querySelector(n):n,f=i?.scrollTop||window?.pageYOffset||0,x=(j(o)?o:E(o,f))+r,O=Date.now();function b(){let d=Date.now()-O,T=d<t,g=T?C(f,x,d,t):x;T&&requestAnimationFrame(b),i?i.scrollTop=g:window.scrollTo(0,g)}b()}function jt(e,r){r<0&&console.warn("[tsu] warning: debounce delays less than 0 will be set to 0.");let t;return function(...n){clearTimeout(t),t=setTimeout(()=>{clearTimeout(t),e(...n)},r)}}function M(e){let r={};return function(...t){let n=JSON.stringify(t);if(n in r)return r[n];let o=e(...t);return r[n]=o,o}}var kt=M;function Nt(e){let r=!1;return(...t)=>{r||(e(...t),r=!0)}}function Ct(e,r){r<0&&console.warn("[tsu] warning: throttle limits less than 0 will be set to 0.");let t=!1;return function(...n){t||(e(...n),t=!0,setTimeout(()=>{t=!1},r))}}function Dt(){}async function qt(e){return e<0&&console.warn("[tsu] warning: sleep durations less than 0 are set to 0."),new Promise(r=>{setTimeout(r,e)})}var v="useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";function $t(e=16){let r=v.length,t=e,n="";for(;t--;)n+=v[u(r)];return n}function F(e,r=!1,t=" "){return r?e.split(t).map(n=>n.charAt(0).toUpperCase()+n.slice(1)).join(t):e.charAt(0).toUpperCase()+e.slice(1)}var _t=F;function Jt(e){return e.split("")}function Yt(e){return e.trim().length===0}function Gt(e){return e.length===0}function en(e,r,t){return r<0||r>e.length-1?e:e.slice(0,r)+t+e.slice(r+1)}function tn(e,r){return r<=0?["",e]:r>e.length?[e,""]:[e.slice(0,r),e.slice(r)]}function on(e){let r=/-(\w)/g;return e.replace(r,(t,n)=>n?n.toUpperCase():"")}function fn(e){let r=/\B([A-Z])/g;return e.replace(r,"-$1").toLowerCase()}function sn(e){let t=["st","nd","rd"][(Math.abs(e)/10%10^1&&Math.abs(e)%10)-1]||"th";return`${e}${t}`}var k={1:"I",4:"IV",5:"V",9:"IX",10:"X",40:"XL",50:"L",90:"XC",100:"C",400:"CD",500:"D",900:"CM",1e3:"M"};function pn(e,r=!1){let t=e,n="",o=Object.keys(k).map(Number).sort((i,f)=>f-i);for(let i of o)for(;t>=i;)n+=k[i],t-=i;return r?n.toLowerCase():n}function an(e,r,t="..."){return r<=0?t:e.slice(0,r)+t}function bn(e){return e.join("")}export{V as average,F as capitalise,_t as capitalize,K as ceil,Jt as chars,h as clamp,c as clone,xt as copyToClipboard,jt as debounce,S as drop,Cr as es,G as floor,L as groups,R as head,B as init,m as isArray,Yt as isBlank,Ie as isBoolean,s as isBrowser,We as isDefined,Gt as isEmpty,He as isEmptyArray,Je as isEmptyObject,ee as isEven,Ye as isFunction,l as isNull,j as isNumber,w as isObject,p as isObjectLike,te as isOdd,a as isString,nr as isTouchDevice,ir as isUndefined,mr as isWindow,Mr as ks,$ as last,oe as max,M as memoise,kt as memoize,ue as min,Dt as noop,Nt as once,W as partition,me as product,ce as randomChance,u as randomNumber,z as range,en as replaceChar,xe as round,Tt as scroll,Pr as shuffle,qt as sleep,Xr as splitArray,tn as splitString,y as sum,Hr as tail,Vr as take,Ct as throttle,Kr as toArray,on as toCamel,ge as toDp,fn as toKebab,he as toNumber,sn as toOrdinal,pn as toRomanNumerals,an as truncate,bn as unchars,Zr as uniq,$t as uuid,Sr as vs};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tsu",
-  "version": "2.9.1",
+  "version": "2.10.1",
   "type": "module",
   "description": "TypeScript utilities",
   "license": "MIT",