@etsoo/shared 1.2.51 → 1.2.54

package/lib/mjs/DomUtils.js

@@ -1,11 +1,11 @@
 /// <reference lib="dom" />
-import { DataTypes } from './DataTypes';
-import { DateUtils } from './DateUtils';
-import { Utils } from './Utils';
-if (typeof navigator === 'undefined') {
+import { DataTypes } from "./DataTypes";
+import { DateUtils } from "./DateUtils";
+import { Utils } from "./Utils";
+if (typeof navigator === "undefined") {
     // Test mock only
-    globalThis.navigator = { language: 'en-US' };
-    globalThis.location = { href: 'http://localhost/' };
+    globalThis.navigator = { language: "en-US" };
+    globalThis.location = { href: "http://localhost/" };
 }
 /**
  * Dom Utilities
@@ -16,11 +16,11 @@ export var DomUtils;
     /**
      * Language cache parameter name
      */
-    DomUtils.CultureField = 'culture';
+    DomUtils.CultureField = "culture";
     /**
      * Country cache parameter name
      */
-    DomUtils.CountryField = 'country';
+    DomUtils.CountryField = "country";
     /**
      * Clear form data
      * @param data Form data
@@ -37,7 +37,7 @@ export var DomUtils;
                 return;
             // Get all values
             const formValues = data.getAll(key);
-            if (formValues.length == 1 && formValues[0] === '') {
+            if (formValues.length == 1 && formValues[0] === "") {
                 // Remove empty field
                 data.delete(key);
             }
@@ -62,7 +62,7 @@ export var DomUtils;
                     const sourceValue = Reflect.get(source, key);
                     if (Array.isArray(sourceValue)) {
                         // Array, types may differ
-                        if (formValues.join('`') === sourceValue.join('`')) {
+                        if (formValues.join("`") === sourceValue.join("`")) {
                             // Equal value, remove the key
                             data.delete(key);
                         }
@@ -96,8 +96,7 @@ export var DomUtils;
         const entries = Object.entries(isFormData(source) ? formDataToObject(source) : source);
         for (const [key, value] of entries) {
             // Is included or keepSource
-            const property = properties.find((p) => p.localeCompare(key, 'en', { sensitivity: 'base' }) ===
-                0) ?? (keepSource ? key : undefined);
+            const property = properties.find((p) => p.localeCompare(key, "en", { sensitivity: "base" }) === 0) ?? (keepSource ? key : undefined);
             if (property == null)
                 continue;
             // Template value
@@ -135,7 +134,7 @@ export var DomUtils;
         // New data
         // Object.create(...)
         const data = {};
-        if (source != null && typeof source === 'object') {
+        if (source != null && typeof source === "object") {
             // Travel all properties
             dataAsTraveller(source, data, template, keepSource, false);
         }
@@ -196,8 +195,7 @@ export var DomUtils;
         // Browser detected
         if (culture == null) {
             culture =
-                (navigator.languages && navigator.languages[0]) ||
-                    navigator.language;
+                (navigator.languages && navigator.languages[0]) || navigator.language;
         }
         // Return
         return culture;
@@ -231,7 +229,7 @@ export var DomUtils;
      */
     async function downloadFile(data, suggestedName, autoDetect = true) {
         try {
-            if (autoDetect && 'showSaveFilePicker' in globalThis) {
+            if (autoDetect && "showSaveFilePicker" in globalThis) {
                 // AbortError - Use dismisses the window
                 const handle = await globalThis.showSaveFilePicker({
                     suggestedName
@@ -248,11 +246,9 @@ export var DomUtils;
                 return true;
             }
             else {
-                const url = window.URL.createObjectURL(data instanceof Blob
-                    ? data
-                    : await new Response(data).blob());
-                const a = document.createElement('a');
-                a.style.display = 'none';
+                const url = window.URL.createObjectURL(data instanceof Blob ? data : await new Response(data).blob());
+                const a = document.createElement("a");
+                a.style.display = "none";
                 a.href = url;
                 if (suggestedName)
                     a.download = suggestedName;
@@ -264,7 +260,7 @@ export var DomUtils;
             }
         }
         catch (e) {
-            console.error('DomUtils.downloadFile with error', e);
+            console.error("DomUtils.downloadFile with error", e);
         }
         return false;
     }
@@ -313,7 +309,7 @@ export var DomUtils;
         data ?? (data = parseUserAgent());
         if (!data)
             return false;
-        return data.brands.some((item) => item.brand.toLowerCase() === 'micromessenger');
+        return data.brands.some((item) => item.brand.toLowerCase() === "micromessenger");
     }
     DomUtils.isWechatClient = isWechatClient;
     /**
@@ -332,8 +328,8 @@ export var DomUtils;
      * @returns Result
      */
     DomUtils.en = (resources) => ({
-        name: 'en',
-        label: 'English',
+        name: "en",
+        label: "English",
         resources
     });
     /**
@@ -342,10 +338,10 @@ export var DomUtils;
      * @returns Result
      */
     DomUtils.zhHans = (resources) => ({
-        name: 'zh-Hans',
-        label: '简体中文',
+        name: "zh-Hans",
+        label: "简体中文",
         resources,
-        compatibleNames: ['zh-CN', 'zh-SG']
+        compatibleNames: ["zh-CN", "zh-SG"]
     });
     /**
      * Get traditional Chinese resources definition
@@ -353,10 +349,10 @@ export var DomUtils;
      * @returns Result
      */
     DomUtils.zhHant = (resources) => ({
-        name: 'zh-Hant',
-        label: '繁體中文',
+        name: "zh-Hant",
+        label: "繁體中文",
         resources,
-        compatibleNames: ['zh-HK', 'zh-TW', 'zh-MO']
+        compatibleNames: ["zh-HK", "zh-TW", "zh-MO"]
     });
     /**
      * Get the available culture definition
@@ -373,11 +369,11 @@ export var DomUtils;
             return [exactMatch, CultureMatch.Exact];
         // Compatible match
         const compatibleMatch = items.find((item) => item.compatibleNames?.includes(culture) ||
-            culture.startsWith(item + '-'));
+            culture.startsWith(item + "-"));
         if (compatibleMatch)
             return [compatibleMatch, CultureMatch.Compatible];
         // Same part, like zh-CN and zh-HK
-        const samePart = culture.split('-')[0];
+        const samePart = culture.split("-")[0];
         const samePartMatch = items.find((item) => item.name.startsWith(samePart));
         if (samePartMatch)
             return [samePartMatch, CultureMatch.SamePart];
@@ -391,13 +387,13 @@ export var DomUtils;
      */
     function getInputValue(input) {
         const type = input.type;
-        if (type === 'number' || type === 'range') {
+        if (type === "number" || type === "range") {
             const num = input.valueAsNumber;
             if (isNaN(num))
                 return null;
             return num;
         }
-        else if (type === 'date' || type === 'datetime-local')
+        else if (type === "date" || type === "datetime-local")
             return input.valueAsDate ?? DateUtils.parse(input.value);
         return input.value;
     }
@@ -418,7 +414,7 @@ export var DomUtils;
         if (Array.isArray(headers)) {
             return Object.fromEntries(headers);
         }
-        if (typeof Headers === 'undefined') {
+        if (typeof Headers === "undefined") {
             return Object.fromEntries(Object.entries(headers));
         }
         if (headers instanceof Headers) {
@@ -436,11 +432,11 @@ export var DomUtils;
      * @returns result
      */
     function isFormData(input) {
-        if (typeof input === 'object' &&
+        if (typeof input === "object" &&
             input != null &&
-            'entries' in input &&
-            'getAll' in input &&
-            'keys' in input) {
+            "entries" in input &&
+            "getAll" in input &&
+            "keys" in input) {
             return true;
         }
         return false;
@@ -454,8 +450,8 @@ export var DomUtils;
         if (contentType &&
             // application/problem+json
             // application/json
-            (contentType.includes('json') ||
-                contentType.startsWith('application/javascript')))
+            (contentType.includes("json") ||
+                contentType.startsWith("application/javascript")))
             return true;
         return false;
     }
@@ -470,9 +466,7 @@ export var DomUtils;
         for (const newForm of forms) {
             for (const key of new Set(newForm.keys())) {
                 form.delete(key);
-                newForm
-                    .getAll(key)
-                    .forEach((value) => form.append(key, value));
+                newForm.getAll(key).forEach((value) => form.append(key, value));
             }
         }
         return form;
@@ -506,16 +500,16 @@ export var DomUtils;
         }
         const parts = ua.split(/(?!\(.*)\s+(?!\()(?![^(]*?\))/g);
         let mobile = false;
-        let platform = '';
+        let platform = "";
         let platformVersion;
-        let device = 'Desktop';
+        let device = "Desktop";
         const brands = [];
         // with the 'g' will causing failures for multiple calls
         const platformVersionReg = /^[a-zA-Z0-9-\s]+\s+(0|\d+)(\.(0|\d+)){0,3}(\(|$)/;
         const versionReg = /^[a-zA-Z0-9]+\/(0|\d+)(\.(0|\d+)){0,3}(\(|$)/;
         parts.forEach((part) => {
             const pl = part.toLowerCase();
-            if (pl.startsWith('mozilla/')) {
+            if (pl.startsWith("mozilla/")) {
                 const data = /\((.*)\)$/.exec(part);
                 if (data && data.length > 1) {
                     const pfItems = data[1].split(/;\s*/);
@@ -524,7 +518,7 @@ export var DomUtils;
                     if (pfIndex !== -1) {
                         const pfParts = pfItems[pfIndex].split(/\s+/);
                         platformVersion = pfParts.pop();
-                        platform = pfParts.join(' ');
+                        platform = pfParts.join(" ");
                     }
                     else {
                         const appleVersionReg = /((iPhone|Mac)\s+OS(\s+\w+)?)\s+((0|\d+)(_(0|\d+)){0,3})/i;
@@ -532,46 +526,46 @@ export var DomUtils;
                             const match = appleVersionReg.exec(pfItems[i]);
                             if (match && match.length > 4) {
                                 platform = match[1];
-                                platformVersion = match[4].replace(/_/g, '.');
+                                platformVersion = match[4].replace(/_/g, ".");
                                 pfItems.splice(i, 1);
                                 break;
                             }
                         }
                     }
                     // Device
-                    const deviceIndex = pfItems.findIndex((item) => item.includes(' Build/'));
+                    const deviceIndex = pfItems.findIndex((item) => item.includes(" Build/"));
                     if (deviceIndex === -1) {
                         const firstItem = pfItems[0];
-                        if (firstItem.toLowerCase() !== 'linux' &&
+                        if (firstItem.toLowerCase() !== "linux" &&
                             !firstItem.startsWith(platform)) {
                             device = firstItem;
                             pfItems.shift();
                         }
                     }
                     else {
-                        device = pfItems[deviceIndex].split(' Build/')[0];
+                        device = pfItems[deviceIndex].split(" Build/")[0];
                         pfItems.splice(deviceIndex, 1);
                     }
                 }
                 return;
             }
-            if (pl === 'mobile' || pl.startsWith('mobile/')) {
+            if (pl === "mobile" || pl.startsWith("mobile/")) {
                 mobile = true;
                 return;
             }
-            if (pl === 'version' || pl.startsWith('version/')) {
+            if (pl === "version" || pl.startsWith("version/")) {
                 // No process
                 return;
             }
             if (versionReg.test(part)) {
-                let [brand, version] = part.split('/');
-                const pindex = version.indexOf('(');
+                let [brand, version] = part.split("/");
+                const pindex = version.indexOf("(");
                 if (pindex > 0) {
                     version = version.substring(0, pindex);
                 }
                 brands.push({
                     brand,
-                    version: Utils.trimEnd(version, '.0')
+                    version: Utils.trimEnd(version, ".0")
                 });
                 return;
             }
@@ -585,7 +579,7 @@ export var DomUtils;
      * @param container Container, limits the element range
      */
     function setFocus(name, container) {
-        const elementName = typeof name === 'string' ? name : Object.keys(name)[0];
+        const elementName = typeof name === "string" ? name : Object.keys(name)[0];
         container ?? (container = document.body);
         const element = container.querySelector(`[name="${elementName}"]`);
         if (element != null)
@@ -602,13 +596,13 @@ export var DomUtils;
         // Avoid multiple setup, if there is already a handler, please set "window.onunhandledrejection = null" first
         if (window.onunhandledrejection)
             return;
-        const errorType = 'error';
+        const errorType = "error";
         const errorPD = Utils.getResult(preventDefault, errorType) ?? true;
         window.onerror = (message, source, lineNo, colNo, error) => {
             // Default source
             source || (source = window.location.href);
             let data;
-            if (typeof message === 'string') {
+            if (typeof message === "string") {
                 data = {
                     type: errorType,
                     message, // Share the same message with error
@@ -622,8 +616,7 @@ export var DomUtils;
                 data = {
                     type: errorType,
                     subType: message.type,
-                    message: error?.message ??
-                        `${message.currentTarget} event error`,
+                    message: error?.message ?? `${message.currentTarget} event error`,
                     source,
                     lineNo,
                     colNo,
@@ -634,7 +627,7 @@ export var DomUtils;
             // Return true to suppress error alert
             return errorPD;
         };
-        const rejectionType = 'unhandledrejection';
+        const rejectionType = "unhandledrejection";
         const rejectionPD = Utils.getResult(preventDefault, rejectionType) ?? true;
         window.onunhandledrejection = (event) => {
             if (rejectionPD)
@@ -655,9 +648,7 @@ export var DomUtils;
             else {
                 data = {
                     type: rejectionType,
-                    message: typeof reason === 'string'
-                        ? reason
-                        : JSON.stringify(reason),
+                    message: typeof reason === "string" ? reason : JSON.stringify(reason),
                     source
                 };
             }
@@ -671,14 +662,14 @@ export var DomUtils;
                     orgin(...args);
                 const [first, ...rest] = args;
                 let message;
-                if (typeof first === 'string') {
+                if (typeof first === "string") {
                     message = first;
                 }
                 else {
                     message = JSON.stringify(first);
                 }
                 const stack = rest.length > 0
-                    ? rest.map((item) => JSON.stringify(item)).join(', ')
+                    ? rest.map((item) => JSON.stringify(item)).join(", ")
                     : undefined;
                 const data = {
                     type,
@@ -689,8 +680,8 @@ export var DomUtils;
                 action(data);
             };
         };
-        window.console.warn = localConsole('consoleWarn', window.console.warn);
-        window.console.error = localConsole('consoleError', window.console.error);
+        window.console.warn = localConsole("consoleWarn", window.console.warn);
+        window.console.error = localConsole("consoleError", window.console.error);
     }
     DomUtils.setupLogging = setupLogging;
     /**
@@ -701,17 +692,17 @@ export var DomUtils;
      * @returns Result
      */
     async function verifyPermission(fileHandle, withWrite = false) {
-        if (!('queryPermission' in fileHandle) ||
-            !('requestPermission' in fileHandle))
+        if (!("queryPermission" in fileHandle) ||
+            !("requestPermission" in fileHandle))
             return false;
         // FileSystemHandlePermissionDescriptor
-        const opts = { mode: withWrite ? 'readwrite' : 'read' };
+        const opts = { mode: withWrite ? "readwrite" : "read" };
         // Check if we already have permission, if so, return true.
-        if ((await fileHandle.queryPermission(opts)) === 'granted') {
+        if ((await fileHandle.queryPermission(opts)) === "granted") {
             return true;
         }
         // Request permission to the file, if the user grants permission, return true.
-        if ((await fileHandle.requestPermission(opts)) === 'granted') {
+        if ((await fileHandle.requestPermission(opts)) === "granted") {
             return true;
         }
         // The user did not grant permission, return false.

package/lib/mjs/ExtendUtils.d.ts

@@ -1,4 +1,4 @@
-import { DelayedExecutorType } from './types/DelayedExecutorType';
+import { DelayedExecutorType } from "./types/DelayedExecutorType";
 /**
  * Extend utilities
  */

package/lib/mjs/ExtendUtils.js

@@ -1,4 +1,4 @@
-const hasRequestAnimationFrame = typeof requestAnimationFrame === 'function';
+const hasRequestAnimationFrame = typeof requestAnimationFrame === "function";
 /**
  * Extend utilities
  */
@@ -13,7 +13,7 @@ export var ExtendUtils;
     function applyMixins(derivedCtor, baseCtors) {
         baseCtors.forEach((baseCtor) => {
             Object.getOwnPropertyNames(baseCtor.prototype).forEach((name) => {
-                if (name !== 'constructor') {
+                if (name !== "constructor") {
                     // eslint-disable-next-line no-param-reassign
                     derivedCtor.prototype[name] = baseCtor.prototype[name];
                 }
@@ -98,7 +98,7 @@ export var ExtendUtils;
                     lastTime = timestamp;
                 }
                 const elapsed = timestamp - lastTime;
-                const isReady = typeof checkReady === 'number'
+                const isReady = typeof checkReady === "number"
                     ? elapsed >= checkReady
                     : checkReady(elapsed);
                 if (isReady) {
@@ -111,7 +111,7 @@ export var ExtendUtils;
             }
             requestID = requestAnimationFrame(loop);
         }
-        else if (typeof checkReady === 'number') {
+        else if (typeof checkReady === "number") {
             requestID = setTimeout(callback, checkReady);
         }
         else {
@@ -136,7 +136,7 @@ export var ExtendUtils;
         }
         return () => {
             if (requestID) {
-                if (hasRequestAnimationFrame && typeof requestID === 'number') {
+                if (hasRequestAnimationFrame && typeof requestID === "number") {
                     cancelAnimationFrame(requestID);
                 }
                 else {
@@ -181,7 +181,7 @@ export var ExtendUtils;
         }
         return () => {
             if (requestID) {
-                if (hasRequestAnimationFrame && typeof requestID === 'number') {
+                if (hasRequestAnimationFrame && typeof requestID === "number") {
                     cancelAnimationFrame(requestID);
                 }
                 else {

package/lib/mjs/IActionResult.d.ts

@@ -1,4 +1,4 @@
-import { IdType } from './DataTypes';
+import { IdType } from "./DataTypes";
 /**
  * Result errors
  * Indexable type
@@ -48,11 +48,24 @@ export interface IActionResult<D extends object = {}> {
     readonly ok: boolean;
 }
 /**
- * Action result with id data
+ * Action result with id
  */
 export type IdActionResult<T extends IdType = number> = IActionResult<{
     id: T;
 }>;
+/**
+ * Action result with message data
+ */
+export type MsgActionResult = IActionResult<{
+    msg: string;
+}>;
+/**
+ * Action result with id, message data
+ */
+export type IdMsgActionResult = IActionResult<{
+    id: number;
+    msg: string;
+}>;
 /**
  * Action result with dynamic data
  */

package/lib/mjs/NumberUtils.d.ts

@@ -40,7 +40,7 @@ export declare namespace NumberUtils {
      * @param locale Locale
      * @returns Result
      */
-    function getCurrencySymbol(code: string, display?: 'symbol' | 'narrowSymbol' | 'name', locale?: string): string | undefined;
+    function getCurrencySymbol(code: string, display?: "symbol" | "narrowSymbol" | "name", locale?: string): string | undefined;
     /**
      * Parse number
      * @param rawData Raw data

package/lib/mjs/NumberUtils.js

@@ -33,9 +33,9 @@ export var NumberUtils;
     function formatMoney(input, currency, locale, isInteger = false, options = {}) {
         if (currency) {
             // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat
-            options.style = 'currency';
+            options.style = "currency";
             options.currency = currency;
-            options.currencyDisplay ?? (options.currencyDisplay = 'narrowSymbol');
+            options.currencyDisplay ?? (options.currencyDisplay = "narrowSymbol");
         }
         if (isInteger) {
             options.minimumFractionDigits ?? (options.minimumFractionDigits = 0);
@@ -55,8 +55,8 @@ export var NumberUtils;
     function formatFileSize(size, fractionDigits = 2) {
         const i = size === 0 ? 0 : Math.floor(Math.log(size) / Math.log(1024));
         return ((size / Math.pow(1024, i)).toFixed(fractionDigits) +
-            ' ' +
-            ['B', 'KB', 'MB', 'GB', 'TB', 'PB'][i]);
+            " " +
+            ["B", "KB", "MB", "GB", "TB", "PB"][i]);
     }
     NumberUtils.formatFileSize = formatFileSize;
     /**
@@ -66,22 +66,22 @@ export var NumberUtils;
      * @param locale Locale
      * @returns Result
      */
-    function getCurrencySymbol(code, display = 'narrowSymbol', locale) {
+    function getCurrencySymbol(code, display = "narrowSymbol", locale) {
         const formatter = new Intl.NumberFormat(locale, {
-            style: 'currency',
+            style: "currency",
             currency: code,
             currencyDisplay: display
         });
         const parts = formatter.formatToParts();
-        const symbol = parts.find((part) => part.type === 'currency')?.value;
+        const symbol = parts.find((part) => part.type === "currency")?.value;
         return symbol;
     }
     NumberUtils.getCurrencySymbol = getCurrencySymbol;
     function parse(rawData, defaultValue) {
-        if (rawData == null || rawData === '') {
+        if (rawData == null || rawData === "") {
             return defaultValue;
         }
-        if (typeof rawData === 'number') {
+        if (typeof rawData === "number") {
             if (isNaN(rawData))
                 return defaultValue;
             return rawData;

package/lib/mjs/StorageUtils.js

@@ -1,5 +1,5 @@
-import { NodeStorage } from './node/Storage';
-import { Utils } from './Utils';
+import { NodeStorage } from "./node/Storage";
+import { Utils } from "./Utils";
 // Mock node
 globalThis.localStorage ?? (globalThis.localStorage = new NodeStorage());
 globalThis.sessionStorage ?? (globalThis.sessionStorage = new NodeStorage());
@@ -19,7 +19,7 @@ export var StorageUtils;
             localStorage.removeItem(key);
             return;
         }
-        localStorage.setItem(key, typeof data === 'string' ? data : JSON.stringify(data));
+        localStorage.setItem(key, typeof data === "string" ? data : JSON.stringify(data));
     }
     StorageUtils.setLocalData = setLocalData;
     /**
@@ -32,7 +32,7 @@ export var StorageUtils;
             sessionStorage.removeItem(key);
             return;
         }
-        sessionStorage.setItem(key, typeof data === 'string' ? data : JSON.stringify(data));
+        sessionStorage.setItem(key, typeof data === "string" ? data : JSON.stringify(data));
     }
     StorageUtils.setSessionData = setSessionData;
     /**

package/lib/mjs/Utils.d.ts

@@ -1,5 +1,5 @@
-import { DataTypes, IdType } from './DataTypes';
-import { ParsedPath } from './types/ParsedPath';
+import { DataTypes, IdType } from "./DataTypes";
+import { ParsedPath } from "./types/ParsedPath";
 declare global {
     interface String {
         /**
@@ -127,7 +127,7 @@ export declare namespace Utils {
      */
     function exclude<T extends {
         [P in D]: IdType;
-    }, D extends string = 'id'>(items: T[], field: D, ...excludedValues: T[D][]): T[];
+    }, D extends string = "id">(items: T[], field: D, ...excludedValues: T[D][]): T[];
     /**
      * Async exclude specific items
      * @param items Items
@@ -137,7 +137,7 @@ export declare namespace Utils {
      */
     function excludeAsync<T extends {
         [P in D]: IdType;
-    }, D extends string = 'id'>(items: Promise<T[] | undefined>, field: D, ...excludedValues: T[D][]): Promise<T[] | undefined>;
+    }, D extends string = "id">(items: Promise<T[] | undefined>, field: D, ...excludedValues: T[D][]): Promise<T[] | undefined>;
     /**
      * Format inital character to lower case or upper case
      * @param input Input string