tsu 1.2.1 → 1.3.2

package/README.md

@@ -1,6 +1,6 @@
 # tsu
 
-> A collection of TypeScript utilities.
+> TypeScript utilities
 
 <a href="https://npmjs.com/package/tsu">
   <img src="https://img.shields.io/npm/v/tsu" alt="npm version">
@@ -18,7 +18,7 @@ Install with your favourite package manager:
 yarn add tsu
 
 # pnpm
-pnpm install tsu
+pnpm add tsu
 
 # npm
 npm install tsu

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";var l=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var O=Object.getOwnPropertyNames;var j=Object.prototype.hasOwnProperty;var E=(n,e)=>{for(var t in e)l(n,t,{get:e[t],enumerable:!0})},F=(n,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of O(e))!j.call(n,o)&&o!==t&&l(n,o,{get:()=>e[o],enumerable:!(r=v(e,o))||r.enumerable});return n};var N=n=>F(l({},"__esModule",{value:!0}),n);var xn={};E(xn,{capitalise:()=>fn,chars:()=>cn,debounce:()=>W,deepMerge:()=>w,drop:()=>A,groupsOf:()=>S,head:()=>M,init:()=>C,isArray:()=>f,isBlank:()=>ln,isBoolean:()=>z,isBrowser:()=>g,isDefined:()=>J,isEmpty:()=>pn,isEmptyObject:()=>K,isEven:()=>G,isFunction:()=>Y,isNumber:()=>m,isObject:()=>u,isOdd:()=>Q,isString:()=>c,isTouchDevice:()=>Z,isWindow:()=>_,last:()=>U,max:()=>I,memoize:()=>$,min:()=>q,modulo:()=>X,noop:()=>en,once:()=>k,partition:()=>B,randomChance:()=>nn,randomNumber:()=>h,scroll:()=>rn,sleep:()=>tn,splitAt:()=>D,sum:()=>R,tail:()=>L,take:()=>P,throttle:()=>H,toArray:()=>V,toCamel:()=>mn,toKebab:()=>an,toNumber:()=>bn,toOrdinal:()=>Tn,truncate:()=>dn,uniq:()=>p});module.exports=N(xn);function A(n,e){return n<=0?[...e]:e.slice(n)}function S(n,e){if(n<=0)throw new Error("[tsu] Invalid group size. Is it greater than 0?");if(n>=e.length)return[[...e]];let t=[];for(let r=0;r<e.length;r+=n)t.push(e.slice(r,r+n));return t}function M(n){return n[0]}function C(n){return n.slice(0,n.length-1)}function U(n){return n[n.length-1]}function I(n){if(!!n.length)return Math.max(...n)}function q(n){if(!!n.length)return Math.min(...n)}function B(n,e){return e.reduce(([t,r],o,i,s)=>n(o,i,s)?[[...t,o],r]:[t,[...r,o]],[[],[]])}function D(n,e){return n<=0?[[],[...e]]:[e.slice(0,n),e.slice(n)]}function R(n){return n.length?n.reduce((e,t)=>e+t,0):0}function L(n){return n.slice(1)}function P(n,e){return n<=0?[]:e.slice(0,n)}function V(n){return n?Array.isArray(n)?n:[n]:[]}function p(n){return Array.from(new Set(n))}function W(n,e){let t;return function(...r){clearTimeout(t),t=setTimeout(()=>{clearTimeout(t),n(...r)},e)}}function $(n){let e={};return function(...t){let r=JSON.stringify(t);if(r in e)return e[r];let o=n(...t);return e[r]=o,o}}function k(n){let e=!1;return(...t)=>{e||(n(...t),e=!0)}}function H(n,e){let t=!1;return function(...r){t||(n(...r),t=!0,setTimeout(()=>{t=!1},e))}}function f(n){return Array.isArray(n)}function z(n){return typeof n=="boolean"}function g(){return typeof window<"u"}function J(n){return typeof n<"u"}function K(n){if(!u(n))return!1;for(let e in n)return!1;return!0}function Y(n){return typeof n=="function"}function m(n){return typeof n=="number"}function u(n){return Object.prototype.toString.call(n)==="[object Object]"}function c(n){return typeof n=="string"}function Z(){return"ontouchstart"in window||navigator.maxTouchPoints>0}function _(n){return g()&&toString.call(n)==="[object Window]"}function G(n){return n%2===0}function Q(n){return n%2!==0}function X(n,e){return n-Math.floor(n/e)*e}function h(n,e=0){return Math.floor(Math.random()*(n-e))+e}function nn(n){return h(n)===0}function en(){}async function tn(n){return new Promise(e=>setTimeout(e,n))}function w(...n){return n.reduce((e,t)=>(Object.keys(t).forEach(r=>{f(e[r])&&f(t[r])?e[r]=p(e[r].concat(t[r])):u(e[r])&&u(t[r])?e[r]=w(e[r],t[r]):e[r]=t[r]}),e),{})}function rn({to:n,offset:e=0,duration:t=1e3,container:r=null}){let o=c(n)?document.querySelector(n):n,i=c(r)?document.querySelector(r):r,s=(i==null?void 0:i.scrollTop)||(window==null?void 0:window.pageYOffset)||0,a=(m(o)?o:sn(o,s))+e,y=Date.now();function b(){let T=Date.now()-y,d=T<t,x=d?un(s,a,T,t):a;d&&requestAnimationFrame(b),i?i.scrollTop=x:window.scrollTo(0,x)}b()}function on(n){return n<.5?4*Math.pow(n,3):(n-1)*(2*n-2)*(2*n-2)+1}function un(n,e,t,r){return n+(e-n)*on(t/r)}function sn(n,e){return n.nodeName==="HTML"?-e:n.getBoundingClientRect().top+e}function fn(n,e=!1,t=" "){return e?n.split(t).map(r=>r.charAt(0).toUpperCase()+r.slice(1)).join(t):n.charAt(0).toUpperCase()+n.slice(1)}function cn(n){return n.split("")}function ln(n){return n.trim().length===0}function pn(n){return n.length===0}function mn(n){let e=/-(\w)/g;return n.replace(e,(t,r)=>r?r.toUpperCase():"")}function an(n){let e=/\B([A-Z])/g;return n.replace(e,"-$1").toLowerCase()}function bn(n){return n.length?Number(n.replace(/[#£€$,%]/g,"")):NaN}function Tn(n){if(typeof n=="string"&&(n.trim()===""||isNaN(parseFloat(n))))throw new Error("[tsu] invalid string. Does it contain only a number?");let r=["st","nd","rd"][(Number(n)/10%10^1&&Number(n)%10)-1]||"th";return`${n}${r}`}function dn(n,e,t="..."){return e<=0?t:n.slice(0,e)+t}0&&(module.exports={capitalise,chars,debounce,deepMerge,drop,groupsOf,head,init,isArray,isBlank,isBoolean,isBrowser,isDefined,isEmpty,isEmptyObject,isEven,isFunction,isNumber,isObject,isOdd,isString,isTouchDevice,isWindow,last,max,memoize,min,modulo,noop,once,partition,randomChance,randomNumber,scroll,sleep,splitAt,sum,tail,take,throttle,toArray,toCamel,toKebab,toNumber,toOrdinal,truncate,uniq});
+"use strict";var l=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var O=Object.getOwnPropertyNames;var j=Object.prototype.hasOwnProperty;var F=(n,e)=>{for(var t in e)l(n,t,{get:e[t],enumerable:!0})},E=(n,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of O(e))!j.call(n,o)&&o!==t&&l(n,o,{get:()=>e[o],enumerable:!(r=v(e,o))||r.enumerable});return n};var A=n=>E(l({},"__esModule",{value:!0}),n);var gn={};F(gn,{capitalise:()=>cn,chars:()=>ln,debounce:()=>G,deepMerge:()=>w,delay:()=>Q,drop:()=>N,groupsOf:()=>S,head:()=>M,init:()=>C,isArray:()=>s,isBlank:()=>pn,isBoolean:()=>W,isBrowser:()=>g,isDefined:()=>$,isEmpty:()=>mn,isEmptyObject:()=>k,isEven:()=>tn,isFunction:()=>H,isNumber:()=>m,isObject:()=>u,isOdd:()=>rn,isString:()=>c,isTouchDevice:()=>z,isWindow:()=>J,last:()=>U,max:()=>V,memoize:()=>X,min:()=>I,modulo:()=>on,noop:()=>fn,once:()=>nn,partition:()=>q,randomChance:()=>un,randomNumber:()=>h,scroll:()=>K,sleep:()=>sn,splitAt:()=>B,sum:()=>R,tail:()=>D,take:()=>L,throttle:()=>en,toArray:()=>P,toCamel:()=>an,toKebab:()=>bn,toNumber:()=>dn,toOrdinal:()=>Tn,truncate:()=>xn,uniq:()=>p});module.exports=A(gn);function N(n,e){return n<=0?[...e]:e.slice(n)}function S(n,e){if(n<=0)throw new Error("[tsu] Invalid group size. Is it greater than 0?");if(n>=e.length)return[[...e]];let t=[];for(let r=0;r<e.length;r+=n)t.push(e.slice(r,r+n));return t}function M(n){return n[0]}function C(n){return n.slice(0,n.length-1)}function U(n){return n[n.length-1]}function V(n){if(!!n.length)return Math.max(...n)}function I(n){if(!!n.length)return Math.min(...n)}function q(n,e){return e.reduce(([t,r],o,i,f)=>n(o,i,f)?[[...t,o],r]:[t,[...r,o]],[[],[]])}function B(n,e){return n<=0?[[],[...e]]:[e.slice(0,n),e.slice(n)]}function R(n){return n.length?n.reduce((e,t)=>e+t,0):0}function D(n){return n.slice(1)}function L(n,e){return n<=0?[]:e.slice(0,n)}function P(n){return n?Array.isArray(n)?n:[n]:[]}function p(n){return Array.from(new Set(n))}function s(n){return Array.isArray(n)}function W(n){return typeof n=="boolean"}function g(){return typeof window<"u"}function $(n){return typeof n<"u"}function k(n){if(!u(n))return!1;for(let e in n)return!1;return!0}function H(n){return typeof n=="function"}function m(n){return typeof n=="number"}function u(n){return Object.prototype.toString.call(n)==="[object Object]"}function c(n){return typeof n=="string"}function z(){return"ontouchstart"in window||navigator.maxTouchPoints>0}function J(n){return g()&&toString.call(n)==="[object Window]"}function K({to:n,offset:e=0,duration:t=1e3,container:r=null}){let o=c(n)?document.querySelector(n):n,i=c(r)?document.querySelector(r):r,f=(i==null?void 0:i.scrollTop)||(window==null?void 0:window.pageYOffset)||0,a=(m(o)?o:_(o,f))+e,y=Date.now();function b(){let d=Date.now()-y,T=d<t,x=T?Z(f,a,d,t):a;T&&requestAnimationFrame(b),i?i.scrollTop=x:window.scrollTo(0,x)}b()}function Y(n){return n<.5?4*Math.pow(n,3):(n-1)*(2*n-2)*(2*n-2)+1}function Z(n,e,t,r){return n+(e-n)*Y(t/r)}function _(n,e){return n.nodeName==="HTML"?-e:n.getBoundingClientRect().top+e}function G(n,e){let t;return function(...r){clearTimeout(t),t=setTimeout(()=>{clearTimeout(t),n(...r)},e)}}function Q(n,e){setTimeout(()=>{n()},e)}function X(n){let e={};return function(...t){let r=JSON.stringify(t);if(r in e)return e[r];let o=n(...t);return e[r]=o,o}}function nn(n){let e=!1;return(...t)=>{e||(n(...t),e=!0)}}function en(n,e){let t=!1;return function(...r){t||(n(...r),t=!0,setTimeout(()=>{t=!1},e))}}function tn(n){return n%2===0}function rn(n){return n%2!==0}function on(n,e){return n-Math.floor(n/e)*e}function un(n){return h(n)===0}function h(n,e=0){return Math.floor(Math.random()*(n-e))+e}function fn(){}async function sn(n){return new Promise(e=>setTimeout(e,n))}function w(...n){return n.reduce((e,t)=>(Object.keys(t).forEach(r=>{s(e[r])&&s(t[r])?e[r]=p(e[r].concat(t[r])):u(e[r])&&u(t[r])?e[r]=w(e[r],t[r]):e[r]=t[r]}),e),{})}function cn(n,e=!1,t=" "){return e?n.split(t).map(r=>r.charAt(0).toUpperCase()+r.slice(1)).join(t):n.charAt(0).toUpperCase()+n.slice(1)}function ln(n){return n.split("")}function pn(n){return n.trim().length===0}function mn(n){return n.length===0}function an(n){let e=/-(\w)/g;return n.replace(e,(t,r)=>r?r.toUpperCase():"")}function bn(n){let e=/\B([A-Z])/g;return n.replace(e,"-$1").toLowerCase()}function dn(n){return n.length?Number(n.replace(/[#£€$,%]/g,"")):NaN}function Tn(n){let t=["st","nd","rd"][(n/10%10^1&&n%10)-1]||"th";return`${n}${t}`}function xn(n,e,t="..."){return e<=0?t:n.slice(0,e)+t}0&&(module.exports={capitalise,chars,debounce,deepMerge,delay,drop,groupsOf,head,init,isArray,isBlank,isBoolean,isBrowser,isDefined,isEmpty,isEmptyObject,isEven,isFunction,isNumber,isObject,isOdd,isString,isTouchDevice,isWindow,last,max,memoize,min,modulo,noop,once,partition,randomChance,randomNumber,scroll,sleep,splitAt,sum,tail,take,throttle,toArray,toCamel,toKebab,toNumber,toOrdinal,truncate,uniq});

package/dist/index.d.ts

@@ -5,7 +5,7 @@ declare type VoidFn = Fn<void>;
 declare type Obj<V = unknown> = Record<string | symbol | number, V>;
 
 /**
- * Removes the first n items of an array.
+ * Removes the first `n` items of an array.
  *
  * @param n - The number of items to remove.
  * @param array - The array.
@@ -13,7 +13,7 @@ declare type Obj<V = unknown> = Record<string | symbol | number, V>;
  */
 declare function drop<T>(n: number, array: readonly T[]): T[];
 /**
- * Splits an array into groups of size s.
+ * Splits an array into groups of equal size.
  *
  * @param s - The size of each group.
  * @param array - The array.
@@ -64,7 +64,7 @@ declare function min(array: readonly number[]): number | undefined;
  */
 declare function partition<T>(filter: (x: T, idx: number, a: readonly T[]) => boolean, array: readonly T[]): [T[], T[]];
 /**
- * Splits an array into two at a given index.
+ * Splits an array into two at a stated index.
  *
  * @param i - The position to split at.
  * @param array - The array.
@@ -86,15 +86,15 @@ declare function sum(array: readonly number[]): number;
  */
 declare function tail<T>(array: readonly T[]): T[];
 /**
- * Returns the first n items of an array.
+ * Returns the first `n` items of an array.
  *
  * @param n - The number of items to return.
  * @param array - The array.
- * @returns The first n items.
+ * @returns The first `n` items.
  */
 declare function take<T>(n: number, array: readonly T[]): T[];
 /**
- * Wraps a single value of an array, if not already an array.
+ * Wraps a single value in an array, if not already an array.
  *
  * @param maybeArray - The value to wrap, or the existing array.
  * @returns The item wrapped in an array, or the provided array.
@@ -108,14 +108,38 @@ declare function toArray<T>(maybeArray: Nullable<Arrayable<T>>): T[];
  */
 declare function uniq<T>(array: readonly T[]): T[];
 
+interface ScrollConfig {
+    to: Element | string | number;
+    offset?: number;
+    duration?: number;
+    container?: Element | string | null;
+}
+/**
+ * Scrolls the page or provided container to a target element or y-coordinate.
+ *
+ * @param config - The scroll config.
+ * @param config.to - The scroll target.
+ * @param config.offset - The offset from the scroll target (in px).
+ * @param config.duration - The scroll duration (in ms).
+ * @param config.container - The container to scroll in.
+ */
+declare function scroll({ to, offset, duration, container }: ScrollConfig): void;
+
 /**
- * Prevents a function from running until it hasn't been called for a certain time period.
+ * Prevents function execution until it hasn't been called for a stated time period.
  *
  * @param fn - The function.
  * @param delay - The time period (in ms).
  * @returns The debounced function.
  */
-declare function debounce(fn: Fn, delay: number): VoidFn;
+declare function debounce(fn: VoidFn, delay: number): VoidFn;
+/**
+ * Delays function execution until after a stated time period has passed.
+ *
+ * @param fn - The function.
+ * @param delay - The time period (in ms).
+ */
+declare function delay(fn: VoidFn, delay: number): void;
 /**
  * Optimises subsequent calls of a function by caching return values.
  *
@@ -129,15 +153,15 @@ declare function memoize<T>(fn: Fn<T>): Fn<T>;
  * @param fn - The function.
  * @returns The one-time callable function.
  */
-declare function once(fn: Fn): VoidFn;
+declare function once(fn: VoidFn): VoidFn;
 /**
- * Prevents a function from running for some time period after it was last called.
+ * Prevents function execution for a stated time period after it was last called.
  *
  * @param fn - The function.
  * @param limit - The time period.
  * @returns The throttled function.
  */
-declare function throttle(fn: Fn, limit: number): VoidFn;
+declare function throttle(fn: VoidFn, limit: number): VoidFn;
 
 /**
  * Identifies if a value is an array.
@@ -237,6 +261,13 @@ declare function isOdd(n: number): boolean;
  * @returns The remainder of dividing n by m.
  */
 declare function modulo(n: number, m: number): number;
+/**
+ * Rolls an `n`-sided die.
+ *
+ * @param n - The number of sides on the die.
+ * @returns If the die roll was 0.
+ */
+declare function randomChance(n: number): boolean;
 /**
  * Generates a random integer between bounds.
  *
@@ -245,13 +276,6 @@ declare function modulo(n: number, m: number): number;
  * @returns The random integer.
  */
 declare function randomNumber(max: number, min?: number): number;
-/**
- * Rolls an n-sided die.
- *
- * @param n - The number of sides on the die.
- * @returns If the die roll was 0.
- */
-declare function randomChance(n: number): boolean;
 
 /**
  * Does nothing.
@@ -260,9 +284,9 @@ declare function randomChance(n: number): boolean;
  */
 declare function noop(): void;
 /**
- * Halts program execution for a specified time.
+ * Halts thread execution for a stated time period.
  *
- * @param duration - The time to wait (in ms).
+ * @param duration - The time period (in ms).
  * @returns The halting promise.
  */
 declare function sleep(duration: number): Promise<void>;
@@ -276,23 +300,6 @@ declare type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) e
  */
 declare function deepMerge<T extends Obj<any>[]>(...objects: T): UnionToIntersection<T[number]>;
 
-declare type ScrollConfig = {
-    to: Element | string | number;
-    offset?: number;
-    duration?: number;
-    container?: Element | string | null;
-};
-/**
- * Scrolls the page or provided container to a target element or y-coordinate.
- *
- * @param config - The scroll config.
- * @param config.to - The scroll target.
- * @param config.offset - The offset from the scroll target (in px).
- * @param config.duration - The scroll duration (in ms).
- * @param config.container - The container to scroll in.
- */
-declare function scroll({ to, offset, duration, container }: ScrollConfig): void;
-
 /**
  * Capitalises the first letter of one word, or all words, in a string.
  *
@@ -338,7 +345,7 @@ declare function toCamel(str: string): string;
  */
 declare function toKebab(str: string): string;
 /**
- * Converts a string which contains a number to the number itself.
+ * Converts a string which contains a number into the number itself.
  *
  * @param str - The string.
  * @returns The number.
@@ -350,7 +357,7 @@ declare function toNumber(str: string): number;
  * @param n - The number.
  * @returns The number with the ordinal suffix appended.
  */
-declare function toOrdinal(n: number | string): string;
+declare function toOrdinal(n: number): string;
 /**
  * Truncates a string to a provided length.
  *
@@ -361,4 +368,4 @@ declare function toOrdinal(n: number | string): string;
  */
 declare function truncate(str: string, length: number, truncateStr?: string): string;
 
-export { Arrayable, Fn, Nullable, Obj, VoidFn, capitalise, chars, debounce, deepMerge, drop, groupsOf, head, init, isArray, isBlank, isBoolean, isBrowser, isDefined, isEmpty, isEmptyObject, isEven, isFunction, isNumber, isObject, isOdd, isString, isTouchDevice, isWindow, last, max, memoize, min, modulo, noop, once, partition, randomChance, randomNumber, scroll, sleep, splitAt, sum, tail, take, throttle, toArray, toCamel, toKebab, toNumber, toOrdinal, truncate, uniq };
+export { Arrayable, Fn, Nullable, Obj, VoidFn, capitalise, chars, debounce, deepMerge, delay, drop, groupsOf, head, init, isArray, isBlank, isBoolean, isBrowser, isDefined, isEmpty, isEmptyObject, isEven, isFunction, isNumber, isObject, isOdd, isString, isTouchDevice, isWindow, last, max, memoize, min, modulo, noop, once, partition, randomChance, randomNumber, scroll, sleep, splitAt, sum, tail, take, throttle, toArray, toCamel, toKebab, toNumber, toOrdinal, truncate, uniq };

package/dist/index.js

@@ -1 +1 @@
-function j(n,e){return n<=0?[...e]:e.slice(n)}function E(n,e){if(n<=0)throw new Error("[tsu] Invalid group size. Is it greater than 0?");if(n>=e.length)return[[...e]];let r=[];for(let t=0;t<e.length;t+=n)r.push(e.slice(t,t+n));return r}function F(n){return n[0]}function N(n){return n.slice(0,n.length-1)}function A(n){return n[n.length-1]}function S(n){if(!!n.length)return Math.max(...n)}function M(n){if(!!n.length)return Math.min(...n)}function C(n,e){return e.reduce(([r,t],o,i,u)=>n(o,i,u)?[[...r,o],t]:[r,[...t,o]],[[],[]])}function U(n,e){return n<=0?[[],[...e]]:[e.slice(0,n),e.slice(n)]}function I(n){return n.length?n.reduce((e,r)=>e+r,0):0}function q(n){return n.slice(1)}function B(n,e){return n<=0?[]:e.slice(0,n)}function D(n){return n?Array.isArray(n)?n:[n]:[]}function T(n){return Array.from(new Set(n))}function L(n,e){let r;return function(...t){clearTimeout(r),r=setTimeout(()=>{clearTimeout(r),n(...t)},e)}}function P(n){let e={};return function(...r){let t=JSON.stringify(r);if(t in e)return e[t];let o=n(...r);return e[t]=o,o}}function V(n){let e=!1;return(...r)=>{e||(n(...r),e=!0)}}function W(n,e){let r=!1;return function(...t){r||(n(...t),r=!0,setTimeout(()=>{r=!1},e))}}function f(n){return Array.isArray(n)}function k(n){return typeof n=="boolean"}function g(){return typeof window<"u"}function H(n){return typeof n<"u"}function z(n){if(!s(n))return!1;for(let e in n)return!1;return!0}function J(n){return typeof n=="function"}function d(n){return typeof n=="number"}function s(n){return Object.prototype.toString.call(n)==="[object Object]"}function c(n){return typeof n=="string"}function K(){return"ontouchstart"in window||navigator.maxTouchPoints>0}function Y(n){return g()&&toString.call(n)==="[object Window]"}function _(n){return n%2===0}function G(n){return n%2!==0}function Q(n,e){return n-Math.floor(n/e)*e}function h(n,e=0){return Math.floor(Math.random()*(n-e))+e}function X(n){return h(n)===0}function en(){}async function tn(n){return new Promise(e=>setTimeout(e,n))}function w(...n){return n.reduce((e,r)=>(Object.keys(r).forEach(t=>{f(e[t])&&f(r[t])?e[t]=T(e[t].concat(r[t])):s(e[t])&&s(r[t])?e[t]=w(e[t],r[t]):e[t]=r[t]}),e),{})}function cn({to:n,offset:e=0,duration:r=1e3,container:t=null}){let o=c(n)?document.querySelector(n):n,i=c(t)?document.querySelector(t):t,u=(i==null?void 0:i.scrollTop)||(window==null?void 0:window.pageYOffset)||0,l=(d(o)?o:O(o,u))+e,x=Date.now();function p(){let m=Date.now()-x,a=m<r,b=a?v(u,l,m,r):l;a&&requestAnimationFrame(p),i?i.scrollTop=b:window.scrollTo(0,b)}p()}function y(n){return n<.5?4*Math.pow(n,3):(n-1)*(2*n-2)*(2*n-2)+1}function v(n,e,r,t){return n+(e-n)*y(r/t)}function O(n,e){return n.nodeName==="HTML"?-e:n.getBoundingClientRect().top+e}function pn(n,e=!1,r=" "){return e?n.split(r).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(r):n.charAt(0).toUpperCase()+n.slice(1)}function mn(n){return n.split("")}function an(n){return n.trim().length===0}function bn(n){return n.length===0}function Tn(n){let e=/-(\w)/g;return n.replace(e,(r,t)=>t?t.toUpperCase():"")}function dn(n){let e=/\B([A-Z])/g;return n.replace(e,"-$1").toLowerCase()}function xn(n){return n.length?Number(n.replace(/[#£€$,%]/g,"")):NaN}function gn(n){if(typeof n=="string"&&(n.trim()===""||isNaN(parseFloat(n))))throw new Error("[tsu] invalid string. Does it contain only a number?");let t=["st","nd","rd"][(Number(n)/10%10^1&&Number(n)%10)-1]||"th";return`${n}${t}`}function hn(n,e,r="..."){return e<=0?r:n.slice(0,e)+r}export{pn as capitalise,mn as chars,L as debounce,w as deepMerge,j as drop,E as groupsOf,F as head,N as init,f as isArray,an as isBlank,k as isBoolean,g as isBrowser,H as isDefined,bn as isEmpty,z as isEmptyObject,_ as isEven,J as isFunction,d as isNumber,s as isObject,G as isOdd,c as isString,K as isTouchDevice,Y as isWindow,A as last,S as max,P as memoize,M as min,Q as modulo,en as noop,V as once,C as partition,X as randomChance,h as randomNumber,cn as scroll,tn as sleep,U as splitAt,I as sum,q as tail,B as take,W as throttle,D as toArray,Tn as toCamel,dn as toKebab,xn as toNumber,gn as toOrdinal,hn as truncate,T as uniq};
+function j(n,e){return n<=0?[...e]:e.slice(n)}function F(n,e){if(n<=0)throw new Error("[tsu] Invalid group size. Is it greater than 0?");if(n>=e.length)return[[...e]];let t=[];for(let r=0;r<e.length;r+=n)t.push(e.slice(r,r+n));return t}function E(n){return n[0]}function A(n){return n.slice(0,n.length-1)}function N(n){return n[n.length-1]}function S(n){if(!!n.length)return Math.max(...n)}function M(n){if(!!n.length)return Math.min(...n)}function C(n,e){return e.reduce(([t,r],o,i,u)=>n(o,i,u)?[[...t,o],r]:[t,[...r,o]],[[],[]])}function U(n,e){return n<=0?[[],[...e]]:[e.slice(0,n),e.slice(n)]}function V(n){return n.length?n.reduce((e,t)=>e+t,0):0}function I(n){return n.slice(1)}function q(n,e){return n<=0?[]:e.slice(0,n)}function B(n){return n?Array.isArray(n)?n:[n]:[]}function d(n){return Array.from(new Set(n))}function s(n){return Array.isArray(n)}function D(n){return typeof n=="boolean"}function g(){return typeof window<"u"}function L(n){return typeof n<"u"}function P(n){if(!f(n))return!1;for(let e in n)return!1;return!0}function W(n){return typeof n=="function"}function T(n){return typeof n=="number"}function f(n){return Object.prototype.toString.call(n)==="[object Object]"}function c(n){return typeof n=="string"}function $(){return"ontouchstart"in window||navigator.maxTouchPoints>0}function k(n){return g()&&toString.call(n)==="[object Window]"}function J({to:n,offset:e=0,duration:t=1e3,container:r=null}){let o=c(n)?document.querySelector(n):n,i=c(r)?document.querySelector(r):r,u=(i==null?void 0:i.scrollTop)||(window==null?void 0:window.pageYOffset)||0,l=(T(o)?o:y(o,u))+e,x=Date.now();function p(){let m=Date.now()-x,a=m<t,b=a?w(u,l,m,t):l;a&&requestAnimationFrame(p),i?i.scrollTop=b:window.scrollTo(0,b)}p()}function h(n){return n<.5?4*Math.pow(n,3):(n-1)*(2*n-2)*(2*n-2)+1}function w(n,e,t,r){return n+(e-n)*h(t/r)}function y(n,e){return n.nodeName==="HTML"?-e:n.getBoundingClientRect().top+e}function Y(n,e){let t;return function(...r){clearTimeout(t),t=setTimeout(()=>{clearTimeout(t),n(...r)},e)}}function Z(n,e){setTimeout(()=>{n()},e)}function _(n){let e={};return function(...t){let r=JSON.stringify(t);if(r in e)return e[r];let o=n(...t);return e[r]=o,o}}function G(n){let e=!1;return(...t)=>{e||(n(...t),e=!0)}}function Q(n,e){let t=!1;return function(...r){t||(n(...r),t=!0,setTimeout(()=>{t=!1},e))}}function nn(n){return n%2===0}function en(n){return n%2!==0}function tn(n,e){return n-Math.floor(n/e)*e}function rn(n){return v(n)===0}function v(n,e=0){return Math.floor(Math.random()*(n-e))+e}function un(){}async function fn(n){return new Promise(e=>setTimeout(e,n))}function O(...n){return n.reduce((e,t)=>(Object.keys(t).forEach(r=>{s(e[r])&&s(t[r])?e[r]=d(e[r].concat(t[r])):f(e[r])&&f(t[r])?e[r]=O(e[r],t[r]):e[r]=t[r]}),e),{})}function mn(n,e=!1,t=" "){return e?n.split(t).map(r=>r.charAt(0).toUpperCase()+r.slice(1)).join(t):n.charAt(0).toUpperCase()+n.slice(1)}function an(n){return n.split("")}function bn(n){return n.trim().length===0}function dn(n){return n.length===0}function Tn(n){let e=/-(\w)/g;return n.replace(e,(t,r)=>r?r.toUpperCase():"")}function xn(n){let e=/\B([A-Z])/g;return n.replace(e,"-$1").toLowerCase()}function gn(n){return n.length?Number(n.replace(/[#£€$,%]/g,"")):NaN}function hn(n){let t=["st","nd","rd"][(n/10%10^1&&n%10)-1]||"th";return`${n}${t}`}function wn(n,e,t="..."){return e<=0?t:n.slice(0,e)+t}export{mn as capitalise,an as chars,Y as debounce,O as deepMerge,Z as delay,j as drop,F as groupsOf,E as head,A as init,s as isArray,bn as isBlank,D as isBoolean,g as isBrowser,L as isDefined,dn as isEmpty,P as isEmptyObject,nn as isEven,W as isFunction,T as isNumber,f as isObject,en as isOdd,c as isString,$ as isTouchDevice,k as isWindow,N as last,S as max,_ as memoize,M as min,tn as modulo,un as noop,G as once,C as partition,rn as randomChance,v as randomNumber,J as scroll,fn as sleep,U as splitAt,V as sum,I as tail,q as take,Q as throttle,B as toArray,Tn as toCamel,xn as toKebab,gn as toNumber,hn as toOrdinal,wn as truncate,d as uniq};

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "tsu",
-  "version": "1.2.1",
+  "version": "1.3.2",
   "type": "module",
-  "description": "A collection of TypeScript utilities.",
+  "description": "TypeScript utilities",
   "license": "MIT",
   "author": "eb3n",
   "main": "./dist/index.js",
@@ -30,8 +30,8 @@
     "watch": "nr build --watch src",
     "test": "jest",
     "prepublishOnly": "nr test; nr build",
-    "docs:dev": "vuepress dev docs",
-    "docs:build": "vuepress build docs"
+    "docs:dev": "vitepress dev docs --port 8888",
+    "docs:build": "vitepress build docs"
   },
   "devDependencies": {
     "@antfu/ni": "^0.17.2",
@@ -46,6 +46,7 @@
     "ts-jest": "^28.0.8",
     "tsup": "^6.2.2",
     "typescript": "^4.7.4",
+    "vitepress": "1.0.0-alpha.8",
     "vuepress": "2.0.0-beta.41"
   }
 }