@maz-ui/utils 4.0.0-beta.0

package/dist/utils/normalizeString.js

@@ -0,0 +1,69 @@
+const l = {
+  removeAccents: !0,
+  caseSensitive: !1,
+  replaceSpaces: !0,
+  removeSpecialCharacters: !1,
+  trim: !0,
+  normalizeSpaces: !0,
+  removeNumbers: !1,
+  customNormalizationForms: ["NFC", "NFKD"]
+};
+function s(o, i) {
+  const r = { ...l, ...i }, t = {
+    À: "A",
+    Á: "A",
+    Â: "A",
+    Ã: "A",
+    Ä: "A",
+    Å: "A",
+    à: "a",
+    á: "a",
+    â: "a",
+    ã: "a",
+    ä: "a",
+    å: "a",
+    È: "E",
+    É: "E",
+    Ê: "E",
+    Ë: "E",
+    è: "e",
+    é: "e",
+    ê: "e",
+    ë: "e",
+    Î: "I",
+    Ï: "I",
+    í: "I",
+    î: "i",
+    ï: "i",
+    Ô: "O",
+    Õ: "O",
+    Ö: "O",
+    Ø: "O",
+    ô: "o",
+    õ: "o",
+    ö: "o",
+    ø: "o",
+    Ù: "U",
+    Ú: "U",
+    Û: "U",
+    Ü: "U",
+    ù: "u",
+    ú: "u",
+    û: "u",
+    ü: "u",
+    Ç: "C",
+    ç: "c",
+    ÿ: "y",
+    Ñ: "N",
+    ñ: "n",
+    ó: "o"
+  };
+  let e = o.toString();
+  if (r.trim && (e = e.trim()), r.normalizeSpaces && (e = e.replaceAll(/\s+/g, " ")), r.replaceSpaces && (e = e.replaceAll(" ", "-")), r.removeNumbers && (e = e.replaceAll(/\d/g, "")), r.removeAccents && (e = e.replaceAll(/[ÀÁÂÃÄÅÇÈÉÊËÎÏÑÔÕÖØÙÚÛÜàáâãäåçèéêëíîïñóôõöøùúûüÿ]/g, (a) => t[a] || a), e = e.replaceAll(/[\u0300-\u036F]/g, "")), r.caseSensitive === !1 && (e = e.toLowerCase()), r.removeSpecialCharacters && (e = e.replaceAll(/[^\dA-Z-]/gi, "")), r.trim && (e = e.trim()), r.customNormalizationForms)
+    for (const a of r.customNormalizationForms)
+      e = e.normalize(a);
+  return e;
+}
+export {
+  s as normalizeString
+};

package/dist/utils/scriptLoader.js

@@ -0,0 +1,43 @@
+class s {
+  src;
+  script;
+  once;
+  async;
+  defer;
+  identifier;
+  constructor({ src: e, identifier: t, once: n = !0, async: r = !0, defer: i = !0 }) {
+    if (typeof window > "u")
+      throw new TypeError("[ScriptLoader]: Is supported only on browser side");
+    if (!e)
+      throw new Error('[ScriptLoader]: You should provide the attribut "src"');
+    if (!t)
+      throw new Error('[ScriptLoader]: You should provide the attribut "identifier"');
+    this.src = e, this.identifier = t, this.once = n, this.async = r, this.defer = i;
+  }
+  removeTag(e) {
+    typeof e == "string" ? document.head.querySelector(`[data-identifier="${e}"]`)?.remove() : e.remove();
+  }
+  load() {
+    const e = window, t = document.head.querySelectorAll(`[data-identifier="${this.identifier}"]`);
+    if (this.once && e[this.identifier] && t.length > 0)
+      return this.script = e[this.identifier], Promise.resolve(this.script);
+    if (!this.once && t.length > 0)
+      for (const n of t)
+        this.removeTag(n);
+    return this.injectScript();
+  }
+  injectScript() {
+    const e = window;
+    return new Promise((t, n) => {
+      try {
+        const r = document.createElement("script");
+        r.src = this.src, r.async = this.async, r.defer = this.defer, r.dataset.identifier = this.identifier, r.addEventListener("error", (i) => n(new Error(`[ScriptLoader](injectScript) ${i.message}`))), r.addEventListener("load", (i) => (this.script = i, e[this.identifier] = i, t(i))), document.head.append(r);
+      } catch (r) {
+        throw new Error(`[ScriptLoader](init) ${r}`);
+      }
+    });
+  }
+}
+export {
+  s as ScriptLoader
+};

package/dist/utils/sleep.js

@@ -0,0 +1,6 @@
+function n(e) {
+  return new Promise((t) => setTimeout(t, e));
+}
+export {
+  n as sleep
+};

package/dist/utils/swipeHandler.js

@@ -0,0 +1,80 @@
+const s = {
+  preventDefaultOnTouchMove: !1,
+  preventDefaultOnMouseWheel: !1,
+  threshold: 50,
+  immediate: !1,
+  triggerOnEnd: !1
+};
+class n {
+  constructor(t) {
+    this.inputOption = t, this.options = { ...s, ...t }, this.onToucheStartCallback = this.toucheStartHandler.bind(this), this.onToucheMoveCallback = this.handleTouchMove.bind(this), this.onToucheEndCallback = this.handleTouchEnd.bind(this), this.onMouseWheelCallback = this.handleMouseWheel.bind(this), this.start = this.startListening.bind(this), this.stop = this.stopListening.bind(this), this.options.element && this.setElement(this.options.element), this.options.immediate && this.start();
+  }
+  element;
+  xStart;
+  yStart;
+  xEnd;
+  yEnd;
+  xDiff;
+  yDiff;
+  onToucheStartCallback;
+  onToucheMoveCallback;
+  onToucheEndCallback;
+  onMouseWheelCallback;
+  start;
+  stop;
+  options;
+  startListening() {
+    this.setElement(this.options.element), this.element?.addEventListener("touchstart", this.onToucheStartCallback, { passive: !0 }), this.element?.addEventListener("touchmove", this.onToucheMoveCallback, { passive: !0 }), this.options.triggerOnEnd && this.element?.addEventListener("touchend", this.onToucheEndCallback, { passive: !0 }), this.options.preventDefaultOnMouseWheel && this.element?.addEventListener("mousewheel", this.onMouseWheelCallback, { passive: !1 });
+  }
+  stopListening() {
+    this.element?.removeEventListener("touchstart", this.onToucheStartCallback), this.element?.removeEventListener("touchmove", this.onToucheMoveCallback), this.element?.removeEventListener("touchend", this.onToucheEndCallback), this.options.preventDefaultOnMouseWheel && this.element?.removeEventListener("mousewheel", this.onMouseWheelCallback);
+  }
+  setElement(t) {
+    if (!t) {
+      console.error(
+        "[maz-ui][SwipeHandler](setElement) Element should be provided. Its can be a string selector or an HTMLElement"
+      );
+      return;
+    }
+    if (typeof t == "string") {
+      const e = document.querySelector(t);
+      if (!(e instanceof HTMLElement)) {
+        console.error("[maz-ui][SwipeHandler](setElement) String selector for element is not found");
+        return;
+      }
+      this.element = e;
+    } else
+      this.element = t;
+  }
+  handleMouseWheel(t) {
+    t.preventDefault();
+  }
+  toucheStartHandler(t) {
+    this.xStart = t.touches[0].clientX, this.yStart = t.touches[0].clientY, this.emitValuesChanged();
+  }
+  emitValuesChanged() {
+    this.options.onValuesChanged?.({
+      xStart: this.xStart,
+      yStart: this.yStart,
+      xEnd: this.xEnd,
+      yEnd: this.yEnd,
+      xDiff: this.xDiff,
+      yDiff: this.yDiff
+    });
+  }
+  handleTouchMove(t) {
+    this.options.preventDefaultOnTouchMove && t.cancelable && t.preventDefault(), this.xEnd = t.touches[0].clientX, this.yEnd = t.touches[0].clientY, !(!this.xStart || !this.yStart) && (this.xDiff = this.xStart - this.xEnd, this.yDiff = this.yStart - this.yEnd, this.emitValuesChanged(), this.options.triggerOnEnd || this.runCallbacks(t));
+  }
+  handleTouchEnd(t) {
+    this.runCallbacks(t), this.emitValuesChanged();
+  }
+  runCallbacks(t) {
+    typeof this.xDiff != "number" || typeof this.yDiff != "number" || Math.abs(this.xDiff) < this.options.threshold && Math.abs(this.yDiff) < this.options.threshold || (Math.abs(this.xDiff) > Math.abs(this.yDiff) ? this.xDiff > 0 ? this.options.onLeft?.(t) : this.options.onRight?.(t) : this.yDiff > 0 ? this.options.onUp?.(t) : this.options.onDown?.(t), this.resetValues());
+  }
+  resetValues() {
+    this.xStart = void 0, this.yStart = void 0, this.xEnd = void 0, this.yEnd = void 0, this.xDiff = void 0, this.yDiff = void 0, this.emitValuesChanged();
+  }
+}
+export {
+  n as Swipe
+};

package/dist/utils/throttle.js

@@ -0,0 +1,11 @@
+function i(e, a) {
+  let l = !1, n, t;
+  return function(...o) {
+    l ? (clearTimeout(n), n = setTimeout(() => {
+      Date.now() - t >= a && (e.apply(this, o), t = Date.now());
+    }, Math.max(a - (Date.now() - t), 0))) : (e.apply(this, o), t = Date.now(), l = !0);
+  };
+}
+export {
+  i as throttle
+};

package/dist/utils/throttleId.js

@@ -0,0 +1,19 @@
+function c(s, o, t) {
+  const l = {};
+  return async (...m) => {
+    const a = Date.now();
+    return l[s] || (l[s] = { promise: null, lastCall: 0, lastArgs: [] }), a - l[s].lastCall >= t ? (l[s].lastCall = a, o(...m)) : (l[s].lastArgs = m, l[s].promise || (l[s].promise = new Promise((u) => {
+      setTimeout(
+        async () => {
+          l[s].lastCall = Date.now();
+          const p = await o(...l[s].lastArgs);
+          l[s].promise = null, u(p);
+        },
+        t - (a - l[s].lastCall)
+      );
+    })), l[s].promise);
+  };
+}
+export {
+  c as throttleId
+};

package/dist/utils/truthyFilter.js

@@ -0,0 +1,6 @@
+function r(t) {
+  return !!t;
+}
+export {
+  r as truthyFilter
+};

package/dist/utils/userVisibility.js

@@ -0,0 +1,50 @@
+import { isClient as i } from "./isClient.js";
+class o {
+  constructor(t, e) {
+    this.callback = t, this.options = {
+      ...this.defaultOptions,
+      ...e
+    }, this.eventHandlerFunction = this.eventHandler.bind(this), i() && this.start();
+  }
+  eventHandlerFunction;
+  event = "visibilitychange";
+  timeoutHandler;
+  options;
+  defaultOptions = {
+    timeout: 5e3,
+    once: !1,
+    immediate: !0
+  };
+  isVisible = !1;
+  start() {
+    if (!i()) {
+      console.warn("[UserVisibility](start) you should run this method on client side");
+      return;
+    }
+    this.options.immediate && this.emitCallback(), this.addEventListener();
+  }
+  emitCallback() {
+    this.isVisible = document.visibilityState === "visible", this.callback({ isVisible: this.isVisible }), this.options.once && this.destroy();
+  }
+  eventHandler() {
+    document.visibilityState === "visible" && !this.isVisible ? (this.clearTimeout(), this.emitCallback()) : document.visibilityState === "hidden" && this.initTimeout();
+  }
+  clearTimeout() {
+    this.timeoutHandler && (clearTimeout(this.timeoutHandler), this.timeoutHandler = void 0);
+  }
+  initTimeout() {
+    this.clearTimeout(), this.timeoutHandler = setTimeout(this.emitCallback.bind(this), this.options.timeout);
+  }
+  addEventListener() {
+    document.addEventListener(this.event, this.eventHandlerFunction);
+  }
+  removeEventListener() {
+    document.removeEventListener(this.event, this.eventHandlerFunction);
+  }
+  destroy() {
+    this.removeEventListener(), this.timeoutHandler && clearTimeout(this.timeoutHandler);
+  }
+}
+export {
+  o as UserVisibility
+};

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@maz-ui/utils",
+  "type": "module",
+  "version": "4.0.0-beta.0",
+  "description": "Utils of maz-ui for JavaScript/TypeScript users",
+  "author": "Louis Mazel <me@loicmazuel.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LouisMazel/maz-ui.git"
+  },
+  "bugs": "https://github.com/LouisMazel/maz-ui/issues",
+  "keywords": [
+    "utils",
+    "javascript",
+    "typescript",
+    "maz-ui"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js",
+      "module": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./utils": {
+      "types": "./dist/types/utils/index.d.ts",
+      "import": "./dist/utils/index.js",
+      "module": "./dist/utils/index.js",
+      "default": "./dist/utils/index.js"
+    },
+    "./formatters": {
+      "types": "./dist/types/formatters/index.d.ts",
+      "import": "./dist/formatters/index.js",
+      "module": "./dist/formatters/index.js",
+      "default": "./dist/formatters/index.js"
+    },
+    "./utils/*": {
+      "types": "./dist/types/utils/*.d.ts",
+      "import": "./dist/utils/*.js",
+      "module": "./dist/utils/*.js",
+      "default": "./dist/utils/*.js"
+    },
+    "./formatters/*": {
+      "types": "./dist/types/formatters/*.d.ts",
+      "import": "./dist/formatters/*.js",
+      "module": "./dist/formatters/*.js",
+      "default": "./dist/formatters/*.js"
+    },
+    "./*": "./*"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "LICENSE",
+    "README.md",
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "typecheck": "tsc --noEmit --skipLibCheck",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "pre-commit": "lint-staged"
+  },
+  "devDependencies": {
+    "eslint": "^9.29.0",
+    "eslint-plugin-format": "^1.0.1",
+    "glob": "catalog:",
+    "libphonenumber-js": "catalog:",
+    "typescript": "^5.8.3",
+    "vite": "^6.3.5",
+    "vue": "catalog:"
+  },
+  "lint-staged": {
+    "*.{js,jsx,ts,tsx,mjs,mts,cjs,md}": [
+      "eslint --fix"
+    ]
+  },
+  "gitHead": "9ef7beb4feeee0b0cb44e7df8af7115d5d5ef334"
+}