@magic-translate/react 1.15.0 → 1.16.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.16.0](https://github.com/magic-translate/magic-translate-react/compare/v1.15.1...v1.16.0) (2025-02-28)
+
+
+### Features
+
+* add language switcher hook ([dff729f](https://github.com/magic-translate/magic-translate-react/commit/dff729f1e8395a0c992a5f614d80fa00445be0ec))
+
+## [1.15.1](https://github.com/magic-translate/magic-translate-react/compare/v1.15.0...v1.15.1) (2023-09-26)
+
+
+### Bug Fixes
+
+* fix conflicting types in translate component ([76a29b4](https://github.com/magic-translate/magic-translate-react/commit/76a29b41402826806f269138a8689761013a7f86))
+
 ## [1.15.0](https://github.com/magic-translate/magic-translate-react/compare/v1.14.0...v1.15.0) (2023-09-25)
 
 

package/dist/context/MagicTranslateContext.d.ts

@@ -1,6 +1,6 @@
 import DataLoader from 'dataloader';
 import React, { PropsWithChildren } from 'react';
-import { DataLoaderLoadParams, DataLoaderOptions, TranslateOptions, Language, MagicTranslateConfig } from '@magic-translate/core';
+import { DataLoaderLoadParams, DataLoaderOptions, Language, MagicTranslateConfig, TranslateOptions } from '@magic-translate/core';
 export interface MagicTranslateProviderProps extends MagicTranslateConfig {
     /**
      * The API URL to use for the translate requests. This is only used for debugging purposes.
@@ -13,13 +13,20 @@ export interface MagicTranslateProviderProps extends MagicTranslateConfig {
      */
     _loaderFactory?: (options?: DataLoaderOptions) => (content: readonly DataLoaderLoadParams[]) => Promise<readonly string[]>;
 }
+/**
+ * Type alias to make the language enum more flexible to also allow passing language strings
+ * instead of just the enum.
+ */
+declare type Languages = `${Language}`;
 export interface MagicTranslateContextValue extends TranslateOptions {
     dataLoader: DataLoader<DataLoaderLoadParams, string>;
-    language: `${Language}`;
-    sourceLanguage?: `${Language}`;
+    language: Languages;
+    sourceLanguage?: Languages;
+    setLanguage: (language: Languages) => void;
     apiUrl?: string;
     apiKey: string;
 }
 export declare const MagicTranslateContext: React.Context<MagicTranslateContextValue | null>;
 export declare const MagicTranslateProvider: React.FunctionComponent<PropsWithChildren<MagicTranslateProviderProps>>;
+export {};
 //# sourceMappingURL=MagicTranslateContext.d.ts.map

package/dist/context/MagicTranslateContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MagicTranslateContext.d.ts","sourceRoot":"","sources":["../../src/context/MagicTranslateContext.tsx"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,EAAE,EAAiB,iBAAiB,EAAW,MAAM,OAAO,CAAC;AACzE,OAAO,EAEL,oBAAoB,EACpB,iBAAiB,EAEjB,gBAAgB,EAChB,QAAQ,EACR,oBAAoB,EAErB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,cAAc,CAAC,EAAE,CACf,OAAO,CAAC,EAAE,iBAAiB,KACxB,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,KAAK,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAClE,UAAU,EAAE,UAAU,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IAErD,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAAC;IAExB,cAAc,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC;IAE/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,qBAAqB,kDACsB,CAAC;AAEzD,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,iBAAiB,CAC1D,iBAAiB,CAAC,2BAA2B,CAAC,CA0C/C,CAAC"}
+{"version":3,"file":"MagicTranslateContext.d.ts","sourceRoot":"","sources":["../../src/context/MagicTranslateContext.tsx"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,EAAE,EAEZ,iBAAiB,EAGlB,MAAM,OAAO,CAAC;AACf,OAAO,EAEL,oBAAoB,EACpB,iBAAiB,EAEjB,QAAQ,EAER,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,cAAc,CAAC,EAAE,CACf,OAAO,CAAC,EAAE,iBAAiB,KACxB,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,KAAK,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;CAC/E;AAED;;;GAGG;AACH,aAAK,SAAS,GAAG,GAAG,QAAQ,EAAE,CAAC;AAE/B,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAClE,UAAU,EAAE,UAAU,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IACrD,QAAQ,EAAE,SAAS,CAAC;IACpB,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,WAAW,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,IAAI,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,qBAAqB,kDACsB,CAAC;AAEzD,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,iBAAiB,CAC1D,iBAAiB,CAAC,2BAA2B,CAAC,CAkD/C,CAAC"}

package/dist/context/MagicTranslateContext.js

@@ -1,12 +1,14 @@
 import DataLoader from 'dataloader';
-import React, { createContext, useMemo } from 'react';
+import React, { createContext, useMemo, useState, } from 'react';
 import { cacheKeyFn, defaultLoaderFactory as defaultLoaderFactory, libraryWebsite, } from '@magic-translate/core';
 export var MagicTranslateContext = createContext(null);
 export var MagicTranslateProvider = function (_a) {
-    var language = _a.language, sourceLanguage = _a.sourceLanguage, debug = _a.debug, apiKey = _a.apiKey, children = _a.children, _b = _a._loaderFactory, _loaderFactory = _b === void 0 ? defaultLoaderFactory : _b, _apiUrl = _a._apiUrl, formality = _a.formality;
+    var passedLanguage = _a.language, sourceLanguage = _a.sourceLanguage, debug = _a.debug, apiKey = _a.apiKey, children = _a.children, _b = _a._loaderFactory, _loaderFactory = _b === void 0 ? defaultLoaderFactory : _b, _apiUrl = _a._apiUrl, formality = _a.formality;
     if (!apiKey) {
         throw new Error("Missing API key. Please get one at ".concat(libraryWebsite));
     }
+    var _c = useState(null), languageFromContext = _c[0], setLanguage = _c[1];
+    var language = useMemo(function () { return languageFromContext !== null && languageFromContext !== void 0 ? languageFromContext : passedLanguage; }, [passedLanguage, languageFromContext]);
     var value = useMemo(function () { return ({
         dataLoader: new DataLoader(_loaderFactory({
             debug: !!debug,
@@ -21,6 +23,7 @@ export var MagicTranslateProvider = function (_a) {
         language: language,
         sourceLanguage: sourceLanguage,
         apiKey: apiKey,
+        setLanguage: setLanguage,
     }); }, [_loaderFactory, language, sourceLanguage, debug, apiKey, _apiUrl]);
     return (React.createElement(MagicTranslateContext.Provider, { value: value }, children));
 };

package/dist/context/MagicTranslateContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"MagicTranslateContext.js","sourceRoot":"","sources":["../../src/context/MagicTranslateContext.tsx"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,EAAE,EAAE,aAAa,EAAqB,OAAO,EAAE,MAAM,OAAO,CAAC;AACzE,OAAO,EACL,UAAU,EAGV,oBAAoB,IAAI,oBAAoB,EAI5C,cAAc,GACf,MAAM,uBAAuB,CAAC;AA8B/B,MAAM,CAAC,IAAM,qBAAqB,GAChC,aAAa,CAAoC,IAAI,CAAC,CAAC;AAEzD,MAAM,CAAC,IAAM,sBAAsB,GAE/B,UAAC,EASJ;QARC,QAAQ,cAAA,EACR,cAAc,oBAAA,EACd,KAAK,WAAA,EACL,MAAM,YAAA,EACN,QAAQ,cAAA,EACR,sBAAqC,EAArC,cAAc,mBAAG,oBAAoB,KAAA,EACrC,OAAO,aAAA,EACP,SAAS,eAAA;IAET,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,IAAI,KAAK,CAAC,6CAAsC,cAAc,CAAE,CAAC,CAAC;KACzE;IAED,IAAM,KAAK,GAAG,OAAO,CACnB,cAAM,OAAA,CAAC;QACL,UAAU,EAAE,IAAI,UAAU,CACxB,cAAc,CAAC;YACb,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,QAAA;YACN,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,cAAc;YAC1B,MAAM,EAAE,OAAO;YACf,SAAS,WAAA;SACV,CAAC,EACF;YACE,UAAU,EAAE,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC;SACzD,CACF;QACD,QAAQ,UAAA;QACR,cAAc,gBAAA;QACd,MAAM,QAAA;KACP,CAAC,EAjBI,CAiBJ,EACF,CAAC,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CACnE,CAAC;IAEF,OAAO,CACL,oBAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,IACzC,QAAQ,CACsB,CAClC,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"MagicTranslateContext.js","sourceRoot":"","sources":["../../src/context/MagicTranslateContext.tsx"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,EAAE,EACZ,aAAa,EAEb,OAAO,EACP,QAAQ,GACT,MAAM,OAAO,CAAC;AACf,OAAO,EACL,UAAU,EAGV,oBAAoB,IAAI,oBAAoB,EAE5C,cAAc,GAGf,MAAM,uBAAuB,CAAC;AAiC/B,MAAM,CAAC,IAAM,qBAAqB,GAChC,aAAa,CAAoC,IAAI,CAAC,CAAC;AAEzD,MAAM,CAAC,IAAM,sBAAsB,GAE/B,UAAC,EASJ;QARW,cAAc,cAAA,EACxB,cAAc,oBAAA,EACd,KAAK,WAAA,EACL,MAAM,YAAA,EACN,QAAQ,cAAA,EACR,sBAAqC,EAArC,cAAc,mBAAG,oBAAoB,KAAA,EACrC,OAAO,aAAA,EACP,SAAS,eAAA;IAET,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,IAAI,KAAK,CAAC,6CAAsC,cAAc,CAAE,CAAC,CAAC;KACzE;IAEK,IAAA,KAAqC,QAAQ,CAAmB,IAAI,CAAC,EAApE,mBAAmB,QAAA,EAAE,WAAW,QAAoC,CAAC;IAE5E,IAAM,QAAQ,GAAG,OAAO,CACtB,cAAM,OAAA,mBAAmB,aAAnB,mBAAmB,cAAnB,mBAAmB,GAAI,cAAc,EAArC,CAAqC,EAC3C,CAAC,cAAc,EAAE,mBAAmB,CAAC,CACtC,CAAC;IAEF,IAAM,KAAK,GAAG,OAAO,CACnB,cAAM,OAAA,CAAC;QACL,UAAU,EAAE,IAAI,UAAU,CACxB,cAAc,CAAC;YACb,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,QAAA;YACN,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,cAAc;YAC1B,MAAM,EAAE,OAAO;YACf,SAAS,WAAA;SACV,CAAC,EACF;YACE,UAAU,EAAE,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC;SACzD,CACF;QACD,QAAQ,UAAA;QACR,cAAc,gBAAA;QACd,MAAM,QAAA;QACN,WAAW,aAAA;KACZ,CAAC,EAlBI,CAkBJ,EACF,CAAC,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CACnE,CAAC;IAEF,OAAO,CACL,oBAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,IACzC,QAAQ,CACsB,CAClC,CAAC;AACJ,CAAC,CAAC"}

package/dist/hooks/use-language-switcher.d.ts

@@ -0,0 +1,6 @@
+import { Language } from '@magic-translate/core';
+export declare function useLanguageSwitcher(): {
+    setLanguage: (language: `${Language}`) => void;
+    currentLanguage: `${Language}`;
+};
+//# sourceMappingURL=use-language-switcher.d.ts.map

package/dist/hooks/use-language-switcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-language-switcher.d.ts","sourceRoot":"","sources":["../../src/hooks/use-language-switcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,wBAAgB,mBAAmB,IAAI;IACrC,WAAW,EAAE,CAAC,QAAQ,EAAE,GAAG,QAAQ,EAAE,KAAK,IAAI,CAAC;IAC/C,eAAe,EAAE,GAAG,QAAQ,EAAE,CAAC;CAChC,CAOA"}

package/dist/hooks/use-language-switcher.js

@@ -0,0 +1,7 @@
+import { useMagicTranslate } from './use-magic-translate';
+import { useMemo } from 'react';
+export function useLanguageSwitcher() {
+    var _a = useMagicTranslate(), setLanguage = _a.setLanguage, language = _a.language;
+    return useMemo(function () { return ({ setLanguage: setLanguage, currentLanguage: language }); }, [setLanguage, language]);
+}
+//# sourceMappingURL=use-language-switcher.js.map

package/dist/hooks/use-language-switcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-language-switcher.js","sourceRoot":"","sources":["../../src/hooks/use-language-switcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,MAAM,UAAU,mBAAmB;IAI3B,IAAA,KAA4B,iBAAiB,EAAE,EAA7C,WAAW,iBAAA,EAAE,QAAQ,cAAwB,CAAC;IAEtD,OAAO,OAAO,CACZ,cAAM,OAAA,CAAC,EAAE,WAAW,aAAA,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,EAA5C,CAA4C,EAClD,CAAC,WAAW,EAAE,QAAQ,CAAC,CACxB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -2,4 +2,5 @@ export * from '@magic-translate/core';
 export * from './components/Translate';
 export * from './context/MagicTranslateContext';
 export * from './hooks/use-translate';
+export * from './hooks/use-language-switcher';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC"}