@snack-uikit/locale 0.13.1-preview-2289a98e.0 → 0.14.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 0.14.0 (2025-03-20)
+
+
+### Features
+
+* **FF-6326:** locale support for dictionary extensions ([867a28c](https://github.com/cloud-ru-tech/snack-uikit/commit/867a28cf18a8b8c7ee34621daac204533b713d60))
+
+
+
+
+
 # 0.13.0 (2025-03-14)
 
 

package/README.md

@@ -54,6 +54,7 @@ const lang = 'en_GB'; // or 'ru_RU' or 'custom_LANG'
 | name | type | default value | description |
 |------|------|---------------|-------------|
 | lang* | `string` | - |  |
+| fallbackLang | "en-GB" \| "ru-RU" | - |  |
 | overrideLocales | `PartialObjectDeep<Record<"en-GB" \| "ru-RU", LocaleDictionary<Dictionary>>>` | - |  |
 ## useLocale
 `helper` 

package/dist/cjs/components/LocaleProvider/LocaleProvider.d.ts

@@ -8,6 +8,7 @@ export type LocaleContextType<D extends Dictionary> = {
 };
 export type LocaleProviderProps<D extends Dictionary> = {
     lang: LocaleLang | string;
+    fallbackLang?: LocaleLang;
     overrideLocales?: OverrideLocales<D>;
     children: ReactNode;
 };
@@ -19,7 +20,7 @@ type LocaleComponentName<D extends Dictionary> = keyof LocaleDictionary<D>;
 type GetLocaleText<D extends Dictionary, T extends keyof LocaleDictionary<D> | undefined = undefined> = (key: DottedTranslationKey<D, T>) => string;
 export declare function createLocaleContext<D extends Dictionary>({ extendedDictionary, defaultLanguage, }: ContextOptions<D>): {
     LocaleContext: import("react").Context<LocaleContextType<D>>;
-    LocaleProvider: ({ lang, overrideLocales, children }: LocaleProviderProps<D>) => import("react/jsx-runtime").JSX.Element;
+    LocaleProvider: ({ lang, fallbackLang, overrideLocales, children }: LocaleProviderProps<D>) => import("react/jsx-runtime").JSX.Element;
     useLocale: {
         (): {
             t: GetLocaleText<D>;
@@ -31,7 +32,7 @@ export declare function createLocaleContext<D extends Dictionary>({ extendedDict
         };
     };
 };
-export declare const LocaleProvider: ({ lang, overrideLocales, children }: LocaleProviderProps<Dictionary>) => import("react/jsx-runtime").JSX.Element, useLocale: {
+export declare const LocaleProvider: ({ lang, fallbackLang, overrideLocales, children }: LocaleProviderProps<Dictionary>) => import("react/jsx-runtime").JSX.Element, useLocale: {
     (): {
         t: GetLocaleText<Dictionary>;
         lang: LocaleLang;

package/dist/cjs/components/LocaleProvider/LocaleProvider.js

@@ -33,6 +33,7 @@ function createLocaleContext(_ref) {
   function LocaleProvider(_ref2) {
     let {
       lang,
+      fallbackLang = defaultLanguage,
       overrideLocales,
       children
     } = _ref2;
@@ -46,10 +47,10 @@ function createLocaleContext(_ref) {
       let localesObj = locales[lang];
       if (!localesObj) {
         console.warn(`Snack-uikit: localization for lang ${lang} was not found. Make sure you are using correct lang or passed proper locales to LocaleProvider. For now default language (${exports.DEFAULT_LANG}) will be used`);
-        localesObj = locales[defaultLanguage];
+        localesObj = locales[fallbackLang];
       }
       return localesObj;
-    }, [lang, locales]);
+    }, [fallbackLang, lang, locales]);
     return (0, jsx_runtime_1.jsx)(LocaleContext.Provider, {
       value: {
         lang,

package/dist/esm/components/LocaleProvider/LocaleProvider.d.ts

@@ -8,6 +8,7 @@ export type LocaleContextType<D extends Dictionary> = {
 };
 export type LocaleProviderProps<D extends Dictionary> = {
     lang: LocaleLang | string;
+    fallbackLang?: LocaleLang;
     overrideLocales?: OverrideLocales<D>;
     children: ReactNode;
 };
@@ -19,7 +20,7 @@ type LocaleComponentName<D extends Dictionary> = keyof LocaleDictionary<D>;
 type GetLocaleText<D extends Dictionary, T extends keyof LocaleDictionary<D> | undefined = undefined> = (key: DottedTranslationKey<D, T>) => string;
 export declare function createLocaleContext<D extends Dictionary>({ extendedDictionary, defaultLanguage, }: ContextOptions<D>): {
     LocaleContext: import("react").Context<LocaleContextType<D>>;
-    LocaleProvider: ({ lang, overrideLocales, children }: LocaleProviderProps<D>) => import("react/jsx-runtime").JSX.Element;
+    LocaleProvider: ({ lang, fallbackLang, overrideLocales, children }: LocaleProviderProps<D>) => import("react/jsx-runtime").JSX.Element;
     useLocale: {
         (): {
             t: GetLocaleText<D>;
@@ -31,7 +32,7 @@ export declare function createLocaleContext<D extends Dictionary>({ extendedDict
         };
     };
 };
-export declare const LocaleProvider: ({ lang, overrideLocales, children }: LocaleProviderProps<Dictionary>) => import("react/jsx-runtime").JSX.Element, useLocale: {
+export declare const LocaleProvider: ({ lang, fallbackLang, overrideLocales, children }: LocaleProviderProps<Dictionary>) => import("react/jsx-runtime").JSX.Element, useLocale: {
     (): {
         t: GetLocaleText<Dictionary>;
         lang: LocaleLang;

package/dist/esm/components/LocaleProvider/LocaleProvider.js

@@ -13,7 +13,7 @@ export function createLocaleContext({ extendedDictionary, defaultLanguage = DEFA
         locales: extendedLocales,
         localesByLang: extendedLocales[defaultLanguage],
     });
-    function LocaleProvider({ lang, overrideLocales, children }) {
+    function LocaleProvider({ lang, fallbackLang = defaultLanguage, overrideLocales, children }) {
         const locales = useMemo(() => {
             if (overrideLocales) {
                 return merge({}, extendedLocales, overrideLocales);
@@ -24,10 +24,10 @@ export function createLocaleContext({ extendedDictionary, defaultLanguage = DEFA
             let localesObj = locales[lang];
             if (!localesObj) {
                 console.warn(`Snack-uikit: localization for lang ${lang} was not found. Make sure you are using correct lang or passed proper locales to LocaleProvider. For now default language (${DEFAULT_LANG}) will be used`);
-                localesObj = locales[defaultLanguage];
+                localesObj = locales[fallbackLang];
             }
             return localesObj;
-        }, [lang, locales]);
+        }, [fallbackLang, lang, locales]);
         return _jsx(LocaleContext.Provider, { value: { lang, locales, localesByLang }, children: children });
     }
     function useLocale(componentName) {

package/package.json

@@ -4,7 +4,7 @@
     "access": "public"
   },
   "title": "Locale",
-  "version": "0.13.1-preview-2289a98e.0",
+  "version": "0.14.0",
   "sideEffects": [
     "*.css",
     "*.woff",
@@ -41,5 +41,5 @@
   "devDependencies": {
     "@types/lodash.merge": "4.6.9"
   },
-  "gitHead": "21c1bc32fdd9158b071e613acd950143adb9d0b4"
+  "gitHead": "2c50d707746c6aeab336e4097df6e4c8494d67a4"
 }

package/src/components/LocaleProvider/LocaleProvider.tsx

@@ -23,6 +23,7 @@ export type LocaleContextType<D extends Dictionary> = {
 
 export type LocaleProviderProps<D extends Dictionary> = {
   lang: LocaleLang | string;
+  fallbackLang?: LocaleLang;
   overrideLocales?: OverrideLocales<D>;
   children: ReactNode;
 };
@@ -56,7 +57,7 @@ export function createLocaleContext<D extends Dictionary>({
     localesByLang: extendedLocales[defaultLanguage],
   });
 
-  function LocaleProvider({ lang, overrideLocales, children }: LocaleProviderProps<D>) {
+  function LocaleProvider({ lang, fallbackLang = defaultLanguage, overrideLocales, children }: LocaleProviderProps<D>) {
     const locales = useMemo(() => {
       if (overrideLocales) {
         return merge({}, extendedLocales, overrideLocales);
@@ -73,11 +74,11 @@ export function createLocaleContext<D extends Dictionary>({
           `Snack-uikit: localization for lang ${lang} was not found. Make sure you are using correct lang or passed proper locales to LocaleProvider. For now default language (${DEFAULT_LANG}) will be used`,
         );
 
-        localesObj = locales[defaultLanguage] as LocaleDictionary<D>;
+        localesObj = locales[fallbackLang] as LocaleDictionary<D>;
       }
 
       return localesObj;
-    }, [lang, locales]);
+    }, [fallbackLang, lang, locales]);
 
     return <LocaleContext.Provider value={{ lang, locales, localesByLang }}>{children}</LocaleContext.Provider>;
   }