tsu 1.1.2 → 1.3.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021-present eb3n
+Copyright © 2021-Present eb3n
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -17,6 +17,9 @@ Install with your favourite package manager:
 # yarn
 yarn add tsu
 
+# pnpm
+pnpm install tsu
+
 # npm
 npm install tsu
 ```
@@ -29,7 +32,7 @@ import { ... } from 'tsu'
 
 ## Documentation
 
-Full documentation is available [here](https://tsu-docs.netlify.app).
+Full documentation is available [here](https://tsu.eb3n.dev).
 
 ## Credits
 

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var l=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var O=Object.getOwnPropertyNames;var F=Object.prototype.hasOwnProperty;var j=(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))!F.call(n,o)&&o!==t&&l(n,o,{get:()=>e[o],enumerable:!(r=v(e,o))||r.enumerable});return n};var N=n=>E(l({},"__esModule",{value:!0}),n);var gn={};j(gn,{capitalise:()=>cn,chars:()=>ln,debounce:()=>W,deepMerge:()=>w,delay:()=>$,drop:()=>A,groupsOf:()=>S,head:()=>M,init:()=>C,isArray:()=>f,isBlank:()=>pn,isBoolean:()=>J,isBrowser:()=>g,isDefined:()=>K,isEmpty:()=>mn,isEmptyObject:()=>Y,isEven:()=>Q,isFunction:()=>Z,isNumber:()=>m,isObject:()=>u,isOdd:()=>X,isString:()=>c,isTouchDevice:()=>_,isWindow:()=>G,last:()=>U,max:()=>I,memoize:()=>k,min:()=>q,modulo:()=>nn,noop:()=>tn,once:()=>H,partition:()=>B,randomChance:()=>en,randomNumber:()=>h,scroll:()=>on,sleep:()=>rn,splitAt:()=>D,sum:()=>R,tail:()=>L,take:()=>P,throttle:()=>z,toArray:()=>V,toCamel:()=>an,toKebab:()=>bn,toNumber:()=>Tn,toOrdinal:()=>dn,truncate:()=>xn,uniq:()=>p});module.exports=N(gn);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,e){setTimeout(()=>{n()},e)}function k(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 H(n){let e=!1;return(...t)=>{e||(n(...t),e=!0)}}function z(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 J(n){return typeof n=="boolean"}function g(){return typeof window<"u"}function K(n){return typeof n<"u"}function Y(n){if(!u(n))return!1;for(let e in n)return!1;return!0}function Z(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 _(){return"ontouchstart"in window||navigator.maxTouchPoints>0}function G(n){return g()&&toString.call(n)==="[object Window]"}function Q(n){return n%2===0}function X(n){return n%2!==0}function nn(n,e){return n-Math.floor(n/e)*e}function h(n,e=0){return Math.floor(Math.random()*(n-e))+e}function en(n){return h(n)===0}function tn(){}async function rn(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 on({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:fn(o,s))+e,y=Date.now();function b(){let T=Date.now()-y,d=T<t,x=d?sn(s,a,T,t):a;d&&requestAnimationFrame(b),i?i.scrollTop=x:window.scrollTo(0,x)}b()}function un(n){return n<.5?4*Math.pow(n,3):(n-1)*(2*n-2)*(2*n-2)+1}function sn(n,e,t,r){return n+(e-n)*un(t/r)}function fn(n,e){return n.nodeName==="HTML"?-e:n.getBoundingClientRect().top+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 Tn(n){return n.length?Number(n.replace(/[#£€$,%]/g,"")):NaN}function dn(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 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

@@ -60,7 +60,7 @@ declare function min(array: readonly number[]): number | undefined;
  *
  * @param filter - The predicate function.
  * @param array - The array.
- * @returns The array split in two.
+ * @returns The tuple of values that satisfy the predicate and those that don't.
  */
 declare function partition<T>(filter: (x: T, idx: number, a: readonly T[]) => boolean, array: readonly T[]): [T[], T[]];
 /**
@@ -68,11 +68,11 @@ declare function partition<T>(filter: (x: T, idx: number, a: readonly T[]) => bo
  *
  * @param i - The position to split at.
  * @param array - The array.
- * @returns The array split in two.
+ * @returns The tuple of values before and after the split.
  */
 declare function splitAt<T>(i: number, array: readonly T[]): [T[], T[]];
 /**
- * Returns the sum of the numbers of an array.
+ * Returns the sum of an array of numbers.
  *
  * @param array - The array of numbers.
  * @returns The sum.
@@ -109,13 +109,20 @@ declare function toArray<T>(maybeArray: Nullable<Arrayable<T>>): T[];
 declare function uniq<T>(array: readonly T[]): T[];
 
 /**
- * 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;
+/**
+ * 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: Fn, delay: number): void;
 /**
  * Optimises subsequent calls of a function by caching return values.
  *
@@ -124,7 +131,14 @@ declare function debounce(fn: Fn, delay: number): VoidFn;
  */
 declare function memoize<T>(fn: Fn<T>): Fn<T>;
 /**
- * Prevents a function from running for some time period after it was last called.
+ * Enforces that a function is only callable one time.
+ *
+ * @param fn - The function.
+ * @returns The one-time callable function.
+ */
+declare function once(fn: Fn): VoidFn;
+/**
+ * Prevents function execution for a stated time period after it was last called.
  *
  * @param fn - The function.
  * @param limit - The time period.
@@ -147,9 +161,9 @@ declare function isArray(val: unknown): val is any[];
  */
 declare function isBoolean(val: unknown): val is boolean;
 /**
- * Identifies if the code is being run in the browser.
+ * Identifies if the code is being run in a browser.
  *
- * @returns If the code is being run on a browser.
+ * @returns If the code is being run in a browser.
  */
 declare function isBrowser(): boolean;
 /**
@@ -159,6 +173,13 @@ declare function isBrowser(): boolean;
  * @returns If the value is defined.
  */
 declare function isDefined<T = unknown>(val?: T): val is T;
+/**
+ * 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>;
 /**
  * Identifies if a value is a function.
  *
@@ -246,9 +267,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>;
@@ -284,9 +305,10 @@ declare function scroll({ to, offset, duration, container }: ScrollConfig): void
  *
  * @param str - The string.
  * @param allWords - If all words should be capitalised.
+ * @param delimiter - The delimiter to split the string by.
  * @returns The capitalised string.
  */
-declare function capitalise(str: string, allWords?: boolean): string;
+declare function capitalise(str: string, allWords?: boolean, delimiter?: string): string;
 /**
  * Separates a string into an array of characters.
  *
@@ -329,6 +351,13 @@ declare function toKebab(str: string): string;
  * @returns The number.
  */
 declare function toNumber(str: string): number;
+/**
+ * Adds the respective ordinal suffix (-st, -nd, -rd or -th) to a number.
+ *
+ * @param n - The number.
+ * @returns The number with the ordinal suffix appended.
+ */
+declare function toOrdinal(n: number | string): string;
 /**
  * Truncates a string to a provided length.
  *
@@ -339,4 +368,4 @@ declare function toNumber(str: string): number;
  */
 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, isEven, isFunction, isNumber, isObject, isOdd, isString, isTouchDevice, isWindow, last, max, memoize, min, modulo, noop, partition, randomChance, randomNumber, scroll, sleep, splitAt, sum, tail, take, throttle, toArray, toCamel, toKebab, toNumber, 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,382 +1 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __markAsModule = (target) => __defProp(target, "__esModule", { value: true });
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __reExport = (target, module2, copyDefault, desc) => {
-  if (module2 && typeof module2 === "object" || typeof module2 === "function") {
-    for (let key of __getOwnPropNames(module2))
-      if (!__hasOwnProp.call(target, key) && (copyDefault || key !== "default"))
-        __defProp(target, key, { get: () => module2[key], enumerable: !(desc = __getOwnPropDesc(module2, key)) || desc.enumerable });
-  }
-  return target;
-};
-var __toCommonJS = /* @__PURE__ */ ((cache) => {
-  return (module2, temp) => {
-    return cache && cache.get(module2) || (temp = __reExport(__markAsModule({}), module2, 1), cache && cache.set(module2, temp), temp);
-  };
-})(typeof WeakMap !== "undefined" ? /* @__PURE__ */ new WeakMap() : 0);
-
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  capitalise: () => capitalise,
-  chars: () => chars,
-  debounce: () => debounce,
-  deepMerge: () => deepMerge,
-  drop: () => drop,
-  groupsOf: () => groupsOf,
-  head: () => head,
-  init: () => init,
-  isArray: () => isArray,
-  isBlank: () => isBlank,
-  isBoolean: () => isBoolean,
-  isBrowser: () => isBrowser,
-  isDefined: () => isDefined,
-  isEmpty: () => isEmpty,
-  isEven: () => isEven,
-  isFunction: () => isFunction,
-  isNumber: () => isNumber,
-  isObject: () => isObject,
-  isOdd: () => isOdd,
-  isString: () => isString,
-  isTouchDevice: () => isTouchDevice,
-  isWindow: () => isWindow,
-  last: () => last,
-  max: () => max,
-  memoize: () => memoize,
-  min: () => min,
-  modulo: () => modulo,
-  noop: () => noop,
-  partition: () => partition,
-  randomChance: () => randomChance,
-  randomNumber: () => randomNumber,
-  scroll: () => scroll,
-  sleep: () => sleep,
-  splitAt: () => splitAt,
-  sum: () => sum,
-  tail: () => tail,
-  take: () => take,
-  throttle: () => throttle,
-  toArray: () => toArray,
-  toCamel: () => toCamel,
-  toKebab: () => toKebab,
-  toNumber: () => toNumber,
-  truncate: () => truncate,
-  uniq: () => uniq
-});
-
-// src/array.ts
-function drop(n, array) {
-  if (n <= 0) {
-    return [...array];
-  }
-  return array.slice(n);
-}
-function groupsOf(s, array) {
-  if (s <= 0) {
-    throw new Error("[tsu] Invalid group size");
-  }
-  if (s >= array.length) {
-    return [[...array]];
-  }
-  const groupedArray = [];
-  for (let i = 0; i < array.length; i += s) {
-    groupedArray.push(array.slice(i, i + s));
-  }
-  return groupedArray;
-}
-function head(array) {
-  return array[0];
-}
-function init(array) {
-  return array.slice(0, array.length - 1);
-}
-function last(array) {
-  return array[array.length - 1];
-}
-function max(array) {
-  if (!array.length) {
-    return;
-  }
-  return Math.max(...array);
-}
-function min(array) {
-  if (!array.length) {
-    return;
-  }
-  return Math.min(...array);
-}
-function partition(filter, array) {
-  return array.reduce(([passed, failed], item, idx, arr) => {
-    if (filter(item, idx, arr)) {
-      return [[...passed, item], failed];
-    }
-    return [passed, [...failed, item]];
-  }, [[], []]);
-}
-function splitAt(i, array) {
-  if (i <= 0) {
-    return [[], [...array]];
-  }
-  return [array.slice(0, i), array.slice(i)];
-}
-function sum(array) {
-  if (!array.length) {
-    return 0;
-  }
-  return array.reduce((sum2, current) => sum2 + current, 0);
-}
-function tail(array) {
-  return array.slice(1);
-}
-function take(n, array) {
-  if (n <= 0) {
-    return [];
-  }
-  return array.slice(0, n);
-}
-function toArray(maybeArray) {
-  if (!maybeArray) {
-    return [];
-  }
-  return Array.isArray(maybeArray) ? maybeArray : [maybeArray];
-}
-function uniq(array) {
-  return Array.from(new Set(array));
-}
-
-// src/function.ts
-function debounce(fn, delay) {
-  let timeout;
-  return function(...args) {
-    clearTimeout(timeout);
-    timeout = setTimeout(() => {
-      clearTimeout(timeout);
-      fn(...args);
-    }, delay);
-  };
-}
-function memoize(fn) {
-  const cache = {};
-  return function(...args) {
-    const argsString = JSON.stringify(args);
-    if (argsString in cache) {
-      return cache[argsString];
-    }
-    const result = fn(...args);
-    cache[argsString] = result;
-    return result;
-  };
-}
-function throttle(fn, limit) {
-  let isWaiting = false;
-  return function(...args) {
-    if (!isWaiting) {
-      fn(...args);
-      isWaiting = true;
-      setTimeout(() => {
-        isWaiting = false;
-      }, limit);
-    }
-  };
-}
-
-// src/is.ts
-function isArray(val) {
-  return Array.isArray(val);
-}
-function isBoolean(val) {
-  return typeof val === "boolean";
-}
-function isBrowser() {
-  return typeof window !== "undefined";
-}
-function isDefined(val) {
-  return typeof val !== "undefined";
-}
-function isFunction(val) {
-  return typeof val === "function";
-}
-function isNumber(val) {
-  return typeof val === "number";
-}
-function isObject(val) {
-  return Object.prototype.toString.call(val) === "[object Object]";
-}
-function isString(val) {
-  return typeof val === "string";
-}
-function isTouchDevice() {
-  return "ontouchstart" in window || navigator.maxTouchPoints > 0;
-}
-function isWindow(val) {
-  return isBrowser() && toString.call(val) === "[object Window]";
-}
-
-// src/maths.ts
-function isEven(n) {
-  return n % 2 === 0;
-}
-function isOdd(n) {
-  return n % 2 !== 0;
-}
-function modulo(n, m) {
-  return n - Math.floor(n / m) * m;
-}
-function randomNumber(max2, min2 = 0) {
-  return Math.floor(Math.random() * (max2 - min2)) + min2;
-}
-function randomChance(n) {
-  return randomNumber(n) === 0;
-}
-
-// src/misc.ts
-function noop() {
-  return;
-}
-async function sleep(duration) {
-  return new Promise((resolve) => setTimeout(resolve, duration));
-}
-
-// src/object.ts
-function deepMerge(...objects) {
-  return objects.reduce((result, current) => {
-    Object.keys(current).forEach((key) => {
-      if (isArray(result[key]) && isArray(current[key])) {
-        result[key] = uniq(result[key].concat(current[key]));
-      } else if (isObject(result[key]) && isObject(current[key])) {
-        result[key] = deepMerge(result[key], current[key]);
-      } else {
-        result[key] = current[key];
-      }
-    });
-    return result;
-  }, {});
-}
-
-// src/scroll.ts
-function scroll({
-  to,
-  offset = 0,
-  duration = 1e3,
-  container = null
-}) {
-  const target = isString(to) ? document.querySelector(to) : to;
-  const _container = isString(container) ? document.querySelector(container) : container;
-  const start = (_container == null ? void 0 : _container.scrollTop) || (window == null ? void 0 : window.pageYOffset) || 0;
-  const end = (isNumber(target) ? target : getElTop(target, start)) + offset;
-  const startTime = Date.now();
-  function step() {
-    const timeElapsed = Date.now() - startTime;
-    const isScrolling = timeElapsed < duration;
-    const position = isScrolling ? getPosition(start, end, timeElapsed, duration) : end;
-    if (isScrolling) {
-      requestAnimationFrame(step);
-    }
-    if (_container) {
-      _container.scrollTop = position;
-    } else {
-      window.scrollTo(0, position);
-    }
-  }
-  step();
-}
-function easing(t) {
-  return t < 0.5 ? 4 * Math.pow(t, 3) : (t - 1) * (2 * t - 2) * (2 * t - 2) + 1;
-}
-function getPosition(s, e, t, d) {
-  return s + (e - s) * easing(t / d);
-}
-function getElTop(element, start) {
-  return element.nodeName === "HTML" ? -start : element.getBoundingClientRect().top + start;
-}
-
-// src/string.ts
-function capitalise(str, allWords = false) {
-  if (!allWords) {
-    return str.charAt(0).toUpperCase() + str.slice(1);
-  }
-  return str.split(" ").map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join(" ");
-}
-function chars(str) {
-  return str.split("");
-}
-function isBlank(str) {
-  return str.trim().length === 0;
-}
-function isEmpty(str) {
-  return str.length === 0;
-}
-function toCamel(str) {
-  const RE = /-(\w)/g;
-  return str.replace(RE, (_, c) => c ? c.toUpperCase() : "");
-}
-function toKebab(str) {
-  const RE = /\B([A-Z])/g;
-  return str.replace(RE, "-$1").toLowerCase();
-}
-function toNumber(str) {
-  if (!str.length) {
-    return NaN;
-  }
-  return Number(str.replace(/[#£€$,%]/g, ""));
-}
-function truncate(str, length, truncateStr = "...") {
-  if (length <= 0) {
-    return truncateStr;
-  }
-  return str.slice(0, length) + truncateStr;
-}
-module.exports = __toCommonJS(src_exports);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  capitalise,
-  chars,
-  debounce,
-  deepMerge,
-  drop,
-  groupsOf,
-  head,
-  init,
-  isArray,
-  isBlank,
-  isBoolean,
-  isBrowser,
-  isDefined,
-  isEmpty,
-  isEven,
-  isFunction,
-  isNumber,
-  isObject,
-  isOdd,
-  isString,
-  isTouchDevice,
-  isWindow,
-  last,
-  max,
-  memoize,
-  min,
-  modulo,
-  noop,
-  partition,
-  randomChance,
-  randomNumber,
-  scroll,
-  sleep,
-  splitAt,
-  sum,
-  tail,
-  take,
-  throttle,
-  toArray,
-  toCamel,
-  toKebab,
-  toNumber,
-  truncate,
-  uniq
-});
+function F(n,e){return n<=0?[...e]:e.slice(n)}function j(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 E(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,e){setTimeout(()=>{n()},e)}function V(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 W(n){let e=!1;return(...r)=>{e||(n(...r),e=!0)}}function $(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 H(n){return typeof n=="boolean"}function g(){return typeof window<"u"}function z(n){return typeof n<"u"}function J(n){if(!s(n))return!1;for(let e in n)return!1;return!0}function K(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 Y(){return"ontouchstart"in window||navigator.maxTouchPoints>0}function Z(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 tn(){}async function rn(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 ln({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 mn(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 an(n){return n.split("")}function bn(n){return n.trim().length===0}function Tn(n){return n.length===0}function dn(n){let e=/-(\w)/g;return n.replace(e,(r,t)=>t?t.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){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 wn(n,e,r="..."){return e<=0?r:n.slice(0,e)+r}export{mn as capitalise,an as chars,L as debounce,w as deepMerge,P as delay,F as drop,j as groupsOf,E as head,N as init,f as isArray,bn as isBlank,H as isBoolean,g as isBrowser,z as isDefined,Tn as isEmpty,J as isEmptyObject,G as isEven,K as isFunction,d as isNumber,s as isObject,Q as isOdd,c as isString,Y as isTouchDevice,Z as isWindow,A as last,S as max,V as memoize,M as min,X as modulo,tn as noop,W as once,C as partition,nn as randomChance,h as randomNumber,ln as scroll,rn as sleep,U as splitAt,I as sum,q as tail,B as take,$ as throttle,D as toArray,dn as toCamel,xn as toKebab,gn as toNumber,hn as toOrdinal,wn as truncate,T as uniq};

package/package.json

@@ -1,47 +1,51 @@
 {
   "name": "tsu",
-  "version": "1.1.2",
+  "version": "1.3.0",
+  "type": "module",
   "description": "A collection of TypeScript utilities.",
+  "license": "MIT",
   "author": "eb3n",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://gitlab.com/eb3n/tsu.git"
   },
-  "license": "MIT",
+  "bugs": {
+    "url": "https://gitlab.com/eb3n/tsu/issues"
+  },
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
-    "watch": "yarn build -- --watch src",
+    "build": "tsup",
+    "watch": "nr build --watch src",
     "test": "jest",
-    "prepublishOnly": "yarn test && yarn build",
+    "prepublishOnly": "nr test; nr build",
     "docs:dev": "vuepress dev docs",
     "docs:build": "vuepress build docs"
   },
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "exports": {
-    ".": {
-      "require": "./dist/index.js",
-      "import": "./dist/index.mjs",
-      "types": "./dist/index.d.ts"
-    }
-  },
   "devDependencies": {
-    "@types/jest": "^27.4.1",
-    "@typescript-eslint/eslint-plugin": "^5.14.0",
-    "@typescript-eslint/parser": "^5.14.0",
-    "eslint": "^8.10.0",
+    "@antfu/ni": "^0.17.2",
+    "@types/jest": "^28.1.7",
+    "@typescript-eslint/eslint-plugin": "^5.33.0",
+    "@typescript-eslint/parser": "^5.33.0",
+    "eslint": "^8.22.0",
     "eslint-config-prettier": "^8.5.0",
-    "eslint-plugin-prettier": "^4.0.0",
-    "jest": "^27.5.1",
-    "prettier": "^2.5.1",
-    "ts-jest": "^27.1.3",
-    "tsup": "^5.12.0",
-    "typescript": "^4.6.2",
-    "vuepress": "^2.0.0-beta.41"
-  },
-  "dependencies": {}
+    "eslint-plugin-prettier": "^4.2.1",
+    "jest": "^28.1.3",
+    "prettier": "^2.7.1",
+    "ts-jest": "^28.0.8",
+    "tsup": "^6.2.2",
+    "typescript": "^4.7.4",
+    "vuepress": "2.0.0-beta.41"
+  }
 }

package/dist/index.mjs

@@ -1,308 +0,0 @@
-// src/array.ts
-function drop(n, array) {
-  if (n <= 0) {
-    return [...array];
-  }
-  return array.slice(n);
-}
-function groupsOf(s, array) {
-  if (s <= 0) {
-    throw new Error("[tsu] Invalid group size");
-  }
-  if (s >= array.length) {
-    return [[...array]];
-  }
-  const groupedArray = [];
-  for (let i = 0; i < array.length; i += s) {
-    groupedArray.push(array.slice(i, i + s));
-  }
-  return groupedArray;
-}
-function head(array) {
-  return array[0];
-}
-function init(array) {
-  return array.slice(0, array.length - 1);
-}
-function last(array) {
-  return array[array.length - 1];
-}
-function max(array) {
-  if (!array.length) {
-    return;
-  }
-  return Math.max(...array);
-}
-function min(array) {
-  if (!array.length) {
-    return;
-  }
-  return Math.min(...array);
-}
-function partition(filter, array) {
-  return array.reduce(([passed, failed], item, idx, arr) => {
-    if (filter(item, idx, arr)) {
-      return [[...passed, item], failed];
-    }
-    return [passed, [...failed, item]];
-  }, [[], []]);
-}
-function splitAt(i, array) {
-  if (i <= 0) {
-    return [[], [...array]];
-  }
-  return [array.slice(0, i), array.slice(i)];
-}
-function sum(array) {
-  if (!array.length) {
-    return 0;
-  }
-  return array.reduce((sum2, current) => sum2 + current, 0);
-}
-function tail(array) {
-  return array.slice(1);
-}
-function take(n, array) {
-  if (n <= 0) {
-    return [];
-  }
-  return array.slice(0, n);
-}
-function toArray(maybeArray) {
-  if (!maybeArray) {
-    return [];
-  }
-  return Array.isArray(maybeArray) ? maybeArray : [maybeArray];
-}
-function uniq(array) {
-  return Array.from(new Set(array));
-}
-
-// src/function.ts
-function debounce(fn, delay) {
-  let timeout;
-  return function(...args) {
-    clearTimeout(timeout);
-    timeout = setTimeout(() => {
-      clearTimeout(timeout);
-      fn(...args);
-    }, delay);
-  };
-}
-function memoize(fn) {
-  const cache = {};
-  return function(...args) {
-    const argsString = JSON.stringify(args);
-    if (argsString in cache) {
-      return cache[argsString];
-    }
-    const result = fn(...args);
-    cache[argsString] = result;
-    return result;
-  };
-}
-function throttle(fn, limit) {
-  let isWaiting = false;
-  return function(...args) {
-    if (!isWaiting) {
-      fn(...args);
-      isWaiting = true;
-      setTimeout(() => {
-        isWaiting = false;
-      }, limit);
-    }
-  };
-}
-
-// src/is.ts
-function isArray(val) {
-  return Array.isArray(val);
-}
-function isBoolean(val) {
-  return typeof val === "boolean";
-}
-function isBrowser() {
-  return typeof window !== "undefined";
-}
-function isDefined(val) {
-  return typeof val !== "undefined";
-}
-function isFunction(val) {
-  return typeof val === "function";
-}
-function isNumber(val) {
-  return typeof val === "number";
-}
-function isObject(val) {
-  return Object.prototype.toString.call(val) === "[object Object]";
-}
-function isString(val) {
-  return typeof val === "string";
-}
-function isTouchDevice() {
-  return "ontouchstart" in window || navigator.maxTouchPoints > 0;
-}
-function isWindow(val) {
-  return isBrowser() && toString.call(val) === "[object Window]";
-}
-
-// src/maths.ts
-function isEven(n) {
-  return n % 2 === 0;
-}
-function isOdd(n) {
-  return n % 2 !== 0;
-}
-function modulo(n, m) {
-  return n - Math.floor(n / m) * m;
-}
-function randomNumber(max2, min2 = 0) {
-  return Math.floor(Math.random() * (max2 - min2)) + min2;
-}
-function randomChance(n) {
-  return randomNumber(n) === 0;
-}
-
-// src/misc.ts
-function noop() {
-  return;
-}
-async function sleep(duration) {
-  return new Promise((resolve) => setTimeout(resolve, duration));
-}
-
-// src/object.ts
-function deepMerge(...objects) {
-  return objects.reduce((result, current) => {
-    Object.keys(current).forEach((key) => {
-      if (isArray(result[key]) && isArray(current[key])) {
-        result[key] = uniq(result[key].concat(current[key]));
-      } else if (isObject(result[key]) && isObject(current[key])) {
-        result[key] = deepMerge(result[key], current[key]);
-      } else {
-        result[key] = current[key];
-      }
-    });
-    return result;
-  }, {});
-}
-
-// src/scroll.ts
-function scroll({
-  to,
-  offset = 0,
-  duration = 1e3,
-  container = null
-}) {
-  const target = isString(to) ? document.querySelector(to) : to;
-  const _container = isString(container) ? document.querySelector(container) : container;
-  const start = (_container == null ? void 0 : _container.scrollTop) || (window == null ? void 0 : window.pageYOffset) || 0;
-  const end = (isNumber(target) ? target : getElTop(target, start)) + offset;
-  const startTime = Date.now();
-  function step() {
-    const timeElapsed = Date.now() - startTime;
-    const isScrolling = timeElapsed < duration;
-    const position = isScrolling ? getPosition(start, end, timeElapsed, duration) : end;
-    if (isScrolling) {
-      requestAnimationFrame(step);
-    }
-    if (_container) {
-      _container.scrollTop = position;
-    } else {
-      window.scrollTo(0, position);
-    }
-  }
-  step();
-}
-function easing(t) {
-  return t < 0.5 ? 4 * Math.pow(t, 3) : (t - 1) * (2 * t - 2) * (2 * t - 2) + 1;
-}
-function getPosition(s, e, t, d) {
-  return s + (e - s) * easing(t / d);
-}
-function getElTop(element, start) {
-  return element.nodeName === "HTML" ? -start : element.getBoundingClientRect().top + start;
-}
-
-// src/string.ts
-function capitalise(str, allWords = false) {
-  if (!allWords) {
-    return str.charAt(0).toUpperCase() + str.slice(1);
-  }
-  return str.split(" ").map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join(" ");
-}
-function chars(str) {
-  return str.split("");
-}
-function isBlank(str) {
-  return str.trim().length === 0;
-}
-function isEmpty(str) {
-  return str.length === 0;
-}
-function toCamel(str) {
-  const RE = /-(\w)/g;
-  return str.replace(RE, (_, c) => c ? c.toUpperCase() : "");
-}
-function toKebab(str) {
-  const RE = /\B([A-Z])/g;
-  return str.replace(RE, "-$1").toLowerCase();
-}
-function toNumber(str) {
-  if (!str.length) {
-    return NaN;
-  }
-  return Number(str.replace(/[#£€$,%]/g, ""));
-}
-function truncate(str, length, truncateStr = "...") {
-  if (length <= 0) {
-    return truncateStr;
-  }
-  return str.slice(0, length) + truncateStr;
-}
-export {
-  capitalise,
-  chars,
-  debounce,
-  deepMerge,
-  drop,
-  groupsOf,
-  head,
-  init,
-  isArray,
-  isBlank,
-  isBoolean,
-  isBrowser,
-  isDefined,
-  isEmpty,
-  isEven,
-  isFunction,
-  isNumber,
-  isObject,
-  isOdd,
-  isString,
-  isTouchDevice,
-  isWindow,
-  last,
-  max,
-  memoize,
-  min,
-  modulo,
-  noop,
-  partition,
-  randomChance,
-  randomNumber,
-  scroll,
-  sleep,
-  splitAt,
-  sum,
-  tail,
-  take,
-  throttle,
-  toArray,
-  toCamel,
-  toKebab,
-  toNumber,
-  truncate,
-  uniq
-};