@maz-ui/utils 5.0.0-canary.ef64a02.0 → 5.2.0-beta.0

package/README.md

@@ -163,7 +163,7 @@ const phone = formatPhoneNumber('+33123456789', 'international')
 
 ## Requirements
 
-- Node.js >= 18.0.0
+- Node.js >= 22.12.0
 - TypeScript support included
 - Tree-shakeable for optimal bundle size
 

package/dist/helpers/TextareaAutogrow.js

@@ -1 +1,25 @@
-import{debounce}from"./debounce.js";var TextareaAutogrow=class{element;constructor(element){this.element=element,this.onFocus=this.onFocus.bind(this),this.autogrow=this.autogrow.bind(this),this.onResize=debounce(this.onResize.bind(this),200),this.connect()}connect(){this.element.addEventListener(`focus`,this.onFocus),this.element.style.resize=`none`,this.element.style.boxSizing=`border-box`}disconnect(){window.removeEventListener(`resize`,this.onResize),this.element.removeEventListener(`input`,this.autogrow)}onFocus(){this.autogrow(),this.element.addEventListener(`input`,this.autogrow),window.addEventListener(`resize`,this.onResize),this.element.removeEventListener(`focus`,this.onFocus)}onResize(){this.autogrow()}autogrow(){this.element.style.height=`auto`,this.element.style.overflow=`hidden`,this.element.style.height=`${this.element.scrollHeight}px`}};export{TextareaAutogrow};
+import { debounce } from "./debounce.js";
+//#region src/helpers/TextareaAutogrow.ts
+var TextareaAutogrow = class {
+	element;
+	constructor(element) {
+		this.element = element, this.onFocus = this.onFocus.bind(this), this.autogrow = this.autogrow.bind(this), this.onResize = debounce(this.onResize.bind(this), 200), this.connect();
+	}
+	connect() {
+		this.element.addEventListener("focus", this.onFocus), this.element.style.resize = "none", this.element.style.boxSizing = "border-box";
+	}
+	disconnect() {
+		window.removeEventListener("resize", this.onResize), this.element.removeEventListener("input", this.autogrow);
+	}
+	onFocus() {
+		this.autogrow(), this.element.addEventListener("input", this.autogrow), window.addEventListener("resize", this.onResize), this.element.removeEventListener("focus", this.onFocus);
+	}
+	onResize() {
+		this.autogrow();
+	}
+	autogrow() {
+		this.element.style.height = "auto", this.element.style.overflow = "hidden", this.element.style.height = `${this.element.scrollHeight}px`;
+	}
+};
+//#endregion
+export { TextareaAutogrow };

package/dist/helpers/camelCase.js

@@ -1 +1,6 @@
-function camelCase(str){return str.replaceAll(/-(\w)/g,(_,c)=>c?c.toUpperCase():``)}export{camelCase};
+//#region src/helpers/camelCase.ts
+function camelCase(str) {
+	return str.replaceAll(/-(\w)/g, (_, c) => c ? c.toUpperCase() : "");
+}
+//#endregion
+export { camelCase };

package/dist/helpers/capitalize.js

@@ -1 +1,6 @@
-function capitalize(value){return typeof value==`string`?value.charAt(0).toUpperCase()+value.slice(1):``}export{capitalize};
+//#region src/helpers/capitalize.ts
+function capitalize(value) {
+	return typeof value == "string" ? value.charAt(0).toUpperCase() + value.slice(1) : "";
+}
+//#endregion
+export { capitalize };

package/dist/helpers/checkAvailability.js

@@ -1 +1,16 @@
-function checkAvailability(getRef,callback,options){let opts={maxAttempts:20,interval:100,...options};let attempts=0;function check(){let ref=getRef();ref==null||opts.expectedValue!==void 0&&ref!==opts.expectedValue?attempts<opts.maxAttempts?(attempts++,setTimeout(check,opts.interval)):opts.onError?.(Error(opts.errorMessage||`[maz-ui](checkAvailability) Nothing found after ${opts.maxAttempts} attempts`)):callback(ref)}check()}export{checkAvailability};
+//#region src/helpers/checkAvailability.ts
+function checkAvailability(getRef, callback, options) {
+	let opts = {
+		maxAttempts: 20,
+		interval: 100,
+		...options
+	};
+	let attempts = 0;
+	function check() {
+		let ref = getRef();
+		ref == null || opts.expectedValue !== void 0 && ref !== opts.expectedValue ? attempts < opts.maxAttempts ? (attempts++, setTimeout(check, opts.interval)) : opts.onError?.(Error(opts.errorMessage || `[maz-ui](checkAvailability) Nothing found after ${opts.maxAttempts} attempts`)) : callback(ref);
+	}
+	check();
+}
+//#endregion
+export { checkAvailability };

package/dist/helpers/cookie.d.ts

@@ -0,0 +1,38 @@
+export type CookieSameSite = 'Lax' | 'Strict' | 'None' | 'lax' | 'strict' | 'none';
+export interface CookieOptions {
+    /** Path attribute. Defaults to `'/'`. Pass `null` to omit. */
+    path?: string | null;
+    /** Domain attribute. */
+    domain?: string;
+    /** Lifetime in seconds. Defaults to one year. Pass `null` to omit (session cookie). */
+    maxAge?: number | null;
+    /** Explicit expiration date. Takes precedence over `maxAge` when both are set. */
+    expires?: Date;
+    /** Restrict the cookie to HTTPS connections. */
+    secure?: boolean;
+    /** Same-site policy. Defaults to `'Lax'`. Pass `null` to omit. */
+    sameSite?: CookieSameSite | null;
+    /** Mark the cookie as partitioned (CHIPS). */
+    partitioned?: boolean;
+}
+/**
+ * Read a cookie by key.
+ *
+ * - On the client, the cookie is read from `document.cookie`.
+ * - On the server, pass the raw `Cookie` request header via `cookieHeader`
+ *   (e.g. from `useSSRContext().event.node.req.headers.cookie` in Nuxt) to
+ *   resolve the value during SSR. Without it, the function returns `null`.
+ */
+export declare function getCookie(key: string, cookieHeader?: string): string | null;
+/**
+ * Write a cookie via `document.cookie` with full attribute support.
+ *
+ * No-op on the server. `HttpOnly` is intentionally omitted as it cannot be set
+ * from `document.cookie` (browsers reject it).
+ */
+export declare function setCookie(key: string, value: string, options?: CookieOptions): void;
+/**
+ * Delete a cookie by writing `max-age=0`. `path` and `domain` must match the
+ * cookie's original attributes for the browser to actually drop it.
+ */
+export declare function deleteCookie(key: string, options?: Pick<CookieOptions, 'path' | 'domain'>): void;

package/dist/helpers/cookie.js

@@ -0,0 +1,23 @@
+import { isServer } from "./isServer.js";
+//#region src/helpers/cookie.ts
+var ONE_YEAR_SECONDS = 31536e3;
+function getCookie(key, cookieHeader) {
+	let source = isServer() ? cookieHeader : document.cookie;
+	if (!source) return null;
+	let cookie = source.split(";").find((c) => c.trim().startsWith(`${key}=`));
+	return cookie ? decodeURIComponent(cookie.split("=")[1]) : null;
+}
+function setCookie(key, value, options = {}) {
+	if (isServer()) return;
+	let { path = "/", domain, maxAge = ONE_YEAR_SECONDS, expires, secure, sameSite = "Lax", partitioned } = options;
+	let parts = [`${key}=${encodeURIComponent(value)}`];
+	path != null && parts.push(`path=${path}`), domain && parts.push(`domain=${domain}`), maxAge != null && parts.push(`max-age=${maxAge}`), expires && parts.push(`expires=${expires.toUTCString()}`), secure && parts.push("secure"), sameSite != null && parts.push(`SameSite=${sameSite}`), partitioned && parts.push("partitioned"), document.cookie = parts.join("; ");
+}
+function deleteCookie(key, options = {}) {
+	setCookie(key, "", {
+		...options,
+		maxAge: 0
+	});
+}
+//#endregion
+export { deleteCookie, getCookie, setCookie };

package/dist/helpers/countryCodeToUnicodeFlag.js

@@ -1 +1,10 @@
-import{truthyFilter}from"./truthyFilter.js";function countryCodeToUnicodeFlag(locale){return Array.from(locale,letter=>{let code=letter.codePointAt(0);return code?code%32+127461:void 0}).filter(truthyFilter).map(n=>String.fromCodePoint(n)).join(``)}export{countryCodeToUnicodeFlag};
+import { truthyFilter } from "./truthyFilter.js";
+//#region src/helpers/countryCodeToUnicodeFlag.ts
+function countryCodeToUnicodeFlag(locale) {
+	return Array.from(locale, (letter) => {
+		let code = letter.codePointAt(0);
+		return code ? code % 32 + 127461 : void 0;
+	}).filter(truthyFilter).map((n) => String.fromCodePoint(n)).join("");
+}
+//#endregion
+export { countryCodeToUnicodeFlag };

package/dist/helpers/debounce.js

@@ -1 +1,11 @@
-function debounce(fn,delay){let timeout;return function(...args){clearTimeout(timeout),timeout=setTimeout(()=>{fn.apply(this,args)},delay)}}export{debounce};
+//#region src/helpers/debounce.ts
+function debounce(fn, delay) {
+	let timeout;
+	return function(...args) {
+		clearTimeout(timeout), timeout = setTimeout(() => {
+			fn.apply(this, args);
+		}, delay);
+	};
+}
+//#endregion
+export { debounce };

package/dist/helpers/debounceCallback.js

@@ -1 +1,7 @@
-var timeout=null;function debounceCallback(callback,delay){timeout&&clearTimeout(timeout),timeout=setTimeout(callback,delay)}export{debounceCallback};
+//#region src/helpers/debounceCallback.ts
+var timeout = null;
+function debounceCallback(callback, delay) {
+	timeout && clearTimeout(timeout), timeout = setTimeout(callback, delay);
+}
+//#endregion
+export { debounceCallback };

package/dist/helpers/debounceId.js

@@ -1 +1,24 @@
-function debounceId(identifier,func,delay){let debouncedFunctions={};return function(...args){debouncedFunctions[identifier]||(debouncedFunctions[identifier]={timer:null,promise:null});let debounced=debouncedFunctions[identifier];return debounced.timer&&clearTimeout(debounced.timer),debounced.promise=new Promise((resolve,reject)=>{debounced.timer=setTimeout(async()=>{try{resolve(await func(...args))}catch(error){reject(error)}finally{delete debouncedFunctions[identifier]}},delay)}),debounced.promise}}export{debounceId};
+//#region src/helpers/debounceId.ts
+function debounceId(identifier, func, delay) {
+	let debouncedFunctions = {};
+	return function(...args) {
+		debouncedFunctions[identifier] || (debouncedFunctions[identifier] = {
+			timer: null,
+			promise: null
+		});
+		let debounced = debouncedFunctions[identifier];
+		return debounced.timer && clearTimeout(debounced.timer), debounced.promise = new Promise((resolve, reject) => {
+			debounced.timer = setTimeout(async () => {
+				try {
+					resolve(await func(...args));
+				} catch (error) {
+					reject(error);
+				} finally {
+					delete debouncedFunctions[identifier];
+				}
+			}, delay);
+		}), debounced.promise;
+	};
+}
+//#endregion
+export { debounceId };

package/dist/helpers/fetchLocaleIp.js

@@ -1 +1,12 @@
-async function fetchLocaleIp(){try{let{country_code}=await(await fetch(`https://ipwho.is`)).json();return country_code}catch(error){console.error(`[maz-ui](fetchLocaleIp) ${error}`);return}}export{fetchLocaleIp};
+//#region src/helpers/fetchLocaleIp.ts
+async function fetchLocaleIp() {
+	try {
+		let { country_code } = await (await fetch("https://ipwho.is")).json();
+		return country_code;
+	} catch (error) {
+		console.error(`[maz-ui](fetchLocaleIp) ${error}`);
+		return;
+	}
+}
+//#endregion
+export { fetchLocaleIp };

package/dist/helpers/formatCurrency.js

@@ -1 +1,30 @@
-var DEFAULT_OPTIONS={style:`currency`,minimumFractionDigits:2,round:!1};function getFormattedCurrency(number,locale,options){let numberToFormat=+number;return options.round&&(numberToFormat=Math.floor(numberToFormat),options.minimumFractionDigits=0),new Intl.NumberFormat(locale,options).format(numberToFormat)}function validRequiredAttributes(number,locale,options){if(number===void 0)throw TypeError("[maz-ui](FilterCurrency) The `number` attribute is required.");if(locale===void 0)throw TypeError("[maz-ui](FilterCurrency) The `locale` attribute is required.");if(typeof locale!=`string`)throw TypeError("[maz-ui](FilterCurrency) The `locale` attribute must be a string.");if(options.currency===void 0)throw TypeError("[maz-ui](FilterCurrency) The `options.currency` attribute is required.")}function formatCurrency(number,locale,options){let options_={...DEFAULT_OPTIONS,...options};validRequiredAttributes(number,locale,options_);try{return getFormattedCurrency(number,locale,options_)}catch(error){throw Error(`[maz-ui](FilterCurrency) ${error}`,{cause:error})}}export{formatCurrency};
+//#region src/helpers/formatCurrency.ts
+var DEFAULT_OPTIONS = {
+	style: "currency",
+	minimumFractionDigits: 2,
+	round: !1
+};
+function getFormattedCurrency(number, locale, options) {
+	let numberToFormat = +number;
+	return options.round && (numberToFormat = Math.floor(numberToFormat), options.minimumFractionDigits = 0), new Intl.NumberFormat(locale, options).format(numberToFormat);
+}
+function validRequiredAttributes(number, locale, options) {
+	if (number === void 0) throw TypeError("[maz-ui](FilterCurrency) The `number` attribute is required.");
+	if (locale === void 0) throw TypeError("[maz-ui](FilterCurrency) The `locale` attribute is required.");
+	if (typeof locale != "string") throw TypeError("[maz-ui](FilterCurrency) The `locale` attribute must be a string.");
+	if (options.currency === void 0) throw TypeError("[maz-ui](FilterCurrency) The `options.currency` attribute is required.");
+}
+function formatCurrency(number, locale, options) {
+	let options_ = {
+		...DEFAULT_OPTIONS,
+		...options
+	};
+	validRequiredAttributes(number, locale, options_);
+	try {
+		return getFormattedCurrency(number, locale, options_);
+	} catch (error) {
+		throw Error(`[maz-ui](FilterCurrency) ${error}`, { cause: error });
+	}
+}
+//#endregion
+export { formatCurrency };

package/dist/helpers/formatDate.js

@@ -1 +1,19 @@
-var DEFAULT_OPTIONS={month:`short`,day:`numeric`,year:`numeric`};function formatDate(date,locale,options){if(locale===void 0)throw TypeError("[maz-ui](FilterDate) The `locale` attribute is required.");if(typeof locale!=`string`)throw TypeError("[maz-ui](FilterDate) The `locale` attribute must be a string.");let opts=options??DEFAULT_OPTIONS;try{let usedDate=date instanceof Date?date:new Date(date);return new Intl.DateTimeFormat(locale,opts).format(usedDate)}catch(error){throw Error(`[maz-ui](FilterDate) ${error}`,{cause:error})}}export{formatDate};
+//#region src/helpers/formatDate.ts
+var DEFAULT_OPTIONS = {
+	month: "short",
+	day: "numeric",
+	year: "numeric"
+};
+function formatDate(date, locale, options) {
+	if (locale === void 0) throw TypeError("[maz-ui](FilterDate) The `locale` attribute is required.");
+	if (typeof locale != "string") throw TypeError("[maz-ui](FilterDate) The `locale` attribute must be a string.");
+	let opts = options ?? DEFAULT_OPTIONS;
+	try {
+		let usedDate = date instanceof Date ? date : new Date(date);
+		return new Intl.DateTimeFormat(locale, opts).format(usedDate);
+	} catch (error) {
+		throw Error(`[maz-ui](FilterDate) ${error}`, { cause: error });
+	}
+}
+//#endregion
+export { formatDate };

package/dist/helpers/formatJson.js

@@ -1 +1,6 @@
-function formatJson(json,indent=2){return JSON.stringify(json,null,indent)}export{formatJson};
+//#region src/helpers/formatJson.ts
+function formatJson(json, indent = 2) {
+	return JSON.stringify(json, null, indent);
+}
+//#endregion
+export { formatJson };

package/dist/helpers/formatNumber.js

@@ -1 +1,18 @@
-var DEFAULT_OPTIONS={minimumFractionDigits:2};function formatNumber(number,locale,options){let filterOptions={...DEFAULT_OPTIONS,...options};if(number===void 0)throw TypeError("[maz-ui](FilterNumber) The `number` attribute is required.");if(locale===void 0)throw TypeError("[maz-ui](FilterNumber) The `locale` attribute is required.");if(typeof locale!=`string`)throw TypeError("[maz-ui](FilterNumber) The `locale` attribute must be a string.");try{return new Intl.NumberFormat(locale,filterOptions).format(Number(number))}catch(error){throw Error(`[maz-ui](FilterNumber) ${error}`,{cause:error})}}export{formatNumber};
+//#region src/helpers/formatNumber.ts
+var DEFAULT_OPTIONS = { minimumFractionDigits: 2 };
+function formatNumber(number, locale, options) {
+	let filterOptions = {
+		...DEFAULT_OPTIONS,
+		...options
+	};
+	if (number === void 0) throw TypeError("[maz-ui](FilterNumber) The `number` attribute is required.");
+	if (locale === void 0) throw TypeError("[maz-ui](FilterNumber) The `locale` attribute is required.");
+	if (typeof locale != "string") throw TypeError("[maz-ui](FilterNumber) The `locale` attribute must be a string.");
+	try {
+		return new Intl.NumberFormat(locale, filterOptions).format(Number(number));
+	} catch (error) {
+		throw Error(`[maz-ui](FilterNumber) ${error}`, { cause: error });
+	}
+}
+//#endregion
+export { formatNumber };

package/dist/helpers/formatPhoneNumber.js

@@ -1 +1,9 @@
-import{parsePhoneNumberFromString}from"libphonenumber-js";function formatPhoneNumber(phoneNumber){if(!phoneNumber)throw TypeError("[maz-ui](formatPhoneNumber) The `phoneNumber` argument is required.");let parsedPhone=parsePhoneNumberFromString(phoneNumber);return parsedPhone?parsedPhone.formatInternational():phoneNumber}export{formatPhoneNumber};
+import { parsePhoneNumberFromString } from "libphonenumber-js";
+//#region src/helpers/formatPhoneNumber.ts
+function formatPhoneNumber(phoneNumber) {
+	if (!phoneNumber) throw TypeError("[maz-ui](formatPhoneNumber) The `phoneNumber` argument is required.");
+	let parsedPhone = parsePhoneNumberFromString(phoneNumber);
+	return parsedPhone ? parsedPhone.formatInternational() : phoneNumber;
+}
+//#endregion
+export { formatPhoneNumber };

package/dist/helpers/getBrowserLocale.js

@@ -1 +1,11 @@
-import{isServer}from"./isServer.js";function getBrowserLocale(){try{return isServer()?void 0:globalThis.navigator.language}catch(error){throw Error(`[MazInputPhoneNumber] (browserLocale) ${error}`,{cause:error})}}export{getBrowserLocale};
+import { isServer } from "./isServer.js";
+//#region src/helpers/getBrowserLocale.ts
+function getBrowserLocale() {
+	try {
+		return isServer() ? void 0 : globalThis.navigator.language;
+	} catch (error) {
+		throw Error(`[MazInputPhoneNumber] (browserLocale) ${error}`, { cause: error });
+	}
+}
+//#endregion
+export { getBrowserLocale };

package/dist/helpers/getCountryFlagUrl.js

@@ -1 +1,8 @@
-var _supportedCodes=`ad.ae.af.ag.ai.al.am.ao.aq.ar.as.at.au.aw.ax.az.ba.bb.bd.be.bf.bg.bh.bi.bj.bl.bm.bn.bo.bq.br.bs.bt.bv.bw.by.bz.ca.cc.cd.cf.cg.ch.ci.ck.cl.cm.cn.co.cr.cu.cv.cw.cx.cy.cz.de.dj.dk.dm.do.dz.ec.ee.eg.eh.er.es.et.eu.fi.fj.fk.fm.fo.fr.ga.gb.gb-eng.gb-nir.gb-sct.gb-wls.gd.ge.gf.gg.gh.gi.gl.gm.gn.gp.gq.gr.gs.gt.gu.gw.gy.hk.hm.hn.hr.ht.hu.id.ie.il.im.in.io.iq.ir.is.it.je.jm.jo.jp.ke.kg.kh.ki.km.kn.kp.kr.kw.ky.kz.la.lb.lc.li.lk.lr.ls.lt.lu.lv.ly.ma.mc.md.me.mf.mg.mh.mk.ml.mm.mn.mo.mp.mq.mr.ms.mt.mu.mv.mw.mx.my.mz.na.nc.ne.nf.ng.ni.nl.no.np.nr.nu.nz.om.pa.pe.pf.pg.ph.pk.pl.pm.pn.pr.ps.pt.pw.py.qa.re.ro.rs.ru.rw.sa.sb.sc.sd.se.sg.sh.si.sj.sk.sl.sm.sn.so.sr.ss.st.sv.sx.sy.sz.tc.td.tf.tg.th.tj.tk.tl.tm.tn.to.tr.tt.tv.tw.tz.ua.ug.um.un.us.us-ak.us-al.us-ar.us-az.us-ca.us-co.us-ct.us-de.us-fl.us-ga.us-hi.us-ia.us-id.us-il.us-in.us-ks.us-ky.us-la.us-ma.us-md.us-me.us-mi.us-mn.us-mo.us-ms.us-mt.us-nc.us-nd.us-ne.us-nh.us-nj.us-nm.us-nv.us-ny.us-oh.us-ok.us-or.us-pa.us-ri.us-sc.us-sd.us-tn.us-tx.us-ut.us-va.us-vt.us-wa.us-wi.us-wv.us-wy.uy.uz.va.vc.ve.vg.vi.vn.vu.wf.ws.xk.ye.yt.za.zm.zw`.split(`.`);function getCountryFlagUrl(countryIsoCode,size){let code=countryIsoCode.toLowerCase();if(_supportedCodes.includes(code))return size?`https://flagcdn.com/${size}/${code}.png`:`https://flagcdn.com/${code}.svg`}export{getCountryFlagUrl};
+//#region src/helpers/getCountryFlagUrl.ts
+var _supportedCodes = /* @__PURE__ */ "ad.ae.af.ag.ai.al.am.ao.aq.ar.as.at.au.aw.ax.az.ba.bb.bd.be.bf.bg.bh.bi.bj.bl.bm.bn.bo.bq.br.bs.bt.bv.bw.by.bz.ca.cc.cd.cf.cg.ch.ci.ck.cl.cm.cn.co.cr.cu.cv.cw.cx.cy.cz.de.dj.dk.dm.do.dz.ec.ee.eg.eh.er.es.et.eu.fi.fj.fk.fm.fo.fr.ga.gb.gb-eng.gb-nir.gb-sct.gb-wls.gd.ge.gf.gg.gh.gi.gl.gm.gn.gp.gq.gr.gs.gt.gu.gw.gy.hk.hm.hn.hr.ht.hu.id.ie.il.im.in.io.iq.ir.is.it.je.jm.jo.jp.ke.kg.kh.ki.km.kn.kp.kr.kw.ky.kz.la.lb.lc.li.lk.lr.ls.lt.lu.lv.ly.ma.mc.md.me.mf.mg.mh.mk.ml.mm.mn.mo.mp.mq.mr.ms.mt.mu.mv.mw.mx.my.mz.na.nc.ne.nf.ng.ni.nl.no.np.nr.nu.nz.om.pa.pe.pf.pg.ph.pk.pl.pm.pn.pr.ps.pt.pw.py.qa.re.ro.rs.ru.rw.sa.sb.sc.sd.se.sg.sh.si.sj.sk.sl.sm.sn.so.sr.ss.st.sv.sx.sy.sz.tc.td.tf.tg.th.tj.tk.tl.tm.tn.to.tr.tt.tv.tw.tz.ua.ug.um.un.us.us-ak.us-al.us-ar.us-az.us-ca.us-co.us-ct.us-de.us-fl.us-ga.us-hi.us-ia.us-id.us-il.us-in.us-ks.us-ky.us-la.us-ma.us-md.us-me.us-mi.us-mn.us-mo.us-ms.us-mt.us-nc.us-nd.us-ne.us-nh.us-nj.us-nm.us-nv.us-ny.us-oh.us-ok.us-or.us-pa.us-ri.us-sc.us-sd.us-tn.us-tx.us-ut.us-va.us-vt.us-wa.us-wi.us-wv.us-wy.uy.uz.va.vc.ve.vg.vi.vn.vu.wf.ws.xk.ye.yt.za.zm.zw".split(".");
+function getCountryFlagUrl(countryIsoCode, size) {
+	let code = countryIsoCode.toLowerCase();
+	if (_supportedCodes.includes(code)) return size ? `https://flagcdn.com/${size}/${code}.png` : `https://flagcdn.com/${code}.svg`;
+}
+//#endregion
+export { getCountryFlagUrl };

package/dist/helpers/getErrorMessage.js

@@ -1 +1,6 @@
-function getErrorMessage(error){return error instanceof Error?error.message:typeof error==`string`?error:error&&typeof error==`object`&&`message`in error?String(error.message):error?String(error):`An unexpected error occurred`}export{getErrorMessage};
+//#region src/helpers/getErrorMessage.ts
+function getErrorMessage(error) {
+	return error instanceof Error ? error.message : typeof error == "string" ? error : error && typeof error == "object" && "message" in error ? String(error.message) : error ? String(error) : "An unexpected error occurred";
+}
+//#endregion
+export { getErrorMessage };

package/dist/helpers/idleTimeout.js

@@ -1 +1,121 @@
-import{isClient}from"./isClient.js";var IdleTimeout=class{defaultOptions={element:void 0,timeout:60*1e3*5,once:!1,immediate:!0};options;timeoutHandler;isIdle=!1;isDestroy=!1;startTime=0;remainingTime=0;lastClientX=-1;lastClientY=-1;eventNames=[`DOMMouseScroll`,`mousedown`,`mousemove`,`mousewheel`,`MSPointerDown`,`MSPointerMove`,`keydown`,`touchmove`,`touchstart`,`wheel`,`click`];constructor(callback,options){this.callback=callback,this.options={...this.defaultOptions,...options},isClient()&&this.start()}get element(){return this.options.element??document.body}start(){if(!isClient()){console.warn(`[IdleTimeout](start) you should run this method on client side`);return}for(let eventName of this.eventNames)this.element.addEventListener(eventName,this.handleEvent);this.resetTimeout(),this.options.immediate&&this.callback({isIdle:!1,instance:this})}pause(){let remainingTime=this.startTime+this.options.timeout-Date.now();remainingTime<=0||(this.remainingTime=remainingTime,this.timeoutHandler&&=(clearTimeout(this.timeoutHandler),void 0))}resume(){this.remainingTime<=0||(this.resetTimeout(),this.callback({isIdle:this.isIdle,instance:this}),this.remainingTime=0)}reset(){this.isDestroy=!1,this.isIdle=!1,this.remainingTime=0,this.resetTimeout(),this.callback({isIdle:this.isIdle,instance:this})}destroy(){if(!isClient()){console.warn(`[IdleTimeout](destroy) you should run this method on client side`);return}this.isDestroy=!0;for(let eventName of this.eventNames)this.element.removeEventListener(eventName,this.handleEvent);this.timeoutHandler&&clearTimeout(this.timeoutHandler)}resetTimeout(){this.isIdle=!1,this.timeoutHandler&&=(clearTimeout(this.timeoutHandler),void 0),this.timeoutHandler=setTimeout(this.handleTimeout.bind(this),this.remainingTime||this.options.timeout),this.startTime=Date.now()}handleEvent=event=>{try{if(this.remainingTime>0)return;if(event.type===`mousemove`){let{clientX,clientY}=event;if(clientX===void 0&&clientY===void 0||clientX===this.lastClientX&&clientY===this.lastClientY)return;this.lastClientX=clientX,this.lastClientY=clientY}this.resetTimeout(),this.callback({isIdle:this.isIdle,eventType:event.type,instance:this})}catch(error){throw Error(`[IdleTimeout](handleEvent) ${error}`,{cause:error})}};handleTimeout(){this.isIdle=!0,this.callback({isIdle:this.isIdle,instance:this}),this.options.once&&this.destroy()}get destroyed(){return this.isDestroy}get timeout(){return this.options.timeout}set timeout(value){this.options.timeout=value}get idle(){return this.isIdle}set idle(value){value?this.handleTimeout():this.reset(),this.callback({isIdle:this.isIdle,instance:this})}};export{IdleTimeout};
+import { isClient } from "./isClient.js";
+//#region src/helpers/idleTimeout.ts
+var IdleTimeout = class {
+	callback;
+	defaultOptions = {
+		element: void 0,
+		timeout: 3e5,
+		once: !1,
+		immediate: !0
+	};
+	options;
+	timeoutHandler;
+	isIdle = !1;
+	isDestroy = !1;
+	startTime = 0;
+	remainingTime = 0;
+	lastClientX = -1;
+	lastClientY = -1;
+	eventNames = [
+		"DOMMouseScroll",
+		"mousedown",
+		"mousemove",
+		"mousewheel",
+		"MSPointerDown",
+		"MSPointerMove",
+		"keydown",
+		"touchmove",
+		"touchstart",
+		"wheel",
+		"click"
+	];
+	constructor(callback, options) {
+		this.callback = callback, this.options = {
+			...this.defaultOptions,
+			...options
+		}, isClient() && this.start();
+	}
+	get element() {
+		return this.options.element ?? document.body;
+	}
+	start() {
+		if (!isClient()) console.warn("[IdleTimeout](start) you should run this method on client side");
+		else {
+			for (let eventName of this.eventNames) this.element.addEventListener(eventName, this.handleEvent);
+			this.resetTimeout(), this.options.immediate && this.callback({
+				isIdle: !1,
+				instance: this
+			});
+		}
+	}
+	pause() {
+		let remainingTime = this.startTime + this.options.timeout - Date.now();
+		remainingTime <= 0 || (this.remainingTime = remainingTime, this.timeoutHandler &&= (clearTimeout(this.timeoutHandler), void 0));
+	}
+	resume() {
+		this.remainingTime <= 0 || (this.resetTimeout(), this.callback({
+			isIdle: this.isIdle,
+			instance: this
+		}), this.remainingTime = 0);
+	}
+	reset() {
+		this.isDestroy = !1, this.isIdle = !1, this.remainingTime = 0, this.resetTimeout(), this.callback({
+			isIdle: this.isIdle,
+			instance: this
+		});
+	}
+	destroy() {
+		if (!isClient()) console.warn("[IdleTimeout](destroy) you should run this method on client side");
+		else {
+			this.isDestroy = !0;
+			for (let eventName of this.eventNames) this.element.removeEventListener(eventName, this.handleEvent);
+			this.timeoutHandler && clearTimeout(this.timeoutHandler);
+		}
+	}
+	resetTimeout() {
+		this.isIdle = !1, this.timeoutHandler &&= (clearTimeout(this.timeoutHandler), void 0), this.timeoutHandler = setTimeout(this.handleTimeout.bind(this), this.remainingTime || this.options.timeout), this.startTime = Date.now();
+	}
+	handleEvent = (event) => {
+		try {
+			if (this.remainingTime > 0) return;
+			if (event.type === "mousemove") {
+				let { clientX, clientY } = event;
+				if (clientX === void 0 && clientY === void 0 || clientX === this.lastClientX && clientY === this.lastClientY) return;
+				this.lastClientX = clientX, this.lastClientY = clientY;
+			}
+			this.resetTimeout(), this.callback({
+				isIdle: this.isIdle,
+				eventType: event.type,
+				instance: this
+			});
+		} catch (error) {
+			throw Error(`[IdleTimeout](handleEvent) ${error}`, { cause: error });
+		}
+	};
+	handleTimeout() {
+		this.isIdle = !0, this.callback({
+			isIdle: this.isIdle,
+			instance: this
+		}), this.options.once && this.destroy();
+	}
+	get destroyed() {
+		return this.isDestroy;
+	}
+	get timeout() {
+		return this.options.timeout;
+	}
+	set timeout(value) {
+		this.options.timeout = value;
+	}
+	get idle() {
+		return this.isIdle;
+	}
+	set idle(value) {
+		value ? this.handleTimeout() : this.reset(), this.callback({
+			isIdle: this.isIdle,
+			instance: this
+		});
+	}
+};
+//#endregion
+export { IdleTimeout };

package/dist/helpers/index.d.ts

@@ -1,24 +1,30 @@
 export * from './camelCase';
 export * from './capitalize';
 export * from './checkAvailability';
+export * from './cookie';
 export * from './countryCodeToUnicodeFlag';
 export * from './debounce';
 export * from './debounceCallback';
 export * from './debounceId';
+export * from './fetchLocaleIp';
 export * from './formatCurrency';
 export * from './formatDate';
 export * from './formatJson';
 export * from './formatNumber';
+export * from './formatPhoneNumber';
+export * from './getBrowserLocale';
 export * from './getCountryFlagUrl';
 export * from './getErrorMessage';
 export * from './idleTimeout';
 export * from './isClient';
 export * from './isEqual';
+export * from './isIos';
 export * from './isServer';
 export * from './isStandaloneMode';
 export * from './kebabCase';
 export * from './normalizeString';
 export * from './pascalCase';
+export * from './preventIosInputZoom';
 export * from './scriptLoader';
 export * from './sleep';
 export * from './snakeCase';

package/dist/helpers/index.js

@@ -1 +1,38 @@
-import{camelCase}from"./camelCase.js";import{capitalize}from"./capitalize.js";import{checkAvailability}from"./checkAvailability.js";import{truthyFilter}from"./truthyFilter.js";import{countryCodeToUnicodeFlag}from"./countryCodeToUnicodeFlag.js";import{debounce}from"./debounce.js";import{debounceCallback}from"./debounceCallback.js";import{debounceId}from"./debounceId.js";import{formatCurrency}from"./formatCurrency.js";import{formatDate}from"./formatDate.js";import{formatJson}from"./formatJson.js";import{formatNumber}from"./formatNumber.js";import{getCountryFlagUrl}from"./getCountryFlagUrl.js";import{getErrorMessage}from"./getErrorMessage.js";import{isClient}from"./isClient.js";import{IdleTimeout}from"./idleTimeout.js";import{isEqual}from"./isEqual.js";import{isServer}from"./isServer.js";import{isStandaloneMode}from"./isStandaloneMode.js";import{kebabCase}from"./kebabCase.js";import{pascalCase}from"./pascalCase.js";import{snakeCase}from"./snakeCase.js";import{normalizeString}from"./normalizeString.js";import{ScriptLoader}from"./scriptLoader.js";import{sleep}from"./sleep.js";import{Swipe}from"./swipeHandler.js";import{TextareaAutogrow}from"./TextareaAutogrow.js";import{throttle}from"./throttle.js";import{throttleId}from"./throttleId.js";import{upperFirst}from"./upperFirst.js";import{UserVisibility}from"./userVisibility.js";export{IdleTimeout,ScriptLoader,Swipe,TextareaAutogrow,UserVisibility,camelCase,capitalize,checkAvailability,countryCodeToUnicodeFlag,debounce,debounceCallback,debounceId,formatCurrency,formatDate,formatJson,formatNumber,getCountryFlagUrl,getErrorMessage,isClient,isEqual,isServer,isStandaloneMode,kebabCase,normalizeString,pascalCase,sleep,snakeCase,throttle,throttleId,truthyFilter,upperFirst};
+import { camelCase } from "./camelCase.js";
+import { capitalize } from "./capitalize.js";
+import { checkAvailability } from "./checkAvailability.js";
+import { isServer } from "./isServer.js";
+import { deleteCookie, getCookie, setCookie } from "./cookie.js";
+import { truthyFilter } from "./truthyFilter.js";
+import { countryCodeToUnicodeFlag } from "./countryCodeToUnicodeFlag.js";
+import { debounce } from "./debounce.js";
+import { debounceCallback } from "./debounceCallback.js";
+import { debounceId } from "./debounceId.js";
+import { fetchLocaleIp } from "./fetchLocaleIp.js";
+import { formatCurrency } from "./formatCurrency.js";
+import { formatDate } from "./formatDate.js";
+import { formatJson } from "./formatJson.js";
+import { formatNumber } from "./formatNumber.js";
+import { formatPhoneNumber } from "./formatPhoneNumber.js";
+import { getBrowserLocale } from "./getBrowserLocale.js";
+import { getCountryFlagUrl } from "./getCountryFlagUrl.js";
+import { getErrorMessage } from "./getErrorMessage.js";
+import { isClient } from "./isClient.js";
+import { IdleTimeout } from "./idleTimeout.js";
+import { isEqual } from "./isEqual.js";
+import { isIos } from "./isIos.js";
+import { isStandaloneMode } from "./isStandaloneMode.js";
+import { kebabCase } from "./kebabCase.js";
+import { pascalCase } from "./pascalCase.js";
+import { snakeCase } from "./snakeCase.js";
+import { normalizeString } from "./normalizeString.js";
+import { addViewportMaximumScale, preventIosInputZoom } from "./preventIosInputZoom.js";
+import { ScriptLoader } from "./scriptLoader.js";
+import { sleep } from "./sleep.js";
+import { Swipe } from "./swipeHandler.js";
+import { TextareaAutogrow } from "./TextareaAutogrow.js";
+import { throttle } from "./throttle.js";
+import { throttleId } from "./throttleId.js";
+import { upperFirst } from "./upperFirst.js";
+import { UserVisibility } from "./userVisibility.js";
+export { IdleTimeout, ScriptLoader, Swipe, TextareaAutogrow, UserVisibility, addViewportMaximumScale, camelCase, capitalize, checkAvailability, countryCodeToUnicodeFlag, debounce, debounceCallback, debounceId, deleteCookie, fetchLocaleIp, formatCurrency, formatDate, formatJson, formatNumber, formatPhoneNumber, getBrowserLocale, getCookie, getCountryFlagUrl, getErrorMessage, isClient, isEqual, isIos, isServer, isStandaloneMode, kebabCase, normalizeString, pascalCase, preventIosInputZoom, setCookie, sleep, snakeCase, throttle, throttleId, truthyFilter, upperFirst };

package/dist/helpers/isClient.js

@@ -1 +1,6 @@
-function isClient(){return typeof document<`u`}export{isClient};
+//#region src/helpers/isClient.ts
+function isClient() {
+	return typeof document < "u";
+}
+//#endregion
+export { isClient };

package/dist/helpers/isEqual.js

@@ -1 +1,21 @@
-function isPrimitive(value){return value==null||typeof value==`string`||typeof value==`number`||typeof value==`boolean`||typeof value==`symbol`||typeof value==`bigint`}function isEqualArrays(a,b){if(a.length!==b.length)return!1;for(let[i,element]of a.entries())if(!isEqual(element,b[i]))return!1;return!0}function isEqualObjects(a,b){let keysA=Object.keys(a);let keysB=Object.keys(b);if(keysA.length!==keysB.length)return!1;for(let key of keysA)if(!keysB.includes(key)||!isEqual(a[key],b[key]))return!1;return!0}function isEqual(a,b){return isPrimitive(a)||isPrimitive(b)?a===b:a instanceof Date&&b instanceof Date?a.getTime()===b.getTime():typeof a!=typeof b||Array.isArray(a)!==Array.isArray(b)?!1:Array.isArray(a)&&Array.isArray(b)?isEqualArrays(a,b):typeof a==`object`&&typeof b==`object`?isEqualObjects(a,b):!1}export{isEqual};
+//#region src/helpers/isEqual.ts
+function isPrimitive(value) {
+	return value == null || typeof value == "string" || typeof value == "number" || typeof value == "boolean" || typeof value == "symbol" || typeof value == "bigint";
+}
+function isEqualArrays(a, b) {
+	if (a.length !== b.length) return !1;
+	for (let [i, element] of a.entries()) if (!isEqual(element, b[i])) return !1;
+	return !0;
+}
+function isEqualObjects(a, b) {
+	let keysA = Object.keys(a);
+	let keysB = Object.keys(b);
+	if (keysA.length !== keysB.length) return !1;
+	for (let key of keysA) if (!keysB.includes(key) || !isEqual(a[key], b[key])) return !1;
+	return !0;
+}
+function isEqual(a, b) {
+	return isPrimitive(a) || isPrimitive(b) ? a === b : a instanceof Date && b instanceof Date ? a.getTime() === b.getTime() : typeof a != typeof b || Array.isArray(a) !== Array.isArray(b) ? !1 : Array.isArray(a) && Array.isArray(b) ? isEqualArrays(a, b) : typeof a == "object" && typeof b == "object" && isEqualObjects(a, b);
+}
+//#endregion
+export { isEqual };

package/dist/helpers/isIos.d.ts

@@ -0,0 +1 @@
+export declare function isIos(): boolean;

package/dist/helpers/isIos.js

@@ -0,0 +1,9 @@
+import { isClient } from "./isClient.js";
+//#region src/helpers/isIos.ts
+function isIos() {
+	if (!isClient()) return !1;
+	let userAgent = navigator.userAgent;
+	return /iPhone|iPad|iPod/.test(userAgent) || /Macintosh/.test(userAgent) && navigator.maxTouchPoints > 1;
+}
+//#endregion
+export { isIos };

package/dist/helpers/isServer.js

@@ -1 +1,6 @@
-function isServer(){return typeof document>`u`||globalThis.window===void 0}export{isServer};
+//#region src/helpers/isServer.ts
+function isServer() {
+	return typeof document > "u" || globalThis.window === void 0;
+}
+//#endregion
+export { isServer };

package/dist/helpers/isStandaloneMode.js

@@ -1 +1,10 @@
-import{isClient}from"./isClient.js";function isStandaloneMode(){if(!isClient())return!1;let nav=navigator;let isStandalone=globalThis.matchMedia(`(display-mode: standalone)`).matches;return nav.standalone||isStandalone}export{isStandaloneMode};
+import { isClient } from "./isClient.js";
+//#region src/helpers/isStandaloneMode.ts
+function isStandaloneMode() {
+	if (!isClient()) return !1;
+	let nav = navigator;
+	let isStandalone = globalThis.matchMedia("(display-mode: standalone)").matches;
+	return nav.standalone || isStandalone;
+}
+//#endregion
+export { isStandaloneMode };

package/dist/helpers/kebabCase.js

@@ -1 +1,6 @@
-function kebabCase(str){return str.replace(/([a-z])([A-Z])/g,`$1-$2`).replace(/([A-Z])([A-Z][a-z])/g,`$1-$2`).replace(/[\s_]+/g,`-`).toLowerCase().replace(/-+/g,`-`).replace(/(^-)|(-$)/g,``)}export{kebabCase};
+//#region src/helpers/kebabCase.ts
+function kebabCase(str) {
+	return str.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/([A-Z])([A-Z][a-z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase().replace(/-+/g, "-").replace(/(^-)|(-$)/g, "");
+}
+//#endregion
+export { kebabCase };