@studiometa/js-toolkit 2.12.1 → 3.0.0-alpha.10

package/utils/is.js

@@ -1,4 +1,5 @@
 const isDev = typeof __DEV__ !== "undefined" && __DEV__;
+const isNull = (value) => value === null;
 const isFunction = (value) => typeof value === "function";
 const isDefined = (value) => typeof value !== "undefined";
 const isString = (value) => typeof value === "string";
@@ -6,12 +7,28 @@ const isObject = (value) => typeof value === "object" && !!value && value.toStri
 const isNumber = (value) => typeof value === "number" && !Number.isNaN(value);
 const isBoolean = (value) => typeof value === "boolean";
 const isArray = Array.isArray;
+const isEmptyString = (value) => isString(value) && value.length === 0;
+const isEmpty = (value) => {
+  if (isNull(value) || !isDefined(value)) {
+    return true;
+  }
+  if (isString(value) || isArray(value)) {
+    return value.length === 0;
+  }
+  if (isObject(value)) {
+    return value.constructor === Object && Object.keys(value).length === 0;
+  }
+  return false;
+};
 export {
   isArray,
   isBoolean,
   isDefined,
   isDev,
+  isEmpty,
+  isEmptyString,
   isFunction,
+  isNull,
   isNumber,
   isObject,
   isString

package/utils/is.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/utils/is.ts"],
-  "sourcesContent": ["// eslint-disable-next-line no-undef\nexport const isDev = typeof __DEV__ !== 'undefined' && __DEV__;\n\n/**\n * Test if the given value is a function.\n */\n// eslint-disable-next-line @typescript-eslint/ban-types\nexport const isFunction = (value: unknown): value is Function => typeof value === 'function';\n\n/**\n * Test if a value is defined or not.\n */\nexport const isDefined = (value: unknown): boolean => typeof value !== 'undefined';\n\n/**\n * Test if value is a string.\n */\nexport const isString = (value: unknown): value is string => typeof value === 'string';\n\n/**\n * Test if the given value is an object.\n */\nexport const isObject = (value: unknown): boolean =>\n  typeof value === 'object' && !!value && value.toString() === '[object Object]';\n\n/**\n * Test if a given value is a number.\n */\nexport const isNumber = (value: unknown): value is number =>\n  typeof value === 'number' && !Number.isNaN(value);\n\n/**\n * Test if a given value is a boolean.\n */\nexport const isBoolean = (value: unknown): value is boolean => typeof value === 'boolean';\n\n// eslint-disable-next-line prefer-destructuring\nexport const isArray = Array.isArray;\n"],
-  "mappings": "AACO,MAAM,QAAQ,OAAO,YAAY,eAAe;AAMhD,MAAM,aAAa,CAAC,UAAsC,OAAO,UAAU;AAK3E,MAAM,YAAY,CAAC,UAA4B,OAAO,UAAU;AAKhE,MAAM,WAAW,CAAC,UAAoC,OAAO,UAAU;AAKvE,MAAM,WAAW,CAAC,UACvB,OAAO,UAAU,YAAY,CAAC,CAAC,SAAS,MAAM,SAAS,MAAM;AAKxD,MAAM,WAAW,CAAC,UACvB,OAAO,UAAU,YAAY,CAAC,OAAO,MAAM,KAAK;AAK3C,MAAM,YAAY,CAAC,UAAqC,OAAO,UAAU;AAGzE,MAAM,UAAU,MAAM;",
+  "sourcesContent": ["// eslint-disable-next-line no-undef\nexport const isDev = typeof __DEV__ !== 'undefined' && __DEV__;\n\n/**\n * Test is the given value is null.\n */\nexport const isNull = (value: unknown): value is null => value === null;\n\n/**\n * Test if the given value is a function.\n */\n// eslint-disable-next-line @typescript-eslint/ban-types\nexport const isFunction = (value: unknown): value is Function => typeof value === 'function';\n\n/**\n * Test if a value is defined or not.\n */\nexport const isDefined = (value: unknown): boolean => typeof value !== 'undefined';\n\n/**\n * Test if value is a string.\n */\nexport const isString = (value: unknown): value is string => typeof value === 'string';\n\n/**\n * Test if the given value is an object.\n */\nexport const isObject = (value: unknown): boolean =>\n  typeof value === 'object' && !!value && value.toString() === '[object Object]';\n\n/**\n * Test if a given value is a number.\n */\nexport const isNumber = (value: unknown): value is number =>\n  typeof value === 'number' && !Number.isNaN(value);\n\n/**\n * Test if a given value is a boolean.\n */\nexport const isBoolean = (value: unknown): value is boolean => typeof value === 'boolean';\n\n// eslint-disable-next-line prefer-destructuring\nexport const isArray = Array.isArray;\n\n/**\n * Test if a given value is an empty string.\n */\nexport const isEmptyString = (value?: unknown): boolean => isString(value) && value.length === 0;\n\n/**\n * Test if the given value is empty.\n */\nexport const isEmpty = (value?) => {\n  if (isNull(value) || !isDefined(value)) {\n    return true;\n  }\n\n  if (isString(value) || isArray(value)) {\n    return value.length === 0;\n  }\n\n  if (isObject(value)) {\n    return value.constructor === Object && Object.keys(value).length === 0;\n  }\n\n  return false;\n};\n"],
+  "mappings": "AACO,MAAM,QAAQ,OAAO,YAAY,eAAe;AAKhD,MAAM,SAAS,CAAC,UAAkC,UAAU;AAM5D,MAAM,aAAa,CAAC,UAAsC,OAAO,UAAU;AAK3E,MAAM,YAAY,CAAC,UAA4B,OAAO,UAAU;AAKhE,MAAM,WAAW,CAAC,UAAoC,OAAO,UAAU;AAKvE,MAAM,WAAW,CAAC,UACvB,OAAO,UAAU,YAAY,CAAC,CAAC,SAAS,MAAM,SAAS,MAAM;AAKxD,MAAM,WAAW,CAAC,UACvB,OAAO,UAAU,YAAY,CAAC,OAAO,MAAM,KAAK;AAK3C,MAAM,YAAY,CAAC,UAAqC,OAAO,UAAU;AAGzE,MAAM,UAAU,MAAM;AAKtB,MAAM,gBAAgB,CAAC,UAA6B,SAAS,KAAK,KAAK,MAAM,WAAW;AAKxF,MAAM,UAAU,CAAC,UAAW;AACjC,MAAI,OAAO,KAAK,KAAK,CAAC,UAAU,KAAK,GAAG;AACtC,WAAO;AAAA,EACT;AAEA,MAAI,SAAS,KAAK,KAAK,QAAQ,KAAK,GAAG;AACrC,WAAO,MAAM,WAAW;AAAA,EAC1B;AAEA,MAAI,SAAS,KAAK,GAAG;AACnB,WAAO,MAAM,gBAAgB,UAAU,OAAO,KAAK,KAAK,EAAE,WAAW;AAAA,EACvE;AAEA,SAAO;AACT;",
   "names": []
 }

package/utils/math/createRange.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Create an array from a given range and with the given incremental step.
+ */
+export declare function createRange(min: number, max: number, step: number): number[];

package/utils/math/createRange.js

@@ -0,0 +1,13 @@
+function createRange(min, max, step) {
+  const result = [];
+  let value = min;
+  while (value <= max) {
+    result.push(value);
+    value += step;
+  }
+  return result;
+}
+export {
+  createRange
+};
+//# sourceMappingURL=createRange.js.map

package/utils/math/createRange.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/js-toolkit/utils/math/createRange.ts"],
+  "sourcesContent": ["/**\n * Create an array from a given range and with the given incremental step.\n */\nexport function createRange(min: number, max: number, step: number): number[] {\n  const result: number[] = [];\n  let value = min;\n\n  while (value <= max) {\n    result.push(value);\n    value += step;\n  }\n\n  return result;\n}\n"],
+  "mappings": "AAGO,SAAS,YAAY,KAAa,KAAa,MAAwB;AAC5E,QAAM,SAAmB,CAAC;AAC1B,MAAI,QAAQ;AAEZ,SAAO,SAAS,KAAK;AACnB,WAAO,KAAK,KAAK;AACjB,aAAS;AAAA,EACX;AAEA,SAAO;AACT;",
+  "names": []
+}

package/utils/math/ease.d.ts

@@ -1,3 +1,4 @@
+export { noopValue as easeLinear } from '../noop.js';
 /**
  * @param  {number} progress Progress value betwen 0 and 1.
  * @returns {number}          Eased value between 0 and 1.

package/utils/math/ease.js

@@ -1,4 +1,5 @@
 import { createEaseOut, createEaseInOut } from "./createEases.js";
+import { noopValue } from "../noop.js";
 function easeInQuad(progress) {
   return progress ** 2;
 }
@@ -49,6 +50,7 @@ export {
   easeInQuart,
   easeInQuint,
   easeInSine,
+  noopValue as easeLinear,
   easeOutCirc,
   easeOutCubic,
   easeOutExpo,

package/utils/math/ease.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/utils/math/ease.ts"],
-  "sourcesContent": ["import { createEaseOut, createEaseInOut } from './createEases.js';\n\n/**\n * @param  {number} progress Progress value betwen 0 and 1.\n * @returns {number}          Eased value between 0 and 1.\n */\nexport function easeInQuad(progress: number) {\n  return progress ** 2;\n}\n\nexport const easeOutQuad = createEaseOut(easeInQuad);\nexport const easeInOutQuad = createEaseInOut(easeInQuad);\n\n/**\n * Ease in cubic.\n *\n * @param  {number} progress Progress value betwen 0 and 1.\n * @returns {number}          Eased value between 0 and 1.\n */\nexport function easeInCubic(progress: number) {\n  return progress ** 3;\n}\n\nexport const easeOutCubic = createEaseOut(easeInCubic);\nexport const easeInOutCubic = createEaseInOut(easeInCubic);\n\n/**\n * Ease in quart.\n *\n * @param  {number} progress Progress value betwen 0 and 1.\n * @returns {number}          Eased value between 0 and 1.\n */\nexport function easeInQuart(progress: number) {\n  return progress ** 4;\n}\n\nexport const easeOutQuart = createEaseOut(easeInQuart);\nexport const easeInOutQuart = createEaseInOut(easeInQuart);\n\n/**\n * Ease in quint.\n *\n * @param  {number} progress Progress value betwen 0 and 1.\n * @returns {number}          Eased value between 0 and 1.\n */\nexport function easeInQuint(progress: number) {\n  return progress ** 5;\n}\n\nexport const easeOutQuint = createEaseOut(easeInQuint);\nexport const easeInOutQuint = createEaseInOut(easeInQuint);\n\n/**\n * Ease in sine.\n *\n * @param  {number} progress Progress value betwen 0 and 1.\n * @returns {number}          Eased value between 0 and 1.\n */\nexport function easeInSine(progress: number) {\n  return progress === 1 ? 1 : -Math.cos((progress * Math.PI) / 2) + 1;\n}\n\nexport const easeOutSine = createEaseOut(easeInSine);\nexport const easeInOutSine = createEaseInOut(easeInSine);\n\n/**\n * Ease in circ.\n *\n * @param  {number} progress Progress value betwen 0 and 1.\n * @returns {number}          Eased value between 0 and 1.\n */\nexport function easeInCirc(progress: number) {\n  return -(Math.sqrt(1 - progress * progress) - 1);\n}\n\nexport const easeOutCirc = createEaseOut(easeInCirc);\nexport const easeInOutCirc = createEaseInOut(easeInCirc);\n\n/**\n * Ease in exponential.\n *\n * @param  {number} progress Progress value betwen 0 and 1.\n * @returns {number}          Eased value between 0 and 1.\n */\nexport function easeInExpo(progress: number) {\n  return progress === 0 ? 0 : 2 ** (10 * (progress - 1));\n}\n\nexport const easeOutExpo = createEaseOut(easeInExpo);\nexport const easeInOutExpo = createEaseInOut(easeInExpo);\n"],
-  "mappings": "AAAA,SAAS,eAAe,uBAAuB;AAMxC,SAAS,WAAW,UAAkB;AAC3C,SAAO,YAAY;AACrB;AAEO,MAAM,cAAc,cAAc,UAAU;AAC5C,MAAM,gBAAgB,gBAAgB,UAAU;AAQhD,SAAS,YAAY,UAAkB;AAC5C,SAAO,YAAY;AACrB;AAEO,MAAM,eAAe,cAAc,WAAW;AAC9C,MAAM,iBAAiB,gBAAgB,WAAW;AAQlD,SAAS,YAAY,UAAkB;AAC5C,SAAO,YAAY;AACrB;AAEO,MAAM,eAAe,cAAc,WAAW;AAC9C,MAAM,iBAAiB,gBAAgB,WAAW;AAQlD,SAAS,YAAY,UAAkB;AAC5C,SAAO,YAAY;AACrB;AAEO,MAAM,eAAe,cAAc,WAAW;AAC9C,MAAM,iBAAiB,gBAAgB,WAAW;AAQlD,SAAS,WAAW,UAAkB;AAC3C,SAAO,aAAa,IAAI,IAAI,CAAC,KAAK,IAAK,WAAW,KAAK,KAAM,CAAC,IAAI;AACpE;AAEO,MAAM,cAAc,cAAc,UAAU;AAC5C,MAAM,gBAAgB,gBAAgB,UAAU;AAQhD,SAAS,WAAW,UAAkB;AAC3C,SAAO,EAAE,KAAK,KAAK,IAAI,WAAW,QAAQ,IAAI;AAChD;AAEO,MAAM,cAAc,cAAc,UAAU;AAC5C,MAAM,gBAAgB,gBAAgB,UAAU;AAQhD,SAAS,WAAW,UAAkB;AAC3C,SAAO,aAAa,IAAI,IAAI,MAAM,MAAM,WAAW;AACrD;AAEO,MAAM,cAAc,cAAc,UAAU;AAC5C,MAAM,gBAAgB,gBAAgB,UAAU;",
+  "sourcesContent": ["import { createEaseOut, createEaseInOut } from './createEases.js';\n\nexport { noopValue as easeLinear } from '../noop.js';\n\n/**\n * @param  {number} progress Progress value betwen 0 and 1.\n * @returns {number}          Eased value between 0 and 1.\n */\nexport function easeInQuad(progress: number) {\n  return progress ** 2;\n}\n\nexport const easeOutQuad = createEaseOut(easeInQuad);\nexport const easeInOutQuad = createEaseInOut(easeInQuad);\n\n/**\n * Ease in cubic.\n *\n * @param  {number} progress Progress value betwen 0 and 1.\n * @returns {number}          Eased value between 0 and 1.\n */\nexport function easeInCubic(progress: number) {\n  return progress ** 3;\n}\n\nexport const easeOutCubic = createEaseOut(easeInCubic);\nexport const easeInOutCubic = createEaseInOut(easeInCubic);\n\n/**\n * Ease in quart.\n *\n * @param  {number} progress Progress value betwen 0 and 1.\n * @returns {number}          Eased value between 0 and 1.\n */\nexport function easeInQuart(progress: number) {\n  return progress ** 4;\n}\n\nexport const easeOutQuart = createEaseOut(easeInQuart);\nexport const easeInOutQuart = createEaseInOut(easeInQuart);\n\n/**\n * Ease in quint.\n *\n * @param  {number} progress Progress value betwen 0 and 1.\n * @returns {number}          Eased value between 0 and 1.\n */\nexport function easeInQuint(progress: number) {\n  return progress ** 5;\n}\n\nexport const easeOutQuint = createEaseOut(easeInQuint);\nexport const easeInOutQuint = createEaseInOut(easeInQuint);\n\n/**\n * Ease in sine.\n *\n * @param  {number} progress Progress value betwen 0 and 1.\n * @returns {number}          Eased value between 0 and 1.\n */\nexport function easeInSine(progress: number) {\n  return progress === 1 ? 1 : -Math.cos((progress * Math.PI) / 2) + 1;\n}\n\nexport const easeOutSine = createEaseOut(easeInSine);\nexport const easeInOutSine = createEaseInOut(easeInSine);\n\n/**\n * Ease in circ.\n *\n * @param  {number} progress Progress value betwen 0 and 1.\n * @returns {number}          Eased value between 0 and 1.\n */\nexport function easeInCirc(progress: number) {\n  return -(Math.sqrt(1 - progress * progress) - 1);\n}\n\nexport const easeOutCirc = createEaseOut(easeInCirc);\nexport const easeInOutCirc = createEaseInOut(easeInCirc);\n\n/**\n * Ease in exponential.\n *\n * @param  {number} progress Progress value betwen 0 and 1.\n * @returns {number}          Eased value between 0 and 1.\n */\nexport function easeInExpo(progress: number) {\n  return progress === 0 ? 0 : 2 ** (10 * (progress - 1));\n}\n\nexport const easeOutExpo = createEaseOut(easeInExpo);\nexport const easeInOutExpo = createEaseInOut(easeInExpo);\n"],
+  "mappings": "AAAA,SAAS,eAAe,uBAAuB;AAE/C,SAAsB,iBAAkB;AAMjC,SAAS,WAAW,UAAkB;AAC3C,SAAO,YAAY;AACrB;AAEO,MAAM,cAAc,cAAc,UAAU;AAC5C,MAAM,gBAAgB,gBAAgB,UAAU;AAQhD,SAAS,YAAY,UAAkB;AAC5C,SAAO,YAAY;AACrB;AAEO,MAAM,eAAe,cAAc,WAAW;AAC9C,MAAM,iBAAiB,gBAAgB,WAAW;AAQlD,SAAS,YAAY,UAAkB;AAC5C,SAAO,YAAY;AACrB;AAEO,MAAM,eAAe,cAAc,WAAW;AAC9C,MAAM,iBAAiB,gBAAgB,WAAW;AAQlD,SAAS,YAAY,UAAkB;AAC5C,SAAO,YAAY;AACrB;AAEO,MAAM,eAAe,cAAc,WAAW;AAC9C,MAAM,iBAAiB,gBAAgB,WAAW;AAQlD,SAAS,WAAW,UAAkB;AAC3C,SAAO,aAAa,IAAI,IAAI,CAAC,KAAK,IAAK,WAAW,KAAK,KAAM,CAAC,IAAI;AACpE;AAEO,MAAM,cAAc,cAAc,UAAU;AAC5C,MAAM,gBAAgB,gBAAgB,UAAU;AAQhD,SAAS,WAAW,UAAkB;AAC3C,SAAO,EAAE,KAAK,KAAK,IAAI,WAAW,QAAQ,IAAI;AAChD;AAEO,MAAM,cAAc,cAAc,UAAU;AAC5C,MAAM,gBAAgB,gBAAgB,UAAU;AAQhD,SAAS,WAAW,UAAkB;AAC3C,SAAO,aAAa,IAAI,IAAI,MAAM,MAAM,WAAW;AACrD;AAEO,MAAM,cAAc,cAAc,UAAU;AAC5C,MAAM,gBAAgB,gBAAgB,UAAU;",
   "names": []
 }

package/utils/math/index.d.ts

@@ -1,3 +1,7 @@
+export * as ease from './ease.js';
+export * from './createEases.js';
+export * from './ease.js';
+export { createRange } from './createRange.js';
 export { default as clamp } from './clamp.js';
 export { default as clamp01 } from './clamp01.js';
 export { default as damp } from './damp.js';
@@ -5,6 +9,4 @@ export { default as inertiaFinalValue } from './inertiaFinalValue.js';
 export { default as lerp } from './lerp.js';
 export { default as map } from './map.js';
 export { default as round } from './round.js';
-export * from './ease.js';
-export * as ease from './ease.js';
-export * from './createEases.js';
+export { mean } from './mean.js';

package/utils/math/index.js

@@ -1,3 +1,7 @@
+import * as ease from "./ease.js";
+export * from "./createEases.js";
+export * from "./ease.js";
+import { createRange } from "./createRange.js";
 import { default as default2 } from "./clamp.js";
 import { default as default3 } from "./clamp01.js";
 import { default as default4 } from "./damp.js";
@@ -5,17 +9,17 @@ import { default as default5 } from "./inertiaFinalValue.js";
 import { default as default6 } from "./lerp.js";
 import { default as default7 } from "./map.js";
 import { default as default8 } from "./round.js";
-export * from "./ease.js";
-import * as ease from "./ease.js";
-export * from "./createEases.js";
+import { mean } from "./mean.js";
 export {
   default2 as clamp,
   default3 as clamp01,
+  createRange,
   default4 as damp,
   ease,
   default5 as inertiaFinalValue,
   default6 as lerp,
   default7 as map,
+  mean,
   default8 as round
 };
 //# sourceMappingURL=index.js.map

package/utils/math/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/utils/math/index.ts"],
-  "sourcesContent": ["export { default as clamp } from './clamp.js';\nexport { default as clamp01 } from './clamp01.js';\nexport { default as damp } from './damp.js';\nexport { default as inertiaFinalValue } from './inertiaFinalValue.js';\nexport { default as lerp } from './lerp.js';\nexport { default as map } from './map.js';\nexport { default as round } from './round.js';\nexport * from './ease.js';\nexport * as ease from './ease.js';\nexport * from './createEases.js';\n"],
-  "mappings": "AAAA,SAAoB,WAAXA,gBAAwB;AACjC,SAAoB,WAAXA,gBAA0B;AACnC,SAAoB,WAAXA,gBAAuB;AAChC,SAAoB,WAAXA,gBAAoC;AAC7C,SAAoB,WAAXA,gBAAuB;AAChC,SAAoB,WAAXA,gBAAsB;AAC/B,SAAoB,WAAXA,gBAAwB;AACjC,cAAc;AACd,YAAY,UAAU;AACtB,cAAc;",
+  "sourcesContent": ["export * as ease from './ease.js';\nexport * from './createEases.js';\nexport * from './ease.js';\nexport { createRange } from './createRange.js';\nexport { default as clamp } from './clamp.js';\nexport { default as clamp01 } from './clamp01.js';\nexport { default as damp } from './damp.js';\nexport { default as inertiaFinalValue } from './inertiaFinalValue.js';\nexport { default as lerp } from './lerp.js';\nexport { default as map } from './map.js';\nexport { default as round } from './round.js';\nexport { mean } from './mean.js';\n"],
+  "mappings": "AAAA,YAAY,UAAU;AACtB,cAAc;AACd,cAAc;AACd,SAAS,mBAAmB;AAC5B,SAAoB,WAAXA,gBAAwB;AACjC,SAAoB,WAAXA,gBAA0B;AACnC,SAAoB,WAAXA,gBAAuB;AAChC,SAAoB,WAAXA,gBAAoC;AAC7C,SAAoB,WAAXA,gBAAuB;AAChC,SAAoB,WAAXA,gBAAsB;AAC/B,SAAoB,WAAXA,gBAAwB;AACjC,SAAS,YAAY;",
   "names": ["default"]
 }

package/utils/math/mean.d.ts

@@ -0,0 +1 @@
+export declare function mean(numbers: number[]): number;

package/utils/math/mean.js

@@ -0,0 +1,17 @@
+function mean(numbers) {
+  if (numbers.length === 0) {
+    return 0;
+  }
+  if (numbers.length === 1) {
+    return numbers[0];
+  }
+  let sum = 0;
+  for (const value of numbers) {
+    sum += value;
+  }
+  return sum / numbers.length;
+}
+export {
+  mean
+};
+//# sourceMappingURL=mean.js.map

package/utils/math/mean.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/js-toolkit/utils/math/mean.ts"],
+  "sourcesContent": ["export function mean(numbers: number[]) {\n  if (numbers.length === 0) {\n    return 0;\n  }\n\n  if (numbers.length === 1) {\n    return numbers[0];\n  }\n\n  let sum = 0;\n  for (const value of numbers) {\n    sum += value;\n  }\n\n  return sum / numbers.length;\n}\n"],
+  "mappings": "AAAO,SAAS,KAAK,SAAmB;AACtC,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO;AAAA,EACT;AAEA,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO,QAAQ,CAAC;AAAA,EAClB;AAEA,MAAI,MAAM;AACV,aAAW,SAAS,SAAS;AAC3B,WAAO;AAAA,EACT;AAEA,SAAO,MAAM,QAAQ;AACvB;",
+  "names": []
+}

package/utils/memo.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Memoize the result of a function with a single argument indefinitely.
+ * This is a simpler implementation of the `memoize` function.
+ */
+export declare function memo<T extends (...args: unknown[]) => unknown>(fn: T): T;

package/utils/memo.js

@@ -0,0 +1,14 @@
+function memo(fn) {
+  const cache = /* @__PURE__ */ new Map();
+  return function cached(...args) {
+    const key = args.join("");
+    if (!cache.has(key)) {
+      cache.set(key, fn(...args));
+    }
+    return cache.get(key);
+  };
+}
+export {
+  memo
+};
+//# sourceMappingURL=memo.js.map

package/utils/memo.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../packages/js-toolkit/utils/memo.ts"],
+  "sourcesContent": ["/**\n * Memoize the result of a function with a single argument indefinitely.\n * This is a simpler implementation of the `memoize` function.\n */\nexport function memo<T extends (...args: unknown[]) => unknown>(fn: T): T {\n  const cache = new Map<string, ReturnType<T>>();\n\n  // @ts-ignore\n  return function cached(...args) {\n    const key = args.join('');\n    if (!cache.has(key)) {\n      cache.set(key, fn(...args) as ReturnType<T>);\n    }\n    return cache.get(key);\n  };\n}\n"],
+  "mappings": "AAIO,SAAS,KAAgD,IAAU;AACxE,QAAM,QAAQ,oBAAI,IAA2B;AAG7C,SAAO,SAAS,UAAU,MAAM;AAC9B,UAAM,MAAM,KAAK,KAAK,EAAE;AACxB,QAAI,CAAC,MAAM,IAAI,GAAG,GAAG;AACnB,YAAM,IAAI,KAAK,GAAG,GAAG,IAAI,CAAkB;AAAA,IAC7C;AACA,WAAO,MAAM,IAAI,GAAG;AAAA,EACtB;AACF;",
+  "names": []
+}

package/utils/nextFrame.d.ts

@@ -1,25 +1,7 @@
-/**
- * RequestAnimation frame polyfill.
- *
- * @see  https://github.com/vuejs/vue/blob/ec78fc8b6d03e59da669be1adf4b4b5abf670a34/dist/vue.runtime.esm.js#L7355
- */
-export declare function getRaf(): (handler: Function) => number;
-/**
- * Get a function to cancel the method returned by `getRaf()`.
- */
-export declare function getCancelRaf(): (id: number) => void;
+type Callback = (time?: DOMHighResTimeStamp) => any;
 /**
  * Wait for the next frame to execute a function.
- *
- * @template {() => any} T
- * @param    {T} [fn] The callback function to execute.
- * @returns  {Promise<T extends Function ? ReturnType<T> : undefined>} A Promise resolving when the next frame is reached.
- * @example
- * ```js
- * nextFrame(() => console.log('hello world'));
- *
- * await nextFrame();
- * console.log('hello world');
- * ```
  */
-export declare function nextFrame<T extends () => unknown>(fn?: T): Promise<T extends () => unknown ? ReturnType<T> : void>;
+export declare function nextFrame(): Promise<DOMHighResTimeStamp>;
+export declare function nextFrame<T extends Callback>(callback?: T): Promise<ReturnType<T>>;
+export {};

package/utils/nextFrame.js

@@ -1,19 +1,12 @@
 import { isFunction } from "./is.js";
 import { hasWindow } from "./has.js";
-function getRaf() {
-  return hasWindow() && window.requestAnimationFrame ? window.requestAnimationFrame.bind(window) : setTimeout;
-}
-function getCancelRaf() {
-  return hasWindow() && window.cancelAnimationFrame ? window.cancelAnimationFrame.bind(window) : clearTimeout;
-}
-function nextFrame(fn) {
+function nextFrame(callback) {
+  const fn = hasWindow() ? window?.requestAnimationFrame ?? setTimeout : setTimeout;
   return new Promise((resolve) => {
-    getRaf()(() => resolve(isFunction(fn) && fn()));
+    fn((time) => resolve(isFunction(callback) ? callback(time) : time));
   });
 }
 export {
-  getCancelRaf,
-  getRaf,
   nextFrame
 };
 //# sourceMappingURL=nextFrame.js.map

package/utils/nextFrame.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/utils/nextFrame.ts"],
-  "sourcesContent": ["import { isFunction } from './is.js';\nimport { hasWindow } from './has.js';\n\n/**\n * RequestAnimation frame polyfill.\n *\n * @see  https://github.com/vuejs/vue/blob/ec78fc8b6d03e59da669be1adf4b4b5abf670a34/dist/vue.runtime.esm.js#L7355\n */\n// eslint-disable-next-line @typescript-eslint/ban-types\nexport function getRaf(): (handler: Function) => number {\n  return hasWindow() && window.requestAnimationFrame\n    ? window.requestAnimationFrame.bind(window)\n    : setTimeout;\n}\n\n/**\n * Get a function to cancel the method returned by `getRaf()`.\n */\nexport function getCancelRaf(): (id: number) => void {\n  return hasWindow() && window.cancelAnimationFrame\n    ? window.cancelAnimationFrame.bind(window)\n    : clearTimeout;\n}\n\n/**\n * Wait for the next frame to execute a function.\n *\n * @template {() => any} T\n * @param    {T} [fn] The callback function to execute.\n * @returns  {Promise<T extends Function ? ReturnType<T> : undefined>} A Promise resolving when the next frame is reached.\n * @example\n * ```js\n * nextFrame(() => console.log('hello world'));\n *\n * await nextFrame();\n * console.log('hello world');\n * ```\n */\nexport function nextFrame<T extends () => unknown>(\n  fn?: T,\n): Promise<T extends () => unknown ? ReturnType<T> : void> {\n  return new Promise((resolve) => {\n    // @ts-ignore\n    getRaf()(() => resolve(isFunction(fn) && fn()));\n  });\n}\n"],
-  "mappings": "AAAA,SAAS,kBAAkB;AAC3B,SAAS,iBAAiB;AAQnB,SAAS,SAAwC;AACtD,SAAO,UAAU,KAAK,OAAO,wBACzB,OAAO,sBAAsB,KAAK,MAAM,IACxC;AACN;AAKO,SAAS,eAAqC;AACnD,SAAO,UAAU,KAAK,OAAO,uBACzB,OAAO,qBAAqB,KAAK,MAAM,IACvC;AACN;AAgBO,SAAS,UACd,IACyD;AACzD,SAAO,IAAI,QAAQ,CAAC,YAAY;AAE9B,WAAO,EAAE,MAAM,QAAQ,WAAW,EAAE,KAAK,GAAG,CAAC,CAAC;AAAA,EAChD,CAAC;AACH;",
+  "sourcesContent": ["import { isFunction } from './is.js';\nimport { hasWindow } from './has.js';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype Callback = (time?: DOMHighResTimeStamp) => any;\n\n/**\n * Wait for the next frame to execute a function.\n */\nexport function nextFrame(): Promise<DOMHighResTimeStamp>;\nexport function nextFrame<T extends Callback>(callback?: T): Promise<ReturnType<T>>;\nexport function nextFrame<T extends Callback>(callback?: T): Promise<ReturnType<T>> {\n  const fn = hasWindow() ? window?.requestAnimationFrame ?? setTimeout : setTimeout;\n  return new Promise((resolve) => {\n    fn((time) => resolve(isFunction(callback) ? callback(time) : time));\n  });\n}\n"],
+  "mappings": "AAAA,SAAS,kBAAkB;AAC3B,SAAS,iBAAiB;AAUnB,SAAS,UAA8B,UAAsC;AAClF,QAAM,KAAK,UAAU,IAAI,QAAQ,yBAAyB,aAAa;AACvE,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,OAAG,CAAC,SAAS,QAAQ,WAAW,QAAQ,IAAI,SAAS,IAAI,IAAI,IAAI,CAAC;AAAA,EACpE,CAAC;AACH;",
   "names": []
 }

package/utils/nextMicrotask.d.ts

@@ -1,4 +1,7 @@
+type Callback = (...args: any[]) => any;
 /**
  * Wait for the next microtask.
  */
-export default function nextMicrotask<T extends () => unknown>(fn?: T): Promise<T extends () => unknown ? ReturnType<T> : void>;
+export declare function nextMicrotask(): Promise<void>;
+export declare function nextMicrotask<T extends Callback>(callback?: T): Promise<ReturnType<T>>;
+export {};

package/utils/nextMicrotask.js

@@ -1,8 +1,8 @@
 import { isFunction } from "./is.js";
-async function nextMicrotask(fn) {
-  return Promise.resolve().then(() => isFunction(fn) && fn());
+async function nextMicrotask(callback) {
+  return Promise.resolve().then(() => isFunction(callback) && callback());
 }
 export {
-  nextMicrotask as default
+  nextMicrotask
 };
 //# sourceMappingURL=nextMicrotask.js.map

package/utils/nextMicrotask.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/utils/nextMicrotask.ts"],
-  "sourcesContent": ["import { isFunction } from './is.js';\n\n/**\n * Wait for the next microtask.\n */\nexport default async function nextMicrotask<T extends () => unknown>(\n  fn?: T,\n): Promise<T extends () => unknown ? ReturnType<T> : void> {\n  // @ts-ignore\n  return Promise.resolve().then(() => isFunction(fn) && fn());\n}\n"],
-  "mappings": "AAAA,SAAS,kBAAkB;AAK3B,eAAO,cACL,IACyD;AAEzD,SAAO,QAAQ,QAAQ,EAAE,KAAK,MAAM,WAAW,EAAE,KAAK,GAAG,CAAC;AAC5D;",
+  "sourcesContent": ["import { isFunction } from './is.js';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype Callback = (...args: any[]) => any;\n\n/**\n * Wait for the next microtask.\n */\nexport async function nextMicrotask(): Promise<void>;\nexport async function nextMicrotask<T extends Callback>(callback?: T): Promise<ReturnType<T>>;\nexport async function nextMicrotask<T extends Callback>(callback?: T): Promise<ReturnType<T>> {\n  return Promise.resolve().then(() => isFunction(callback) && callback());\n}\n"],
+  "mappings": "AAAA,SAAS,kBAAkB;AAU3B,eAAsB,cAAkC,UAAsC;AAC5F,SAAO,QAAQ,QAAQ,EAAE,KAAK,MAAM,WAAW,QAAQ,KAAK,SAAS,CAAC;AACxE;",
   "names": []
 }

package/utils/nextTick.d.ts

@@ -1,4 +1,7 @@
+type Callback = (...args: any[]) => any;
 /**
  * Wait for the next tick.
  */
-export default function nextTick<T extends () => any>(fn?: T): Promise<T extends void ? void : ReturnType<T>>;
+export declare function nextTick(): Promise<void>;
+export declare function nextTick<T extends Callback>(callback?: T): Promise<ReturnType<T>>;
+export {};

package/utils/nextTick.js

@@ -1,9 +1,9 @@
 import { isFunction } from "./is.js";
 import { wait } from "./wait.js";
-async function nextTick(fn) {
-  return wait().then(isFunction(fn) && fn);
+async function nextTick(callback) {
+  return wait().then(isFunction(callback) && callback);
 }
 export {
-  nextTick as default
+  nextTick
 };
 //# sourceMappingURL=nextTick.js.map

package/utils/nextTick.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/utils/nextTick.ts"],
-  "sourcesContent": ["import { isFunction } from './is.js';\nimport { wait } from './wait.js';\n\n/**\n * Wait for the next tick.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport default async function nextTick<T extends () => any>(\n  fn?: T,\n): Promise<T extends void ? void : ReturnType<T>> {\n  return wait().then(isFunction(fn) && (fn as ReturnType<T>));\n}\n"],
-  "mappings": "AAAA,SAAS,kBAAkB;AAC3B,SAAS,YAAY;AAMrB,eAAO,SACL,IACgD;AAChD,SAAO,KAAK,EAAE,KAAK,WAAW,EAAE,KAAM,EAAoB;AAC5D;",
+  "sourcesContent": ["import { isFunction } from './is.js';\nimport { wait } from './wait.js';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype Callback = (...args: any[]) => any;\n\n/**\n * Wait for the next tick.\n */\nexport async function nextTick(): Promise<void>;\nexport async function nextTick<T extends Callback>(callback?: T): Promise<ReturnType<T>>;\nexport async function nextTick<T extends Callback>(callback?: T): Promise<ReturnType<T>> {\n  return wait().then(isFunction(callback) && (callback as ReturnType<T>));\n}\n"],
+  "mappings": "AAAA,SAAS,kBAAkB;AAC3B,SAAS,YAAY;AAUrB,eAAsB,SAA6B,UAAsC;AACvF,SAAO,KAAK,EAAE,KAAK,WAAW,QAAQ,KAAM,QAA0B;AACxE;",
   "names": []
 }

package/utils/random.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Get a random integer between bounds
+ *
+ * @param {number} a Lower bound
+ * @param {number} b Upper bound
+ * @returns {number}
+ */
+export declare function randomInt(a: number, b?: number): number;
+/**
+ * Get a random item of an array or a random character of a string
+ *
+ * @param {T[] | string} items Array or string
+ * @returns {T | undefined}
+ */
+export declare function randomItem<T>(items: T[] | string): T | string | undefined;

package/utils/random.js

@@ -0,0 +1,15 @@
+import { isArray, isString } from "./is.js";
+function randomInt(a, b = 0) {
+  return Math.floor(Math.random() * (a - b + 1)) + b;
+}
+function randomItem(items) {
+  if (!isArray(items) && !isString(items)) {
+    throw new Error("randomItem() expects an array or a string as argument.");
+  }
+  return items.length > 0 ? items[randomInt(items.length - 1)] : void 0;
+}
+export {
+  randomInt,
+  randomItem
+};
+//# sourceMappingURL=random.js.map

package/utils/random.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../packages/js-toolkit/utils/random.ts"],
+  "sourcesContent": ["import { isArray, isString } from './is.js';\n\n/**\n * Get a random integer between bounds\n *\n * @param {number} a Lower bound\n * @param {number} b Upper bound\n * @returns {number}\n */\nexport function randomInt(a: number, b = 0): number {\n  return Math.floor(Math.random() * (a - b + 1)) + b;\n}\n\n/**\n * Get a random item of an array or a random character of a string\n *\n * @param {T[] | string} items Array or string\n * @returns {T | undefined}\n */\nexport function randomItem<T>(items: T[] | string): T | string | undefined {\n  if (!isArray(items) && !isString(items)) {\n    throw new Error('randomItem() expects an array or a string as argument.');\n  }\n  return items.length > 0 ? items[randomInt(items.length - 1)] : undefined;\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS,gBAAgB;AAS3B,SAAS,UAAU,GAAW,IAAI,GAAW;AAClD,SAAO,KAAK,MAAM,KAAK,OAAO,KAAK,IAAI,IAAI,EAAE,IAAI;AACnD;AAQO,SAAS,WAAc,OAA6C;AACzE,MAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,SAAS,KAAK,GAAG;AACvC,UAAM,IAAI,MAAM,wDAAwD;AAAA,EAC1E;AACA,SAAO,MAAM,SAAS,IAAI,MAAM,UAAU,MAAM,SAAS,CAAC,CAAC,IAAI;AACjE;",
+  "names": []
+}

package/utils/scrollTo.d.ts

@@ -1,9 +1,33 @@
+import type { TweenOptions } from './tween.js';
+export interface ScrollPosition {
+    left: number;
+    top: number;
+}
+export type ScrollTarget = string | HTMLElement | number | Partial<ScrollPosition>;
+export interface ScrollToOptions extends TweenOptions {
+    /**
+     * Root element that will be scrolled.
+     */
+    rootElement?: HTMLElement | typeof window;
+    /**
+     * Scroll direction.
+     */
+    axis?: (typeof scrollTo.axis)[keyof typeof scrollTo.axis];
+    /**
+     * Distance from the target.
+     */
+    offset?: number;
+}
 /**
- * Handler for the click event on anchor links
+ * Scroll to an element.
  *
- * @returns {Promise<number>} A promising resolving with the target scroll position.
+ * @returns {Promise<ScrollPosition>} A promising resolving with the scroll position.
  */
-export default function scrollTo(selectorElement: HTMLElement | string, { offset, dampFactor }?: {
-    offset?: number;
-    dampFactor?: number;
-}): Promise<number>;
+export declare function scrollTo(target: string | HTMLElement | number | Partial<ScrollPosition>, { rootElement, axis, offset, ...tweenOptions }?: ScrollToOptions): Promise<ScrollPosition>;
+export declare namespace scrollTo {
+    var axis: {
+        x: symbol;
+        y: symbol;
+        both: symbol;
+    };
+}