x-essential-lib 0.11.7 → 0.11.9

package/dist/{i18n-en.b05zxa4b.js → i18n-en.j7vfghgh.js}

@@ -193,7 +193,7 @@ var en_default = {
 	$vuetify,
 	"x-essential-lib": {
 		dlg: {
-			ask: "Do you want {verb} {object} '{name}' ?",
+			ask: "Do you want {verb} {object} '{name}'?",
 			cancel: "Cancel",
 			ok: "OK",
 			responding: "Responding..."

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { n as EventType, t as Emitter } from "./vendor.gz9a1xde.js";
+import { n as EventType, t as Emitter } from "./vendor.fpmj8dgj.js";
 import { Ref } from "vue";
-import { LocaleInstance, VuetifyOptions } from "vuetify";
+import { VuetifyOptions } from "vuetify";
 import { AxiosInstance } from "axios";
 //#region src/composables/color.d.ts
 export declare function useColor(): {
@@ -142,7 +142,7 @@ export declare function popView(views: Ref<string[]>): void;
 export declare function clearViews(views: Ref<string[]>): void;
 //#endregion
 //#region src/logic/vuetify/index.d.ts
-export declare function createVuetifyOptions(prod: boolean, localeAdapter: LocaleInstance): VuetifyOptions;
+export declare const baseVuetifyOptions: VuetifyOptions;
 //#endregion
 //#region src/composables/globalStates.d.ts
 export interface GlobalStates {
@@ -174,11 +174,19 @@ export declare function usePermission(): {
 };
 //#endregion
 //#region src/composables/system.d.ts
+declare global {
+  interface Navigator {
+    Backbutton?: {
+      goHome: (p1: () => void, p2: () => void) => void;
+    };
+  }
+}
 export declare function useSystem(): {
-  sysBarAvail: import("vue").ComputedRef<boolean>;
-  compactWidth: import("vue").ComputedRef<string>;
-  isCurvedScreen: import("vue").ComputedRef<boolean>;
   isMobile: () => boolean;
+  compactWidth: import("vue").ComputedRef<string>;
+  minimizeApp: () => Promise<void>;
+  insetTop: import("vue").Ref<number, number>;
+  insetBottom: import("vue").Ref<number, number>;
   nameList: (entries: string[], instances?: string[]) => string;
   sentenceOfAsk: (verb: string, object: string, name: string) => string;
 };

package/dist/index.js

@@ -1,14 +1,12 @@
 (function(){try{document.getElementById(`x-essential-lib`)?.remove();const e = document.createElement(`style`);e.setAttribute(`id`, `x-essential-lib`);const t = document.createTextNode(`.fade-leave-active[data-v-x-essential-lib-c3545c8d]{transition:opacity .5s}.fade-leave-to[data-v-x-essential-lib-c3545c8d]{opacity:0}.x-cont[data-v-x-essential-lib-c3545c8d]{justify-content:center;align-items:center;display:flex;position:absolute;inset:0}.lds-spinner[data-v-x-essential-lib-c3545c8d]{color:official;width:40px;height:40px;display:inline-block;position:relative}.lds-spinner div[data-v-x-essential-lib-c3545c8d]{transform-origin:20px 20px;animation:1.2s linear infinite lds-spinner-x-essential-lib-c3545c8d}.lds-spinner div[data-v-x-essential-lib-c3545c8d]:after{content:" ";background:#9e9e9e;border-radius:5%;width:2px;height:6px;display:block;position:absolute;top:3px;left:18px}.lds-spinner div[data-v-x-essential-lib-c3545c8d]:first-child{animation-delay:-1.1s;transform:rotate(0)}.lds-spinner div[data-v-x-essential-lib-c3545c8d]:nth-child(2){animation-delay:-1s;transform:rotate(30deg)}.lds-spinner div[data-v-x-essential-lib-c3545c8d]:nth-child(3){animation-delay:-.9s;transform:rotate(60deg)}.lds-spinner div[data-v-x-essential-lib-c3545c8d]:nth-child(4){animation-delay:-.8s;transform:rotate(90deg)}.lds-spinner div[data-v-x-essential-lib-c3545c8d]:nth-child(5){animation-delay:-.7s;transform:rotate(120deg)}.lds-spinner div[data-v-x-essential-lib-c3545c8d]:nth-child(6){animation-delay:-.6s;transform:rotate(150deg)}.lds-spinner div[data-v-x-essential-lib-c3545c8d]:nth-child(7){animation-delay:-.5s;transform:rotate(180deg)}.lds-spinner div[data-v-x-essential-lib-c3545c8d]:nth-child(8){animation-delay:-.4s;transform:rotate(210deg)}.lds-spinner div[data-v-x-essential-lib-c3545c8d]:nth-child(9){animation-delay:-.3s;transform:rotate(240deg)}.lds-spinner div[data-v-x-essential-lib-c3545c8d]:nth-child(10){animation-delay:-.2s;transform:rotate(270deg)}.lds-spinner div[data-v-x-essential-lib-c3545c8d]:nth-child(11){animation-delay:-.1s;transform:rotate(300deg)}.lds-spinner div[data-v-x-essential-lib-c3545c8d]:nth-child(12){animation-delay:0s;transform:rotate(330deg)}@keyframes lds-spinner-x-essential-lib-c3545c8d{0%{opacity:1}to{opacity:0}}.x-item[data-v-x-essential-lib-cfcda9d9]{width:600px}@media (width<=600px){.x-item[data-v-x-essential-lib-cfcda9d9]{width:calc(100vw - 16px)}}.x-cont[data-v-x-essential-lib-b973907d]{z-index:9999;position:fixed;bottom:50px;left:50%;transform:translate(-50%)}`);e.appendChild(t);document.head.appendChild(e);}catch(e){console.error('rolldown-plugin-inject-css', e);}})()
-import { a as email$1, c as mitt_default, i as custom, l as usePreferredDark, o as string, r as toLower, s as api } from "./vendor.gz9a1xde.js";
-import { Fragment, Transition, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, inject, isRef, normalizeStyle, onBeforeMount, onBeforeUnmount, onMounted, openBlock, provide, ref, renderList, resolveComponent, toDisplayString, unref, useTemplateRef, watch, watchEffect, withCtx, withKeys, withModifiers } from "vue";
+import { a as custom, c as api, i as debounce, l as mitt_default, o as email$1, r as toLower, s as string, u as usePreferredDark } from "./vendor.fpmj8dgj.js";
+import { Fragment, Transition, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, inject, isRef, normalizeStyle, onBeforeMount, onBeforeUnmount, onMounted, onUnmounted, openBlock, provide, ref, renderList, resolveComponent, toDisplayString, unref, useTemplateRef, watch, watchEffect, withCtx, withKeys, withModifiers } from "vue";
 import { useI18n } from "vue-i18n";
 import { useDisplay, useTheme } from "vuetify";
 import axios from "axios";
 import { globalObjects as globalObjects$1 } from "x-essential-lib";
-import * as components from "vuetify/components";
-import * as directives from "vuetify/directives";
-import * as labsComponents from "vuetify/labs/components";
 import { useRoute, useRouter } from "vue-router";
+import { invoke } from "@tauri-apps/api/core";
 
 //#region src/composables/color.ts
 function useColor() {
@@ -611,28 +609,16 @@ function clearViews(views) {
 
 //#endregion
 //#region src/logic/vuetify/index.ts
-function createVuetifyOptions(prod, localeAdapter) {
-	const dynamicOptions = {};
-	if (!prod) {
-		dynamicOptions["components"] = {
-			...components,
-			...labsComponents
-		};
-		dynamicOptions["directives"] = directives;
-	}
-	return {
-		...dynamicOptions,
-		locale: { adapter: localeAdapter },
-		defaults: {
-			VDataTable: { hover: true },
-			VDataTableServer: { hover: true },
-			VDataTableVirtual: { hover: true },
-			VDialog: { captureFocus: false },
-			VNavigationDrawer: { disableRouteWatcher: true }
-		},
-		icons: { defaultSet: "mdi" }
-	};
-}
+const baseVuetifyOptions = {
+	defaults: {
+		VDataTable: { hover: true },
+		VDataTableServer: { hover: true },
+		VDataTableVirtual: { hover: true },
+		VDialog: { captureFocus: false },
+		VNavigationDrawer: { disableRouteWatcher: true }
+	},
+	icons: { defaultSet: "mdi" }
+};
 
 //#endregion
 //#region src/composables/globalStates.ts
@@ -704,11 +690,84 @@ function useGlobalStates(globalStates, base) {
 	});
 }
 
+//#endregion
+//#region src/composables/system.ts
+function useSystem() {
+	const { locale, t } = useI18n();
+	const display = useDisplay();
+	function isMobile() {
+		return /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent);
+	}
+	const compactWidth = computed(() => {
+		if (display.width.value <= 1280) return display.width.value + "px";
+		else if (display.width.value <= 1920) return "768px";
+		else return "1024px";
+	});
+	async function minimizeApp() {
+		navigator.Backbutton?.goHome(() => {}, () => {});
+		invoke("goHome");
+	}
+	const insetTop = ref(0);
+	const insetBottom = ref(0);
+	function getSafeAreaVar(name) {
+		const str = getComputedStyle(document.documentElement).getPropertyValue(name).trim();
+		return parseFloat(str) || 0;
+	}
+	function syncSafeArea() {
+		insetTop.value = getSafeAreaVar("--safe-top");
+		insetBottom.value = getSafeAreaVar("--safe-bottom");
+	}
+	const handleResize = debounce(() => {
+		syncSafeArea();
+	}, 250);
+	function onResize() {
+		handleResize();
+	}
+	onMounted(() => {
+		window.addEventListener("resize", onResize);
+		syncSafeArea();
+	});
+	onUnmounted(() => {
+		window.removeEventListener("resize", onResize);
+		handleResize.cancel();
+	});
+	function nameList(entries, instances) {
+		let name;
+		const names = entries.map((entry) => t(entry));
+		if (instances) name = `${names.join("/")} <${instances.join("/")}>`;
+		else if (locale.value === "en") name = names.join(" ");
+		else name = names.join("");
+		return name;
+	}
+	function sentenceOfAsk(verb, object, name) {
+		if (locale.value === "en") return t("x-essential-lib.dlg.ask", {
+			verb: toLower(t(verb)),
+			object: toLower(t(object)),
+			name
+		});
+		else return t("x-essential-lib.dlg.ask", {
+			verb: t(verb),
+			object: t(object),
+			name
+		});
+	}
+	return {
+		isMobile,
+		compactWidth,
+		minimizeApp,
+		insetTop,
+		insetBottom,
+		nameList,
+		sentenceOfAsk
+	};
+}
+
 //#endregion
 //#region src/composables/microApp.ts
 function useMicroApp(globalStates, customBack) {
 	const route = useRoute();
 	const router = useRouter();
+	const { minimizeApp } = useSystem();
 	useGlobalStates(globalStates);
 	const { activeOrg, views } = globalStates;
 	async function handleBack() {
@@ -718,7 +777,7 @@ function useMicroApp(globalStates, customBack) {
 		}
 		const routeMeta = matchRouteMeta(route.path);
 		if (!routeMeta) return;
-		if (routeMeta.level === 0) navigator?.Backbutton?.goHome(() => {}, () => {});
+		if (routeMeta.level === 0) minimizeApp();
 		else if (customBack) customBack(routeMeta);
 		else {
 			let back;
@@ -816,55 +875,6 @@ function usePermission() {
 	return { verifyPermission: verifyPermission$1 };
 }
 
-//#endregion
-//#region src/composables/system.ts
-function useSystem() {
-	const { locale, t } = useI18n();
-	const sysBarAvail = computed(() => {
-		return !!window.cordova;
-	});
-	const display = useDisplay();
-	const compactWidth = computed(() => {
-		if (display.width.value <= 1280) return display.width.value + "px";
-		else if (display.width.value <= 1920) return "768px";
-		else return "1024px";
-	});
-	const isCurvedScreen = computed(() => {
-		return false;
-	});
-	function isMobile() {
-		return /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent);
-	}
-	function nameList(entries, instances) {
-		let name;
-		const names = entries.map((entry) => t(entry));
-		if (instances) name = `${names.join("/")} <${instances.join("/")}>`;
-		else if (locale.value === "en") name = names.join(" ");
-		else name = names.join("");
-		return name;
-	}
-	function sentenceOfAsk(verb, object, name) {
-		if (locale.value === "en") return t("x-essential-lib.dlg.ask", {
-			verb: toLower(t(verb)),
-			object: toLower(t(object)),
-			name
-		});
-		else return t("x-essential-lib.dlg.ask", {
-			verb: t(verb),
-			object: t(object),
-			name
-		});
-	}
-	return {
-		sysBarAvail,
-		compactWidth,
-		isCurvedScreen,
-		isMobile,
-		nameList,
-		sentenceOfAsk
-	};
-}
-
 //#endregion
 //#region src/composables/viewStack.ts
 function useViewStack(name, openHook, closeHook) {
@@ -1570,7 +1580,7 @@ const install = (app) => {
 //#endregion
 //#region src/i18n/index.ts
 async function loadLocaleMessageEssential(locale) {
-	if (locale === "en") return (await import("./i18n-en.b05zxa4b.js").then((n) => n.t)).default;
+	if (locale === "en") return (await import("./i18n-en.j7vfghgh.js").then((n) => n.t)).default;
 	else if (locale === "zhHans") return (await import("./i18n-zhHans.bl5d1n9h.js").then((n) => n.t)).default;
 	else throw new Error(`invalid locale=${locale}`);
 }
@@ -1580,4 +1590,4 @@ async function loadLocaleMessageEssential(locale) {
 var src_default = { install };
 
 //#endregion
-export { addView, clearViews, closeWaitDlg, createAxios, createVuetifyOptions, src_default as default, delView, email, eventBus, getErrorMessage, getTypeColor, getTypeDefault, globalObjects, hasView, injectDark, injectLocale, injectPermissionObjects, injectViews, isEmpty, isExist, lastView, length, loadLocaleMessageEssential, matchRouteMeta, maxLength, messageError, messageInfo, messageSuccess, messageWarning, minLength, onBeforeEnter, openConfirmDlg, openNumberDlg, openPromptDlg, openWaitDlg, popView, provideDark, provideLocale, providePermissionObjects, provideViews, required, routeTransName, toPermissionObjects, types, useColor, useGlobalStates, useMicroApp, usePageRoute, usePermission, useSystem, useViewStack, verifyPermission, waitMs, waitUtil };
+export { addView, baseVuetifyOptions, clearViews, closeWaitDlg, createAxios, src_default as default, delView, email, eventBus, getErrorMessage, getTypeColor, getTypeDefault, globalObjects, hasView, injectDark, injectLocale, injectPermissionObjects, injectViews, isEmpty, isExist, lastView, length, loadLocaleMessageEssential, matchRouteMeta, maxLength, messageError, messageInfo, messageSuccess, messageWarning, minLength, onBeforeEnter, openConfirmDlg, openNumberDlg, openPromptDlg, openWaitDlg, popView, provideDark, provideLocale, providePermissionObjects, provideViews, required, routeTransName, toPermissionObjects, types, useColor, useGlobalStates, useMicroApp, usePageRoute, usePermission, useSystem, useViewStack, verifyPermission, waitMs, waitUtil };

package/dist/{vendor.gz9a1xde.js → vendor.fpmj8dgj.js}

@@ -1,4 +1,4 @@
-import { Fragment, computed, defineComponent, getCurrentInstance, getCurrentScope, hasInjectionContext, inject, isRef, onBeforeMount, onBeforeUnmount, onMounted, provide, ref, shallowRef, toValue, unref, watch, watchEffect } from "vue";
+import { Fragment, computed, defineComponent, getCurrentInstance, getCurrentScope, hasInjectionContext, inject, isRef, onBeforeMount, onBeforeUnmount, onMounted, onUnmounted, provide, ref, shallowRef, toValue, unref, watch, watchEffect } from "vue";
 
 //#region node_modules/.pnpm/@vueuse+shared@14.4.0_vue@3.5.43_typescript@6.0.3_/node_modules/@vueuse/shared/dist/index.js
 const localProvidedStateMap = /* @__PURE__ */ new WeakMap();
@@ -25,7 +25,7 @@ const injectLocal = (...args) => {
 const isClient = typeof window !== "undefined" && typeof document !== "undefined";
 const isWorker = typeof WorkerGlobalScope !== "undefined" && globalThis instanceof WorkerGlobalScope;
 const toString$1 = Object.prototype.toString;
-const isObject$1 = (val) => toString$1.call(val) === "[object Object]";
+const isObject$2 = (val) => toString$1.call(val) === "[object Object]";
 /**
 * Get a px value for SSR use, do not rely on this method outside of SSR as REM unit is assumed at 16px, which might not be the case on the client
 */
@@ -94,7 +94,7 @@ function useEventListener(...args) {
 		];
 	}, ([raw_targets, raw_events, raw_listeners, raw_options], _, onCleanup) => {
 		if (!(raw_targets === null || raw_targets === void 0 ? void 0 : raw_targets.length) || !(raw_events === null || raw_events === void 0 ? void 0 : raw_events.length) || !(raw_listeners === null || raw_listeners === void 0 ? void 0 : raw_listeners.length)) return;
-		const optionsClone = isObject$1(raw_options) ? { ...raw_options } : raw_options;
+		const optionsClone = isObject$2(raw_options) ? { ...raw_options } : raw_options;
 		const cleanups = raw_targets.flatMap((el) => raw_events.flatMap((event) => raw_listeners.map((listener) => register(el, event, listener, optionsClone))));
 		onCleanup(() => {
 			cleanups.forEach((fn) => fn());
@@ -322,16 +322,16 @@ function slugify(input) {
 	return input.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/[\s_-]+/g, "-").replace(/^-+|-+$/g, "");
 }
 const captureStackTrace = "captureStackTrace" in Error ? Error.captureStackTrace : (..._args) => {};
-function isObject(data) {
+function isObject$1(data) {
 	return typeof data === "object" && data !== null && !Array.isArray(data);
 }
 function isPlainObject(o) {
-	if (isObject(o) === false) return false;
+	if (isObject$1(o) === false) return false;
 	const ctor = o.constructor;
 	if (ctor === void 0) return true;
 	if (typeof ctor !== "function") return true;
 	const prot = ctor.prototype;
-	if (isObject(prot) === false) return false;
+	if (isObject$1(prot) === false) return false;
 	if (Object.prototype.hasOwnProperty.call(prot, "isPrototypeOf") === false) return false;
 	return true;
 }
@@ -4601,6 +4601,119 @@ function baseToString(value) {
 	return result == "0" && 1 / value == -INFINITY ? "-0" : result;
 }
 
+//#endregion
+//#region node_modules/.pnpm/lodash-es@4.18.1/node_modules/lodash-es/_trimmedEndIndex.js
+/** Used to match a single whitespace character. */
+var reWhitespace = /\s/;
+/**
+* Used by `_.trim` and `_.trimEnd` to get the index of the last non-whitespace
+* character of `string`.
+*
+* @private
+* @param {string} string The string to inspect.
+* @returns {number} Returns the index of the last non-whitespace character.
+*/
+function trimmedEndIndex(string) {
+	var index = string.length;
+	while (index-- && reWhitespace.test(string.charAt(index)));
+	return index;
+}
+
+//#endregion
+//#region node_modules/.pnpm/lodash-es@4.18.1/node_modules/lodash-es/_baseTrim.js
+/** Used to match leading whitespace. */
+var reTrimStart = /^\s+/;
+/**
+* The base implementation of `_.trim`.
+*
+* @private
+* @param {string} string The string to trim.
+* @returns {string} Returns the trimmed string.
+*/
+function baseTrim(string) {
+	return string ? string.slice(0, trimmedEndIndex(string) + 1).replace(reTrimStart, "") : string;
+}
+
+//#endregion
+//#region node_modules/.pnpm/lodash-es@4.18.1/node_modules/lodash-es/isObject.js
+/**
+* Checks if `value` is the
+* [language type](http://www.ecma-international.org/ecma-262/7.0/#sec-ecmascript-language-types)
+* of `Object`. (e.g. arrays, functions, objects, regexes, `new Number(0)`, and `new String('')`)
+*
+* @static
+* @memberOf _
+* @since 0.1.0
+* @category Lang
+* @param {*} value The value to check.
+* @returns {boolean} Returns `true` if `value` is an object, else `false`.
+* @example
+*
+* _.isObject({});
+* // => true
+*
+* _.isObject([1, 2, 3]);
+* // => true
+*
+* _.isObject(_.noop);
+* // => true
+*
+* _.isObject(null);
+* // => false
+*/
+function isObject(value) {
+	var type = typeof value;
+	return value != null && (type == "object" || type == "function");
+}
+
+//#endregion
+//#region node_modules/.pnpm/lodash-es@4.18.1/node_modules/lodash-es/toNumber.js
+/** Used as references for various `Number` constants. */
+var NAN = NaN;
+/** Used to detect bad signed hexadecimal string values. */
+var reIsBadHex = /^[-+]0x[0-9a-f]+$/i;
+/** Used to detect binary string values. */
+var reIsBinary = /^0b[01]+$/i;
+/** Used to detect octal string values. */
+var reIsOctal = /^0o[0-7]+$/i;
+/** Built-in method references without a dependency on `root`. */
+var freeParseInt = parseInt;
+/**
+* Converts `value` to a number.
+*
+* @static
+* @memberOf _
+* @since 4.0.0
+* @category Lang
+* @param {*} value The value to process.
+* @returns {number} Returns the number.
+* @example
+*
+* _.toNumber(3.2);
+* // => 3.2
+*
+* _.toNumber(Number.MIN_VALUE);
+* // => 5e-324
+*
+* _.toNumber(Infinity);
+* // => Infinity
+*
+* _.toNumber('3.2');
+* // => 3.2
+*/
+function toNumber(value) {
+	if (typeof value == "number") return value;
+	if (isSymbol(value)) return NAN;
+	if (isObject(value)) {
+		var other = typeof value.valueOf == "function" ? value.valueOf() : value;
+		value = isObject(other) ? other + "" : other;
+	}
+	if (typeof value != "string") return value === 0 ? value : +value;
+	value = baseTrim(value);
+	var isBinary = reIsBinary.test(value);
+	return isBinary || reIsOctal.test(value) ? freeParseInt(value.slice(2), isBinary ? 2 : 8) : reIsBadHex.test(value) ? NAN : +value;
+}
+
 //#endregion
 //#region node_modules/.pnpm/lodash-es@4.18.1/node_modules/lodash-es/toString.js
 /**
@@ -4628,6 +4741,158 @@ function toString(value) {
 	return value == null ? "" : baseToString(value);
 }
 
+//#endregion
+//#region node_modules/.pnpm/lodash-es@4.18.1/node_modules/lodash-es/now.js
+/**
+* Gets the timestamp of the number of milliseconds that have elapsed since
+* the Unix epoch (1 January 1970 00:00:00 UTC).
+*
+* @static
+* @memberOf _
+* @since 2.4.0
+* @category Date
+* @returns {number} Returns the timestamp.
+* @example
+*
+* _.defer(function(stamp) {
+*   console.log(_.now() - stamp);
+* }, _.now());
+* // => Logs the number of milliseconds it took for the deferred invocation.
+*/
+var now = function() {
+	return root.Date.now();
+};
+
+//#endregion
+//#region node_modules/.pnpm/lodash-es@4.18.1/node_modules/lodash-es/debounce.js
+/** Error message constants. */
+var FUNC_ERROR_TEXT = "Expected a function";
+var nativeMax = Math.max;
+var nativeMin = Math.min;
+/**
+* Creates a debounced function that delays invoking `func` until after `wait`
+* milliseconds have elapsed since the last time the debounced function was
+* invoked. The debounced function comes with a `cancel` method to cancel
+* delayed `func` invocations and a `flush` method to immediately invoke them.
+* Provide `options` to indicate whether `func` should be invoked on the
+* leading and/or trailing edge of the `wait` timeout. The `func` is invoked
+* with the last arguments provided to the debounced function. Subsequent
+* calls to the debounced function return the result of the last `func`
+* invocation.
+*
+* **Note:** If `leading` and `trailing` options are `true`, `func` is
+* invoked on the trailing edge of the timeout only if the debounced function
+* is invoked more than once during the `wait` timeout.
+*
+* If `wait` is `0` and `leading` is `false`, `func` invocation is deferred
+* until to the next tick, similar to `setTimeout` with a timeout of `0`.
+*
+* See [David Corbacho's article](https://css-tricks.com/debouncing-throttling-explained-examples/)
+* for details over the differences between `_.debounce` and `_.throttle`.
+*
+* @static
+* @memberOf _
+* @since 0.1.0
+* @category Function
+* @param {Function} func The function to debounce.
+* @param {number} [wait=0] The number of milliseconds to delay.
+* @param {Object} [options={}] The options object.
+* @param {boolean} [options.leading=false]
+*  Specify invoking on the leading edge of the timeout.
+* @param {number} [options.maxWait]
+*  The maximum time `func` is allowed to be delayed before it's invoked.
+* @param {boolean} [options.trailing=true]
+*  Specify invoking on the trailing edge of the timeout.
+* @returns {Function} Returns the new debounced function.
+* @example
+*
+* // Avoid costly calculations while the window size is in flux.
+* jQuery(window).on('resize', _.debounce(calculateLayout, 150));
+*
+* // Invoke `sendMail` when clicked, debouncing subsequent calls.
+* jQuery(element).on('click', _.debounce(sendMail, 300, {
+*   'leading': true,
+*   'trailing': false
+* }));
+*
+* // Ensure `batchLog` is invoked once after 1 second of debounced calls.
+* var debounced = _.debounce(batchLog, 250, { 'maxWait': 1000 });
+* var source = new EventSource('/stream');
+* jQuery(source).on('message', debounced);
+*
+* // Cancel the trailing debounced invocation.
+* jQuery(window).on('popstate', debounced.cancel);
+*/
+function debounce(func, wait, options) {
+	var lastArgs, lastThis, maxWait, result, timerId, lastCallTime, lastInvokeTime = 0, leading = false, maxing = false, trailing = true;
+	if (typeof func != "function") throw new TypeError(FUNC_ERROR_TEXT);
+	wait = toNumber(wait) || 0;
+	if (isObject(options)) {
+		leading = !!options.leading;
+		maxing = "maxWait" in options;
+		maxWait = maxing ? nativeMax(toNumber(options.maxWait) || 0, wait) : maxWait;
+		trailing = "trailing" in options ? !!options.trailing : trailing;
+	}
+	function invokeFunc(time) {
+		var args = lastArgs, thisArg = lastThis;
+		lastArgs = lastThis = void 0;
+		lastInvokeTime = time;
+		result = func.apply(thisArg, args);
+		return result;
+	}
+	function leadingEdge(time) {
+		lastInvokeTime = time;
+		timerId = setTimeout(timerExpired, wait);
+		return leading ? invokeFunc(time) : result;
+	}
+	function remainingWait(time) {
+		var timeSinceLastCall = time - lastCallTime, timeSinceLastInvoke = time - lastInvokeTime, timeWaiting = wait - timeSinceLastCall;
+		return maxing ? nativeMin(timeWaiting, maxWait - timeSinceLastInvoke) : timeWaiting;
+	}
+	function shouldInvoke(time) {
+		var timeSinceLastCall = time - lastCallTime, timeSinceLastInvoke = time - lastInvokeTime;
+		return lastCallTime === void 0 || timeSinceLastCall >= wait || timeSinceLastCall < 0 || maxing && timeSinceLastInvoke >= maxWait;
+	}
+	function timerExpired() {
+		var time = now();
+		if (shouldInvoke(time)) return trailingEdge(time);
+		timerId = setTimeout(timerExpired, remainingWait(time));
+	}
+	function trailingEdge(time) {
+		timerId = void 0;
+		if (trailing && lastArgs) return invokeFunc(time);
+		lastArgs = lastThis = void 0;
+		return result;
+	}
+	function cancel() {
+		if (timerId !== void 0) clearTimeout(timerId);
+		lastInvokeTime = 0;
+		lastArgs = lastCallTime = lastThis = timerId = void 0;
+	}
+	function flush() {
+		return timerId === void 0 ? result : trailingEdge(now());
+	}
+	function debounced() {
+		var time = now(), isInvoking = shouldInvoke(time);
+		lastArgs = arguments;
+		lastThis = this;
+		lastCallTime = time;
+		if (isInvoking) {
+			if (timerId === void 0) return leadingEdge(lastCallTime);
+			if (maxing) {
+				clearTimeout(timerId);
+				timerId = setTimeout(timerExpired, wait);
+				return invokeFunc(lastCallTime);
+			}
+		}
+		if (timerId === void 0) timerId = setTimeout(timerExpired, wait);
+		return result;
+	}
+	debounced.cancel = cancel;
+	debounced.flush = flush;
+	return debounced;
+}
+
 //#endregion
 //#region node_modules/.pnpm/lodash-es@4.18.1/node_modules/lodash-es/toLower.js
 /**
@@ -4658,12 +4923,12 @@ function toLower(value) {
 //#endregion
 //#region node_modules/.pnpm/mitt@3.0.1/node_modules/mitt/index.d.ts
 var [EventType] = [
-	67,
+	68,
 	() => [],
 	[]
 ];
 var [Handler] = [
-	68,
+	69,
 	(T) => [T],
 	[
 		"",
@@ -4672,7 +4937,7 @@ var [Handler] = [
 	]
 ];
 var [WildcardHandler] = [
-	69,
+	70,
 	(T) => [
 		Record,
 		T,
@@ -4690,7 +4955,7 @@ var [WildcardHandler] = [
 	]
 ];
 var [EventHandlerList] = [
-	70,
+	71,
 	(T) => [
 		T,
 		Handler,
@@ -4704,7 +4969,7 @@ var [EventHandlerList] = [
 	]
 ];
 var [WildCardEventHandlerList] = [
-	71,
+	72,
 	(T) => [
 		Record,
 		T,
@@ -4720,7 +4985,7 @@ var [WildCardEventHandlerList] = [
 	]
 ];
 var [EventHandlerMap] = [
-	72,
+	73,
 	(Events) => [
 		EventType,
 		Record,
@@ -4746,7 +5011,7 @@ var [EventHandlerMap] = [
 	]
 ];
 var [Emitter] = [
-	73,
+	74,
 	(Key, Events) => [
 		EventType,
 		Record,
@@ -4829,4 +5094,4 @@ var [Emitter] = [
 ];
 
 //#endregion
-export { email as a, mitt_default as c, custom as i, usePreferredDark as l, EventType as n, string as o, toLower as r, api as s, Emitter as t };
+export { custom as a, api as c, debounce as i, mitt_default as l, EventType as n, email as o, toLower as r, string as s, Emitter as t, usePreferredDark as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x-essential-lib",
-  "version": "0.11.7",
+  "version": "0.11.9",
   "files": [
     "dist"
   ],
@@ -15,7 +15,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "scripts": {
-    "sync": "git submodule update --remote",
+    "sync": "git submodule update --init --remote",
     "gen": "buf generate --clean",
     "play": "vite",
     "test": "vitest",
@@ -25,6 +25,9 @@
     "lint-staged": "lint-staged",
     "prepare": "husky"
   },
+  "dependencies": {
+    "@tauri-apps/api": "^2.12.1"
+  },
   "devDependencies": {
     "@types/js-cookie": "^3.0.6",
     "@types/lodash-es": "^4.17.12",
@@ -45,7 +48,7 @@
     "typescript": "^6.0.3",
     "vite": "^8.3.0",
     "vue-tsc": "^3.3.11",
-    "x-config-lib": "^0.1.6",
+    "x-config-lib": "^0.1.8",
     "x-config-oxfmt": "^0.1.6",
     "x-config-oxlint": "^0.1.7",
     "zod": "^4.6.5"