adnbn 0.5.7 → 0.6.0

package/dist/locale/adapters/react/LocaleProvider.js

@@ -5,11 +5,11 @@ import { DynamicLocale } from "./../../../locale/providers/index.js";
 const LocaleProvider = ({ children, storage, container = "html" }) => {
   const locale = useMemo(() => new DynamicLocale(storage), []);
   const [lang, setLang] = useState(locale.lang());
-  const _ = useCallback((key, substitutions) => {
-    return locale.trans(key, substitutions);
+  const t = useCallback((key, ...args) => {
+    return locale.trans(key, ...args);
   }, []);
-  const choice = useCallback((key, count, substitutions) => {
-    return locale.choice(key, count, substitutions);
+  const choice = useCallback((key, count, ...args) => {
+    return locale.choice(key, count, ...args);
   }, []);
   const change = useCallback((lang2) => {
     locale.change(lang2).catch((err) => console.error(`[LocaleProvider] Cannot find locale file for "${lang2}" language`, err));
@@ -38,7 +38,7 @@ const LocaleProvider = ({ children, storage, container = "html" }) => {
     LocaleContext.Provider,
     {
       value: {
-        _,
+        t,
         choice,
         change,
         lang,

package/dist/locale/adapters/react/LocaleProvider.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/locale/adapters/react/LocaleProvider.tsx"],"sourcesContent":["import React, {PropsWithChildren, useCallback, useEffect, useMemo, useState} from \"react\";\n\nimport {LocaleContext, LocaleContract} from \"./context\";\n\nimport {getLocaleDir, isLocaleRtl} from \"@locale/utils\";\n\nimport {DynamicLocale} from \"@locale/providers\";\n\nimport {Language} from \"@typing/locale\";\n\nexport interface LocaleProviderProps {\n    storage?: string | false;\n    container?: string | Element | false;\n}\n\nconst LocaleProvider = ({children, storage, container = \"html\"}: PropsWithChildren<LocaleProviderProps>) => {\n    const locale = useMemo(() => new DynamicLocale(storage), []);\n\n    const [lang, setLang] = useState<Language>(locale.lang());\n\n    const _: LocaleContract[\"_\"] = useCallback((key, substitutions): string => {\n        return locale.trans(key, substitutions);\n    }, []);\n\n    const choice: LocaleContract[\"choice\"] = useCallback((key, count, substitutions): string => {\n        return locale.choice(key, count, substitutions);\n    }, []);\n\n    const change: LocaleContract[\"change\"] = useCallback((lang): void => {\n        locale\n            .change(lang)\n            .catch(err => console.error(`[LocaleProvider] Cannot find locale file for \"${lang}\" language`, err));\n    }, []);\n\n    useEffect(() => {\n        if (container === false) {\n            return;\n        }\n\n        const element = typeof container === \"string\" ? document.querySelector(container) : container;\n\n        if (element) {\n            element.setAttribute(\"lang\", lang);\n            element.setAttribute(\"dir\", getLocaleDir(lang));\n\n            return () => {\n                element.removeAttribute(\"lang\");\n                element.removeAttribute(\"dir\");\n            };\n        }\n    }, [lang, container]);\n\n    useEffect(() => {\n        locale.sync().then(lang => setLang(lang));\n    }, []);\n\n    useEffect(() => {\n        return locale.watch(lang => setLang(lang));\n    }, []);\n\n    return (\n        <LocaleContext.Provider\n            value={{\n                _,\n                choice,\n                change,\n                lang,\n                dir: getLocaleDir(lang),\n                isRtl: isLocaleRtl(lang),\n            }}\n        >\n            {children}\n        </LocaleContext.Provider>\n    );\n};\n\nexport default LocaleProvider;\n"],"mappings":"AAAA,OAAO,SAA2B,aAAa,WAAW,SAAS,gBAAe;AAElF,SAAQ,qBAAoC;AAE5C,SAAQ,cAAc,mBAAkB;AAExC,SAAQ,qBAAoB;AAS5B,MAAM,iBAAiB,CAAC,EAAC,UAAU,SAAS,YAAY,OAAM,MAA8C;AACxG,QAAM,SAAS,QAAQ,MAAM,IAAI,cAAc,OAAO,GAAG,CAAC,CAAC;AAE3D,QAAM,CAAC,MAAM,OAAO,IAAI,SAAmB,OAAO,KAAK,CAAC;AAExD,QAAM,IAAyB,YAAY,CAAC,KAAK,kBAA0B;AACvE,WAAO,OAAO,MAAM,KAAK,aAAa;AAAA,EAC1C,GAAG,CAAC,CAAC;AAEL,QAAM,SAAmC,YAAY,CAAC,KAAK,OAAO,kBAA0B;AACxF,WAAO,OAAO,OAAO,KAAK,OAAO,aAAa;AAAA,EAClD,GAAG,CAAC,CAAC;AAEL,QAAM,SAAmC,YAAY,CAACA,UAAe;AACjE,WACK,OAAOA,KAAI,EACX,MAAM,SAAO,QAAQ,MAAM,iDAAiDA,KAAI,cAAc,GAAG,CAAC;AAAA,EAC3G,GAAG,CAAC,CAAC;AAEL,YAAU,MAAM;AACZ,QAAI,cAAc,OAAO;AACrB;AAAA,IACJ;AAEA,UAAM,UAAU,OAAO,cAAc,WAAW,SAAS,cAAc,SAAS,IAAI;AAEpF,QAAI,SAAS;AACT,cAAQ,aAAa,QAAQ,IAAI;AACjC,cAAQ,aAAa,OAAO,aAAa,IAAI,CAAC;AAE9C,aAAO,MAAM;AACT,gBAAQ,gBAAgB,MAAM;AAC9B,gBAAQ,gBAAgB,KAAK;AAAA,MACjC;AAAA,IACJ;AAAA,EACJ,GAAG,CAAC,MAAM,SAAS,CAAC;AAEpB,YAAU,MAAM;AACZ,WAAO,KAAK,EAAE,KAAK,CAAAA,UAAQ,QAAQA,KAAI,CAAC;AAAA,EAC5C,GAAG,CAAC,CAAC;AAEL,YAAU,MAAM;AACZ,WAAO,OAAO,MAAM,CAAAA,UAAQ,QAAQA,KAAI,CAAC;AAAA,EAC7C,GAAG,CAAC,CAAC;AAEL,SACI;AAAA,IAAC,cAAc;AAAA,IAAd;AAAA,MACG,OAAO;AAAA,QACH;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,KAAK,aAAa,IAAI;AAAA,QACtB,OAAO,YAAY,IAAI;AAAA,MAC3B;AAAA;AAAA,IAEC;AAAA,EACL;AAER;AAEA,IAAO,yBAAQ;","names":["lang"]}
+{"version":3,"sources":["../../../../src/locale/adapters/react/LocaleProvider.tsx"],"sourcesContent":["import React, {PropsWithChildren, useCallback, useEffect, useMemo, useState} from \"react\";\n\nimport {LocaleContext, LocaleContract} from \"./context\";\n\nimport {getLocaleDir, isLocaleRtl} from \"@locale/utils\";\n\nimport {DynamicLocale} from \"@locale/providers\";\n\nimport {Language} from \"@typing/locale\";\n\nexport interface LocaleProviderProps {\n    storage?: string | false;\n    container?: string | Element | false;\n}\n\nconst LocaleProvider = ({children, storage, container = \"html\"}: PropsWithChildren<LocaleProviderProps>) => {\n    const locale = useMemo(() => new DynamicLocale(storage), []);\n\n    const [lang, setLang] = useState<Language>(locale.lang());\n\n    const t: LocaleContract[\"t\"] = useCallback((key, ...args): string => {\n        return locale.trans(key, ...args);\n    }, []);\n\n    const choice: LocaleContract[\"choice\"] = useCallback((key, count, ...args): string => {\n        return locale.choice(key, count, ...args);\n    }, []);\n\n    const change: LocaleContract[\"change\"] = useCallback((lang): void => {\n        locale\n            .change(lang)\n            .catch(err => console.error(`[LocaleProvider] Cannot find locale file for \"${lang}\" language`, err));\n    }, []);\n\n    useEffect(() => {\n        if (container === false) {\n            return;\n        }\n\n        const element = typeof container === \"string\" ? document.querySelector(container) : container;\n\n        if (element) {\n            element.setAttribute(\"lang\", lang);\n            element.setAttribute(\"dir\", getLocaleDir(lang));\n\n            return () => {\n                element.removeAttribute(\"lang\");\n                element.removeAttribute(\"dir\");\n            };\n        }\n    }, [lang, container]);\n\n    useEffect(() => {\n        locale.sync().then(lang => setLang(lang));\n    }, []);\n\n    useEffect(() => {\n        return locale.watch(lang => setLang(lang));\n    }, []);\n\n    return (\n        <LocaleContext.Provider\n            value={{\n                t,\n                choice,\n                change,\n                lang,\n                dir: getLocaleDir(lang),\n                isRtl: isLocaleRtl(lang),\n            }}\n        >\n            {children}\n        </LocaleContext.Provider>\n    );\n};\n\nexport default LocaleProvider;\n"],"mappings":"AAAA,OAAO,SAA2B,aAAa,WAAW,SAAS,gBAAe;AAElF,SAAQ,qBAAoC;AAE5C,SAAQ,cAAc,mBAAkB;AAExC,SAAQ,qBAAoB;AAS5B,MAAM,iBAAiB,CAAC,EAAC,UAAU,SAAS,YAAY,OAAM,MAA8C;AACxG,QAAM,SAAS,QAAQ,MAAM,IAAI,cAAc,OAAO,GAAG,CAAC,CAAC;AAE3D,QAAM,CAAC,MAAM,OAAO,IAAI,SAAmB,OAAO,KAAK,CAAC;AAExD,QAAM,IAAyB,YAAY,CAAC,QAAQ,SAAiB;AACjE,WAAO,OAAO,MAAM,KAAK,GAAG,IAAI;AAAA,EACpC,GAAG,CAAC,CAAC;AAEL,QAAM,SAAmC,YAAY,CAAC,KAAK,UAAU,SAAiB;AAClF,WAAO,OAAO,OAAO,KAAK,OAAO,GAAG,IAAI;AAAA,EAC5C,GAAG,CAAC,CAAC;AAEL,QAAM,SAAmC,YAAY,CAACA,UAAe;AACjE,WACK,OAAOA,KAAI,EACX,MAAM,SAAO,QAAQ,MAAM,iDAAiDA,KAAI,cAAc,GAAG,CAAC;AAAA,EAC3G,GAAG,CAAC,CAAC;AAEL,YAAU,MAAM;AACZ,QAAI,cAAc,OAAO;AACrB;AAAA,IACJ;AAEA,UAAM,UAAU,OAAO,cAAc,WAAW,SAAS,cAAc,SAAS,IAAI;AAEpF,QAAI,SAAS;AACT,cAAQ,aAAa,QAAQ,IAAI;AACjC,cAAQ,aAAa,OAAO,aAAa,IAAI,CAAC;AAE9C,aAAO,MAAM;AACT,gBAAQ,gBAAgB,MAAM;AAC9B,gBAAQ,gBAAgB,KAAK;AAAA,MACjC;AAAA,IACJ;AAAA,EACJ,GAAG,CAAC,MAAM,SAAS,CAAC;AAEpB,YAAU,MAAM;AACZ,WAAO,KAAK,EAAE,KAAK,CAAAA,UAAQ,QAAQA,KAAI,CAAC;AAAA,EAC5C,GAAG,CAAC,CAAC;AAEL,YAAU,MAAM;AACZ,WAAO,OAAO,MAAM,CAAAA,UAAQ,QAAQA,KAAI,CAAC;AAAA,EAC7C,GAAG,CAAC,CAAC;AAEL,SACI;AAAA,IAAC,cAAc;AAAA,IAAd;AAAA,MACG,OAAO;AAAA,QACH;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,KAAK,aAAa,IAAI;AAAA,QACtB,OAAO,YAAY,IAAI;AAAA,MAC3B;AAAA;AAAA,IAEC;AAAA,EACL;AAER;AAEA,IAAO,yBAAQ;","names":["lang"]}

package/dist/locale/adapters/react/context.d.ts

@@ -1,18 +1,13 @@
-import * as React from 'react';
-import { LocaleStructure, Language, LocaleDir, LocaleNonPluralKeys, LocaleSubstitutionsFor, LocalePluralKeys } from '../../../types/locale.js';
-import { LocaleNativeStructure } from '../../providers/NativeLocale.js';
-import '../../providers/AbstractLocale.js';
-
-interface LocaleContract<S extends LocaleStructure = LocaleNativeStructure> {
+import { LocaleDir, Language, LocaleNonPluralKeys, LocaleSubstitutionArgs, LocalePluralKeys } from "../../../types/locale.js";
+import { LocaleNativeStructure } from "../../providers/index.js";
+export interface LocaleContract<S extends object = LocaleNativeStructure> {
     lang: Language;
     dir: LocaleDir;
     isRtl: boolean;
-    _<K extends LocaleNonPluralKeys<S>>(key: K, substitutions?: LocaleSubstitutionsFor<S, K>): string;
-    choice<K extends LocalePluralKeys<S>>(key: K, count: number, substitutions?: LocaleSubstitutionsFor<S, K>): string;
+    t<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string;
+    choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string;
     change(lang: Language): void;
 }
-declare const DefaultLocale: LocaleContract;
-declare const LocaleContext: React.Context<LocaleContract<LocaleNativeStructure>>;
-declare const useLocale: () => LocaleContract<LocaleNativeStructure>;
-
-export { DefaultLocale, LocaleContext, type LocaleContract, useLocale };
+export declare const DefaultLocale: LocaleContract;
+export declare const LocaleContext: import("react").Context<LocaleContract<LocaleNativeStructure>>;
+export declare const useLocale: () => LocaleContract<LocaleNativeStructure>;

package/dist/locale/adapters/react/context.js

@@ -1,13 +1,10 @@
 import { createContext, useContext } from "react";
-import {
-  LocaleDir,
-  Language
-} from "./../../../types/locale.js";
+import { LocaleDir, Language } from "./../../../types/locale.js";
 const DefaultLocale = {
   lang: Language.English,
   isRtl: false,
   dir: LocaleDir.LeftToRight,
-  _(key) {
+  t(key) {
     return key;
   },
   choice(key) {

package/dist/locale/adapters/react/context.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/locale/adapters/react/context.ts"],"sourcesContent":["import {createContext, useContext} from \"react\";\n\nimport {\n    LocaleDir,\n    Language,\n    LocaleNonPluralKeys,\n    LocaleStructure,\n    LocaleSubstitutionsFor,\n    LocalePluralKeys,\n} from \"@typing/locale\";\n\nimport {LocaleNativeStructure} from \"@locale/providers\";\n\nexport interface LocaleContract<S extends LocaleStructure = LocaleNativeStructure> {\n    lang: Language;\n\n    dir: LocaleDir;\n\n    isRtl: boolean;\n\n    _<K extends LocaleNonPluralKeys<S>>(key: K, substitutions?: LocaleSubstitutionsFor<S, K>): string;\n\n    choice<K extends LocalePluralKeys<S>>(key: K, count: number, substitutions?: LocaleSubstitutionsFor<S, K>): string;\n\n    change(lang: Language): void;\n}\n\nexport const DefaultLocale: LocaleContract = {\n    lang: Language.English,\n    isRtl: false,\n    dir: LocaleDir.LeftToRight,\n    _(key: string): string {\n        return key as string;\n    },\n    choice(key: string): string {\n        return key;\n    },\n    change(_lang: Language) {},\n};\n\nexport const LocaleContext = createContext<LocaleContract>(DefaultLocale);\n\nLocaleContext.displayName = \"LocaleContext\";\n\nexport const useLocale = () => useContext(LocaleContext);\n"],"mappings":"AAAA,SAAQ,eAAe,kBAAiB;AAExC;AAAA,EACI;AAAA,EACA;AAAA,OAKG;AAkBA,MAAM,gBAAgC;AAAA,EACzC,MAAM,SAAS;AAAA,EACf,OAAO;AAAA,EACP,KAAK,UAAU;AAAA,EACf,EAAE,KAAqB;AACnB,WAAO;AAAA,EACX;AAAA,EACA,OAAO,KAAqB;AACxB,WAAO;AAAA,EACX;AAAA,EACA,OAAO,OAAiB;AAAA,EAAC;AAC7B;AAEO,MAAM,gBAAgB,cAA8B,aAAa;AAExE,cAAc,cAAc;AAErB,MAAM,YAAY,MAAM,WAAW,aAAa;","names":[]}
+{"version":3,"sources":["../../../../src/locale/adapters/react/context.ts"],"sourcesContent":["import {createContext, useContext} from \"react\";\n\nimport {LocaleDir, Language, LocaleNonPluralKeys, LocaleSubstitutionArgs, LocalePluralKeys} from \"@typing/locale\";\n\nimport {LocaleNativeStructure} from \"@locale/providers\";\n\nexport interface LocaleContract<S extends object = LocaleNativeStructure> {\n    lang: Language;\n\n    dir: LocaleDir;\n\n    isRtl: boolean;\n\n    t<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string;\n\n    choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string;\n\n    change(lang: Language): void;\n}\n\nexport const DefaultLocale: LocaleContract = {\n    lang: Language.English,\n    isRtl: false,\n    dir: LocaleDir.LeftToRight,\n    t(key: string): string {\n        return key as string;\n    },\n    choice(key: string): string {\n        return key;\n    },\n    change(_lang: Language) {},\n};\n\nexport const LocaleContext = createContext<LocaleContract>(DefaultLocale);\n\nLocaleContext.displayName = \"LocaleContext\";\n\nexport const useLocale = () => useContext(LocaleContext);\n"],"mappings":"AAAA,SAAQ,eAAe,kBAAiB;AAExC,SAAQ,WAAW,gBAA8E;AAkB1F,MAAM,gBAAgC;AAAA,EACzC,MAAM,SAAS;AAAA,EACf,OAAO;AAAA,EACP,KAAK,UAAU;AAAA,EACf,EAAE,KAAqB;AACnB,WAAO;AAAA,EACX;AAAA,EACA,OAAO,KAAqB;AACxB,WAAO;AAAA,EACX;AAAA,EACA,OAAO,OAAiB;AAAA,EAAC;AAC7B;AAEO,MAAM,gBAAgB,cAA8B,aAAa;AAExE,cAAc,cAAc;AAErB,MAAM,YAAY,MAAM,WAAW,aAAa;","names":[]}

package/dist/locale/adapters/react/index.d.ts

@@ -1,6 +1,2 @@
-export { default as LocaleProvider, LocaleProviderProps } from './LocaleProvider.js';
-export { LocaleContract, useLocale } from './context.js';
-import 'react';
-import '../../../types/locale.js';
-import '../../providers/NativeLocale.js';
-import '../../providers/AbstractLocale.js';
+export { default as LocaleProvider, type LocaleProviderProps } from "./LocaleProvider.js";
+export { useLocale, type LocaleContract } from "./context.js";

package/dist/locale/helpers.d.ts

@@ -1,47 +1,71 @@
-import { LocaleNonPluralKeys, LocaleSubstitutionsFor, LocalePluralKeys } from '../types/locale.js';
-import { LocaleNativeStructure } from './providers/NativeLocale.js';
-import './providers/AbstractLocale.js';
-
+import { LocaleNativeStructure } from "./providers/index.js";
+import { LocaleNonPluralKeys, LocalePluralKeys, LocaleSubstitutionArgs } from "../types/locale.js";
 /**
- * Translates a given locale key into the corresponding localized string.
+ * Translates a non-plural locale key.
  *
- * @template K - A type representing the non-plural keys of the locale structure.
- * @param {K} key - The locale key to be translated.
- * @param {LocaleSubstitutionsFor<LocaleNativeStructure, K>} [substitutions] - Optional substitutions to be applied
- * within the localized string. These are typically placeholders replaced with dynamic values.
- * @returns {string} - The translated string for the given key, with substitutions applied if provided.
+ * Substitutions are type-checked from the generated locale structure:
+ * keys without placeholders do not accept substitutions, while keys with
+ * placeholders require all declared substitution values.
+ *
+ * @example
+ * ```ts
+ * t("app.name");
+ * t("app.greeting", {name: "Alice"});
+ * ```
+ *
+ * @param key - The locale key to translate.
+ * @param args
+ * @returns The translated string.
  */
-declare const _: <K extends LocaleNonPluralKeys<LocaleNativeStructure>>(key: K, substitutions?: LocaleSubstitutionsFor<LocaleNativeStructure, K>) => string;
+export declare const t: <K extends LocaleNonPluralKeys<LocaleNativeStructure>>(key: K, ...args: LocaleSubstitutionArgs<LocaleNativeStructure, K>) => string;
 /**
- * Translates a given locale key into the corresponding localized string
- * based on a specific count for pluralization.
- *
- * @template K - A type representing the non-plural keys of the locale structure.
- * @param {K} key - The locale key to be translated.
- * @param {number} count - The count used to determine the pluralization form.
- * @param {LocaleSubstitutionsFor<LocaleNativeStructure, K>} [substitutions] - Optional substitutions to be applied
- * within the localized string. These are typically placeholders replaced with dynamic values.
- * @returns {string} - The translated string for the given key, adjusted for pluralization and with substitutions applied if provided.
+ * Translates a plural locale key using the provided count.
+ *
+ * Substitutions are type-checked from the generated locale structure:
+ * keys without placeholders do not accept substitutions, while keys with
+ * placeholders require all declared substitution values.
+ *
+ * @example
+ * ```ts
+ * choice("cart.items", count, {count});
+ * ```
+ *
+ * @param key - The locale key to translate.
+ * @param count - The count used to select the plural form.
+ * @param args
+ * @returns The translated string.
  */
-declare const _c: <K extends LocalePluralKeys<LocaleNativeStructure>>(key: K, count: number, substitutions?: LocaleSubstitutionsFor<LocaleNativeStructure, K>) => string;
+export declare const choice: <K extends LocalePluralKeys<LocaleNativeStructure>>(key: K, count: number, ...args: LocaleSubstitutionArgs<LocaleNativeStructure, K>) => string;
 /**
- * Converts a locale key into a standardized format and logs a warning if the key is not found
- * in the current language's locale keys.
+ * Converts a locale key to a browser message reference.
  *
- * @param {Extract<keyof LocaleNativeStructure, string>} key - The locale key to be converted.
- * This key must be a string and exist within the `LocaleNativeStructure`.
- * @returns {string} - The converted locale message key.
+ * This is useful for browser-managed extension fields that expect
+ * `__MSG_name__` references instead of already translated text.
+ *
+ * A warning is logged when the key does not exist in the generated locale keys.
+ *
+ * @example
+ * ```ts
+ * key("app.name"); // "__MSG_app_name__"
+ * ```
+ *
+ * @param value - The locale key to convert.
+ * @returns The browser message reference.
  */
-declare const __: (key: keyof LocaleNativeStructure & string) => string;
+export declare const key: (value: keyof LocaleNativeStructure & string) => string;
 /**
- * Attempts to extract a locale key from the provided string and translates it
- * into the corresponding localized string. If no locale key can be extracted,
- * the original string is returned.
+ * Resolves a string that may contain a locale marker.
+ *
+ * When the input contains a locale marker, the marker is extracted and translated.
+ * Plain strings are returned unchanged.
+ *
+ * @example
+ * ```ts
+ * resolve("@app.name");
+ * resolve("Plain title");
+ * ```
  *
- * @param {string} input - The input string from which a locale key is to be extracted.
- * @returns {string} - The translated string if a locale key is successfully extracted,
- * or the original string if no locale key is found.
+ * @param input - A plain string or a marked locale key string.
+ * @returns The translated text when a marker is found, otherwise the original input.
  */
-declare const __t: (input: string) => string;
-
-export { _, __, __t, _c };
+export declare const resolve: (input: string) => string;

package/dist/locale/helpers.js

@@ -1,29 +1,29 @@
 import { NativeLocale } from "./../locale/providers/index.js";
 import { convertLocaleMessageKey, extractLocaleKey } from "./../locale/utils.js";
-const _ = (key, substitutions) => {
-  return NativeLocale.getInstance().trans(key, substitutions);
+const t = (key2, ...args) => {
+  return NativeLocale.getInstance().trans(key2, ...args);
 };
-const _c = (key, count, substitutions) => {
-  return NativeLocale.getInstance().choice(key, count, substitutions);
+const choice = (key2, count, ...args) => {
+  return NativeLocale.getInstance().choice(key2, count, ...args);
 };
-const __ = (key) => {
+const key = (value) => {
   const locale = NativeLocale.getInstance();
-  if (!locale.keys().has(key)) {
-    console.warn(`Locale key "${key}" not found in "${locale.lang()}" language.`);
+  if (!locale.keys().has(value)) {
+    console.warn(`Locale key "${value}" not found in "${locale.lang()}" language.`);
   }
-  return convertLocaleMessageKey(key);
+  return convertLocaleMessageKey(value);
 };
-const __t = (input) => {
+const resolve = (input) => {
   const localeKey = extractLocaleKey(input);
   if (localeKey) {
-    return _(localeKey);
+    return t(localeKey);
   }
   return input;
 };
 export {
-  _,
-  __,
-  __t,
-  _c
+  choice,
+  key,
+  resolve,
+  t
 };
 //# sourceMappingURL=helpers.js.map

package/dist/locale/helpers.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/locale/helpers.ts"],"sourcesContent":["import {LocaleNativeStructure, NativeLocale} from \"@locale/providers\";\nimport {convertLocaleMessageKey, extractLocaleKey} from \"@locale/utils\";\nimport {LocaleNonPluralKeys, LocalePluralKeys, LocaleSubstitutionsFor} from \"@typing/locale\";\n\n/**\n * Translates a given locale key into the corresponding localized string.\n *\n * @template K - A type representing the non-plural keys of the locale structure.\n * @param {K} key - The locale key to be translated.\n * @param {LocaleSubstitutionsFor<LocaleNativeStructure, K>} [substitutions] - Optional substitutions to be applied\n * within the localized string. These are typically placeholders replaced with dynamic values.\n * @returns {string} - The translated string for the given key, with substitutions applied if provided.\n */\nexport const _ = <K extends LocaleNonPluralKeys<LocaleNativeStructure>>(\n    key: K,\n    substitutions?: LocaleSubstitutionsFor<LocaleNativeStructure, K>\n): string => {\n    return NativeLocale.getInstance().trans(key, substitutions);\n};\n\n/**\n * Translates a given locale key into the corresponding localized string\n * based on a specific count for pluralization.\n *\n * @template K - A type representing the non-plural keys of the locale structure.\n * @param {K} key - The locale key to be translated.\n * @param {number} count - The count used to determine the pluralization form.\n * @param {LocaleSubstitutionsFor<LocaleNativeStructure, K>} [substitutions] - Optional substitutions to be applied\n * within the localized string. These are typically placeholders replaced with dynamic values.\n * @returns {string} - The translated string for the given key, adjusted for pluralization and with substitutions applied if provided.\n */\nexport const _c = <K extends LocalePluralKeys<LocaleNativeStructure>>(\n    key: K,\n    count: number,\n    substitutions?: LocaleSubstitutionsFor<LocaleNativeStructure, K>\n): string => {\n    return NativeLocale.getInstance().choice(key, count, substitutions);\n};\n\n/**\n * Converts a locale key into a standardized format and logs a warning if the key is not found\n * in the current language's locale keys.\n *\n * @param {Extract<keyof LocaleNativeStructure, string>} key - The locale key to be converted.\n * This key must be a string and exist within the `LocaleNativeStructure`.\n * @returns {string} - The converted locale message key.\n */\nexport const __ = (key: keyof LocaleNativeStructure & string): string => {\n    const locale = NativeLocale.getInstance();\n\n    if (!locale.keys().has(key)) {\n        console.warn(`Locale key \"${key}\" not found in \"${locale.lang()}\" language.`);\n    }\n\n    return convertLocaleMessageKey(key);\n};\n\n/**\n * Attempts to extract a locale key from the provided string and translates it\n * into the corresponding localized string. If no locale key can be extracted,\n * the original string is returned.\n *\n * @param {string} input - The input string from which a locale key is to be extracted.\n * @returns {string} - The translated string if a locale key is successfully extracted,\n * or the original string if no locale key is found.\n */\nexport const __t = (input: string): string => {\n    const localeKey = extractLocaleKey(input);\n\n    if (localeKey) {\n        return _(localeKey as LocaleNonPluralKeys<LocaleNativeStructure>);\n    }\n\n    return input;\n};\n"],"mappings":"AAAA,SAA+B,oBAAmB;AAClD,SAAQ,yBAAyB,wBAAuB;AAYjD,MAAM,IAAI,CACb,KACA,kBACS;AACT,SAAO,aAAa,YAAY,EAAE,MAAM,KAAK,aAAa;AAC9D;AAaO,MAAM,KAAK,CACd,KACA,OACA,kBACS;AACT,SAAO,aAAa,YAAY,EAAE,OAAO,KAAK,OAAO,aAAa;AACtE;AAUO,MAAM,KAAK,CAAC,QAAsD;AACrE,QAAM,SAAS,aAAa,YAAY;AAExC,MAAI,CAAC,OAAO,KAAK,EAAE,IAAI,GAAG,GAAG;AACzB,YAAQ,KAAK,eAAe,GAAG,mBAAmB,OAAO,KAAK,CAAC,aAAa;AAAA,EAChF;AAEA,SAAO,wBAAwB,GAAG;AACtC;AAWO,MAAM,MAAM,CAAC,UAA0B;AAC1C,QAAM,YAAY,iBAAiB,KAAK;AAExC,MAAI,WAAW;AACX,WAAO,EAAE,SAAuD;AAAA,EACpE;AAEA,SAAO;AACX;","names":[]}
+{"version":3,"sources":["../../src/locale/helpers.ts"],"sourcesContent":["import {LocaleNativeStructure, NativeLocale} from \"@locale/providers\";\nimport {convertLocaleMessageKey, extractLocaleKey} from \"@locale/utils\";\nimport {LocaleNonPluralKeys, LocalePluralKeys, LocaleSubstitutionArgs} from \"@typing/locale\";\n\n/**\n * Translates a non-plural locale key.\n *\n * Substitutions are type-checked from the generated locale structure:\n * keys without placeholders do not accept substitutions, while keys with\n * placeholders require all declared substitution values.\n *\n * @example\n * ```ts\n * t(\"app.name\");\n * t(\"app.greeting\", {name: \"Alice\"});\n * ```\n *\n * @param key - The locale key to translate.\n * @param args\n * @returns The translated string.\n */\nexport const t = <K extends LocaleNonPluralKeys<LocaleNativeStructure>>(\n    key: K,\n    ...args: LocaleSubstitutionArgs<LocaleNativeStructure, K>\n): string => {\n    return NativeLocale.getInstance().trans(key, ...args);\n};\n\n/**\n * Translates a plural locale key using the provided count.\n *\n * Substitutions are type-checked from the generated locale structure:\n * keys without placeholders do not accept substitutions, while keys with\n * placeholders require all declared substitution values.\n *\n * @example\n * ```ts\n * choice(\"cart.items\", count, {count});\n * ```\n *\n * @param key - The locale key to translate.\n * @param count - The count used to select the plural form.\n * @param args\n * @returns The translated string.\n */\nexport const choice = <K extends LocalePluralKeys<LocaleNativeStructure>>(\n    key: K,\n    count: number,\n    ...args: LocaleSubstitutionArgs<LocaleNativeStructure, K>\n): string => {\n    return NativeLocale.getInstance().choice(key, count, ...args);\n};\n\n/**\n * Converts a locale key to a browser message reference.\n *\n * This is useful for browser-managed extension fields that expect\n * `__MSG_name__` references instead of already translated text.\n *\n * A warning is logged when the key does not exist in the generated locale keys.\n *\n * @example\n * ```ts\n * key(\"app.name\"); // \"__MSG_app_name__\"\n * ```\n *\n * @param value - The locale key to convert.\n * @returns The browser message reference.\n */\nexport const key = (value: keyof LocaleNativeStructure & string): string => {\n    const locale = NativeLocale.getInstance();\n\n    if (!locale.keys().has(value)) {\n        console.warn(`Locale key \"${value}\" not found in \"${locale.lang()}\" language.`);\n    }\n\n    return convertLocaleMessageKey(value);\n};\n\n/**\n * Resolves a string that may contain a locale marker.\n *\n * When the input contains a locale marker, the marker is extracted and translated.\n * Plain strings are returned unchanged.\n *\n * @example\n * ```ts\n * resolve(\"@app.name\");\n * resolve(\"Plain title\");\n * ```\n *\n * @param input - A plain string or a marked locale key string.\n * @returns The translated text when a marker is found, otherwise the original input.\n */\nexport const resolve = (input: string): string => {\n    const localeKey = extractLocaleKey(input);\n\n    if (localeKey) {\n        return t(localeKey as LocaleNonPluralKeys<LocaleNativeStructure>);\n    }\n\n    return input;\n};\n"],"mappings":"AAAA,SAA+B,oBAAmB;AAClD,SAAQ,yBAAyB,wBAAuB;AAoBjD,MAAM,IAAI,CACbA,SACG,SACM;AACT,SAAO,aAAa,YAAY,EAAE,MAAMA,MAAK,GAAG,IAAI;AACxD;AAmBO,MAAM,SAAS,CAClBA,MACA,UACG,SACM;AACT,SAAO,aAAa,YAAY,EAAE,OAAOA,MAAK,OAAO,GAAG,IAAI;AAChE;AAkBO,MAAM,MAAM,CAAC,UAAwD;AACxE,QAAM,SAAS,aAAa,YAAY;AAExC,MAAI,CAAC,OAAO,KAAK,EAAE,IAAI,KAAK,GAAG;AAC3B,YAAQ,KAAK,eAAe,KAAK,mBAAmB,OAAO,KAAK,CAAC,aAAa;AAAA,EAClF;AAEA,SAAO,wBAAwB,KAAK;AACxC;AAiBO,MAAM,UAAU,CAAC,UAA0B;AAC9C,QAAM,YAAY,iBAAiB,KAAK;AAExC,MAAI,WAAW;AACX,WAAO,EAAE,SAAuD;AAAA,EACpE;AAEA,SAAO;AACX;","names":["key"]}

package/dist/locale/index.d.ts

@@ -1,7 +1,3 @@
-export { default as AbstractLocale } from './providers/AbstractLocale.js';
-export { default as DynamicLocale } from './providers/DynamicLocale.js';
-export { LocaleNativeStructure, default as NativeLocale } from './providers/NativeLocale.js';
-export { _, __, __t, _c } from './helpers.js';
-export { Language, LanguageCodes, LocaleDir, LocaleDynamicProvider, LocaleKeys, LocaleNonPluralKeys, LocalePluralKeys, LocaleProvider, LocaleStructure, LocaleSubstitutionsFor } from '../types/locale.js';
-import '@addon-core/storage';
-import './providers/CustomLocale.js';
+export * from "./providers/index.js";
+export * from "./helpers.js";
+export { Language, LanguageCodes, LocaleDir, type LocaleStructure, type LocaleProvider, type LocaleDynamicProvider, type LocaleKeys, type LocaleSubstitutionArgs, type LocaleSubstitutionKeys, type LocaleSubstitutionValue, type LocaleNonPluralKeys, type LocalePluralKeys, } from "../types/locale.js";

package/dist/locale/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/locale/index.ts"],"sourcesContent":["export * from \"./providers\";\nexport * from \"./helpers\";\n\nexport {\n    Language,\n    LanguageCodes,\n    LocaleDir,\n    type LocaleStructure,\n    type LocaleProvider,\n    type LocaleDynamicProvider,\n    type LocaleKeys,\n    type LocaleSubstitutionsFor,\n    type LocaleNonPluralKeys,\n    type LocalePluralKeys,\n} from \"@typing/locale\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AAEd;AAAA,EACI;AAAA,EACA;AAAA,EACA;AAAA,OAQG;","names":[]}
+{"version":3,"sources":["../../src/locale/index.ts"],"sourcesContent":["export * from \"./providers\";\nexport * from \"./helpers\";\n\nexport {\n    Language,\n    LanguageCodes,\n    LocaleDir,\n    type LocaleStructure,\n    type LocaleProvider,\n    type LocaleDynamicProvider,\n    type LocaleKeys,\n    type LocaleSubstitutionArgs,\n    type LocaleSubstitutionKeys,\n    type LocaleSubstitutionValue,\n    type LocaleNonPluralKeys,\n    type LocalePluralKeys,\n} from \"@typing/locale\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AAEd;AAAA,EACI;AAAA,EACA;AAAA,EACA;AAAA,OAUG;","names":[]}

package/dist/locale/providers/AbstractLocale.d.ts

@@ -1,14 +1,11 @@
-import { LocaleStructure, LocaleProvider, Language, LocaleNonPluralKeys, LocaleSubstitutionsFor, LocalePluralKeys } from '../../types/locale.js';
-
-declare abstract class export_default<S extends LocaleStructure> implements LocaleProvider<S> {
+import { Language, LocaleNonPluralKeys, LocalePluralKeys, LocaleProvider, LocaleStructure, LocaleSubstitutionArgs, LocaleSubstitutionValue } from "../../types/locale.js";
+export default abstract class<S extends object = LocaleStructure> implements LocaleProvider<S> {
     abstract lang(): Language;
     abstract keys(): Set<keyof S>;
     abstract languages(): Set<Language>;
     protected abstract value(key: keyof S & string): string | undefined;
-    trans<K extends LocaleNonPluralKeys<S>>(key: K, substitutions?: LocaleSubstitutionsFor<S, K>): string;
-    choice<K extends LocalePluralKeys<S>>(key: K, count: number, substitutions?: LocaleSubstitutionsFor<S, K>): string;
-    get<K extends keyof S & string>(key: K, substitutions?: LocaleSubstitutionsFor<S, K>): string;
+    trans<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string;
+    choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string;
+    get<K extends keyof S & string>(key: K, substitutions?: Record<string, LocaleSubstitutionValue>): string;
     private getPluralIndex;
 }
-
-export { export_default as default };

package/dist/locale/providers/AbstractLocale.js

@@ -3,10 +3,12 @@ import {
   LocaleValuesSeparator
 } from "./../../types/locale.js";
 class AbstractLocale_default {
-  trans(key, substitutions) {
+  trans(key, ...args) {
+    const [substitutions] = args;
     return this.get(key, substitutions);
   }
-  choice(key, count, substitutions) {
+  choice(key, count, ...args) {
+    const [substitutions] = args;
     const parts = this.get(key, substitutions).split(LocaleValuesSeparator);
     const idx = this.getPluralIndex(count);
     return parts[idx] ?? parts[0] ?? key;
@@ -19,13 +21,14 @@ class AbstractLocale_default {
     }
     if (substitutions) {
       return template.replace(/{{(.*?)}}/g, (_, placeholder) => {
-        if (placeholder in substitutions) {
-          return substitutions[placeholder].toString();
+        const substitution = placeholder.trim();
+        if (substitution in substitutions) {
+          return substitutions[substitution].toString();
         }
         console.warn(
-          `Locale substitution "${placeholder}" not found for key "${key}" in "${this.lang()}" language.`
+          `Locale substitution "${substitution}" not found for key "${key}" in "${this.lang()}" language.`
         );
-        return placeholder;
+        return substitution;
       });
     }
     return template;

package/dist/locale/providers/AbstractLocale.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/locale/providers/AbstractLocale.ts"],"sourcesContent":["import {\n    Language,\n    LocaleNonPluralKeys,\n    LocalePluralKeys,\n    LocaleProvider,\n    LocaleStructure,\n    LocaleSubstitutionsFor,\n    LocaleValuesSeparator,\n} from \"@typing/locale\";\n\nexport default abstract class<S extends LocaleStructure> implements LocaleProvider<S> {\n    public abstract lang(): Language;\n\n    public abstract keys(): Set<keyof S>;\n\n    public abstract languages(): Set<Language>;\n\n    protected abstract value(key: keyof S & string): string | undefined;\n\n    public trans<K extends LocaleNonPluralKeys<S>>(key: K, substitutions?: LocaleSubstitutionsFor<S, K>): string {\n        return this.get(key, substitutions);\n    }\n\n    public choice<K extends LocalePluralKeys<S>>(\n        key: K,\n        count: number,\n        substitutions?: LocaleSubstitutionsFor<S, K>\n    ): string {\n        const parts = this.get(key, substitutions).split(LocaleValuesSeparator);\n\n        const idx = this.getPluralIndex(count);\n\n        return parts[idx] ?? parts[0] ?? (key as string);\n    }\n\n    public get<K extends keyof S & string>(key: K, substitutions?: LocaleSubstitutionsFor<S, K>): string {\n        const template = this.value(key);\n\n        if (template === undefined) {\n            console.warn(`Locale key \"${key}\" not found in \"${this.lang()}\" language.`);\n\n            return key as string;\n        }\n\n        if (substitutions) {\n            return template.replace(/{{(.*?)}}/g, (_, placeholder: string) => {\n                if (placeholder in substitutions) {\n                    return substitutions[placeholder]!.toString();\n                }\n\n                console.warn(\n                    `Locale substitution \"${placeholder}\" not found for key \"${key}\" in \"${this.lang()}\" language.`\n                );\n\n                return placeholder;\n            });\n        }\n\n        return template;\n    }\n\n    private getPluralIndex(count: number): number {\n        switch (this.lang()) {\n            case Language.Indonesian:\n            case Language.Japanese:\n            case Language.Kannada:\n            case Language.Korean:\n            case Language.Malay:\n            case Language.Thai:\n            case Language.Turkish:\n            case Language.Vietnamese:\n                return 0;\n\n            case Language.Bengali:\n            case Language.Bulgarian:\n            case Language.Catalan:\n            case Language.Danish:\n            case Language.German:\n            case Language.Greek:\n            case Language.English:\n            case Language.EnglishAustralia:\n            case Language.EnglishGreatBritain:\n            case Language.EnglishUSA:\n            case Language.Spanish:\n            case Language.SpanishLatinAmericaAndCaribbean:\n            case Language.Estonian:\n            case Language.Persian:\n            case Language.Finnish:\n            case Language.Gujarati:\n            case Language.Hebrew:\n            case Language.Hungarian:\n            case Language.Italian:\n            case Language.Malayalam:\n            case Language.Marathi:\n            case Language.Dutch:\n            case Language.Norwegian:\n            case Language.Swedish:\n            case Language.Swahili:\n            case Language.Tamil:\n            case Language.Telugu:\n            case Language.ChineseChina:\n            case Language.ChineseTaiwan:\n            case Language.PortugueseBrazil:\n            case Language.PortuguesePortugal:\n                return count == 1 ? 0 : 1;\n\n            case Language.Amharic:\n            case Language.Filipino:\n            case Language.French:\n            case Language.Hindi:\n                return count == 0 || count == 1 ? 0 : 1;\n\n            case Language.Croatian:\n            case Language.Russian:\n            case Language.Serbian:\n            case Language.Ukrainian:\n                return count % 10 == 1 && count % 100 != 11\n                    ? 0\n                    : count % 10 >= 2 && count % 10 <= 4 && (count % 100 < 10 || count % 100 >= 20)\n                      ? 1\n                      : 2;\n\n            case Language.Czech:\n            case Language.Slovak:\n                return count == 1 ? 0 : count >= 2 && count <= 4 ? 1 : 2;\n\n            case Language.Lithuanian:\n                return count % 10 == 1 && count % 100 != 11\n                    ? 0\n                    : count % 10 >= 2 && (count % 100 < 10 || count % 100 >= 20)\n                      ? 1\n                      : 2;\n\n            case Language.Slovenian:\n                return count % 100 == 1 ? 0 : count % 100 == 2 ? 1 : count % 100 == 3 || count % 100 == 4 ? 2 : 3;\n\n            case Language.Latvian:\n                return count == 0 ? 0 : count % 10 == 1 && count % 100 != 11 ? 1 : 2;\n\n            case Language.Polish:\n                return count == 1\n                    ? 0\n                    : count % 10 >= 2 && count % 10 <= 4 && (count % 100 < 12 || count % 100 > 14)\n                      ? 1\n                      : 2;\n\n            case Language.Romanian:\n                return count == 1 ? 0 : count == 0 || (count % 100 > 0 && count % 100 < 20) ? 1 : 2;\n\n            case Language.Arabic:\n                return count == 0\n                    ? 0\n                    : count == 1\n                      ? 1\n                      : count == 2\n                        ? 2\n                        : count % 100 >= 3 && count % 100 <= 10\n                          ? 3\n                          : count % 100 >= 11 && count % 100 <= 99\n                            ? 4\n                            : 5;\n\n            default:\n                return 0;\n        }\n    }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/locale/providers/AbstractLocale.ts"],"sourcesContent":["import {\n    Language,\n    LocaleNonPluralKeys,\n    LocalePluralKeys,\n    LocaleProvider,\n    LocaleStructure,\n    LocaleSubstitutionArgs,\n    LocaleSubstitutionValue,\n    LocaleValuesSeparator,\n} from \"@typing/locale\";\n\nexport default abstract class<S extends object = LocaleStructure> implements LocaleProvider<S> {\n    public abstract lang(): Language;\n\n    public abstract keys(): Set<keyof S>;\n\n    public abstract languages(): Set<Language>;\n\n    protected abstract value(key: keyof S & string): string | undefined;\n\n    public trans<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string {\n        const [substitutions] = args;\n\n        return this.get(key, substitutions);\n    }\n\n    public choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string {\n        const [substitutions] = args;\n        const parts = this.get(key, substitutions).split(LocaleValuesSeparator);\n\n        const idx = this.getPluralIndex(count);\n\n        return parts[idx] ?? parts[0] ?? (key as string);\n    }\n\n    public get<K extends keyof S & string>(key: K, substitutions?: Record<string, LocaleSubstitutionValue>): string {\n        const template = this.value(key);\n\n        if (template === undefined) {\n            console.warn(`Locale key \"${key}\" not found in \"${this.lang()}\" language.`);\n\n            return key as string;\n        }\n\n        if (substitutions) {\n            return template.replace(/{{(.*?)}}/g, (_, placeholder: string) => {\n                const substitution = placeholder.trim();\n\n                if (substitution in substitutions) {\n                    return substitutions[substitution]!.toString();\n                }\n\n                console.warn(\n                    `Locale substitution \"${substitution}\" not found for key \"${key}\" in \"${this.lang()}\" language.`\n                );\n\n                return substitution;\n            });\n        }\n\n        return template;\n    }\n\n    private getPluralIndex(count: number): number {\n        switch (this.lang()) {\n            case Language.Indonesian:\n            case Language.Japanese:\n            case Language.Kannada:\n            case Language.Korean:\n            case Language.Malay:\n            case Language.Thai:\n            case Language.Turkish:\n            case Language.Vietnamese:\n                return 0;\n\n            case Language.Bengali:\n            case Language.Bulgarian:\n            case Language.Catalan:\n            case Language.Danish:\n            case Language.German:\n            case Language.Greek:\n            case Language.English:\n            case Language.EnglishAustralia:\n            case Language.EnglishGreatBritain:\n            case Language.EnglishUSA:\n            case Language.Spanish:\n            case Language.SpanishLatinAmericaAndCaribbean:\n            case Language.Estonian:\n            case Language.Persian:\n            case Language.Finnish:\n            case Language.Gujarati:\n            case Language.Hebrew:\n            case Language.Hungarian:\n            case Language.Italian:\n            case Language.Malayalam:\n            case Language.Marathi:\n            case Language.Dutch:\n            case Language.Norwegian:\n            case Language.Swedish:\n            case Language.Swahili:\n            case Language.Tamil:\n            case Language.Telugu:\n            case Language.ChineseChina:\n            case Language.ChineseTaiwan:\n            case Language.PortugueseBrazil:\n            case Language.PortuguesePortugal:\n                return count == 1 ? 0 : 1;\n\n            case Language.Amharic:\n            case Language.Filipino:\n            case Language.French:\n            case Language.Hindi:\n                return count == 0 || count == 1 ? 0 : 1;\n\n            case Language.Croatian:\n            case Language.Russian:\n            case Language.Serbian:\n            case Language.Ukrainian:\n                return count % 10 == 1 && count % 100 != 11\n                    ? 0\n                    : count % 10 >= 2 && count % 10 <= 4 && (count % 100 < 10 || count % 100 >= 20)\n                      ? 1\n                      : 2;\n\n            case Language.Czech:\n            case Language.Slovak:\n                return count == 1 ? 0 : count >= 2 && count <= 4 ? 1 : 2;\n\n            case Language.Lithuanian:\n                return count % 10 == 1 && count % 100 != 11\n                    ? 0\n                    : count % 10 >= 2 && (count % 100 < 10 || count % 100 >= 20)\n                      ? 1\n                      : 2;\n\n            case Language.Slovenian:\n                return count % 100 == 1 ? 0 : count % 100 == 2 ? 1 : count % 100 == 3 || count % 100 == 4 ? 2 : 3;\n\n            case Language.Latvian:\n                return count == 0 ? 0 : count % 10 == 1 && count % 100 != 11 ? 1 : 2;\n\n            case Language.Polish:\n                return count == 1\n                    ? 0\n                    : count % 10 >= 2 && count % 10 <= 4 && (count % 100 < 12 || count % 100 > 14)\n                      ? 1\n                      : 2;\n\n            case Language.Romanian:\n                return count == 1 ? 0 : count == 0 || (count % 100 > 0 && count % 100 < 20) ? 1 : 2;\n\n            case Language.Arabic:\n                return count == 0\n                    ? 0\n                    : count == 1\n                      ? 1\n                      : count == 2\n                        ? 2\n                        : count % 100 >= 3 && count % 100 <= 10\n                          ? 3\n                          : count % 100 >= 11 && count % 100 <= 99\n                            ? 4\n                            : 5;\n\n            default:\n                return 0;\n        }\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/locale/providers/CustomLocale.d.ts

@@ -1,17 +1,14 @@
-import export_default$1 from './AbstractLocale.js';
-import { LocaleStructure, Language } from '../../types/locale.js';
-
-type CustomLocaleData = Record<string, string>;
-declare class export_default<T extends LocaleStructure = LocaleStructure> extends export_default$1<T> {
+import AbstractLocale from "./AbstractLocale.js";
+import { Language, LocaleStructure } from "../../types/locale.js";
+export type CustomLocaleData = Record<string, string>;
+export default class<T extends object = LocaleStructure> extends AbstractLocale<T> {
     protected language: Language;
     protected data: CustomLocaleData;
     constructor(language?: Language, data?: CustomLocaleData);
     setLang(lang: Language): this;
     setData(data: CustomLocaleData): this;
     lang(): Language;
-    keys(): Set<string>;
+    keys(): Set<keyof T>;
     languages(): Set<Language>;
     protected value(key: string): string | undefined;
 }
-
-export { type CustomLocaleData, export_default as default };

package/dist/locale/providers/CustomLocale.js

@@ -7,6 +7,8 @@ class CustomLocale_default extends AbstractLocale {
     this.language = language;
     this.data = data;
   }
+  language;
+  data;
   setLang(lang) {
     this.language = lang;
     return this;
@@ -26,7 +28,7 @@ class CustomLocale_default extends AbstractLocale {
   }
   value(key) {
     const value = this.data[convertLocaleKey(key)];
-    if (!value || value.length === 0) {
+    if (value === void 0) {
       return void 0;
     }
     return value;

package/dist/locale/providers/CustomLocale.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/locale/providers/CustomLocale.ts"],"sourcesContent":["import {convertLocaleKey} from \"../utils\";\n\nimport AbstractLocale from \"./AbstractLocale\";\n\nimport {Language, LocaleStructure} from \"@typing/locale\";\n\nexport type CustomLocaleData = Record<string, string>;\n\nexport default class<T extends LocaleStructure = LocaleStructure> extends AbstractLocale<T> {\n    constructor(\n        protected language: Language = Language.English,\n        protected data: CustomLocaleData = {}\n    ) {\n        super();\n    }\n\n    public setLang(lang: Language): this {\n        this.language = lang;\n\n        return this;\n    }\n\n    public setData(data: CustomLocaleData): this {\n        this.data = data;\n\n        return this;\n    }\n\n    public lang(): Language {\n        return this.language;\n    }\n\n    public keys(): Set<string> {\n        return new Set(Object.keys(this.data));\n    }\n\n    public languages(): Set<Language> {\n        return new Set([this.lang()]);\n    }\n\n    protected value(key: string): string | undefined {\n        const value = this.data[convertLocaleKey(key)];\n\n        if (!value || value.length === 0) {\n            return undefined;\n        }\n\n        return value;\n    }\n}\n"],"mappings":"AAAA,SAAQ,wBAAuB;AAE/B,OAAO,oBAAoB;AAE3B,SAAQ,gBAAgC;AAIxC,MAAO,6BAAmE,eAAkB;AAAA,EACxF,YACc,WAAqB,SAAS,SAC9B,OAAyB,CAAC,GACtC;AACE,UAAM;AAHI;AACA;AAAA,EAGd;AAAA,EAEO,QAAQ,MAAsB;AACjC,SAAK,WAAW;AAEhB,WAAO;AAAA,EACX;AAAA,EAEO,QAAQ,MAA8B;AACzC,SAAK,OAAO;AAEZ,WAAO;AAAA,EACX;AAAA,EAEO,OAAiB;AACpB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEO,OAAoB;AACvB,WAAO,IAAI,IAAI,OAAO,KAAK,KAAK,IAAI,CAAC;AAAA,EACzC;AAAA,EAEO,YAA2B;AAC9B,WAAO,oBAAI,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC;AAAA,EAChC;AAAA,EAEU,MAAM,KAAiC;AAC7C,UAAM,QAAQ,KAAK,KAAK,iBAAiB,GAAG,CAAC;AAE7C,QAAI,CAAC,SAAS,MAAM,WAAW,GAAG;AAC9B,aAAO;AAAA,IACX;AAEA,WAAO;AAAA,EACX;AACJ;","names":[]}
+{"version":3,"sources":["../../../src/locale/providers/CustomLocale.ts"],"sourcesContent":["import {convertLocaleKey} from \"../utils\";\n\nimport AbstractLocale from \"./AbstractLocale\";\n\nimport {Language, LocaleStructure} from \"@typing/locale\";\n\nexport type CustomLocaleData = Record<string, string>;\n\nexport default class<T extends object = LocaleStructure> extends AbstractLocale<T> {\n    constructor(\n        protected language: Language = Language.English,\n        protected data: CustomLocaleData = {}\n    ) {\n        super();\n    }\n\n    public setLang(lang: Language): this {\n        this.language = lang;\n\n        return this;\n    }\n\n    public setData(data: CustomLocaleData): this {\n        this.data = data;\n\n        return this;\n    }\n\n    public lang(): Language {\n        return this.language;\n    }\n\n    public keys(): Set<keyof T> {\n        return new Set(Object.keys(this.data)) as Set<keyof T>;\n    }\n\n    public languages(): Set<Language> {\n        return new Set([this.lang()]);\n    }\n\n    protected value(key: string): string | undefined {\n        const value = this.data[convertLocaleKey(key)];\n\n        if (value === undefined) {\n            return undefined;\n        }\n\n        return value;\n    }\n}\n"],"mappings":"AAAA,SAAQ,wBAAuB;AAE/B,OAAO,oBAAoB;AAE3B,SAAQ,gBAAgC;AAIxC,MAAO,6BAA0D,eAAkB;AAAA,EAC/E,YACc,WAAqB,SAAS,SAC9B,OAAyB,CAAC,GACtC;AACE,UAAM;AAHI;AACA;AAAA,EAGd;AAAA,EAJc;AAAA,EACA;AAAA,EAKP,QAAQ,MAAsB;AACjC,SAAK,WAAW;AAEhB,WAAO;AAAA,EACX;AAAA,EAEO,QAAQ,MAA8B;AACzC,SAAK,OAAO;AAEZ,WAAO;AAAA,EACX;AAAA,EAEO,OAAiB;AACpB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEO,OAAqB;AACxB,WAAO,IAAI,IAAI,OAAO,KAAK,KAAK,IAAI,CAAC;AAAA,EACzC;AAAA,EAEO,YAA2B;AAC9B,WAAO,oBAAI,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC;AAAA,EAChC;AAAA,EAEU,MAAM,KAAiC;AAC7C,UAAM,QAAQ,KAAK,KAAK,iBAAiB,GAAG,CAAC;AAE7C,QAAI,UAAU,QAAW;AACrB,aAAO;AAAA,IACX;AAEA,WAAO;AAAA,EACX;AACJ;","names":[]}

package/dist/locale/providers/DynamicLocale.d.ts

@@ -1,12 +1,10 @@
-import './AbstractLocale.js';
-import { StorageProvider } from '@addon-core/storage';
-import NativeLocale, { LocaleNativeStructure } from './NativeLocale.js';
-import export_default$1, { CustomLocaleData } from './CustomLocale.js';
-import { LocaleDynamicProvider, Language } from '../../types/locale.js';
-
-declare class export_default<T extends LocaleNativeStructure> extends NativeLocale implements LocaleDynamicProvider<T> {
+import { type StorageProvider } from "@addon-core/storage";
+import NativeLocale, { LocaleNativeStructure } from "./NativeLocale.js";
+import CustomLocale, { CustomLocaleData } from "./CustomLocale.js";
+import { Language, LocaleDynamicProvider } from "../../types/locale.js";
+export default class<T extends object = LocaleNativeStructure> extends NativeLocale<T> implements LocaleDynamicProvider<T> {
     protected cache: Map<Language, CustomLocaleData>;
-    protected locale?: export_default$1<T>;
+    protected locale?: CustomLocale<T>;
     protected storage?: StorageProvider<Record<string, Language>>;
     protected storageKey?: string;
     protected unsubscribe?: () => void;
@@ -16,8 +14,6 @@ declare class export_default<T extends LocaleNativeStructure> extends NativeLoca
     watch(handler?: (lang: Language) => void): () => void;
     unwatch(): void;
     lang(): Language;
-    protected value(key: Extract<keyof LocaleNativeStructure, string>): string | undefined;
+    protected value(key: Extract<keyof T, string>): string | undefined;
     protected fetch(lang: Language): Promise<CustomLocaleData>;
 }
-
-export { export_default as default };

package/dist/locale/providers/DynamicLocale.js

@@ -68,7 +68,7 @@ class DynamicLocale_default extends NativeLocale {
   }
   value(key) {
     var _a;
-    return ((_a = this.locale) == null ? void 0 : _a.get(key)) || super.value(key);
+    return ((_a = this.locale) == null ? void 0 : _a.get(key)) ?? super.value(key);
   }
   async fetch(lang) {
     let messages = this.cache.get(lang);

package/dist/locale/providers/DynamicLocale.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/locale/providers/DynamicLocale.ts"],"sourcesContent":["import {flattenLocaleMessages, getLocaleFilename} from \"../utils\";\n\nimport {Storage, type StorageProvider} from \"@addon-core/storage\";\n\nimport NativeLocale, {LocaleNativeStructure} from \"./NativeLocale\";\nimport CustomLocale, {CustomLocaleData} from \"./CustomLocale\";\n\nimport {Language, LanguageCodes, LocaleDynamicProvider, LocaleMessages} from \"@typing/locale\";\n\nexport default class<T extends LocaleNativeStructure> extends NativeLocale implements LocaleDynamicProvider<T> {\n    protected cache = new Map<Language, CustomLocaleData>();\n\n    protected locale?: CustomLocale<T>;\n\n    protected storage?: StorageProvider<Record<string, Language>>;\n    protected storageKey?: string;\n\n    protected unsubscribe?: () => void;\n\n    constructor(storage: string | false = \"lang\") {\n        super();\n\n        if (storage) {\n            this.storageKey = storage;\n            this.storage = Storage.Local();\n        }\n    }\n\n    public async change(lang: Language): Promise<Language> {\n        if (lang === this.lang()) {\n            return lang;\n        }\n\n        const messages = await this.fetch(lang);\n\n        (this.locale ??= new CustomLocale()).setLang(lang).setData(messages);\n\n        if (this.storage && this.storageKey) {\n            await this.storage.set(this.storageKey, lang);\n        }\n\n        return lang;\n    }\n\n    public async sync(): Promise<Language> {\n        if (!this.storage || !this.storageKey) {\n            throw new Error(\"Language is not saving in storage\");\n        }\n\n        const lang = await this.storage.get(this.storageKey);\n\n        if (!lang) {\n            return this.lang();\n        }\n\n        if (!LanguageCodes.has(lang)) {\n            console.warn(`Incorrect language code in storage - \"${lang}\"`);\n\n            return this.lang();\n        }\n\n        return this.change(lang);\n    }\n\n    public watch(handler?: (lang: Language) => void): () => void {\n        if (!this.storage || !this.storageKey) {\n            throw new Error(\"Language is not saved in storage\");\n        }\n\n        if (this.unsubscribe) {\n            throw new Error(\"Already subscribed to language changes in storage\");\n        }\n\n        this.unsubscribe = this.storage.watch({\n            [this.storageKey]: newValue => {\n                if (newValue) {\n                    this.change(newValue)\n                        .then(() => handler && handler(newValue))\n                        .catch(err => console.error(\"Error while changing language:\", err));\n                }\n            },\n        });\n\n        return this.unwatch.bind(this);\n    }\n\n    public unwatch(): void {\n        this.unsubscribe?.();\n        this.unsubscribe = undefined;\n    }\n\n    public lang(): Language {\n        return this.locale?.lang() || super.lang();\n    }\n\n    protected value(key: Extract<keyof LocaleNativeStructure, string>): string | undefined {\n        return this.locale?.get(key) || super.value(key);\n    }\n\n    protected async fetch(lang: Language): Promise<CustomLocaleData> {\n        let messages = this.cache.get(lang);\n\n        if (!messages) {\n            const response: LocaleMessages = await (await fetch(getLocaleFilename(lang))).json();\n\n            if (!response || typeof response !== \"object\") {\n                throw new Error(`Invalid or empty locale data for \"${lang}\"`);\n            }\n\n            messages = flattenLocaleMessages(response);\n\n            this.cache.set(lang, messages);\n        }\n\n        return messages;\n    }\n}\n"],"mappings":"AAAA,SAAQ,uBAAuB,yBAAwB;AAEvD,SAAQ,eAAoC;AAE5C,OAAO,kBAA2C;AAClD,OAAO,kBAAsC;AAE7C,SAAkB,qBAA2D;AAE7E,MAAO,8BAAuD,aAAiD;AAAA,EACjG,QAAQ,oBAAI,IAAgC;AAAA,EAE5C;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EAEV,YAAY,UAA0B,QAAQ;AAC1C,UAAM;AAEN,QAAI,SAAS;AACT,WAAK,aAAa;AAClB,WAAK,UAAU,QAAQ,MAAM;AAAA,IACjC;AAAA,EACJ;AAAA,EAEA,MAAa,OAAO,MAAmC;AACnD,QAAI,SAAS,KAAK,KAAK,GAAG;AACtB,aAAO;AAAA,IACX;AAEA,UAAM,WAAW,MAAM,KAAK,MAAM,IAAI;AAEtC,KAAC,KAAK,WAAL,KAAK,SAAW,IAAI,aAAa,IAAG,QAAQ,IAAI,EAAE,QAAQ,QAAQ;AAEnE,QAAI,KAAK,WAAW,KAAK,YAAY;AACjC,YAAM,KAAK,QAAQ,IAAI,KAAK,YAAY,IAAI;AAAA,IAChD;AAEA,WAAO;AAAA,EACX;AAAA,EAEA,MAAa,OAA0B;AACnC,QAAI,CAAC,KAAK,WAAW,CAAC,KAAK,YAAY;AACnC,YAAM,IAAI,MAAM,mCAAmC;AAAA,IACvD;AAEA,UAAM,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,UAAU;AAEnD,QAAI,CAAC,MAAM;AACP,aAAO,KAAK,KAAK;AAAA,IACrB;AAEA,QAAI,CAAC,cAAc,IAAI,IAAI,GAAG;AAC1B,cAAQ,KAAK,yCAAyC,IAAI,GAAG;AAE7D,aAAO,KAAK,KAAK;AAAA,IACrB;AAEA,WAAO,KAAK,OAAO,IAAI;AAAA,EAC3B;AAAA,EAEO,MAAM,SAAgD;AACzD,QAAI,CAAC,KAAK,WAAW,CAAC,KAAK,YAAY;AACnC,YAAM,IAAI,MAAM,kCAAkC;AAAA,IACtD;AAEA,QAAI,KAAK,aAAa;AAClB,YAAM,IAAI,MAAM,mDAAmD;AAAA,IACvE;AAEA,SAAK,cAAc,KAAK,QAAQ,MAAM;AAAA,MAClC,CAAC,KAAK,UAAU,GAAG,cAAY;AAC3B,YAAI,UAAU;AACV,eAAK,OAAO,QAAQ,EACf,KAAK,MAAM,WAAW,QAAQ,QAAQ,CAAC,EACvC,MAAM,SAAO,QAAQ,MAAM,kCAAkC,GAAG,CAAC;AAAA,QAC1E;AAAA,MACJ;AAAA,IACJ,CAAC;AAED,WAAO,KAAK,QAAQ,KAAK,IAAI;AAAA,EACjC;AAAA,EAEO,UAAgB;AAtF3B;AAuFQ,eAAK,gBAAL;AACA,SAAK,cAAc;AAAA,EACvB;AAAA,EAEO,OAAiB;AA3F5B;AA4FQ,aAAO,UAAK,WAAL,mBAAa,WAAU,MAAM,KAAK;AAAA,EAC7C;AAAA,EAEU,MAAM,KAAuE;AA/F3F;AAgGQ,aAAO,UAAK,WAAL,mBAAa,IAAI,SAAQ,MAAM,MAAM,GAAG;AAAA,EACnD;AAAA,EAEA,MAAgB,MAAM,MAA2C;AAC7D,QAAI,WAAW,KAAK,MAAM,IAAI,IAAI;AAElC,QAAI,CAAC,UAAU;AACX,YAAM,WAA2B,OAAO,MAAM,MAAM,kBAAkB,IAAI,CAAC,GAAG,KAAK;AAEnF,UAAI,CAAC,YAAY,OAAO,aAAa,UAAU;AAC3C,cAAM,IAAI,MAAM,qCAAqC,IAAI,GAAG;AAAA,MAChE;AAEA,iBAAW,sBAAsB,QAAQ;AAEzC,WAAK,MAAM,IAAI,MAAM,QAAQ;AAAA,IACjC;AAEA,WAAO;AAAA,EACX;AACJ;","names":[]}
+{"version":3,"sources":["../../../src/locale/providers/DynamicLocale.ts"],"sourcesContent":["import {flattenLocaleMessages, getLocaleFilename} from \"../utils\";\n\nimport {Storage, type StorageProvider} from \"@addon-core/storage\";\n\nimport NativeLocale, {LocaleNativeStructure} from \"./NativeLocale\";\nimport CustomLocale, {CustomLocaleData} from \"./CustomLocale\";\n\nimport {Language, LanguageCodes, LocaleDynamicProvider, LocaleMessages} from \"@typing/locale\";\n\nexport default class<T extends object = LocaleNativeStructure>\n    extends NativeLocale<T>\n    implements LocaleDynamicProvider<T>\n{\n    protected cache = new Map<Language, CustomLocaleData>();\n\n    protected locale?: CustomLocale<T>;\n\n    protected storage?: StorageProvider<Record<string, Language>>;\n    protected storageKey?: string;\n\n    protected unsubscribe?: () => void;\n\n    constructor(storage: string | false = \"lang\") {\n        super();\n\n        if (storage) {\n            this.storageKey = storage;\n            this.storage = Storage.Local();\n        }\n    }\n\n    public async change(lang: Language): Promise<Language> {\n        if (lang === this.lang()) {\n            return lang;\n        }\n\n        const messages = await this.fetch(lang);\n\n        (this.locale ??= new CustomLocale()).setLang(lang).setData(messages);\n\n        if (this.storage && this.storageKey) {\n            await this.storage.set(this.storageKey, lang);\n        }\n\n        return lang;\n    }\n\n    public async sync(): Promise<Language> {\n        if (!this.storage || !this.storageKey) {\n            throw new Error(\"Language is not saving in storage\");\n        }\n\n        const lang = await this.storage.get(this.storageKey);\n\n        if (!lang) {\n            return this.lang();\n        }\n\n        if (!LanguageCodes.has(lang)) {\n            console.warn(`Incorrect language code in storage - \"${lang}\"`);\n\n            return this.lang();\n        }\n\n        return this.change(lang);\n    }\n\n    public watch(handler?: (lang: Language) => void): () => void {\n        if (!this.storage || !this.storageKey) {\n            throw new Error(\"Language is not saved in storage\");\n        }\n\n        if (this.unsubscribe) {\n            throw new Error(\"Already subscribed to language changes in storage\");\n        }\n\n        this.unsubscribe = this.storage.watch({\n            [this.storageKey]: newValue => {\n                if (newValue) {\n                    this.change(newValue)\n                        .then(() => handler && handler(newValue))\n                        .catch(err => console.error(\"Error while changing language:\", err));\n                }\n            },\n        });\n\n        return this.unwatch.bind(this);\n    }\n\n    public unwatch(): void {\n        this.unsubscribe?.();\n        this.unsubscribe = undefined;\n    }\n\n    public lang(): Language {\n        return this.locale?.lang() || super.lang();\n    }\n\n    protected value(key: Extract<keyof T, string>): string | undefined {\n        return this.locale?.get(key) ?? super.value(key);\n    }\n\n    protected async fetch(lang: Language): Promise<CustomLocaleData> {\n        let messages = this.cache.get(lang);\n\n        if (!messages) {\n            const response: LocaleMessages = await (await fetch(getLocaleFilename(lang))).json();\n\n            if (!response || typeof response !== \"object\") {\n                throw new Error(`Invalid or empty locale data for \"${lang}\"`);\n            }\n\n            messages = flattenLocaleMessages(response);\n\n            this.cache.set(lang, messages);\n        }\n\n        return messages;\n    }\n}\n"],"mappings":"AAAA,SAAQ,uBAAuB,yBAAwB;AAEvD,SAAQ,eAAoC;AAE5C,OAAO,kBAA2C;AAClD,OAAO,kBAAsC;AAE7C,SAAkB,qBAA2D;AAE7E,MAAO,8BACK,aAEZ;AAAA,EACc,QAAQ,oBAAI,IAAgC;AAAA,EAE5C;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,EAEV,YAAY,UAA0B,QAAQ;AAC1C,UAAM;AAEN,QAAI,SAAS;AACT,WAAK,aAAa;AAClB,WAAK,UAAU,QAAQ,MAAM;AAAA,IACjC;AAAA,EACJ;AAAA,EAEA,MAAa,OAAO,MAAmC;AACnD,QAAI,SAAS,KAAK,KAAK,GAAG;AACtB,aAAO;AAAA,IACX;AAEA,UAAM,WAAW,MAAM,KAAK,MAAM,IAAI;AAEtC,KAAC,KAAK,WAAL,KAAK,SAAW,IAAI,aAAa,IAAG,QAAQ,IAAI,EAAE,QAAQ,QAAQ;AAEnE,QAAI,KAAK,WAAW,KAAK,YAAY;AACjC,YAAM,KAAK,QAAQ,IAAI,KAAK,YAAY,IAAI;AAAA,IAChD;AAEA,WAAO;AAAA,EACX;AAAA,EAEA,MAAa,OAA0B;AACnC,QAAI,CAAC,KAAK,WAAW,CAAC,KAAK,YAAY;AACnC,YAAM,IAAI,MAAM,mCAAmC;AAAA,IACvD;AAEA,UAAM,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,UAAU;AAEnD,QAAI,CAAC,MAAM;AACP,aAAO,KAAK,KAAK;AAAA,IACrB;AAEA,QAAI,CAAC,cAAc,IAAI,IAAI,GAAG;AAC1B,cAAQ,KAAK,yCAAyC,IAAI,GAAG;AAE7D,aAAO,KAAK,KAAK;AAAA,IACrB;AAEA,WAAO,KAAK,OAAO,IAAI;AAAA,EAC3B;AAAA,EAEO,MAAM,SAAgD;AACzD,QAAI,CAAC,KAAK,WAAW,CAAC,KAAK,YAAY;AACnC,YAAM,IAAI,MAAM,kCAAkC;AAAA,IACtD;AAEA,QAAI,KAAK,aAAa;AAClB,YAAM,IAAI,MAAM,mDAAmD;AAAA,IACvE;AAEA,SAAK,cAAc,KAAK,QAAQ,MAAM;AAAA,MAClC,CAAC,KAAK,UAAU,GAAG,cAAY;AAC3B,YAAI,UAAU;AACV,eAAK,OAAO,QAAQ,EACf,KAAK,MAAM,WAAW,QAAQ,QAAQ,CAAC,EACvC,MAAM,SAAO,QAAQ,MAAM,kCAAkC,GAAG,CAAC;AAAA,QAC1E;AAAA,MACJ;AAAA,IACJ,CAAC;AAED,WAAO,KAAK,QAAQ,KAAK,IAAI;AAAA,EACjC;AAAA,EAEO,UAAgB;AAzF3B;AA0FQ,eAAK,gBAAL;AACA,SAAK,cAAc;AAAA,EACvB;AAAA,EAEO,OAAiB;AA9F5B;AA+FQ,aAAO,UAAK,WAAL,mBAAa,WAAU,MAAM,KAAK;AAAA,EAC7C;AAAA,EAEU,MAAM,KAAmD;AAlGvE;AAmGQ,aAAO,UAAK,WAAL,mBAAa,IAAI,SAAQ,MAAM,MAAM,GAAG;AAAA,EACnD;AAAA,EAEA,MAAgB,MAAM,MAA2C;AAC7D,QAAI,WAAW,KAAK,MAAM,IAAI,IAAI;AAElC,QAAI,CAAC,UAAU;AACX,YAAM,WAA2B,OAAO,MAAM,MAAM,kBAAkB,IAAI,CAAC,GAAG,KAAK;AAEnF,UAAI,CAAC,YAAY,OAAO,aAAa,UAAU;AAC3C,cAAM,IAAI,MAAM,qCAAqC,IAAI,GAAG;AAAA,MAChE;AAEA,iBAAW,sBAAsB,QAAQ;AAEzC,WAAK,MAAM,IAAI,MAAM,QAAQ;AAAA,IACjC;AAEA,WAAO;AAAA,EACX;AACJ;","names":[]}

package/dist/locale/providers/NativeLocale.d.ts

@@ -1,17 +1,14 @@
-import export_default from './AbstractLocale.js';
-import { LocaleStructure, LocaleProvider, Language } from '../../types/locale.js';
-
-interface LocaleNativeStructure extends LocaleStructure {
+import AbstractLocale from "./AbstractLocale.js";
+import { Language, LocaleProvider, LocaleStructure } from "../../types/locale.js";
+export interface LocaleNativeStructure extends LocaleStructure {
 }
-declare class NativeLocale extends export_default<LocaleNativeStructure> {
+export default class NativeLocale<S extends object = LocaleNativeStructure> extends AbstractLocale<S> {
     private static instance?;
-    static getInstance<S extends LocaleStructure = LocaleNativeStructure>(): LocaleProvider<S>;
+    static getInstance(): LocaleProvider<LocaleNativeStructure>;
     private readonly language?;
     constructor();
     lang(): Language;
-    keys(): Set<keyof LocaleNativeStructure>;
+    keys(): Set<keyof S>;
     languages(): Set<Language>;
-    protected value(key: Extract<keyof LocaleNativeStructure, string>): string | undefined;
+    protected value(key: Extract<keyof S, string>): string | undefined;
 }
-
-export { type LocaleNativeStructure, NativeLocale as default };

package/dist/locale/providers/NativeLocale.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/locale/providers/NativeLocale.ts"],"sourcesContent":["import {getI18nMessage} from \"@addon-core/browser\";\n\nimport AbstractLocale from \"./AbstractLocale\";\n\nimport {convertLocaleKey, resolveLanguage} from \"@locale/utils\";\n\nimport {Language, LocaleCustomKeyForLanguage, LocaleProvider, LocaleStructure} from \"@typing/locale\";\n\nexport interface LocaleNativeStructure extends LocaleStructure {}\n\nexport default class NativeLocale extends AbstractLocale<LocaleNativeStructure> {\n    private static instance?: LocaleProvider<LocaleNativeStructure>;\n\n    public static getInstance<S extends LocaleStructure = LocaleNativeStructure>(): LocaleProvider<S> {\n        return (NativeLocale.instance ??= new NativeLocale());\n    }\n\n    private readonly language?: Language;\n\n    constructor() {\n        super();\n\n        /**\n         Locale detection note:\n         Chrome does NOT expose an API to get the effective translation locale.\n         getUILanguage() returns browser UI language (e.g., es-MX),\n         even if extension translations fall back to default_locale (e.g., en).\n         To detect the actual language used by i18n, we read a locale marker\n         from messages.json via chrome.i18n.getMessage().\n         */\n        const markerLang = getI18nMessage(LocaleCustomKeyForLanguage);\n        const resolvedLang = resolveLanguage(markerLang);\n\n        if (!resolvedLang) {\n            console.warn(`[NativeLocale] Unsupported language detected: \"${markerLang}\".`);\n        }\n\n        if (markerLang && resolvedLang && markerLang !== resolvedLang) {\n            console.info(`[NativeLocale] Language normalized: using \"${resolvedLang}\" instead of \"${markerLang}\".`);\n        }\n\n        this.language = resolvedLang;\n    }\n\n    public lang(): Language {\n        if (!this.language) {\n            throw new Error(\"[NativeLocale] Language is not defined. Failed to determine a supported locale.\");\n        }\n\n        return this.language;\n    }\n\n    public keys(): Set<keyof LocaleNativeStructure> {\n        try {\n            // @ts-expect-error: __ADNBN_LOCALE_KEYS__ is a virtual variable generated by the bundler `src/cli/plugins/locale/index.ts`\n            return new Set<string>(__ADNBN_LOCALE_KEYS__);\n        } catch (e) {\n            console.error(\"[NativeLocale] Failed to access locale keys. Ensure the bundler plugin is active.\", e);\n\n            return new Set<string>();\n        }\n    }\n\n    public languages(): Set<Language> {\n        try {\n            // @ts-expect-error: __ADNBN_DEFINED_LOCALES__ is a virtual variable generated by the bundler `src/cli/plugins/locale/index.ts`\n            return new Set<Language>(__ADNBN_DEFINED_LOCALES__);\n        } catch (e) {\n            console.error(\"[NativeLocale] Failed to access defined locales. Check virtual variables configuration.\", e);\n\n            return new Set<Language>();\n        }\n    }\n\n    protected value(key: Extract<keyof LocaleNativeStructure, string>): string | undefined {\n        const value = getI18nMessage(convertLocaleKey(key));\n\n        if (!value || value.length === 0) {\n            return undefined;\n        }\n\n        return value;\n    }\n}\n"],"mappings":"AAAA,SAAQ,sBAAqB;AAE7B,OAAO,oBAAoB;AAE3B,SAAQ,kBAAkB,uBAAsB;AAEhD,SAAkB,kCAAkE;AAIpF,MAAO,qBAAmC,eAAsC;AAAA,EAC5E,OAAe;AAAA,EAEf,OAAc,cAAoF;AAC9F,WAAQ,aAAa,aAAb,aAAa,WAAa,IAAI,aAAa;AAAA,EACvD;AAAA,EAEiB;AAAA,EAEjB,cAAc;AACV,UAAM;AAUN,UAAM,aAAa,eAAe,0BAA0B;AAC5D,UAAM,eAAe,gBAAgB,UAAU;AAE/C,QAAI,CAAC,cAAc;AACf,cAAQ,KAAK,kDAAkD,UAAU,IAAI;AAAA,IACjF;AAEA,QAAI,cAAc,gBAAgB,eAAe,cAAc;AAC3D,cAAQ,KAAK,8CAA8C,YAAY,iBAAiB,UAAU,IAAI;AAAA,IAC1G;AAEA,SAAK,WAAW;AAAA,EACpB;AAAA,EAEO,OAAiB;AACpB,QAAI,CAAC,KAAK,UAAU;AAChB,YAAM,IAAI,MAAM,iFAAiF;AAAA,IACrG;AAEA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEO,OAAyC;AAC5C,QAAI;AAEA,aAAO,IAAI,IAAY,qBAAqB;AAAA,IAChD,SAAS,GAAG;AACR,cAAQ,MAAM,qFAAqF,CAAC;AAEpG,aAAO,oBAAI,IAAY;AAAA,IAC3B;AAAA,EACJ;AAAA,EAEO,YAA2B;AAC9B,QAAI;AAEA,aAAO,IAAI,IAAc,yBAAyB;AAAA,IACtD,SAAS,GAAG;AACR,cAAQ,MAAM,2FAA2F,CAAC;AAE1G,aAAO,oBAAI,IAAc;AAAA,IAC7B;AAAA,EACJ;AAAA,EAEU,MAAM,KAAuE;AACnF,UAAM,QAAQ,eAAe,iBAAiB,GAAG,CAAC;AAElD,QAAI,CAAC,SAAS,MAAM,WAAW,GAAG;AAC9B,aAAO;AAAA,IACX;AAEA,WAAO;AAAA,EACX;AACJ;","names":[]}
+{"version":3,"sources":["../../../src/locale/providers/NativeLocale.ts"],"sourcesContent":["import {getI18nMessage} from \"@addon-core/browser\";\n\nimport AbstractLocale from \"./AbstractLocale\";\n\nimport {convertLocaleKey, resolveLanguage} from \"@locale/utils\";\n\nimport {Language, LocaleCustomKeyForLanguage, LocaleProvider, LocaleStructure} from \"@typing/locale\";\n\nexport interface LocaleNativeStructure extends LocaleStructure {}\n\nexport default class NativeLocale<S extends object = LocaleNativeStructure> extends AbstractLocale<S> {\n    private static instance?: LocaleProvider<LocaleNativeStructure>;\n\n    public static getInstance(): LocaleProvider<LocaleNativeStructure> {\n        return (NativeLocale.instance ??= new NativeLocale());\n    }\n\n    private readonly language?: Language;\n\n    constructor() {\n        super();\n\n        /**\n         Locale detection note:\n         Chrome does NOT expose an API to get the effective translation locale.\n         getUILanguage() returns browser UI language (e.g., es-MX),\n         even if extension translations fall back to default_locale (e.g., en).\n         To detect the actual language used by i18n, we read a locale marker\n         from messages.json via chrome.i18n.getMessage().\n         */\n        const markerLang = getI18nMessage(LocaleCustomKeyForLanguage);\n        const resolvedLang = resolveLanguage(markerLang);\n\n        if (!resolvedLang) {\n            console.warn(`[NativeLocale] Unsupported language detected: \"${markerLang}\".`);\n        }\n\n        if (markerLang && resolvedLang && markerLang !== resolvedLang) {\n            console.info(`[NativeLocale] Language normalized: using \"${resolvedLang}\" instead of \"${markerLang}\".`);\n        }\n\n        this.language = resolvedLang;\n    }\n\n    public lang(): Language {\n        if (!this.language) {\n            throw new Error(\"[NativeLocale] Language is not defined. Failed to determine a supported locale.\");\n        }\n\n        return this.language;\n    }\n\n    public keys(): Set<keyof S> {\n        try {\n            // @ts-expect-error: __ADNBN_LOCALE_KEYS__ is a virtual variable generated by the bundler `src/cli/plugins/locale/index.ts`\n            return new Set<string>(__ADNBN_LOCALE_KEYS__) as Set<keyof S>;\n        } catch (e) {\n            console.error(\"[NativeLocale] Failed to access locale keys. Ensure the bundler plugin is active.\", e);\n\n            return new Set<keyof S>();\n        }\n    }\n\n    public languages(): Set<Language> {\n        try {\n            // @ts-expect-error: __ADNBN_DEFINED_LOCALES__ is a virtual variable generated by the bundler `src/cli/plugins/locale/index.ts`\n            return new Set<Language>(__ADNBN_DEFINED_LOCALES__);\n        } catch (e) {\n            console.error(\"[NativeLocale] Failed to access defined locales. Check virtual variables configuration.\", e);\n\n            return new Set<Language>();\n        }\n    }\n\n    protected value(key: Extract<keyof S, string>): string | undefined {\n        const value = getI18nMessage(convertLocaleKey(key));\n\n        if (!value || value.length === 0) {\n            return undefined;\n        }\n\n        return value;\n    }\n}\n"],"mappings":"AAAA,SAAQ,sBAAqB;AAE7B,OAAO,oBAAoB;AAE3B,SAAQ,kBAAkB,uBAAsB;AAEhD,SAAkB,kCAAkE;AAIpF,MAAO,qBAA6E,eAAkB;AAAA,EAClG,OAAe;AAAA,EAEf,OAAc,cAAqD;AAC/D,WAAQ,aAAa,aAAb,aAAa,WAAa,IAAI,aAAa;AAAA,EACvD;AAAA,EAEiB;AAAA,EAEjB,cAAc;AACV,UAAM;AAUN,UAAM,aAAa,eAAe,0BAA0B;AAC5D,UAAM,eAAe,gBAAgB,UAAU;AAE/C,QAAI,CAAC,cAAc;AACf,cAAQ,KAAK,kDAAkD,UAAU,IAAI;AAAA,IACjF;AAEA,QAAI,cAAc,gBAAgB,eAAe,cAAc;AAC3D,cAAQ,KAAK,8CAA8C,YAAY,iBAAiB,UAAU,IAAI;AAAA,IAC1G;AAEA,SAAK,WAAW;AAAA,EACpB;AAAA,EAEO,OAAiB;AACpB,QAAI,CAAC,KAAK,UAAU;AAChB,YAAM,IAAI,MAAM,iFAAiF;AAAA,IACrG;AAEA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEO,OAAqB;AACxB,QAAI;AAEA,aAAO,IAAI,IAAY,qBAAqB;AAAA,IAChD,SAAS,GAAG;AACR,cAAQ,MAAM,qFAAqF,CAAC;AAEpG,aAAO,oBAAI,IAAa;AAAA,IAC5B;AAAA,EACJ;AAAA,EAEO,YAA2B;AAC9B,QAAI;AAEA,aAAO,IAAI,IAAc,yBAAyB;AAAA,IACtD,SAAS,GAAG;AACR,cAAQ,MAAM,2FAA2F,CAAC;AAE1G,aAAO,oBAAI,IAAc;AAAA,IAC7B;AAAA,EACJ;AAAA,EAEU,MAAM,KAAmD;AAC/D,UAAM,QAAQ,eAAe,iBAAiB,GAAG,CAAC;AAElD,QAAI,CAAC,SAAS,MAAM,WAAW,GAAG;AAC9B,aAAO;AAAA,IACX;AAEA,WAAO;AAAA,EACX;AACJ;","names":[]}