@etsoo/shared 1.1.80 → 1.1.81

package/README.md

@@ -161,6 +161,7 @@ DOM/window related utilities
 |Name|Description|
 |---:|---|
 |clearFormData|Clear form data|
+|CultureMatch|Culture match case Enum|
 |dataAs|Cast data as template format|
 |detectedCountry|Current detected country|
 |detectedCulture|Current detected culture|

package/__tests__/DomUtils.ts

@@ -229,11 +229,25 @@ test('Tests for getCulture', () => {
         { name: 'en', label: 'English', resources: {} }
     ];
 
-    expect(DomUtils.getCulture(cultures, 'zh-CN')?.name).toBe('zh-Hans');
-    expect(DomUtils.getCulture(cultures, 'zh-Hans-CN')?.name).toBe('zh-Hans');
-    expect(DomUtils.getCulture(cultures, 'zh-Hans-HK')?.name).toBe('zh-Hans');
-    expect(DomUtils.getCulture(cultures, 'zh-SG')?.name).toBe('zh-Hans');
-    expect(DomUtils.getCulture(cultures, 'en-GB')?.name).toBe('en');
+    const [culture1, match1] = DomUtils.getCulture(cultures, 'zh-CN');
+    expect(culture1?.name).toBe('zh-Hans');
+    expect(match1).toBe(DomUtils.CultureMatch.Compatible);
+
+    const [culture2] = DomUtils.getCulture(cultures, 'zh-Hans-CN');
+    expect(culture2?.name).toBe('zh-Hans');
+
+    const [culture3] = DomUtils.getCulture(cultures, 'zh-Hans-HK');
+    expect(culture3?.name).toBe('zh-Hans');
+
+    const [culture4] = DomUtils.getCulture(cultures, 'zh-SG');
+    expect(culture4?.name).toBe('zh-Hans');
+
+    const [culture5] = DomUtils.getCulture(cultures, 'en-GB');
+    expect(culture5?.name).toBe('en');
+
+    const [culture6, match6] = DomUtils.getCulture(cultures, 'fr-CA');
+    expect(culture6?.name).toBe('zh-Hans');
+    expect(match6).toBe(DomUtils.CultureMatch.Default);
 });
 
 test('Tests for getLocationKey', () => {

package/lib/cjs/DomUtils.d.ts

@@ -62,6 +62,15 @@ export declare namespace DomUtils {
      * @returns Object
      */
     function formDataToObject(form: IFormData): Record<string, FormDataFieldValue | FormDataFieldValue[]>;
+    /**
+     * Culture match case Enum
+     */
+    enum CultureMatch {
+        Exact = 0,
+        Compatible = 1,
+        SamePart = 2,
+        Default = 3
+    }
     /**
      * Get the available culture definition
      * @param items Available cultures
@@ -74,14 +83,14 @@ export declare namespace DomUtils {
          * Current detected culture
          */
         compatibleNames?: string[] | undefined;
-    }>[], culture: string) => Readonly<{
+    }>[], culture: string) => [Readonly<{
         name: string;
         label: string;
         resources: T; /**
          * Current detected culture
          */
         compatibleNames?: string[] | undefined;
-    }> | undefined;
+    }> | undefined, CultureMatch];
     /**
      * Get input value depending on its type
      * @param input HTML input

package/lib/cjs/DomUtils.js

@@ -268,6 +268,16 @@ var DomUtils;
         return dic;
     }
     DomUtils.formDataToObject = formDataToObject;
+    /**
+     * Culture match case Enum
+     */
+    let CultureMatch;
+    (function (CultureMatch) {
+        CultureMatch[CultureMatch["Exact"] = 0] = "Exact";
+        CultureMatch[CultureMatch["Compatible"] = 1] = "Compatible";
+        CultureMatch[CultureMatch["SamePart"] = 2] = "SamePart";
+        CultureMatch[CultureMatch["Default"] = 3] = "Default";
+    })(CultureMatch = DomUtils.CultureMatch || (DomUtils.CultureMatch = {}));
     /**
      * Get the available culture definition
      * @param items Available cultures
@@ -275,12 +285,12 @@ var DomUtils;
      */
     DomUtils.getCulture = (items, culture) => {
         if (items.length === 0) {
-            return undefined;
+            return [undefined, CultureMatch.Exact];
         }
         // Exact match
         const exactMatch = items.find((item) => item.name === culture);
         if (exactMatch)
-            return exactMatch;
+            return [exactMatch, CultureMatch.Exact];
         // Compatible match
         const compatibleMatch = items.find((item) => {
             var _a;
@@ -288,14 +298,14 @@ var DomUtils;
                 culture.startsWith(item + '-');
         });
         if (compatibleMatch)
-            return compatibleMatch;
+            return [compatibleMatch, CultureMatch.Compatible];
         // Same part, like zh-CN and zh-HK
         const samePart = culture.split('-')[0];
         const samePartMatch = items.find((item) => item.name.startsWith(samePart));
         if (samePartMatch)
-            return samePartMatch;
+            return [samePartMatch, CultureMatch.SamePart];
         // Default
-        return items[0];
+        return [items[0], CultureMatch.Default];
     };
     /**
      * Get input value depending on its type

package/lib/mjs/DomUtils.d.ts

@@ -62,6 +62,15 @@ export declare namespace DomUtils {
      * @returns Object
      */
     function formDataToObject(form: IFormData): Record<string, FormDataFieldValue | FormDataFieldValue[]>;
+    /**
+     * Culture match case Enum
+     */
+    enum CultureMatch {
+        Exact = 0,
+        Compatible = 1,
+        SamePart = 2,
+        Default = 3
+    }
     /**
      * Get the available culture definition
      * @param items Available cultures
@@ -74,14 +83,14 @@ export declare namespace DomUtils {
          * Current detected culture
          */
         compatibleNames?: string[] | undefined;
-    }>[], culture: string) => Readonly<{
+    }>[], culture: string) => [Readonly<{
         name: string;
         label: string;
         resources: T; /**
          * Current detected culture
          */
         compatibleNames?: string[] | undefined;
-    }> | undefined;
+    }> | undefined, CultureMatch];
     /**
      * Get input value depending on its type
      * @param input HTML input

package/lib/mjs/DomUtils.js

@@ -265,6 +265,16 @@ export var DomUtils;
         return dic;
     }
     DomUtils.formDataToObject = formDataToObject;
+    /**
+     * Culture match case Enum
+     */
+    let CultureMatch;
+    (function (CultureMatch) {
+        CultureMatch[CultureMatch["Exact"] = 0] = "Exact";
+        CultureMatch[CultureMatch["Compatible"] = 1] = "Compatible";
+        CultureMatch[CultureMatch["SamePart"] = 2] = "SamePart";
+        CultureMatch[CultureMatch["Default"] = 3] = "Default";
+    })(CultureMatch = DomUtils.CultureMatch || (DomUtils.CultureMatch = {}));
     /**
      * Get the available culture definition
      * @param items Available cultures
@@ -272,12 +282,12 @@ export var DomUtils;
      */
     DomUtils.getCulture = (items, culture) => {
         if (items.length === 0) {
-            return undefined;
+            return [undefined, CultureMatch.Exact];
         }
         // Exact match
         const exactMatch = items.find((item) => item.name === culture);
         if (exactMatch)
-            return exactMatch;
+            return [exactMatch, CultureMatch.Exact];
         // Compatible match
         const compatibleMatch = items.find((item) => {
             var _a;
@@ -285,14 +295,14 @@ export var DomUtils;
                 culture.startsWith(item + '-');
         });
         if (compatibleMatch)
-            return compatibleMatch;
+            return [compatibleMatch, CultureMatch.Compatible];
         // Same part, like zh-CN and zh-HK
         const samePart = culture.split('-')[0];
         const samePartMatch = items.find((item) => item.name.startsWith(samePart));
         if (samePartMatch)
-            return samePartMatch;
+            return [samePartMatch, CultureMatch.SamePart];
         // Default
-        return items[0];
+        return [items[0], CultureMatch.Default];
     };
     /**
      * Get input value depending on its type

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@etsoo/shared",
-    "version": "1.1.80",
+    "version": "1.1.81",
     "description": "TypeScript shared utilities and functions",
     "main": "lib/cjs/index.js",
     "module": "lib/mjs/index.js",

package/src/DomUtils.ts

@@ -307,6 +307,16 @@ export namespace DomUtils {
         return dic;
     }
 
+    /**
+     * Culture match case Enum
+     */
+    export enum CultureMatch {
+        Exact,
+        Compatible,
+        SamePart,
+        Default
+    }
+
     /**
      * Get the available culture definition
      * @param items Available cultures
@@ -315,14 +325,14 @@ export namespace DomUtils {
     export const getCulture = <T extends DataTypes.StringRecord>(
         items: DataTypes.CultureDefinition<T>[],
         culture: string
-    ) => {
+    ): [DataTypes.CultureDefinition<T> | undefined, CultureMatch] => {
         if (items.length === 0) {
-            return undefined;
+            return [undefined, CultureMatch.Exact];
         }
 
         // Exact match
         const exactMatch = items.find((item) => item.name === culture);
-        if (exactMatch) return exactMatch;
+        if (exactMatch) return [exactMatch, CultureMatch.Exact];
 
         // Compatible match
         const compatibleMatch = items.find(
@@ -330,17 +340,17 @@ export namespace DomUtils {
                 item.compatibleNames?.includes(culture) ||
                 culture.startsWith(item + '-')
         );
-        if (compatibleMatch) return compatibleMatch;
+        if (compatibleMatch) return [compatibleMatch, CultureMatch.Compatible];
 
         // Same part, like zh-CN and zh-HK
         const samePart = culture.split('-')[0];
         const samePartMatch = items.find((item) =>
             item.name.startsWith(samePart)
         );
-        if (samePartMatch) return samePartMatch;
+        if (samePartMatch) return [samePartMatch, CultureMatch.SamePart];
 
         // Default
-        return items[0];
+        return [items[0], CultureMatch.Default];
     };
 
     /**