@studiometa/js-toolkit 3.5.0 → 3.6.0-beta.1

package/utils/css/classes.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/utils/css/classes.ts"],
-  "sourcesContent": ["import { isArray } from '../is.js';\n// eslint-disable-next-line import/extensions\nimport { eachElements } from './utils.js';\n\n/**\n * Manage a list of classes as string on an element.\n */\nfunction setClasses(\n  element: Element | Element[] | NodeListOf<Element>,\n  classNames: string | string[],\n  method: 'add' | 'remove' | 'toggle',\n  forceToggle?: boolean,\n) {\n  if (!element || !classNames) {\n    return;\n  }\n\n  const normalizedClassNames = isArray(classNames)\n    ? classNames\n    : classNames.split(' ').filter((className) => className);\n\n  if (method !== 'toggle') {\n    eachElements(element, (el) => el.classList[method](...normalizedClassNames));\n  } else {\n    for (const className of normalizedClassNames)\n      eachElements(element, (el) => el.classList[method](className, forceToggle));\n  }\n}\n\n/**\n * Add class names to an element.\n * @link https://js-toolkit.studiometa.dev/utils/css/addClass.html\n*/\nexport function add(\n  element: Element | Element[] | NodeListOf<Element>,\n  classNames: string | string[],\n) {\n  setClasses(element, classNames, 'add');\n}\n\n/**\n * Remove class names from an element.\n * @link https://js-toolkit.studiometa.dev/utils/css/removeClass.html\n*/\nexport function remove(\n  element: Element | Element[] | NodeListOf<Element>,\n  classNames: string | string[],\n) {\n  setClasses(element, classNames, 'remove');\n}\n\n/**\n * Toggle class names from an element.\n * @link https://js-toolkit.studiometa.dev/utils/css/toggleClass.html\n*/\nexport function toggle(\n  element: Element | Element[] | NodeListOf<Element>,\n  classNames: string | string[],\n  force?: boolean,\n) {\n  setClasses(element, classNames, 'toggle', force);\n}\n"],
+  "sourcesContent": ["import { isArray } from '../is.js';\n// eslint-disable-next-line import/extensions\nimport { eachElements } from './utils.js';\n\n/**\n * Manage a list of classes as string on an element.\n */\nfunction setClasses(\n  element: Element | Element[] | NodeListOf<Element>,\n  classNames: string | string[],\n  method: 'add' | 'remove' | 'toggle',\n  forceToggle?: boolean,\n) {\n  if (!element || !classNames) {\n    return;\n  }\n\n  const normalizedClassNames = isArray(classNames)\n    ? classNames\n    : classNames.split(' ').filter((className) => className);\n\n  if (method !== 'toggle') {\n    eachElements(element, (el) => el.classList[method](...normalizedClassNames));\n  } else {\n    for (const className of normalizedClassNames)\n      eachElements(element, (el) => el.classList[method](className, forceToggle));\n  }\n}\n\n/**\n * Add class names to an element.\n * @link https://js-toolkit.studiometa.dev/utils/css/addClass.html\n */\nexport function add(\n  element: Element | Element[] | NodeListOf<Element>,\n  classNames: string | string[],\n) {\n  setClasses(element, classNames, 'add');\n}\n\n/**\n * Remove class names from an element.\n * @link https://js-toolkit.studiometa.dev/utils/css/removeClass.html\n */\nexport function remove(\n  element: Element | Element[] | NodeListOf<Element>,\n  classNames: string | string[],\n) {\n  setClasses(element, classNames, 'remove');\n}\n\n/**\n * Toggle class names from an element.\n * @link https://js-toolkit.studiometa.dev/utils/css/toggleClass.html\n */\nexport function toggle(\n  element: Element | Element[] | NodeListOf<Element>,\n  classNames: string | string[],\n  force?: boolean,\n) {\n  setClasses(element, classNames, 'toggle', force);\n}\n"],
   "mappings": "AAAA,SAAS,eAAe;AAExB,SAAS,oBAAoB;AAK7B,SAAS,WACP,SACA,YACA,QACA,aACA;AACA,MAAI,CAAC,WAAW,CAAC,YAAY;AAC3B;AAAA,EACF;AAEA,QAAM,uBAAuB,QAAQ,UAAU,IAC3C,aACA,WAAW,MAAM,GAAG,EAAE,OAAO,CAAC,cAAc,SAAS;AAEzD,MAAI,WAAW,UAAU;AACvB,iBAAa,SAAS,CAAC,OAAO,GAAG,UAAU,MAAM,EAAE,GAAG,oBAAoB,CAAC;AAAA,EAC7E,OAAO;AACL,eAAW,aAAa;AACtB,mBAAa,SAAS,CAAC,OAAO,GAAG,UAAU,MAAM,EAAE,WAAW,WAAW,CAAC;AAAA,EAC9E;AACF;AAMO,SAAS,IACd,SACA,YACA;AACA,aAAW,SAAS,YAAY,KAAK;AACvC;AAMO,SAAS,OACd,SACA,YACA;AACA,aAAW,SAAS,YAAY,QAAQ;AAC1C;AAMO,SAAS,OACd,SACA,YACA,OACA;AACA,aAAW,SAAS,YAAY,UAAU,KAAK;AACjD;",
   "names": []
 }

package/utils/css/getOffsetSizes.d.ts

@@ -1,7 +1,7 @@
 /**
  * Get a `DOMRect` like `Object` for an element, without its transforms.
  * @link https://js-toolkit.studiometa.dev/utils/css/getOffsetSizes.html
-*/
+ */
 export declare function getOffsetSizes(element: HTMLElement): {
     x: number;
     y: number;

package/utils/css/getOffsetSizes.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/utils/css/getOffsetSizes.ts"],
-  "sourcesContent": ["/**\n * Get a `DOMRect` like `Object` for an element, without its transforms.\n * @link https://js-toolkit.studiometa.dev/utils/css/getOffsetSizes.html\n*/\nexport function getOffsetSizes(element: HTMLElement) {\n  let parent = element;\n  let x = -window.scrollX;\n  let y = -window.scrollY;\n\n  while (parent) {\n    x += parent.offsetLeft;\n    y += parent.offsetTop;\n    // @ts-ignore\n    parent = parent.offsetParent;\n  }\n\n  const width = element.offsetWidth;\n  const height = element.offsetHeight;\n\n  return {\n    x,\n    y,\n    width,\n    height,\n    top: y,\n    right: width + x,\n    bottom: height + y,\n    left: x,\n  };\n}\n"],
+  "sourcesContent": ["/**\n * Get a `DOMRect` like `Object` for an element, without its transforms.\n * @link https://js-toolkit.studiometa.dev/utils/css/getOffsetSizes.html\n */\nexport function getOffsetSizes(element: HTMLElement) {\n  let parent = element;\n  let x = -window.scrollX;\n  let y = -window.scrollY;\n\n  while (parent) {\n    x += parent.offsetLeft;\n    y += parent.offsetTop;\n    // @ts-ignore\n    parent = parent.offsetParent;\n  }\n\n  const width = element.offsetWidth;\n  const height = element.offsetHeight;\n\n  return {\n    x,\n    y,\n    width,\n    height,\n    top: y,\n    right: width + x,\n    bottom: height + y,\n    left: x,\n  };\n}\n"],
   "mappings": "AAIO,SAAS,eAAe,SAAsB;AACnD,MAAI,SAAS;AACb,MAAI,IAAI,CAAC,OAAO;AAChB,MAAI,IAAI,CAAC,OAAO;AAEhB,SAAO,QAAQ;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AAEZ,aAAS,OAAO;AAAA,EAClB;AAEA,QAAM,QAAQ,QAAQ;AACtB,QAAM,SAAS,QAAQ;AAEvB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,KAAK;AAAA,IACL,OAAO,QAAQ;AAAA,IACf,QAAQ,SAAS;AAAA,IACjB,MAAM;AAAA,EACR;AACF;",
   "names": []
 }

package/utils/css/matrix.d.ts

@@ -23,6 +23,6 @@ type MatrixTransform = {
  * // matrix(0.5, 0, 0, 0.5, 0, 0)
  * ```
  * @link https://js-toolkit.studiometa.dev/utils/css/matrix.html
-*/
+ */
 export declare function matrix(transform?: MatrixTransform): string;
 export {};

package/utils/css/matrix.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/utils/css/matrix.ts"],
-  "sourcesContent": ["type MatrixTransform = {\n  scaleX?: number;\n  scaleY?: number;\n  skewX?: number;\n  skewY?: number;\n  translateX?: number;\n  translateY?: number;\n};\n\n/**\n * Format a CSS transform matrix with the given values.\n *\n * @param  {Object} transform\n * @param  {number} [transform.scaleX=1]     The scale on the x axis.\n * @param  {number} [transform.scaleY=1]     The scale on the y axis.\n * @param  {number} [transform.skewX=0]      The skew on the x axis.\n * @param  {number} [transform.skewY=0]      The skew on the y axis.\n * @param  {number} [transform.translateX=0] The translate on the x axis.\n * @param  {number} [transform.translateY=0] The translate on the y axis.\n * @return {string}                           A formatted CSS matrix transform.\n * @example\n * ```js\n * matrix({ scaleX: 0.5, scaleY: 0.5 });\n * // matrix(0.5, 0, 0, 0.5, 0, 0)\n * ```\n * @link https://js-toolkit.studiometa.dev/utils/css/matrix.html\n*/\nexport function matrix(transform?: MatrixTransform): string {\n  // eslint-disable-next-line no-param-reassign\n  transform = transform || {};\n  return `matrix(${transform.scaleX ?? 1}, ${transform.skewY ?? 0}, ${transform.skewX ?? 0}, ${\n    transform.scaleY ?? 1\n  }, ${transform.translateX ?? 0}, ${transform.translateY ?? 0})`;\n}\n"],
+  "sourcesContent": ["type MatrixTransform = {\n  scaleX?: number;\n  scaleY?: number;\n  skewX?: number;\n  skewY?: number;\n  translateX?: number;\n  translateY?: number;\n};\n\n/**\n * Format a CSS transform matrix with the given values.\n *\n * @param  {Object} transform\n * @param  {number} [transform.scaleX=1]     The scale on the x axis.\n * @param  {number} [transform.scaleY=1]     The scale on the y axis.\n * @param  {number} [transform.skewX=0]      The skew on the x axis.\n * @param  {number} [transform.skewY=0]      The skew on the y axis.\n * @param  {number} [transform.translateX=0] The translate on the x axis.\n * @param  {number} [transform.translateY=0] The translate on the y axis.\n * @return {string}                           A formatted CSS matrix transform.\n * @example\n * ```js\n * matrix({ scaleX: 0.5, scaleY: 0.5 });\n * // matrix(0.5, 0, 0, 0.5, 0, 0)\n * ```\n * @link https://js-toolkit.studiometa.dev/utils/css/matrix.html\n */\nexport function matrix(transform?: MatrixTransform): string {\n  // eslint-disable-next-line no-param-reassign\n  transform = transform || {};\n  return `matrix(${transform.scaleX ?? 1}, ${transform.skewY ?? 0}, ${transform.skewX ?? 0}, ${\n    transform.scaleY ?? 1\n  }, ${transform.translateX ?? 0}, ${transform.translateY ?? 0})`;\n}\n"],
   "mappings": "AA2BO,SAAS,OAAO,WAAqC;AAE1D,cAAY,aAAa,CAAC;AAC1B,SAAO,UAAU,UAAU,UAAU,CAAC,KAAK,UAAU,SAAS,CAAC,KAAK,UAAU,SAAS,CAAC,KACtF,UAAU,UAAU,CACtB,KAAK,UAAU,cAAc,CAAC,KAAK,UAAU,cAAc,CAAC;AAC9D;",
   "names": []
 }

package/utils/css/styles.d.ts

@@ -1,10 +1,10 @@
 /**
  * Add styles to an element.
  * @link https://js-toolkit.studiometa.dev/utils/css/addStyle.html
-*/
+ */
 export declare function add(elementOrElements: HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>, styles: Partial<CSSStyleDeclaration>): void;
 /**
  * Remove class names from an element.
  * @link https://js-toolkit.studiometa.dev/utils/css/removeStyle.html
-*/
+ */
 export declare function remove(elementOrElements: HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>, styles: Partial<CSSStyleDeclaration>): void;

package/utils/css/styles.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/utils/css/styles.ts"],
-  "sourcesContent": ["import { isObject } from '../is.js';\n// eslint-disable-next-line import/extensions\nimport { eachElements } from './utils.js';\n\n/**\n * Manage a list of style properties on an element.\n */\nfunction setStyles(\n  elementOrElements: HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>,\n  styles: Partial<CSSStyleDeclaration>,\n  method: 'add' | 'remove' = 'add',\n) {\n  if (!elementOrElements || !styles || !isObject(styles)) {\n    return;\n  }\n\n  eachElements(elementOrElements, (el) => {\n    for (const [prop, value] of Object.entries(styles)) {\n      el.style[prop] = method === 'add' ? value : '';\n    }\n  });\n}\n\n/**\n * Add styles to an element.\n * @link https://js-toolkit.studiometa.dev/utils/css/addStyle.html\n*/\nexport function add(\n  elementOrElements: HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>,\n  styles: Partial<CSSStyleDeclaration>,\n) {\n  setStyles(elementOrElements, styles);\n}\n\n/**\n * Remove class names from an element.\n * @link https://js-toolkit.studiometa.dev/utils/css/removeStyle.html\n*/\nexport function remove(\n  elementOrElements: HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>,\n  styles: Partial<CSSStyleDeclaration>,\n) {\n  setStyles(elementOrElements, styles, 'remove');\n}\n"],
+  "sourcesContent": ["import { isObject } from '../is.js';\n// eslint-disable-next-line import/extensions\nimport { eachElements } from './utils.js';\n\n/**\n * Manage a list of style properties on an element.\n */\nfunction setStyles(\n  elementOrElements: HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>,\n  styles: Partial<CSSStyleDeclaration>,\n  method: 'add' | 'remove' = 'add',\n) {\n  if (!elementOrElements || !styles || !isObject(styles)) {\n    return;\n  }\n\n  eachElements(elementOrElements, (el) => {\n    for (const [prop, value] of Object.entries(styles)) {\n      el.style[prop] = method === 'add' ? value : '';\n    }\n  });\n}\n\n/**\n * Add styles to an element.\n * @link https://js-toolkit.studiometa.dev/utils/css/addStyle.html\n */\nexport function add(\n  elementOrElements: HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>,\n  styles: Partial<CSSStyleDeclaration>,\n) {\n  setStyles(elementOrElements, styles);\n}\n\n/**\n * Remove class names from an element.\n * @link https://js-toolkit.studiometa.dev/utils/css/removeStyle.html\n */\nexport function remove(\n  elementOrElements: HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>,\n  styles: Partial<CSSStyleDeclaration>,\n) {\n  setStyles(elementOrElements, styles, 'remove');\n}\n"],
   "mappings": "AAAA,SAAS,gBAAgB;AAEzB,SAAS,oBAAoB;AAK7B,SAAS,UACP,mBACA,QACA,SAA2B,OAC3B;AACA,MAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,SAAS,MAAM,GAAG;AACtD;AAAA,EACF;AAEA,eAAa,mBAAmB,CAAC,OAAO;AACtC,eAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AAClD,SAAG,MAAM,IAAI,IAAI,WAAW,QAAQ,QAAQ;AAAA,IAC9C;AAAA,EACF,CAAC;AACH;AAMO,SAAS,IACd,mBACA,QACA;AACA,YAAU,mBAAmB,MAAM;AACrC;AAMO,SAAS,OACd,mBACA,QACA;AACA,YAAU,mBAAmB,QAAQ,QAAQ;AAC/C;",
   "names": []
 }

package/utils/css/transform.d.ts

@@ -18,5 +18,5 @@ export declare const TRANSFORM_PROPS: string[];
 /**
  * Generate a CSS transform.
  * @link https://js-toolkit.studiometa.dev/utils/css/transform.html
-*/
+ */
 export declare function transform(elementOrElements: HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>, props: TransformProps): string;

package/utils/css/transform.js

@@ -1,4 +1,3 @@
-import { isDefined } from "../is.js";
 import { eachElements } from "./utils.js";
 const TRANSFORM_PROPS = [
   "x",
@@ -19,42 +18,42 @@ const TRANSFORM_PROPS = [
 function transform(elementOrElements, props) {
   if (!elementOrElements) return;
   let value = "";
-  if (isDefined(props.x) || isDefined(props.y) || isDefined(props.z)) {
+  if (props.x !== void 0 || props.y !== void 0 || props.z !== void 0) {
     value += `translate3d(${props.x ?? 0}px, ${props.y ?? 0}px, ${props.z ?? 0}px) `;
   }
-  if (isDefined(props.rotate)) {
+  if (props.rotate !== void 0) {
     value += `rotate(${props.rotate}deg) `;
   } else {
-    if (isDefined(props.rotateX)) {
+    if (props.rotateX !== void 0) {
       value += `rotateX(${props.rotateX}deg) `;
     }
-    if (isDefined(props.rotateY)) {
+    if (props.rotateY !== void 0) {
       value += `rotateY(${props.rotateY}deg) `;
     }
-    if (isDefined(props.rotateZ)) {
+    if (props.rotateZ !== void 0) {
       value += `rotateZ(${props.rotateZ}deg) `;
     }
   }
-  if (isDefined(props.scale)) {
+  if (props.scale !== void 0) {
     value += `scale(${props.scale}) `;
   } else {
-    if (isDefined(props.scaleX)) {
+    if (props.scaleX !== void 0) {
       value += `scaleX(${props.scaleX}) `;
     }
-    if (isDefined(props.scaleY)) {
+    if (props.scaleY !== void 0) {
       value += `scaleY(${props.scaleY}) `;
     }
-    if (isDefined(props.scaleZ)) {
+    if (props.scaleZ !== void 0) {
       value += `scaleZ(${props.scaleZ}) `;
     }
   }
-  if (isDefined(props.skew)) {
+  if (props.skew !== void 0) {
     value += `skew(${props.skew}deg) `;
   } else {
-    if (isDefined(props.skewX)) {
+    if (props.skewX !== void 0) {
       value += `skewX(${props.skewX}deg) `;
     }
-    if (isDefined(props.skewY)) {
+    if (props.skewY !== void 0) {
       value += `skewY(${props.skewY}deg) `;
     }
   }

package/utils/css/transform.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/utils/css/transform.ts"],
-  "sourcesContent": ["import { isDefined } from '../is.js';\n// eslint-disable-next-line import/extensions\nimport { eachElements } from './utils.js';\n\nexport type TransformProps = Partial<{\n  x: number;\n  y: number;\n  z: number;\n  rotate: number;\n  rotateX: number;\n  rotateY: number;\n  rotateZ: number;\n  scale: number;\n  scaleX: number;\n  scaleY: number;\n  scaleZ: number;\n  skew: number;\n  skewX: number;\n  skewY: number;\n}>;\n\nexport const TRANSFORM_PROPS = [\n  'x',\n  'y',\n  'z',\n  'rotate',\n  'rotateX',\n  'rotateY',\n  'rotateZ',\n  'scale',\n  'scaleX',\n  'scaleY',\n  'scaleZ',\n  'skew',\n  'skewX',\n  'skewY',\n];\n\n/**\n * Generate a CSS transform.\n * @link https://js-toolkit.studiometa.dev/utils/css/transform.html\n*/\nexport function transform(\n  elementOrElements: HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>,\n  props: TransformProps,\n): string {\n  if (!elementOrElements) return\n\n  let value = '';\n\n  if (isDefined(props.x) || isDefined(props.y) || isDefined(props.z)) {\n    value += `translate3d(${props.x ?? 0}px, ${props.y ?? 0}px, ${props.z ?? 0}px) `;\n  }\n\n  if (isDefined(props.rotate)) {\n    value += `rotate(${props.rotate}deg) `;\n  } else {\n    if (isDefined(props.rotateX)) {\n      value += `rotateX(${props.rotateX}deg) `;\n    }\n\n    if (isDefined(props.rotateY)) {\n      value += `rotateY(${props.rotateY}deg) `;\n    }\n\n    if (isDefined(props.rotateZ)) {\n      value += `rotateZ(${props.rotateZ}deg) `;\n    }\n  }\n\n  if (isDefined(props.scale)) {\n    value += `scale(${props.scale}) `;\n  } else {\n    if (isDefined(props.scaleX)) {\n      value += `scaleX(${props.scaleX}) `;\n    }\n\n    if (isDefined(props.scaleY)) {\n      value += `scaleY(${props.scaleY}) `;\n    }\n\n    if (isDefined(props.scaleZ)) {\n      value += `scaleZ(${props.scaleZ}) `;\n    }\n  }\n\n  if (isDefined(props.skew)) {\n    value += `skew(${props.skew}deg) `;\n  } else {\n    if (isDefined(props.skewX)) {\n      value += `skewX(${props.skewX}deg) `;\n    }\n\n    if (isDefined(props.skewY)) {\n      value += `skewY(${props.skewY}deg) `;\n    }\n  }\n\n  eachElements(elementOrElements, (element) => {\n    element.style.transform = value;\n  });\n  return value;\n}\n"],
-  "mappings": "AAAA,SAAS,iBAAiB;AAE1B,SAAS,oBAAoB;AAmBtB,MAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAMO,SAAS,UACd,mBACA,OACQ;AACR,MAAI,CAAC,kBAAmB;AAExB,MAAI,QAAQ;AAEZ,MAAI,UAAU,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,GAAG;AAClE,aAAS,eAAe,MAAM,KAAK,CAAC,OAAO,MAAM,KAAK,CAAC,OAAO,MAAM,KAAK,CAAC;AAAA,EAC5E;AAEA,MAAI,UAAU,MAAM,MAAM,GAAG;AAC3B,aAAS,UAAU,MAAM,MAAM;AAAA,EACjC,OAAO;AACL,QAAI,UAAU,MAAM,OAAO,GAAG;AAC5B,eAAS,WAAW,MAAM,OAAO;AAAA,IACnC;AAEA,QAAI,UAAU,MAAM,OAAO,GAAG;AAC5B,eAAS,WAAW,MAAM,OAAO;AAAA,IACnC;AAEA,QAAI,UAAU,MAAM,OAAO,GAAG;AAC5B,eAAS,WAAW,MAAM,OAAO;AAAA,IACnC;AAAA,EACF;AAEA,MAAI,UAAU,MAAM,KAAK,GAAG;AAC1B,aAAS,SAAS,MAAM,KAAK;AAAA,EAC/B,OAAO;AACL,QAAI,UAAU,MAAM,MAAM,GAAG;AAC3B,eAAS,UAAU,MAAM,MAAM;AAAA,IACjC;AAEA,QAAI,UAAU,MAAM,MAAM,GAAG;AAC3B,eAAS,UAAU,MAAM,MAAM;AAAA,IACjC;AAEA,QAAI,UAAU,MAAM,MAAM,GAAG;AAC3B,eAAS,UAAU,MAAM,MAAM;AAAA,IACjC;AAAA,EACF;AAEA,MAAI,UAAU,MAAM,IAAI,GAAG;AACzB,aAAS,QAAQ,MAAM,IAAI;AAAA,EAC7B,OAAO;AACL,QAAI,UAAU,MAAM,KAAK,GAAG;AAC1B,eAAS,SAAS,MAAM,KAAK;AAAA,IAC/B;AAEA,QAAI,UAAU,MAAM,KAAK,GAAG;AAC1B,eAAS,SAAS,MAAM,KAAK;AAAA,IAC/B;AAAA,EACF;AAEA,eAAa,mBAAmB,CAAC,YAAY;AAC3C,YAAQ,MAAM,YAAY;AAAA,EAC5B,CAAC;AACD,SAAO;AACT;",
+  "sourcesContent": ["// eslint-disable-next-line import/extensions\nimport { eachElements } from './utils.js';\n\nexport type TransformProps = Partial<{\n  x: number;\n  y: number;\n  z: number;\n  rotate: number;\n  rotateX: number;\n  rotateY: number;\n  rotateZ: number;\n  scale: number;\n  scaleX: number;\n  scaleY: number;\n  scaleZ: number;\n  skew: number;\n  skewX: number;\n  skewY: number;\n}>;\n\nexport const TRANSFORM_PROPS = [\n  'x',\n  'y',\n  'z',\n  'rotate',\n  'rotateX',\n  'rotateY',\n  'rotateZ',\n  'scale',\n  'scaleX',\n  'scaleY',\n  'scaleZ',\n  'skew',\n  'skewX',\n  'skewY',\n];\n\n/**\n * Generate a CSS transform.\n * @link https://js-toolkit.studiometa.dev/utils/css/transform.html\n */\nexport function transform(\n  elementOrElements: HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>,\n  props: TransformProps,\n): string {\n  if (!elementOrElements) return;\n\n  let value = '';\n\n  if (props.x !== undefined || props.y !== undefined || props.z !== undefined) {\n    value += `translate3d(${props.x ?? 0}px, ${props.y ?? 0}px, ${props.z ?? 0}px) `;\n  }\n\n  if (props.rotate !== undefined) {\n    value += `rotate(${props.rotate}deg) `;\n  } else {\n    if (props.rotateX !== undefined) {\n      value += `rotateX(${props.rotateX}deg) `;\n    }\n\n    if (props.rotateY !== undefined) {\n      value += `rotateY(${props.rotateY}deg) `;\n    }\n\n    if (props.rotateZ !== undefined) {\n      value += `rotateZ(${props.rotateZ}deg) `;\n    }\n  }\n\n  if (props.scale !== undefined) {\n    value += `scale(${props.scale}) `;\n  } else {\n    if (props.scaleX !== undefined) {\n      value += `scaleX(${props.scaleX}) `;\n    }\n\n    if (props.scaleY !== undefined) {\n      value += `scaleY(${props.scaleY}) `;\n    }\n\n    if (props.scaleZ !== undefined) {\n      value += `scaleZ(${props.scaleZ}) `;\n    }\n  }\n\n  if (props.skew !== undefined) {\n    value += `skew(${props.skew}deg) `;\n  } else {\n    if (props.skewX !== undefined) {\n      value += `skewX(${props.skewX}deg) `;\n    }\n\n    if (props.skewY !== undefined) {\n      value += `skewY(${props.skewY}deg) `;\n    }\n  }\n\n  eachElements(elementOrElements, (element) => {\n    element.style.transform = value;\n  });\n  return value;\n}\n"],
+  "mappings": "AACA,SAAS,oBAAoB;AAmBtB,MAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAMO,SAAS,UACd,mBACA,OACQ;AACR,MAAI,CAAC,kBAAmB;AAExB,MAAI,QAAQ;AAEZ,MAAI,MAAM,MAAM,UAAa,MAAM,MAAM,UAAa,MAAM,MAAM,QAAW;AAC3E,aAAS,eAAe,MAAM,KAAK,CAAC,OAAO,MAAM,KAAK,CAAC,OAAO,MAAM,KAAK,CAAC;AAAA,EAC5E;AAEA,MAAI,MAAM,WAAW,QAAW;AAC9B,aAAS,UAAU,MAAM,MAAM;AAAA,EACjC,OAAO;AACL,QAAI,MAAM,YAAY,QAAW;AAC/B,eAAS,WAAW,MAAM,OAAO;AAAA,IACnC;AAEA,QAAI,MAAM,YAAY,QAAW;AAC/B,eAAS,WAAW,MAAM,OAAO;AAAA,IACnC;AAEA,QAAI,MAAM,YAAY,QAAW;AAC/B,eAAS,WAAW,MAAM,OAAO;AAAA,IACnC;AAAA,EACF;AAEA,MAAI,MAAM,UAAU,QAAW;AAC7B,aAAS,SAAS,MAAM,KAAK;AAAA,EAC/B,OAAO;AACL,QAAI,MAAM,WAAW,QAAW;AAC9B,eAAS,UAAU,MAAM,MAAM;AAAA,IACjC;AAEA,QAAI,MAAM,WAAW,QAAW;AAC9B,eAAS,UAAU,MAAM,MAAM;AAAA,IACjC;AAEA,QAAI,MAAM,WAAW,QAAW;AAC9B,eAAS,UAAU,MAAM,MAAM;AAAA,IACjC;AAAA,EACF;AAEA,MAAI,MAAM,SAAS,QAAW;AAC5B,aAAS,QAAQ,MAAM,IAAI;AAAA,EAC7B,OAAO;AACL,QAAI,MAAM,UAAU,QAAW;AAC7B,eAAS,SAAS,MAAM,KAAK;AAAA,IAC/B;AAEA,QAAI,MAAM,UAAU,QAAW;AAC7B,eAAS,SAAS,MAAM,KAAK;AAAA,IAC/B;AAAA,EACF;AAEA,eAAa,mBAAmB,CAAC,YAAY;AAC3C,YAAQ,MAAM,YAAY;AAAA,EAC5B,CAAC;AACD,SAAO;AACT;",
   "names": []
 }

package/utils/css/transition.d.ts

@@ -16,5 +16,5 @@ export declare function setClassesOrStyles(element: HTMLElement, classesOrStyles
  * @param  {string}                                            endMode           Whether to remove or keep the `to` classes/styles
  * @return {Promise<void>}                                                      A promise resolving at the end of the transition.
  * @link https://js-toolkit.studiometa.dev/utils/css/transition.html
-*/
+ */
 export declare function transition(elementOrElements: HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>, name: string | TransitionStyles, endMode?: 'keep' | 'remove'): Promise<void>;

package/utils/css/transition.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/utils/css/transition.ts"],
-  "sourcesContent": ["import { nextFrame } from '../nextFrame.js';\nimport * as classes from './classes.js';\nimport * as styles from './styles.js';\nimport { isArray, isString } from '../is.js';\nimport { hasWindow } from '../has.js';\n// eslint-disable-next-line import/extensions\nimport { eachElements } from './utils.js';\n\n/** WeakMap to hold the transition instances. */\nconst cache = new WeakMap();\n\nexport type ClassesOrStyles = string | string[] | Partial<CSSStyleDeclaration>;\n\nexport type TransitionStyles = {\n  from?: ClassesOrStyles;\n  active?: ClassesOrStyles;\n  to?: ClassesOrStyles;\n};\n\n/**\n * Transition class.\n */\nclass Transition {\n  /**\n   * Is a transition currently running?\n   */\n  isTransitioning = false;\n\n  /**\n   * A callback to execute when the transition ends.\n   */\n  transitionEndHandler: EventListenerOrEventListenerObject | null = null;\n\n  /**\n   * Instantiate and save the instance to the cache.\n   */\n  constructor(element: HTMLElement) {\n    cache.set(element, this);\n  }\n\n  /**\n   * Get the transition class attached to the given element.\n   *\n   * @param  {HTMLElement} element The HTML element concerned by the transition.\n   * @return {Transition}          The transition instance tied to the given element.\n   */\n  static getInstance(element: HTMLElement): Transition {\n    let instance = cache.get(element);\n\n    if (!instance) {\n      instance = new this(element);\n    }\n\n    return instance;\n  }\n}\n\n/**\n * Update either the classes or the styles of an element with the given method.\n */\nexport function setClassesOrStyles(\n  element: HTMLElement,\n  classesOrStyles: ClassesOrStyles,\n  method: 'add' | 'remove' = 'add',\n) {\n  if (isString(classesOrStyles) || isArray(classesOrStyles)) {\n    classes[method](element, classesOrStyles);\n  } else {\n    styles[method](element, classesOrStyles);\n  }\n}\n\n/**\n * Test if the given element has a transition duration.\n */\nfunction testTransition(element: HTMLElement) {\n  if (!hasWindow()) {\n    return false;\n  }\n\n  const { transitionDuration } = window.getComputedStyle(element);\n  return !!transitionDuration && transitionDuration !== '0s';\n}\n\n/**\n * Apply the from state.\n */\nasync function start(element: HTMLElement, classesOrStyles: TransitionStyles) {\n  const trs = Transition.getInstance(element);\n  trs.isTransitioning = true;\n  setClassesOrStyles(element, classesOrStyles.from);\n  await nextFrame();\n  setClassesOrStyles(element, classesOrStyles.active);\n}\n\n/**\n * Apply the active state.\n */\nasync function next(element: HTMLElement, classesOrStyles: TransitionStyles): Promise<void> {\n  const hasTransition = testTransition(element);\n\n  /* eslint-disable-next-line */\n  return new Promise(async (resolve) => {\n    if (hasTransition) {\n      const trs = Transition.getInstance(element);\n      trs.transitionEndHandler = () => resolve();\n      element.addEventListener('transitionend', trs.transitionEndHandler, false);\n    }\n    setClassesOrStyles(element, classesOrStyles.from, 'remove');\n    setClassesOrStyles(element, classesOrStyles.to);\n    await nextFrame();\n    if (!hasTransition) {\n      resolve();\n    }\n  });\n}\n\n/**\n * Apply the final state.\n */\nfunction end(\n  element: HTMLElement,\n  classesOrStyles: TransitionStyles,\n  mode: 'keep' | 'remove' = 'remove',\n) {\n  const trs = Transition.getInstance(element);\n  element.removeEventListener('transitionend', trs.transitionEndHandler, false);\n  if (mode === 'remove') {\n    setClassesOrStyles(element, classesOrStyles.to, 'remove');\n  }\n  setClassesOrStyles(element, classesOrStyles.active, 'remove');\n  trs.isTransitioning = false;\n  trs.transitionEndHandler = null;\n}\n\n/**\n * Manage CSS transition with class.\n *\n * This is inspired by the Vue `<transition>` component\n * and the `@barba/css` package, many thanks to them!\n *\n * @param  {HTMLElement}             element The target element.\n * @param  {string|TransitionStyles} name    The name of the transition or an object with the hooks classesOrStyles.\n * @param  {string}                  endMode Whether to remove or keep the `to` classes/styles\n * @return {Promise<void>}                   A promise resolving at the end of the transition.\n */\nasync function singleTransition(\n  element: HTMLElement,\n  name: string | TransitionStyles,\n  endMode: 'keep' | 'remove' = 'remove',\n): Promise<void> {\n  /** @type {TransitionStyles} */\n  const classesOrStyles = isString(name)\n    ? {\n        from: `${name}-from`,\n        active: `${name}-active`,\n        to: `${name}-to`,\n      }\n    : {\n        from: '',\n        active: '',\n        to: '',\n        ...name,\n      };\n\n  const trs = Transition.getInstance(element);\n  // End any previous transition running on the element.\n  if (trs.isTransitioning) {\n    end(element, classesOrStyles);\n  }\n\n  await start(element, classesOrStyles);\n  await next(element, classesOrStyles);\n  end(element, classesOrStyles, endMode);\n  return Promise.resolve();\n}\n\n/**\n * Manage CSS transition with class.\n *\n * @param  {HTMLElement|HTMLElement[]|NodeListOf<HTMLElement>} elementOrElements The target element or elements.\n * @param  {string|TransitionStyles}                           name              The name of the transition or an object with the hooks classesOrStyles.\n * @param  {string}                                            endMode           Whether to remove or keep the `to` classes/styles\n * @return {Promise<void>}                                                      A promise resolving at the end of the transition.\n * @link https://js-toolkit.studiometa.dev/utils/css/transition.html\n*/\nexport async function transition(\n  elementOrElements: HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>,\n  name: string | TransitionStyles,\n  endMode: 'keep' | 'remove' = 'remove',\n) {\n  await Promise.all(\n    eachElements(elementOrElements, (element) => singleTransition(element, name, endMode)),\n  );\n}\n"],
+  "sourcesContent": ["import { nextFrame } from '../nextFrame.js';\nimport * as classes from './classes.js';\nimport * as styles from './styles.js';\nimport { isArray, isString } from '../is.js';\nimport { hasWindow } from '../has.js';\n// eslint-disable-next-line import/extensions\nimport { eachElements } from './utils.js';\n\n/** WeakMap to hold the transition instances. */\nconst cache = new WeakMap();\n\nexport type ClassesOrStyles = string | string[] | Partial<CSSStyleDeclaration>;\n\nexport type TransitionStyles = {\n  from?: ClassesOrStyles;\n  active?: ClassesOrStyles;\n  to?: ClassesOrStyles;\n};\n\n/**\n * Transition class.\n */\nclass Transition {\n  /**\n   * Is a transition currently running?\n   */\n  isTransitioning = false;\n\n  /**\n   * A callback to execute when the transition ends.\n   */\n  transitionEndHandler: EventListenerOrEventListenerObject | null = null;\n\n  /**\n   * Instantiate and save the instance to the cache.\n   */\n  constructor(element: HTMLElement) {\n    cache.set(element, this);\n  }\n\n  /**\n   * Get the transition class attached to the given element.\n   *\n   * @param  {HTMLElement} element The HTML element concerned by the transition.\n   * @return {Transition}          The transition instance tied to the given element.\n   */\n  static getInstance(element: HTMLElement): Transition {\n    let instance = cache.get(element);\n\n    if (!instance) {\n      instance = new this(element);\n    }\n\n    return instance;\n  }\n}\n\n/**\n * Update either the classes or the styles of an element with the given method.\n */\nexport function setClassesOrStyles(\n  element: HTMLElement,\n  classesOrStyles: ClassesOrStyles,\n  method: 'add' | 'remove' = 'add',\n) {\n  if (isString(classesOrStyles) || isArray(classesOrStyles)) {\n    classes[method](element, classesOrStyles);\n  } else {\n    styles[method](element, classesOrStyles);\n  }\n}\n\n/**\n * Test if the given element has a transition duration.\n */\nfunction testTransition(element: HTMLElement) {\n  if (!hasWindow()) {\n    return false;\n  }\n\n  const { transitionDuration } = window.getComputedStyle(element);\n  return !!transitionDuration && transitionDuration !== '0s';\n}\n\n/**\n * Apply the from state.\n */\nasync function start(element: HTMLElement, classesOrStyles: TransitionStyles) {\n  const trs = Transition.getInstance(element);\n  trs.isTransitioning = true;\n  setClassesOrStyles(element, classesOrStyles.from);\n  await nextFrame();\n  setClassesOrStyles(element, classesOrStyles.active);\n}\n\n/**\n * Apply the active state.\n */\nasync function next(element: HTMLElement, classesOrStyles: TransitionStyles): Promise<void> {\n  const hasTransition = testTransition(element);\n\n  /* eslint-disable-next-line */\n  return new Promise(async (resolve) => {\n    if (hasTransition) {\n      const trs = Transition.getInstance(element);\n      trs.transitionEndHandler = () => resolve();\n      element.addEventListener('transitionend', trs.transitionEndHandler, false);\n    }\n    setClassesOrStyles(element, classesOrStyles.from, 'remove');\n    setClassesOrStyles(element, classesOrStyles.to);\n    await nextFrame();\n    if (!hasTransition) {\n      resolve();\n    }\n  });\n}\n\n/**\n * Apply the final state.\n */\nfunction end(\n  element: HTMLElement,\n  classesOrStyles: TransitionStyles,\n  mode: 'keep' | 'remove' = 'remove',\n) {\n  const trs = Transition.getInstance(element);\n  element.removeEventListener('transitionend', trs.transitionEndHandler, false);\n  if (mode === 'remove') {\n    setClassesOrStyles(element, classesOrStyles.to, 'remove');\n  }\n  setClassesOrStyles(element, classesOrStyles.active, 'remove');\n  trs.isTransitioning = false;\n  trs.transitionEndHandler = null;\n}\n\n/**\n * Manage CSS transition with class.\n *\n * This is inspired by the Vue `<transition>` component\n * and the `@barba/css` package, many thanks to them!\n *\n * @param  {HTMLElement}             element The target element.\n * @param  {string|TransitionStyles} name    The name of the transition or an object with the hooks classesOrStyles.\n * @param  {string}                  endMode Whether to remove or keep the `to` classes/styles\n * @return {Promise<void>}                   A promise resolving at the end of the transition.\n */\nasync function singleTransition(\n  element: HTMLElement,\n  name: string | TransitionStyles,\n  endMode: 'keep' | 'remove' = 'remove',\n): Promise<void> {\n  /** @type {TransitionStyles} */\n  const classesOrStyles = isString(name)\n    ? {\n        from: `${name}-from`,\n        active: `${name}-active`,\n        to: `${name}-to`,\n      }\n    : {\n        from: '',\n        active: '',\n        to: '',\n        ...name,\n      };\n\n  const trs = Transition.getInstance(element);\n  // End any previous transition running on the element.\n  if (trs.isTransitioning) {\n    end(element, classesOrStyles);\n  }\n\n  await start(element, classesOrStyles);\n  await next(element, classesOrStyles);\n  end(element, classesOrStyles, endMode);\n  return Promise.resolve();\n}\n\n/**\n * Manage CSS transition with class.\n *\n * @param  {HTMLElement|HTMLElement[]|NodeListOf<HTMLElement>} elementOrElements The target element or elements.\n * @param  {string|TransitionStyles}                           name              The name of the transition or an object with the hooks classesOrStyles.\n * @param  {string}                                            endMode           Whether to remove or keep the `to` classes/styles\n * @return {Promise<void>}                                                      A promise resolving at the end of the transition.\n * @link https://js-toolkit.studiometa.dev/utils/css/transition.html\n */\nexport async function transition(\n  elementOrElements: HTMLElement | HTMLElement[] | NodeListOf<HTMLElement>,\n  name: string | TransitionStyles,\n  endMode: 'keep' | 'remove' = 'remove',\n) {\n  await Promise.all(\n    eachElements(elementOrElements, (element) => singleTransition(element, name, endMode)),\n  );\n}\n"],
   "mappings": "AAAA,SAAS,iBAAiB;AAC1B,YAAY,aAAa;AACzB,YAAY,YAAY;AACxB,SAAS,SAAS,gBAAgB;AAClC,SAAS,iBAAiB;AAE1B,SAAS,oBAAoB;AAG7B,MAAM,QAAQ,oBAAI,QAAQ;AAa1B,MAAM,WAAW;AAAA;AAAA;AAAA;AAAA,EAIf,kBAAkB;AAAA;AAAA;AAAA;AAAA,EAKlB,uBAAkE;AAAA;AAAA;AAAA;AAAA,EAKlE,YAAY,SAAsB;AAChC,UAAM,IAAI,SAAS,IAAI;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,YAAY,SAAkC;AACnD,QAAI,WAAW,MAAM,IAAI,OAAO;AAEhC,QAAI,CAAC,UAAU;AACb,iBAAW,IAAI,KAAK,OAAO;AAAA,IAC7B;AAEA,WAAO;AAAA,EACT;AACF;AAKO,SAAS,mBACd,SACA,iBACA,SAA2B,OAC3B;AACA,MAAI,SAAS,eAAe,KAAK,QAAQ,eAAe,GAAG;AACzD,YAAQ,MAAM,EAAE,SAAS,eAAe;AAAA,EAC1C,OAAO;AACL,WAAO,MAAM,EAAE,SAAS,eAAe;AAAA,EACzC;AACF;AAKA,SAAS,eAAe,SAAsB;AAC5C,MAAI,CAAC,UAAU,GAAG;AAChB,WAAO;AAAA,EACT;AAEA,QAAM,EAAE,mBAAmB,IAAI,OAAO,iBAAiB,OAAO;AAC9D,SAAO,CAAC,CAAC,sBAAsB,uBAAuB;AACxD;AAKA,eAAe,MAAM,SAAsB,iBAAmC;AAC5E,QAAM,MAAM,WAAW,YAAY,OAAO;AAC1C,MAAI,kBAAkB;AACtB,qBAAmB,SAAS,gBAAgB,IAAI;AAChD,QAAM,UAAU;AAChB,qBAAmB,SAAS,gBAAgB,MAAM;AACpD;AAKA,eAAe,KAAK,SAAsB,iBAAkD;AAC1F,QAAM,gBAAgB,eAAe,OAAO;AAG5C,SAAO,IAAI,QAAQ,OAAO,YAAY;AACpC,QAAI,eAAe;AACjB,YAAM,MAAM,WAAW,YAAY,OAAO;AAC1C,UAAI,uBAAuB,MAAM,QAAQ;AACzC,cAAQ,iBAAiB,iBAAiB,IAAI,sBAAsB,KAAK;AAAA,IAC3E;AACA,uBAAmB,SAAS,gBAAgB,MAAM,QAAQ;AAC1D,uBAAmB,SAAS,gBAAgB,EAAE;AAC9C,UAAM,UAAU;AAChB,QAAI,CAAC,eAAe;AAClB,cAAQ;AAAA,IACV;AAAA,EACF,CAAC;AACH;AAKA,SAAS,IACP,SACA,iBACA,OAA0B,UAC1B;AACA,QAAM,MAAM,WAAW,YAAY,OAAO;AAC1C,UAAQ,oBAAoB,iBAAiB,IAAI,sBAAsB,KAAK;AAC5E,MAAI,SAAS,UAAU;AACrB,uBAAmB,SAAS,gBAAgB,IAAI,QAAQ;AAAA,EAC1D;AACA,qBAAmB,SAAS,gBAAgB,QAAQ,QAAQ;AAC5D,MAAI,kBAAkB;AACtB,MAAI,uBAAuB;AAC7B;AAaA,eAAe,iBACb,SACA,MACA,UAA6B,UACd;AAEf,QAAM,kBAAkB,SAAS,IAAI,IACjC;AAAA,IACE,MAAM,GAAG,IAAI;AAAA,IACb,QAAQ,GAAG,IAAI;AAAA,IACf,IAAI,GAAG,IAAI;AAAA,EACb,IACA;AAAA,IACE,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,IAAI;AAAA,IACJ,GAAG;AAAA,EACL;AAEJ,QAAM,MAAM,WAAW,YAAY,OAAO;AAE1C,MAAI,IAAI,iBAAiB;AACvB,QAAI,SAAS,eAAe;AAAA,EAC9B;AAEA,QAAM,MAAM,SAAS,eAAe;AACpC,QAAM,KAAK,SAAS,eAAe;AACnC,MAAI,SAAS,iBAAiB,OAAO;AACrC,SAAO,QAAQ,QAAQ;AACzB;AAWA,eAAsB,WACpB,mBACA,MACA,UAA6B,UAC7B;AACA,QAAM,QAAQ;AAAA,IACZ,aAAa,mBAAmB,CAAC,YAAY,iBAAiB,SAAS,MAAM,OAAO,CAAC;AAAA,EACvF;AACF;",
   "names": []
 }

package/utils/debounce.d.ts

@@ -7,5 +7,5 @@
  * @param  {number} [delay=300] The delay in ms to wait before calling the function.
  * @return {(...args:unknown[]) => void} The debounced function.
  * @link https://js-toolkit.studiometa.dev/utils/debounce.html
-*/
+ */
 export declare function debounce(fn: (...args: unknown[]) => void, delay?: number): (...args: unknown[]) => void;

package/utils/debounce.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/utils/debounce.ts"],
-  "sourcesContent": ["/**\n * Returns a function, that, as long as it continues to be invoked,\n * will not be triggered. The function will be called after it stops\n * being called for N milliseconds.\n *\n * @param  {(...args:unknown[]) => void} fn The function to call.\n * @param  {number} [delay=300] The delay in ms to wait before calling the function.\n * @return {(...args:unknown[]) => void} The debounced function.\n * @link https://js-toolkit.studiometa.dev/utils/debounce.html\n*/\nexport function debounce(\n  fn: (...args: unknown[]) => void,\n  delay = 300,\n): (...args: unknown[]) => void {\n  let timeout;\n  return function debounced(...args) {\n    clearTimeout(timeout);\n    timeout = setTimeout(() => {\n      fn(...args);\n    }, delay);\n  };\n}\n"],
+  "sourcesContent": ["/**\n * Returns a function, that, as long as it continues to be invoked,\n * will not be triggered. The function will be called after it stops\n * being called for N milliseconds.\n *\n * @param  {(...args:unknown[]) => void} fn The function to call.\n * @param  {number} [delay=300] The delay in ms to wait before calling the function.\n * @return {(...args:unknown[]) => void} The debounced function.\n * @link https://js-toolkit.studiometa.dev/utils/debounce.html\n */\nexport function debounce(\n  fn: (...args: unknown[]) => void,\n  delay = 300,\n): (...args: unknown[]) => void {\n  let timeout;\n  return function debounced(...args) {\n    clearTimeout(timeout);\n    timeout = setTimeout(() => {\n      fn(...args);\n    }, delay);\n  };\n}\n"],
   "mappings": "AAUO,SAAS,SACd,IACA,QAAQ,KACsB;AAC9B,MAAI;AACJ,SAAO,SAAS,aAAa,MAAM;AACjC,iBAAa,OAAO;AACpB,cAAU,WAAW,MAAM;AACzB,SAAG,GAAG,IAAI;AAAA,IACZ,GAAG,KAAK;AAAA,EACV;AACF;",
   "names": []
 }

package/utils/history.d.ts

@@ -12,7 +12,7 @@ export interface HistoryOptions {
  * @param  {string}          defaultSearch A string of defaults search params.
  * @return {URLSearchParams}
  * @link https://js-toolkit.studiometa.dev/utils/history/objectToURLSearchParams.html
-*/
+ */
 export declare function objectToURLSearchParams(obj: unknown, defaultSearch?: string): URLSearchParams;
 /**
  * Push a new state.
@@ -22,7 +22,7 @@ export declare function objectToURLSearchParams(obj: unknown, defaultSearch?: st
  * @param  {string}         [title] The title for the new state.
  * @return {void}
  * @link https://js-toolkit.studiometa.dev/utils/history/historyPush.html
-*/
+ */
 export declare function push(options: HistoryOptions, data?: unknown, title?: string): void;
 /**
  * Replace a new state.
@@ -32,5 +32,5 @@ export declare function push(options: HistoryOptions, data?: unknown, title?: st
  * @param  {string}         [title] The title for the new state.
  * @return {void}
  * @link https://js-toolkit.studiometa.dev/utils/history/historyReplace.html
-*/
+ */
 export declare function replace(options: HistoryOptions, data?: unknown, title?: string): void;

package/utils/history.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/utils/history.ts"],
-  "sourcesContent": ["import { isArray, isObject } from './is.js';\nimport { hasWindow } from './has.js';\nimport { startsWith } from './string/index.js';\n\nexport interface HistoryOptions {\n  path?: string;\n  search?: URLSearchParams | { [key: string]: unknown };\n  hash?: string;\n}\n\ntype SearchParamValue = string | number | boolean;\n\n/**\n * Set a param in a URLSearchParam instance.\n *\n * @param  {URLSearchParams}                    params The params to update.\n * @param  {string}                             name   The name of the param to update.\n * @param  {string|number|boolean|Array|Object} value  The value for this param.\n * @return {URLSearchParams}                           The updated URLSearchParams instance.\n */\nfunction updateUrlSearchParam(\n  params: URLSearchParams,\n  name: string,\n  value: SearchParamValue | Array<SearchParamValue> | Record<string, SearchParamValue>,\n): URLSearchParams {\n  if (value === '' || value === null || value === undefined) {\n    if (params.has(name)) {\n      params.delete(name);\n    }\n    return params;\n  }\n\n  if (isArray(value)) {\n    for (const [index, val] of value.entries()) {\n      const arrayName = `${name}[${index}]`;\n      updateUrlSearchParam(params, arrayName, val);\n    }\n    return params;\n  }\n\n  if (isObject(value)) {\n    for (const [key, val] of Object.entries(value)) {\n      const objectName = `${name}[${key}]`;\n      updateUrlSearchParam(params, objectName, val);\n    }\n    return params;\n  }\n\n  params.set(name, value as string);\n  return params;\n}\n\n/**\n * Transform an object to an URLSearchParams instance.\n *\n * @param  {Object}          obj           The object to convert.\n * @param  {string}          defaultSearch A string of defaults search params.\n * @return {URLSearchParams}\n * @link https://js-toolkit.studiometa.dev/utils/history/objectToURLSearchParams.html\n*/\nexport function objectToURLSearchParams(\n  obj: unknown,\n  defaultSearch = hasWindow() ? window.location.search : '',\n): URLSearchParams {\n  return Object.entries(obj).reduce(\n    (urlSearchParams: URLSearchParams, [name, value]) =>\n      updateUrlSearchParam(urlSearchParams, name, value),\n    new URLSearchParams(defaultSearch),\n  ) as URLSearchParams;\n}\n\n/**\n * Update the history with a new state.\n *\n * @param  {string}         mode\n * @param  {HistoryOptions} options\n * @param  {Object}         [data]\n * @param  {string}         [title]\n * @return {void}\n */\nfunction updateHistory(\n  mode: 'push' | 'replace',\n  options: HistoryOptions,\n  data: unknown = {},\n  title = '',\n) {\n  if (!window.history) {\n    return;\n  }\n\n  const { path, search, hash }: HistoryOptions = {\n    path: window.location.pathname,\n    search: new URLSearchParams(window.location.search),\n    hash: window.location.hash,\n    ...options,\n  };\n\n  let url = path;\n\n  const mergedSearch = search instanceof URLSearchParams ? search : objectToURLSearchParams(search);\n\n  if (mergedSearch.toString()) {\n    url += `?${mergedSearch.toString()}`;\n  }\n\n  if (hash) {\n    if (startsWith(hash, '#')) {\n      url += hash;\n    } else {\n      url += `#${hash}`;\n    }\n  }\n\n  const method = `${mode}State`;\n  window.history[method](data, title, url);\n}\n\n/**\n * Push a new state.\n *\n * @param  {HistoryOptions} options The new state.\n * @param  {Object}         [data]  The data for the new state.\n * @param  {string}         [title] The title for the new state.\n * @return {void}\n * @link https://js-toolkit.studiometa.dev/utils/history/historyPush.html\n*/\nexport function push(options: HistoryOptions, data: unknown = {}, title = '') {\n  updateHistory('push', options, data, title);\n}\n\n/**\n * Replace a new state.\n *\n * @param  {HistoryOptions} options The new state.\n * @param  {Object}         [data]  The data for the new state.\n * @param  {string}         [title] The title for the new state.\n * @return {void}\n * @link https://js-toolkit.studiometa.dev/utils/history/historyReplace.html\n*/\nexport function replace(options: HistoryOptions, data: unknown = {}, title = '') {\n  updateHistory('replace', options, data, title);\n}\n"],
+  "sourcesContent": ["import { isArray, isObject } from './is.js';\nimport { hasWindow } from './has.js';\nimport { startsWith } from './string/index.js';\n\nexport interface HistoryOptions {\n  path?: string;\n  search?: URLSearchParams | { [key: string]: unknown };\n  hash?: string;\n}\n\ntype SearchParamValue = string | number | boolean;\n\n/**\n * Set a param in a URLSearchParam instance.\n *\n * @param  {URLSearchParams}                    params The params to update.\n * @param  {string}                             name   The name of the param to update.\n * @param  {string|number|boolean|Array|Object} value  The value for this param.\n * @return {URLSearchParams}                           The updated URLSearchParams instance.\n */\nfunction updateUrlSearchParam(\n  params: URLSearchParams,\n  name: string,\n  value: SearchParamValue | Array<SearchParamValue> | Record<string, SearchParamValue>,\n): URLSearchParams {\n  if (value === '' || value === null || value === undefined) {\n    if (params.has(name)) {\n      params.delete(name);\n    }\n    return params;\n  }\n\n  if (isArray(value)) {\n    for (const [index, val] of value.entries()) {\n      const arrayName = `${name}[${index}]`;\n      updateUrlSearchParam(params, arrayName, val);\n    }\n    return params;\n  }\n\n  if (isObject(value)) {\n    for (const [key, val] of Object.entries(value)) {\n      const objectName = `${name}[${key}]`;\n      updateUrlSearchParam(params, objectName, val);\n    }\n    return params;\n  }\n\n  params.set(name, value as string);\n  return params;\n}\n\n/**\n * Transform an object to an URLSearchParams instance.\n *\n * @param  {Object}          obj           The object to convert.\n * @param  {string}          defaultSearch A string of defaults search params.\n * @return {URLSearchParams}\n * @link https://js-toolkit.studiometa.dev/utils/history/objectToURLSearchParams.html\n */\nexport function objectToURLSearchParams(\n  obj: unknown,\n  defaultSearch = hasWindow() ? window.location.search : '',\n): URLSearchParams {\n  return Object.entries(obj).reduce(\n    (urlSearchParams: URLSearchParams, [name, value]) =>\n      updateUrlSearchParam(urlSearchParams, name, value),\n    new URLSearchParams(defaultSearch),\n  ) as URLSearchParams;\n}\n\n/**\n * Update the history with a new state.\n *\n * @param  {string}         mode\n * @param  {HistoryOptions} options\n * @param  {Object}         [data]\n * @param  {string}         [title]\n * @return {void}\n */\nfunction updateHistory(\n  mode: 'push' | 'replace',\n  options: HistoryOptions,\n  data: unknown = {},\n  title = '',\n) {\n  if (!window.history) {\n    return;\n  }\n\n  const { path, search, hash }: HistoryOptions = {\n    path: window.location.pathname,\n    search: new URLSearchParams(window.location.search),\n    hash: window.location.hash,\n    ...options,\n  };\n\n  let url = path;\n\n  const mergedSearch = search instanceof URLSearchParams ? search : objectToURLSearchParams(search);\n\n  if (mergedSearch.toString()) {\n    url += `?${mergedSearch.toString()}`;\n  }\n\n  if (hash) {\n    if (startsWith(hash, '#')) {\n      url += hash;\n    } else {\n      url += `#${hash}`;\n    }\n  }\n\n  const method = `${mode}State`;\n  window.history[method](data, title, url);\n}\n\n/**\n * Push a new state.\n *\n * @param  {HistoryOptions} options The new state.\n * @param  {Object}         [data]  The data for the new state.\n * @param  {string}         [title] The title for the new state.\n * @return {void}\n * @link https://js-toolkit.studiometa.dev/utils/history/historyPush.html\n */\nexport function push(options: HistoryOptions, data: unknown = {}, title = '') {\n  updateHistory('push', options, data, title);\n}\n\n/**\n * Replace a new state.\n *\n * @param  {HistoryOptions} options The new state.\n * @param  {Object}         [data]  The data for the new state.\n * @param  {string}         [title] The title for the new state.\n * @return {void}\n * @link https://js-toolkit.studiometa.dev/utils/history/historyReplace.html\n */\nexport function replace(options: HistoryOptions, data: unknown = {}, title = '') {\n  updateHistory('replace', options, data, title);\n}\n"],
   "mappings": "AAAA,SAAS,SAAS,gBAAgB;AAClC,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAkB3B,SAAS,qBACP,QACA,MACA,OACiB;AACjB,MAAI,UAAU,MAAM,UAAU,QAAQ,UAAU,QAAW;AACzD,QAAI,OAAO,IAAI,IAAI,GAAG;AACpB,aAAO,OAAO,IAAI;AAAA,IACpB;AACA,WAAO;AAAA,EACT;AAEA,MAAI,QAAQ,KAAK,GAAG;AAClB,eAAW,CAAC,OAAO,GAAG,KAAK,MAAM,QAAQ,GAAG;AAC1C,YAAM,YAAY,GAAG,IAAI,IAAI,KAAK;AAClC,2BAAqB,QAAQ,WAAW,GAAG;AAAA,IAC7C;AACA,WAAO;AAAA,EACT;AAEA,MAAI,SAAS,KAAK,GAAG;AACnB,eAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC9C,YAAM,aAAa,GAAG,IAAI,IAAI,GAAG;AACjC,2BAAqB,QAAQ,YAAY,GAAG;AAAA,IAC9C;AACA,WAAO;AAAA,EACT;AAEA,SAAO,IAAI,MAAM,KAAe;AAChC,SAAO;AACT;AAUO,SAAS,wBACd,KACA,gBAAgB,UAAU,IAAI,OAAO,SAAS,SAAS,IACtC;AACjB,SAAO,OAAO,QAAQ,GAAG,EAAE;AAAA,IACzB,CAAC,iBAAkC,CAAC,MAAM,KAAK,MAC7C,qBAAqB,iBAAiB,MAAM,KAAK;AAAA,IACnD,IAAI,gBAAgB,aAAa;AAAA,EACnC;AACF;AAWA,SAAS,cACP,MACA,SACA,OAAgB,CAAC,GACjB,QAAQ,IACR;AACA,MAAI,CAAC,OAAO,SAAS;AACnB;AAAA,EACF;AAEA,QAAM,EAAE,MAAM,QAAQ,KAAK,IAAoB;AAAA,IAC7C,MAAM,OAAO,SAAS;AAAA,IACtB,QAAQ,IAAI,gBAAgB,OAAO,SAAS,MAAM;AAAA,IAClD,MAAM,OAAO,SAAS;AAAA,IACtB,GAAG;AAAA,EACL;AAEA,MAAI,MAAM;AAEV,QAAM,eAAe,kBAAkB,kBAAkB,SAAS,wBAAwB,MAAM;AAEhG,MAAI,aAAa,SAAS,GAAG;AAC3B,WAAO,IAAI,aAAa,SAAS,CAAC;AAAA,EACpC;AAEA,MAAI,MAAM;AACR,QAAI,WAAW,MAAM,GAAG,GAAG;AACzB,aAAO;AAAA,IACT,OAAO;AACL,aAAO,IAAI,IAAI;AAAA,IACjB;AAAA,EACF;AAEA,QAAM,SAAS,GAAG,IAAI;AACtB,SAAO,QAAQ,MAAM,EAAE,MAAM,OAAO,GAAG;AACzC;AAWO,SAAS,KAAK,SAAyB,OAAgB,CAAC,GAAG,QAAQ,IAAI;AAC5E,gBAAc,QAAQ,SAAS,MAAM,KAAK;AAC5C;AAWO,SAAS,QAAQ,SAAyB,OAAgB,CAAC,GAAG,QAAQ,IAAI;AAC/E,gBAAc,WAAW,SAAS,MAAM,KAAK;AAC/C;",
   "names": []
 }

package/utils/index.d.ts

@@ -26,3 +26,4 @@ export * from './random.js';
 export * from './memo.js';
 export * from './loadElement.js';
 export * from './cache.js';
+export * from './storage.js';

package/utils/index.js

@@ -30,6 +30,7 @@ export * from "./random.js";
 export * from "./memo.js";
 export * from "./loadElement.js";
 export * from "./cache.js";
+export * from "./storage.js";
 export {
   Queue,
   SmartQueue,

package/utils/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/utils/index.ts"],
-  "sourcesContent": ["export { debounce } from './debounce.js';\nexport * from './trapFocus.js';\nexport { keyCodes } from './keyCodes.js';\nexport { memoize } from './memoize.js';\nexport { nextFrame } from './nextFrame.js';\nexport { nextTick } from './nextTick.js';\nexport { nextMicrotask } from './nextMicrotask.js';\nexport { throttle } from './throttle.js';\nexport { scrollTo } from './scrollTo.js';\nexport { getComponentResolver } from './getComponentResolver.js';\nexport * from './is.js';\nexport * from './has.js';\nexport * from './css/index.js';\nexport {\n  objectToURLSearchParams,\n  push as historyPush,\n  replace as historyReplace,\n} from './history.js';\nexport * from './collide/index.js';\nexport * from './math/index.js';\nexport * from './string/index.js';\nexport * from './scheduler.js';\nexport * from './noop.js';\nexport { tween } from './tween.js';\nexport { Queue } from './Queue.js';\nexport { SmartQueue } from './SmartQueue.js';\nexport * from './dom/index.js';\nexport * from './wait.js';\nexport * from './random.js';\nexport * from './memo.js';\nexport * from './loadElement.js';\nexport * from './cache.js';\n"],
-  "mappings": "AAAA,SAAS,gBAAgB;AACzB,cAAc;AACd,SAAS,gBAAgB;AACzB,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AACzB,SAAS,gBAAgB;AACzB,SAAS,4BAA4B;AACrC,cAAc;AACd,cAAc;AACd,cAAc;AACd;AAAA,EACE;AAAA,EACQ;AAAA,EACG;AAAA,OACN;AACP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,SAAS,aAAa;AACtB,SAAS,aAAa;AACtB,SAAS,kBAAkB;AAC3B,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export { debounce } from './debounce.js';\nexport * from './trapFocus.js';\nexport { keyCodes } from './keyCodes.js';\nexport { memoize } from './memoize.js';\nexport { nextFrame } from './nextFrame.js';\nexport { nextTick } from './nextTick.js';\nexport { nextMicrotask } from './nextMicrotask.js';\nexport { throttle } from './throttle.js';\nexport { scrollTo } from './scrollTo.js';\nexport { getComponentResolver } from './getComponentResolver.js';\nexport * from './is.js';\nexport * from './has.js';\nexport * from './css/index.js';\nexport {\n  objectToURLSearchParams,\n  push as historyPush,\n  replace as historyReplace,\n} from './history.js';\nexport * from './collide/index.js';\nexport * from './math/index.js';\nexport * from './string/index.js';\nexport * from './scheduler.js';\nexport * from './noop.js';\nexport { tween } from './tween.js';\nexport { Queue } from './Queue.js';\nexport { SmartQueue } from './SmartQueue.js';\nexport * from './dom/index.js';\nexport * from './wait.js';\nexport * from './random.js';\nexport * from './memo.js';\nexport * from './loadElement.js';\nexport * from './cache.js';\nexport * from './storage.js';\n"],
+  "mappings": "AAAA,SAAS,gBAAgB;AACzB,cAAc;AACd,SAAS,gBAAgB;AACzB,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AACzB,SAAS,gBAAgB;AACzB,SAAS,4BAA4B;AACrC,cAAc;AACd,cAAc;AACd,cAAc;AACd;AAAA,EACE;AAAA,EACQ;AAAA,EACG;AAAA,OACN;AACP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,SAAS,aAAa;AACtB,SAAS,aAAa;AACtB,SAAS,kBAAkB;AAC3B,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/utils/is.d.ts

@@ -5,50 +5,50 @@ export declare const isDev: boolean;
 /**
  * Test is the given value is null.
  * @link https://js-toolkit.studiometa.dev/utils/is/isNull.html
-*/
+ */
 export declare const isNull: (value: unknown) => value is null;
 /**
  * Test if the given value is a function.
  * @link https://js-toolkit.studiometa.dev/utils/is/isFunction.html
-*/
+ */
 export declare const isFunction: (value: unknown) => value is Function;
 /**
  * Test if a value is defined or not.
  * @link https://js-toolkit.studiometa.dev/utils/is/isDefined.html
-*/
+ */
 export declare const isDefined: (value: unknown) => boolean;
 /**
  * Test if value is a string.
  * @link https://js-toolkit.studiometa.dev/utils/is/isString.html
-*/
+ */
 export declare const isString: (value: unknown) => value is string;
 /**
  * Test if the given value is an object.
  * @link https://js-toolkit.studiometa.dev/utils/is/isObject.html
-*/
+ */
 export declare const isObject: (value: unknown) => boolean;
 /**
  * Test if a given value is a number.
  * @link https://js-toolkit.studiometa.dev/utils/is/isNumber.html
-*/
+ */
 export declare const isNumber: (value: unknown) => value is number;
 /**
  * Test if a given value is a boolean.
  * @link https://js-toolkit.studiometa.dev/utils/is/isBoolean.html
-*/
+ */
 export declare const isBoolean: (value: unknown) => value is boolean;
 /**
  * Test if a given value is an array.
  * @link https://js-toolkit.studiometa.dev/utils/is/isArray.html
-*/
+ */
 export declare const isArray: (arg: any) => arg is any[];
 /**
  * Test if a given value is an empty string.
  * @link https://js-toolkit.studiometa.dev/utils/is/isEmptyString.html
-*/
+ */
 export declare const isEmptyString: (value?: unknown) => boolean;
 /**
  * Test if the given value is empty.
  * @link https://js-toolkit.studiometa.dev/utils/is/isEmpty.html
-*/
+ */
 export declare const isEmpty: (value?: any) => boolean;

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\n/**\n * @link https://js-toolkit.studiometa.dev/utils/is/isDev.html\n */\nexport const isDev = typeof __DEV__ !== 'undefined' && __DEV__;\n\n/**\n * Test is the given value is null.\n * @link https://js-toolkit.studiometa.dev/utils/is/isNull.html\n*/\nexport const isNull = (value: unknown): value is null => value === null;\n\n/**\n * Test if the given value is a function.\n * @link https://js-toolkit.studiometa.dev/utils/is/isFunction.html\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 * @link https://js-toolkit.studiometa.dev/utils/is/isDefined.html\n*/\nexport const isDefined = (value: unknown): boolean => typeof value !== 'undefined';\n\n/**\n * Test if value is a string.\n * @link https://js-toolkit.studiometa.dev/utils/is/isString.html\n*/\nexport const isString = (value: unknown): value is string => typeof value === 'string';\n\n/**\n * Test if the given value is an object.\n * @link https://js-toolkit.studiometa.dev/utils/is/isObject.html\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 * @link https://js-toolkit.studiometa.dev/utils/is/isNumber.html\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 * @link https://js-toolkit.studiometa.dev/utils/is/isBoolean.html\n*/\nexport const isBoolean = (value: unknown): value is boolean => typeof value === 'boolean';\n\n// eslint-disable-next-line prefer-destructuring\n/**\n * Test if a given value is an array.\n * @link https://js-toolkit.studiometa.dev/utils/is/isArray.html\n*/\nexport const isArray = Array.isArray;\n\n/**\n * Test if a given value is an empty string.\n * @link https://js-toolkit.studiometa.dev/utils/is/isEmptyString.html\n*/\nexport const isEmptyString = (value?: unknown): boolean => isString(value) && value.length === 0;\n\n/**\n * Test if the given value is empty.\n * @link https://js-toolkit.studiometa.dev/utils/is/isEmpty.html\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"],
+  "sourcesContent": ["// eslint-disable-next-line no-undef\n/**\n * @link https://js-toolkit.studiometa.dev/utils/is/isDev.html\n */\nexport const isDev = typeof __DEV__ !== 'undefined' && __DEV__;\n\n/**\n * Test is the given value is null.\n * @link https://js-toolkit.studiometa.dev/utils/is/isNull.html\n */\nexport const isNull = (value: unknown): value is null => value === null;\n\n/**\n * Test if the given value is a function.\n * @link https://js-toolkit.studiometa.dev/utils/is/isFunction.html\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 * @link https://js-toolkit.studiometa.dev/utils/is/isDefined.html\n */\nexport const isDefined = (value: unknown): boolean => typeof value !== 'undefined';\n\n/**\n * Test if value is a string.\n * @link https://js-toolkit.studiometa.dev/utils/is/isString.html\n */\nexport const isString = (value: unknown): value is string => typeof value === 'string';\n\n/**\n * Test if the given value is an object.\n * @link https://js-toolkit.studiometa.dev/utils/is/isObject.html\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 * @link https://js-toolkit.studiometa.dev/utils/is/isNumber.html\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 * @link https://js-toolkit.studiometa.dev/utils/is/isBoolean.html\n */\nexport const isBoolean = (value: unknown): value is boolean => typeof value === 'boolean';\n\n// eslint-disable-next-line prefer-destructuring\n/**\n * Test if a given value is an array.\n * @link https://js-toolkit.studiometa.dev/utils/is/isArray.html\n */\nexport const isArray = Array.isArray;\n\n/**\n * Test if a given value is an empty string.\n * @link https://js-toolkit.studiometa.dev/utils/is/isEmptyString.html\n */\nexport const isEmptyString = (value?: unknown): boolean => isString(value) && value.length === 0;\n\n/**\n * Test if the given value is empty.\n * @link https://js-toolkit.studiometa.dev/utils/is/isEmpty.html\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": "AAIO,MAAM,QAAQ,OAAO,YAAY,eAAe;AAMhD,MAAM,SAAS,CAAC,UAAkC,UAAU;AAO5D,MAAM,aAAa,CAAC,UAAsC,OAAO,UAAU;AAM3E,MAAM,YAAY,CAAC,UAA4B,OAAO,UAAU;AAMhE,MAAM,WAAW,CAAC,UAAoC,OAAO,UAAU;AAMvE,MAAM,WAAW,CAAC,UACvB,OAAO,UAAU,YAAY,CAAC,CAAC,SAAS,MAAM,SAAS,MAAM;AAMxD,MAAM,WAAW,CAAC,UACvB,OAAO,UAAU,YAAY,CAAC,OAAO,MAAM,KAAK;AAM3C,MAAM,YAAY,CAAC,UAAqC,OAAO,UAAU;AAOzE,MAAM,UAAU,MAAM;AAMtB,MAAM,gBAAgB,CAAC,UAA6B,SAAS,KAAK,KAAK,MAAM,WAAW;AAMxF,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/loadElement.d.ts

@@ -21,27 +21,27 @@ export type LoadElementsReturnType<T extends LoadableElementsNames> = Promise<{
  * Load the given source for the given type of element.
  * @todo manage memo
  * @link https://js-toolkit.studiometa.dev/utils/loadElement.html
-*/
+ */
 export declare function loadElement<T extends LoadableElementsNames>(src: string, type: T, { appendTo }?: LoadElementsOptions): LoadElementsReturnType<T>;
 /**
  * Load the given source as an `<img>` element.
  * @link https://js-toolkit.studiometa.dev/utils/loadImage.html
-*/
+ */
 export declare function loadImage(src: string, options?: LoadElementsOptions): LoadElementsReturnType<"img">;
 /**
  * Load the given source as an `<iframe>` element.
  * @link https://js-toolkit.studiometa.dev/utils/loadIframe.html
-*/
+ */
 export declare function loadIframe(src: string, options?: LoadElementsOptions): LoadElementsReturnType<"iframe">;
 /**
  * Load the given source as a `<link>` element.
  * @link https://js-toolkit.studiometa.dev/utils/loadLink.html
-*/
+ */
 export declare function loadLink(src: string, options?: LoadElementsOptions): LoadElementsReturnType<"link">;
 /**
  * Load the given source as a `<script>` element. The generated element is
  * appended to `document.head` by default, as a script element needs
  * to be inserted in the DOM to load.
  * @link https://js-toolkit.studiometa.dev/utils/loadScript.html
-*/
+ */
 export declare function loadScript(src: string, options?: LoadElementsOptions): LoadElementsReturnType<"script">;

package/utils/loadElement.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../packages/js-toolkit/utils/loadElement.ts"],
-  "sourcesContent": ["export type LoadableElements = {\n  embed: HTMLEmbedElement;\n  iframe: HTMLIFrameElement;\n  img: HTMLImageElement;\n  link: HTMLLinkElement;\n  script: HTMLScriptElement;\n  track: HTMLTrackElement;\n};\n\nexport type LoadableElementsNames = keyof LoadableElements;\n\nexport type LoadElementsOptions = {\n  /**\n   * An HTML element where the created element will be appended.\n   */\n  appendTo?: HTMLElement;\n};\n\nexport type LoadElementsReturnType<T extends LoadableElementsNames> = Promise<{\n  event: Event;\n  element: LoadableElements[T];\n}>;\n\n/**\n * Load the given source for the given type of element.\n * @todo manage memo\n * @link https://js-toolkit.studiometa.dev/utils/loadElement.html\n*/\nexport function loadElement<T extends LoadableElementsNames>(\n  src: string,\n  type: T,\n  { appendTo = null }: LoadElementsOptions = {},\n): LoadElementsReturnType<T> {\n  return new Promise((resolve, reject) => {\n    const eventOptions = { once: true };\n    const prop = type === 'link' ? 'href' : 'src';\n    const element = document.createElement(type);\n    element.addEventListener('load', (event) => resolve({ event, element }), eventOptions);\n    element.addEventListener('error', (event) => reject({ event, element }), eventOptions);\n    element[prop] = src;\n    if (appendTo) {\n      appendTo.append(element);\n    }\n  });\n}\n\n/**\n * Load the given source as an `<img>` element.\n * @link https://js-toolkit.studiometa.dev/utils/loadImage.html\n*/\nexport function loadImage(src: string, options?: LoadElementsOptions) {\n  return loadElement(src, 'img', options);\n}\n\n/**\n * Load the given source as an `<iframe>` element.\n * @link https://js-toolkit.studiometa.dev/utils/loadIframe.html\n*/\nexport function loadIframe(src: string, options?: LoadElementsOptions) {\n  return loadElement(src, 'iframe', options);\n}\n\n/**\n * Load the given source as a `<link>` element.\n * @link https://js-toolkit.studiometa.dev/utils/loadLink.html\n*/\nexport function loadLink(src: string, options?: LoadElementsOptions) {\n  return loadElement(src, 'link', options);\n}\n\n/**\n * Load the given source as a `<script>` element. The generated element is\n * appended to `document.head` by default, as a script element needs\n * to be inserted in the DOM to load.\n * @link https://js-toolkit.studiometa.dev/utils/loadScript.html\n*/\nexport function loadScript(src: string, options?: LoadElementsOptions) {\n  return loadElement(src, 'script', { appendTo: document.head, ...options });\n}\n"],
+  "sourcesContent": ["export type LoadableElements = {\n  embed: HTMLEmbedElement;\n  iframe: HTMLIFrameElement;\n  img: HTMLImageElement;\n  link: HTMLLinkElement;\n  script: HTMLScriptElement;\n  track: HTMLTrackElement;\n};\n\nexport type LoadableElementsNames = keyof LoadableElements;\n\nexport type LoadElementsOptions = {\n  /**\n   * An HTML element where the created element will be appended.\n   */\n  appendTo?: HTMLElement;\n};\n\nexport type LoadElementsReturnType<T extends LoadableElementsNames> = Promise<{\n  event: Event;\n  element: LoadableElements[T];\n}>;\n\n/**\n * Load the given source for the given type of element.\n * @todo manage memo\n * @link https://js-toolkit.studiometa.dev/utils/loadElement.html\n */\nexport function loadElement<T extends LoadableElementsNames>(\n  src: string,\n  type: T,\n  { appendTo = null }: LoadElementsOptions = {},\n): LoadElementsReturnType<T> {\n  return new Promise((resolve, reject) => {\n    const eventOptions = { once: true };\n    const prop = type === 'link' ? 'href' : 'src';\n    const element = document.createElement(type);\n    element.addEventListener('load', (event) => resolve({ event, element }), eventOptions);\n    element.addEventListener('error', (event) => reject({ event, element }), eventOptions);\n    element[prop] = src;\n    if (appendTo) {\n      appendTo.append(element);\n    }\n  });\n}\n\n/**\n * Load the given source as an `<img>` element.\n * @link https://js-toolkit.studiometa.dev/utils/loadImage.html\n */\nexport function loadImage(src: string, options?: LoadElementsOptions) {\n  return loadElement(src, 'img', options);\n}\n\n/**\n * Load the given source as an `<iframe>` element.\n * @link https://js-toolkit.studiometa.dev/utils/loadIframe.html\n */\nexport function loadIframe(src: string, options?: LoadElementsOptions) {\n  return loadElement(src, 'iframe', options);\n}\n\n/**\n * Load the given source as a `<link>` element.\n * @link https://js-toolkit.studiometa.dev/utils/loadLink.html\n */\nexport function loadLink(src: string, options?: LoadElementsOptions) {\n  return loadElement(src, 'link', options);\n}\n\n/**\n * Load the given source as a `<script>` element. The generated element is\n * appended to `document.head` by default, as a script element needs\n * to be inserted in the DOM to load.\n * @link https://js-toolkit.studiometa.dev/utils/loadScript.html\n */\nexport function loadScript(src: string, options?: LoadElementsOptions) {\n  return loadElement(src, 'script', { appendTo: document.head, ...options });\n}\n"],
   "mappings": "AA4BO,SAAS,YACd,KACA,MACA,EAAE,WAAW,KAAK,IAAyB,CAAC,GACjB;AAC3B,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,eAAe,EAAE,MAAM,KAAK;AAClC,UAAM,OAAO,SAAS,SAAS,SAAS;AACxC,UAAM,UAAU,SAAS,cAAc,IAAI;AAC3C,YAAQ,iBAAiB,QAAQ,CAAC,UAAU,QAAQ,EAAE,OAAO,QAAQ,CAAC,GAAG,YAAY;AACrF,YAAQ,iBAAiB,SAAS,CAAC,UAAU,OAAO,EAAE,OAAO,QAAQ,CAAC,GAAG,YAAY;AACrF,YAAQ,IAAI,IAAI;AAChB,QAAI,UAAU;AACZ,eAAS,OAAO,OAAO;AAAA,IACzB;AAAA,EACF,CAAC;AACH;AAMO,SAAS,UAAU,KAAa,SAA+B;AACpE,SAAO,YAAY,KAAK,OAAO,OAAO;AACxC;AAMO,SAAS,WAAW,KAAa,SAA+B;AACrE,SAAO,YAAY,KAAK,UAAU,OAAO;AAC3C;AAMO,SAAS,SAAS,KAAa,SAA+B;AACnE,SAAO,YAAY,KAAK,QAAQ,OAAO;AACzC;AAQO,SAAS,WAAW,KAAa,SAA+B;AACrE,SAAO,YAAY,KAAK,UAAU,EAAE,UAAU,SAAS,MAAM,GAAG,QAAQ,CAAC;AAC3E;",
   "names": []
 }

package/utils/math/clamp.d.ts

@@ -1,5 +1,5 @@
 /**
  * Clamp a value in a given range.
  * @link https://js-toolkit.studiometa.dev/utils/math/clamp.html
-*/
+ */
 export declare function clamp(value: number, min: number, max: number): number;

package/utils/math/clamp.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/utils/math/clamp.ts"],
-  "sourcesContent": ["/**\n * Clamp a value in a given range.\n * @link https://js-toolkit.studiometa.dev/utils/math/clamp.html\n*/\nexport function clamp(value: number, min: number, max: number) {\n  /* eslint-disable no-nested-ternary */\n  return min < max\n    ? value < min\n      ? min\n      : value > max\n        ? max\n        : value\n    : value < max\n      ? max\n      : value > min\n        ? min\n        : value;\n  /* eslint-enable no-nested-ternary */\n}\n"],
+  "sourcesContent": ["/**\n * Clamp a value in a given range.\n * @link https://js-toolkit.studiometa.dev/utils/math/clamp.html\n */\nexport function clamp(value: number, min: number, max: number) {\n  /* eslint-disable no-nested-ternary */\n  return min < max\n    ? value < min\n      ? min\n      : value > max\n        ? max\n        : value\n    : value < max\n      ? max\n      : value > min\n        ? min\n        : value;\n  /* eslint-enable no-nested-ternary */\n}\n"],
   "mappings": "AAIO,SAAS,MAAM,OAAe,KAAa,KAAa;AAE7D,SAAO,MAAM,MACT,QAAQ,MACN,MACA,QAAQ,MACN,MACA,QACJ,QAAQ,MACN,MACA,QAAQ,MACN,MACA;AAEV;",
   "names": []
 }

package/utils/math/clamp01.d.ts

@@ -1,5 +1,5 @@
 /**
  * Clamp a value in the 0–1 range.
  * @link https://js-toolkit.studiometa.dev/utils/math/clamp01.html
-*/
+ */
 export declare function clamp01(value: number): number;

package/utils/math/clamp01.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/utils/math/clamp01.ts"],
-  "sourcesContent": ["import { clamp } from './clamp.js';\n\n/**\n * Clamp a value in the 0\u20131 range.\n * @link https://js-toolkit.studiometa.dev/utils/math/clamp01.html\n*/\nexport function clamp01(value: number) {\n  return clamp(value, 0, 1);\n}\n"],
+  "sourcesContent": ["import { clamp } from './clamp.js';\n\n/**\n * Clamp a value in the 0\u20131 range.\n * @link https://js-toolkit.studiometa.dev/utils/math/clamp01.html\n */\nexport function clamp01(value: number) {\n  return clamp(value, 0, 1);\n}\n"],
   "mappings": "AAAA,SAAS,aAAa;AAMf,SAAS,QAAQ,OAAe;AACrC,SAAO,MAAM,OAAO,GAAG,CAAC;AAC1B;",
   "names": []
 }

package/utils/math/createEases.d.ts

@@ -11,7 +11,7 @@ export type EasingFunction = (progress: number) => number;
  * @param  {EasingFunction} easeIn The ease in function.
  * @return {EasingFunction}        The out function.
  * @link https://js-toolkit.studiometa.dev/utils/math/createEaseOut.html
-*/
+ */
 export declare function createEaseOut(easeIn: EasingFunction): EasingFunction;
 /**
  * Create an in-out easing function.
@@ -19,5 +19,5 @@ export declare function createEaseOut(easeIn: EasingFunction): EasingFunction;
  * @param  {EasingFunction} easeIn The ease in function.
  * @return {EasingFunction}        The in-out function.
  * @link https://js-toolkit.studiometa.dev/utils/math/createEaseInOut.html
-*/
+ */
 export declare function createEaseInOut(easeIn: EasingFunction): EasingFunction;

package/utils/math/createEases.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/js-toolkit/utils/math/createEases.ts"],
-  "sourcesContent": ["/**\n * Easing function.\n *\n * @param  progress Progress value betwen `0` and `1`.\n * @return          Eased value between `0` and `1`.\n */\nexport type EasingFunction = (progress: number) => number;\n\n/**\n * Create an out easing function.\n *\n * @param  {EasingFunction} easeIn The ease in function.\n * @return {EasingFunction}        The out function.\n * @link https://js-toolkit.studiometa.dev/utils/math/createEaseOut.html\n*/\nexport function createEaseOut(easeIn: EasingFunction): EasingFunction {\n  return (progress) => 1 - easeIn(1 - progress);\n}\n\n/**\n * Create an in-out easing function.\n *\n * @param  {EasingFunction} easeIn The ease in function.\n * @return {EasingFunction}        The in-out function.\n * @link https://js-toolkit.studiometa.dev/utils/math/createEaseInOut.html\n*/\nexport function createEaseInOut(easeIn: EasingFunction): EasingFunction {\n  /* eslint-disable no-nested-ternary */\n  // eslint-disable-next-line no-confusing-arrow\n  return (progress) =>\n    progress === 0\n      ? 0\n      : progress === 1\n        ? 1\n        : progress < 0.5\n          ? easeIn(progress * 2) / 2\n          : 1 - easeIn((1 - progress) * 2) / 2;\n}\n"],
+  "sourcesContent": ["/**\n * Easing function.\n *\n * @param  progress Progress value betwen `0` and `1`.\n * @return          Eased value between `0` and `1`.\n */\nexport type EasingFunction = (progress: number) => number;\n\n/**\n * Create an out easing function.\n *\n * @param  {EasingFunction} easeIn The ease in function.\n * @return {EasingFunction}        The out function.\n * @link https://js-toolkit.studiometa.dev/utils/math/createEaseOut.html\n */\nexport function createEaseOut(easeIn: EasingFunction): EasingFunction {\n  return (progress) => 1 - easeIn(1 - progress);\n}\n\n/**\n * Create an in-out easing function.\n *\n * @param  {EasingFunction} easeIn The ease in function.\n * @return {EasingFunction}        The in-out function.\n * @link https://js-toolkit.studiometa.dev/utils/math/createEaseInOut.html\n */\nexport function createEaseInOut(easeIn: EasingFunction): EasingFunction {\n  /* eslint-disable no-nested-ternary */\n  // eslint-disable-next-line no-confusing-arrow\n  return (progress) =>\n    progress === 0\n      ? 0\n      : progress === 1\n        ? 1\n        : progress < 0.5\n          ? easeIn(progress * 2) / 2\n          : 1 - easeIn((1 - progress) * 2) / 2;\n}\n"],
   "mappings": "AAeO,SAAS,cAAc,QAAwC;AACpE,SAAO,CAAC,aAAa,IAAI,OAAO,IAAI,QAAQ;AAC9C;AASO,SAAS,gBAAgB,QAAwC;AAGtE,SAAO,CAAC,aACN,aAAa,IACT,IACA,aAAa,IACX,IACA,WAAW,MACT,OAAO,WAAW,CAAC,IAAI,IACvB,IAAI,QAAQ,IAAI,YAAY,CAAC,IAAI;AAC7C;",
   "names": []
 }

package/utils/math/createRange.d.ts

@@ -1,5 +1,5 @@
 /**
  * Create an array from a given range and with the given incremental step.
  * @link https://js-toolkit.studiometa.dev/utils/math/createRange.html
-*/
+ */
 export declare function createRange(min: number, max: number, step: number): number[];

package/utils/math/createRange.js.map

@@ -1,7 +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 * @link https://js-toolkit.studiometa.dev/utils/math/createRange.html\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"],
+  "sourcesContent": ["/**\n * Create an array from a given range and with the given incremental step.\n * @link https://js-toolkit.studiometa.dev/utils/math/createRange.html\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": "AAIO,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/damp.d.ts

@@ -7,5 +7,5 @@
  * @param  {number} [precision=0.01] The precision used to calculate the latest value, defaults to `0.01`.
  * @return {number} The next value.
  * @link https://js-toolkit.studiometa.dev/utils/math/damp.html
-*/
+ */
 export declare function damp(targetValue: number, currentValue: number, factor?: number, precision?: number): number;