@bleedingdev/modern-js-plugin-i18n 3.2.0-ultramodern.12 → 3.2.0-ultramodern.120
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +221 -11
- package/dist/cjs/cli/index.js +32 -5
- package/dist/cjs/runtime/I18nLink.js +17 -28
- package/dist/cjs/runtime/Link.js +252 -0
- package/dist/cjs/runtime/canonicalRoutes.js +18 -0
- package/dist/cjs/runtime/context.js +41 -10
- package/dist/cjs/runtime/hooks.js +17 -10
- package/dist/cjs/runtime/i18n/backend/config.js +9 -5
- package/dist/cjs/runtime/i18n/backend/defaults.js +15 -10
- package/dist/cjs/runtime/i18n/backend/defaults.node.js +16 -11
- package/dist/cjs/runtime/i18n/backend/index.js +9 -5
- package/dist/cjs/runtime/i18n/backend/middleware.common.js +9 -5
- package/dist/cjs/runtime/i18n/backend/middleware.js +9 -5
- package/dist/cjs/runtime/i18n/backend/middleware.node.js +13 -9
- package/dist/cjs/runtime/i18n/backend/sdk-backend.js +9 -5
- package/dist/cjs/runtime/i18n/backend/sdk-event.js +16 -11
- package/dist/cjs/runtime/i18n/detection/config.js +9 -5
- package/dist/cjs/runtime/i18n/detection/index.js +9 -5
- package/dist/cjs/runtime/i18n/detection/middleware.js +9 -5
- package/dist/cjs/runtime/i18n/detection/middleware.node.js +9 -5
- package/dist/cjs/runtime/i18n/index.js +9 -5
- package/dist/cjs/runtime/i18n/instance.js +17 -37
- package/dist/cjs/runtime/i18n/react-i18next.js +53 -0
- package/dist/cjs/runtime/i18n/utils.js +9 -17
- package/dist/cjs/runtime/index.js +50 -15
- package/dist/cjs/runtime/localizedPaths.js +105 -0
- package/dist/cjs/runtime/routerAdapter.js +167 -0
- package/dist/cjs/runtime/utils.js +87 -97
- package/dist/cjs/server/index.js +69 -13
- package/dist/cjs/shared/deepMerge.js +12 -8
- package/dist/cjs/shared/detection.js +9 -5
- package/dist/cjs/shared/localisedUrls.js +271 -0
- package/dist/cjs/shared/utils.js +15 -11
- package/dist/esm/cli/index.mjs +23 -0
- package/dist/esm/runtime/I18nLink.mjs +7 -22
- package/dist/esm/runtime/Link.mjs +209 -0
- package/dist/esm/runtime/canonicalRoutes.mjs +0 -0
- package/dist/esm/runtime/context.mjs +34 -7
- package/dist/esm/runtime/hooks.mjs +9 -6
- package/dist/esm/runtime/i18n/backend/defaults.mjs +1 -1
- package/dist/esm/runtime/i18n/backend/defaults.node.mjs +2 -2
- package/dist/esm/runtime/i18n/backend/middleware.node.mjs +3 -3
- package/dist/esm/runtime/i18n/instance.mjs +1 -19
- package/dist/esm/runtime/i18n/react-i18next.mjs +15 -0
- package/dist/esm/runtime/i18n/utils.mjs +0 -12
- package/dist/esm/runtime/index.mjs +23 -13
- package/dist/esm/runtime/localizedPaths.mjs +58 -0
- package/dist/esm/runtime/routerAdapter.mjs +129 -0
- package/dist/esm/runtime/utils.mjs +25 -30
- package/dist/esm/server/index.mjs +53 -7
- package/dist/esm/shared/localisedUrls.mjs +212 -0
- package/dist/esm-node/cli/index.mjs +23 -0
- package/dist/esm-node/runtime/I18nLink.mjs +7 -22
- package/dist/esm-node/runtime/Link.mjs +210 -0
- package/dist/esm-node/runtime/canonicalRoutes.mjs +1 -0
- package/dist/esm-node/runtime/context.mjs +34 -7
- package/dist/esm-node/runtime/hooks.mjs +9 -6
- package/dist/esm-node/runtime/i18n/backend/defaults.mjs +1 -1
- package/dist/esm-node/runtime/i18n/backend/defaults.node.mjs +2 -2
- package/dist/esm-node/runtime/i18n/backend/middleware.node.mjs +3 -3
- package/dist/esm-node/runtime/i18n/instance.mjs +1 -19
- package/dist/esm-node/runtime/i18n/react-i18next.mjs +16 -0
- package/dist/esm-node/runtime/i18n/utils.mjs +0 -12
- package/dist/esm-node/runtime/index.mjs +23 -13
- package/dist/esm-node/runtime/localizedPaths.mjs +59 -0
- package/dist/esm-node/runtime/routerAdapter.mjs +130 -0
- package/dist/esm-node/runtime/utils.mjs +25 -30
- package/dist/esm-node/server/index.mjs +53 -7
- package/dist/esm-node/shared/localisedUrls.mjs +213 -0
- package/dist/types/cli/index.d.ts +1 -0
- package/dist/types/runtime/I18nLink.d.ts +6 -0
- package/dist/types/runtime/Link.d.ts +56 -0
- package/dist/types/runtime/canonicalRoutes.d.ts +60 -0
- package/dist/types/runtime/context.d.ts +3 -0
- package/dist/types/runtime/hooks.d.ts +4 -2
- package/dist/types/runtime/i18n/backend/middleware.node.d.ts +1 -1
- package/dist/types/runtime/i18n/instance.d.ts +4 -6
- package/dist/types/runtime/i18n/react-i18next.d.ts +7 -0
- package/dist/types/runtime/index.d.ts +6 -1
- package/dist/types/runtime/localizedPaths.d.ts +39 -0
- package/dist/types/runtime/routerAdapter.d.ts +26 -0
- package/dist/types/runtime/types.d.ts +1 -1
- package/dist/types/runtime/utils.d.ts +13 -9
- package/dist/types/server/index.d.ts +6 -0
- package/dist/types/shared/localisedUrls.d.ts +21 -0
- package/dist/types/shared/type.d.ts +12 -0
- package/package.json +24 -28
- package/rstest.config.mts +39 -0
- package/src/cli/index.ts +44 -1
- package/src/runtime/I18nLink.tsx +14 -51
- package/src/runtime/Link.tsx +414 -0
- package/src/runtime/canonicalRoutes.ts +93 -0
- package/src/runtime/context.tsx +45 -7
- package/src/runtime/hooks.ts +13 -4
- package/src/runtime/i18n/backend/defaults.node.ts +2 -2
- package/src/runtime/i18n/backend/defaults.ts +3 -1
- package/src/runtime/i18n/backend/middleware.node.ts +1 -1
- package/src/runtime/i18n/instance.ts +3 -30
- package/src/runtime/i18n/react-i18next.ts +25 -0
- package/src/runtime/i18n/utils.ts +4 -26
- package/src/runtime/index.tsx +47 -12
- package/src/runtime/localizedPaths.ts +118 -0
- package/src/runtime/routerAdapter.tsx +333 -0
- package/src/runtime/types.ts +1 -1
- package/src/runtime/utils.ts +44 -37
- package/src/server/index.ts +117 -10
- package/src/shared/localisedUrls.ts +453 -0
- package/src/shared/type.ts +12 -0
- package/tests/i18nUtils.test.ts +52 -0
- package/tests/link.test.tsx +475 -0
- package/tests/linkTypes.test.ts +28 -0
- package/tests/localisedUrls.test.ts +312 -0
- package/tests/routerAdapter.test.tsx +452 -0
- package/tests/type-fixture/linkTypes.fixture.tsx +51 -0
- package/tests/type-fixture/tsconfig.json +15 -0
- package/dist/esm/rslib-runtime.mjs +0 -18
- package/dist/esm-node/rslib-runtime.mjs +0 -19
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
import "node:module";
|
|
2
2
|
import { jsx } from "react/jsx-runtime";
|
|
3
3
|
import { isBrowser } from "@modern-js/runtime";
|
|
4
|
-
import { createContext, useCallback, useContext, useMemo } from "react";
|
|
4
|
+
import { createContext, useCallback, useContext, useEffect, useMemo } from "react";
|
|
5
5
|
import { cacheUserLanguage } from "./i18n/detection/index.mjs";
|
|
6
|
-
import {
|
|
6
|
+
import { useI18nRouterAdapter } from "./routerAdapter.mjs";
|
|
7
|
+
import { buildLocalizedUrl, detectLanguageFromPath, getEntryPath, shouldIgnoreRedirect } from "./utils.mjs";
|
|
7
8
|
const ModernI18nContext = /*#__PURE__*/ createContext(null);
|
|
8
9
|
const ModernI18nProvider = ({ children, value })=>/*#__PURE__*/ jsx(ModernI18nContext.Provider, {
|
|
9
10
|
value: value,
|
|
@@ -12,9 +13,33 @@ const ModernI18nProvider = ({ children, value })=>/*#__PURE__*/ jsx(ModernI18nCo
|
|
|
12
13
|
const useModernI18n = ()=>{
|
|
13
14
|
const context = useContext(ModernI18nContext);
|
|
14
15
|
if (!context) throw new Error('useModernI18n must be used within a ModernI18nProvider');
|
|
15
|
-
const { language: contextLanguage, i18nInstance, languages, localePathRedirect, ignoreRedirectRoutes, updateLanguage } = context;
|
|
16
|
-
const { navigate, location, hasRouter } =
|
|
17
|
-
const
|
|
16
|
+
const { language: contextLanguage, i18nInstance, languages, localePathRedirect, ignoreRedirectRoutes, localisedUrls, updateLanguage } = context;
|
|
17
|
+
const { navigate, location, hasRouter } = useI18nRouterAdapter();
|
|
18
|
+
const pathLanguage = useMemo(()=>{
|
|
19
|
+
if (!localePathRedirect || !location?.pathname) return;
|
|
20
|
+
const detected = detectLanguageFromPath(location.pathname, languages || [], localePathRedirect);
|
|
21
|
+
return detected.detected ? detected.language : void 0;
|
|
22
|
+
}, [
|
|
23
|
+
languages,
|
|
24
|
+
localePathRedirect,
|
|
25
|
+
location?.pathname
|
|
26
|
+
]);
|
|
27
|
+
const currentLanguage = pathLanguage || contextLanguage;
|
|
28
|
+
useEffect(()=>{
|
|
29
|
+
if (!pathLanguage || pathLanguage === contextLanguage) return;
|
|
30
|
+
updateLanguage?.(pathLanguage);
|
|
31
|
+
i18nInstance?.setLang?.(pathLanguage);
|
|
32
|
+
i18nInstance?.changeLanguage?.(pathLanguage);
|
|
33
|
+
if (isBrowser()) {
|
|
34
|
+
const detectionOptions = i18nInstance.options?.detection;
|
|
35
|
+
cacheUserLanguage(i18nInstance, pathLanguage, detectionOptions);
|
|
36
|
+
}
|
|
37
|
+
}, [
|
|
38
|
+
contextLanguage,
|
|
39
|
+
i18nInstance,
|
|
40
|
+
pathLanguage,
|
|
41
|
+
updateLanguage
|
|
42
|
+
]);
|
|
18
43
|
const changeLanguage = useCallback(async (newLang)=>{
|
|
19
44
|
try {
|
|
20
45
|
if (!newLang || 'string' != typeof newLang) throw new Error('Language must be a non-empty string');
|
|
@@ -31,7 +56,7 @@ const useModernI18n = ()=>{
|
|
|
31
56
|
const pathLanguage = detectLanguageFromPath(currentPath, languages || [], localePathRedirect);
|
|
32
57
|
if (pathLanguage.detected && pathLanguage.language === newLang) return;
|
|
33
58
|
if (!shouldIgnoreRedirect(relativePath, languages || [], ignoreRedirectRoutes)) {
|
|
34
|
-
const newPath = buildLocalizedUrl(relativePath, newLang, languages || []);
|
|
59
|
+
const newPath = buildLocalizedUrl(relativePath, newLang, languages || [], localisedUrls);
|
|
35
60
|
const newUrl = entryPath + newPath + location.search + location.hash;
|
|
36
61
|
await navigate(newUrl, {
|
|
37
62
|
replace: true
|
|
@@ -44,7 +69,7 @@ const useModernI18n = ()=>{
|
|
|
44
69
|
const pathLanguage = detectLanguageFromPath(currentPath, languages || [], localePathRedirect);
|
|
45
70
|
if (pathLanguage.detected && pathLanguage.language === newLang) return;
|
|
46
71
|
if (!shouldIgnoreRedirect(relativePath, languages || [], ignoreRedirectRoutes)) {
|
|
47
|
-
const newPath = buildLocalizedUrl(relativePath, newLang, languages || []);
|
|
72
|
+
const newPath = buildLocalizedUrl(relativePath, newLang, languages || [], localisedUrls);
|
|
48
73
|
const newUrl = entryPath + newPath + window.location.search + window.location.hash;
|
|
49
74
|
window.history.pushState(null, '', newUrl);
|
|
50
75
|
}
|
|
@@ -59,6 +84,7 @@ const useModernI18n = ()=>{
|
|
|
59
84
|
updateLanguage,
|
|
60
85
|
localePathRedirect,
|
|
61
86
|
ignoreRedirectRoutes,
|
|
87
|
+
localisedUrls,
|
|
62
88
|
languages,
|
|
63
89
|
hasRouter,
|
|
64
90
|
navigate,
|
|
@@ -99,6 +125,7 @@ const useModernI18n = ()=>{
|
|
|
99
125
|
changeLanguage,
|
|
100
126
|
i18nInstance,
|
|
101
127
|
supportedLanguages: languages || [],
|
|
128
|
+
localisedUrls,
|
|
102
129
|
isLanguageSupported,
|
|
103
130
|
isResourcesReady
|
|
104
131
|
};
|
|
@@ -3,7 +3,8 @@ import { isBrowser } from "@modern-js/runtime";
|
|
|
3
3
|
import { useEffect, useRef } from "react";
|
|
4
4
|
import { I18N_SDK_RESOURCES_LOADED_EVENT, getI18nSdkBackendId } from "./i18n/backend/sdk-event.mjs";
|
|
5
5
|
import { cacheUserLanguage } from "./i18n/detection/index.mjs";
|
|
6
|
-
import {
|
|
6
|
+
import { useI18nRouterAdapter } from "./routerAdapter.mjs";
|
|
7
|
+
import { buildLocalizedUrl, detectLanguageFromPath, getEntryPath, getPathname, shouldIgnoreRedirect } from "./utils.mjs";
|
|
7
8
|
function createMinimalI18nInstance(language) {
|
|
8
9
|
const minimalInstance = {
|
|
9
10
|
language,
|
|
@@ -15,7 +16,7 @@ function createMinimalI18nInstance(language) {
|
|
|
15
16
|
};
|
|
16
17
|
return minimalInstance;
|
|
17
18
|
}
|
|
18
|
-
function createContextValue(lang, i18nInstance, entryName, languages, localePathRedirect, ignoreRedirectRoutes, setLang) {
|
|
19
|
+
function createContextValue(lang, i18nInstance, entryName, languages, localePathRedirect, ignoreRedirectRoutes, localisedUrls, setLang) {
|
|
19
20
|
const instance = i18nInstance || createMinimalI18nInstance(lang);
|
|
20
21
|
return {
|
|
21
22
|
language: lang,
|
|
@@ -24,6 +25,7 @@ function createContextValue(lang, i18nInstance, entryName, languages, localePath
|
|
|
24
25
|
languages,
|
|
25
26
|
localePathRedirect,
|
|
26
27
|
ignoreRedirectRoutes,
|
|
28
|
+
localisedUrls,
|
|
27
29
|
updateLanguage: setLang
|
|
28
30
|
};
|
|
29
31
|
}
|
|
@@ -73,9 +75,9 @@ function useSdkResourcesLoader(i18nInstance, setForceUpdate) {
|
|
|
73
75
|
setForceUpdate
|
|
74
76
|
]);
|
|
75
77
|
}
|
|
76
|
-
function useClientSideRedirect(i18nInstance, localePathRedirect, languages, fallbackLanguage, ignoreRedirectRoutes) {
|
|
78
|
+
function useClientSideRedirect(i18nInstance, localePathRedirect, languages, fallbackLanguage, ignoreRedirectRoutes, localisedUrls) {
|
|
77
79
|
const hasRedirectedRef = useRef(false);
|
|
78
|
-
const { navigate, location, hasRouter } =
|
|
80
|
+
const { navigate, location, hasRouter } = useI18nRouterAdapter();
|
|
79
81
|
useEffect(()=>{
|
|
80
82
|
if ('browser' !== process.env.MODERN_TARGET) return;
|
|
81
83
|
if (!localePathRedirect || !i18nInstance) return;
|
|
@@ -94,7 +96,7 @@ function useClientSideRedirect(i18nInstance, localePathRedirect, languages, fall
|
|
|
94
96
|
const pathDetection = detectLanguageFromPath(currentPathname, languages, localePathRedirect);
|
|
95
97
|
if (pathDetection.detected) return;
|
|
96
98
|
const targetLanguage = i18nInstance.language || fallbackLanguage || languages[0] || 'en';
|
|
97
|
-
const newPath = buildLocalizedUrl(relativePath, targetLanguage, languages);
|
|
99
|
+
const newPath = buildLocalizedUrl(relativePath, targetLanguage, languages, localisedUrls);
|
|
98
100
|
const newUrl = entryPath + newPath + currentSearch + currentHash;
|
|
99
101
|
if (newUrl !== currentPathname + currentSearch + currentHash) {
|
|
100
102
|
hasRedirectedRef.current = true;
|
|
@@ -111,7 +113,8 @@ function useClientSideRedirect(i18nInstance, localePathRedirect, languages, fall
|
|
|
111
113
|
i18nInstance,
|
|
112
114
|
languages,
|
|
113
115
|
fallbackLanguage,
|
|
114
|
-
ignoreRedirectRoutes
|
|
116
|
+
ignoreRedirectRoutes,
|
|
117
|
+
localisedUrls
|
|
115
118
|
]);
|
|
116
119
|
}
|
|
117
120
|
function useLanguageSync(i18nInstance, localePathRedirect, languages, runtimeContextRef, prevLangRef, setLang) {
|
|
@@ -5,7 +5,7 @@ const DEFAULT_I18NEXT_BACKEND_OPTIONS = {
|
|
|
5
5
|
};
|
|
6
6
|
function convertPath(path) {
|
|
7
7
|
if (!path) return path;
|
|
8
|
-
if (path.startsWith('/')) return `${window.__assetPrefix__ || ''}${path}`;
|
|
8
|
+
if (path.startsWith('/')) return "u" < typeof window ? path : `${window.__assetPrefix__ || ''}${path}`;
|
|
9
9
|
return path;
|
|
10
10
|
}
|
|
11
11
|
function convertBackendOptions(options) {
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import "node:module";
|
|
2
2
|
const DEFAULT_I18NEXT_BACKEND_OPTIONS = {
|
|
3
|
-
loadPath: './locales/{{lng}}/{{ns}}.json',
|
|
4
|
-
addPath: './locales/{{lng}}/{{ns}}.json'
|
|
3
|
+
loadPath: './config/public/locales/{{lng}}/{{ns}}.json',
|
|
4
|
+
addPath: './config/public/locales/{{lng}}/{{ns}}.json'
|
|
5
5
|
};
|
|
6
6
|
function convertPath(path) {
|
|
7
7
|
if (!path) return path;
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import "node:module";
|
|
2
|
-
import
|
|
2
|
+
import cjs from "i18next-fs-backend/cjs";
|
|
3
3
|
import { useI18nextBackendCommon } from "./middleware.common.mjs";
|
|
4
|
-
class FsBackendWithSave extends
|
|
4
|
+
class FsBackendWithSave extends cjs {
|
|
5
5
|
save(_language, _namespace, _data) {}
|
|
6
6
|
}
|
|
7
7
|
const HttpBackendWithSave = FsBackendWithSave;
|
|
8
|
-
const useI18nextBackend = (i18nInstance, backend)=>useI18nextBackendCommon(i18nInstance, FsBackendWithSave,
|
|
8
|
+
const useI18nextBackend = (i18nInstance, backend)=>useI18nextBackendCommon(i18nInstance, FsBackendWithSave, cjs, backend);
|
|
9
9
|
export { FsBackendWithSave, HttpBackendWithSave, useI18nextBackend };
|
|
@@ -41,14 +41,6 @@ async function createI18nextInstance() {
|
|
|
41
41
|
return null;
|
|
42
42
|
}
|
|
43
43
|
}
|
|
44
|
-
async function tryImportReactI18next() {
|
|
45
|
-
try {
|
|
46
|
-
const reactI18next = await import("react-i18next");
|
|
47
|
-
return reactI18next;
|
|
48
|
-
} catch (error) {
|
|
49
|
-
return null;
|
|
50
|
-
}
|
|
51
|
-
}
|
|
52
44
|
function getI18nextInstanceForProvider(instance) {
|
|
53
45
|
if (isI18nWrapperInstance(instance)) {
|
|
54
46
|
const i18nextInstance = getI18nWrapperI18nextInstance(instance);
|
|
@@ -65,14 +57,4 @@ async function getI18nInstance(userInstance) {
|
|
|
65
57
|
if (i18nextInstance) return i18nextInstance;
|
|
66
58
|
throw new Error('No i18n instance found');
|
|
67
59
|
}
|
|
68
|
-
|
|
69
|
-
const reactI18nextModule = await tryImportReactI18next();
|
|
70
|
-
if (reactI18nextModule) return reactI18nextModule.initReactI18next;
|
|
71
|
-
return null;
|
|
72
|
-
}
|
|
73
|
-
async function getI18nextProvider() {
|
|
74
|
-
const reactI18nextModule = await tryImportReactI18next();
|
|
75
|
-
if (reactI18nextModule) return reactI18nextModule.I18nextProvider;
|
|
76
|
-
return null;
|
|
77
|
-
}
|
|
78
|
-
export { getActualI18nextInstance, getI18nInstance, getI18nWrapperI18nextInstance, getI18nextInstanceForProvider, getI18nextProvider, getInitReactI18next, isI18nInstance, isI18nWrapperInstance };
|
|
60
|
+
export { getActualI18nextInstance, getI18nInstance, getI18nWrapperI18nextInstance, getI18nextInstanceForProvider, isI18nInstance, isI18nWrapperInstance };
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import "node:module";
|
|
2
|
+
async function tryImportReactI18next() {
|
|
3
|
+
try {
|
|
4
|
+
return await import("react-i18next");
|
|
5
|
+
} catch (error) {
|
|
6
|
+
return null;
|
|
7
|
+
}
|
|
8
|
+
}
|
|
9
|
+
async function getReactI18nextIntegration() {
|
|
10
|
+
const reactI18nextModule = await tryImportReactI18next();
|
|
11
|
+
return {
|
|
12
|
+
I18nextProvider: reactI18nextModule?.I18nextProvider ?? null,
|
|
13
|
+
initReactI18next: reactI18nextModule?.initReactI18next ?? null
|
|
14
|
+
};
|
|
15
|
+
}
|
|
16
|
+
export { getReactI18nextIntegration };
|
|
@@ -101,18 +101,6 @@ const initializeI18nInstance = async (i18nInstance, finalLanguage, fallbackLangu
|
|
|
101
101
|
};
|
|
102
102
|
}
|
|
103
103
|
}
|
|
104
|
-
if (mergedBackend && hasOptions(i18nInstance)) {
|
|
105
|
-
const defaultNS = initOptions.defaultNS || initOptions.ns || 'translation';
|
|
106
|
-
const ns = Array.isArray(defaultNS) ? defaultNS[0] : defaultNS;
|
|
107
|
-
let retries = 20;
|
|
108
|
-
while(retries > 0){
|
|
109
|
-
const actualInstance = getActualI18nextInstance(i18nInstance);
|
|
110
|
-
const store = actualInstance.store;
|
|
111
|
-
if (store?.data?.[finalLanguage]?.[ns]) break;
|
|
112
|
-
await new Promise((resolve)=>setTimeout(resolve, 100));
|
|
113
|
-
retries--;
|
|
114
|
-
}
|
|
115
|
-
}
|
|
116
104
|
}
|
|
117
105
|
};
|
|
118
106
|
function hasOptions(instance) {
|
|
@@ -11,26 +11,31 @@ import { mergeBackendOptions } from "./i18n/backend/index.mjs";
|
|
|
11
11
|
import { useI18nextBackend } from "./i18n/backend/middleware.mjs";
|
|
12
12
|
import { detectLanguageWithPriority, exportServerLngToWindow, mergeDetectionOptions } from "./i18n/detection/index.mjs";
|
|
13
13
|
import { useI18nextLanguageDetector } from "./i18n/detection/middleware.mjs";
|
|
14
|
-
import { getI18nextInstanceForProvider
|
|
14
|
+
import { getI18nextInstanceForProvider } from "./i18n/instance.mjs";
|
|
15
15
|
import { changeI18nLanguage, ensureLanguageMatch, initializeI18nInstance, setupClonedInstance } from "./i18n/utils.mjs";
|
|
16
|
-
import { getPathname } from "./utils.mjs";
|
|
16
|
+
import { buildLocalizedUrl, getPathname, splitUrlTarget } from "./utils.mjs";
|
|
17
17
|
import "./types.mjs";
|
|
18
18
|
const i18nPlugin = (options)=>({
|
|
19
19
|
name: '@modern-js/plugin-i18n',
|
|
20
20
|
setup: (api)=>{
|
|
21
|
-
const { entryName, i18nInstance: userI18nInstance, initOptions, localeDetection, backend, htmlLangAttr = false } = options;
|
|
22
|
-
const { localePathRedirect = false, i18nextDetector = true, languages = [], fallbackLanguage = 'en', detection, ignoreRedirectRoutes } = localeDetection || {};
|
|
21
|
+
const { entryName, i18nInstance: userI18nInstance, initOptions, localeDetection, backend, htmlLangAttr = false, reactI18next = true } = options;
|
|
22
|
+
const { localePathRedirect = false, i18nextDetector = true, languages = [], fallbackLanguage = 'en', detection, ignoreRedirectRoutes, localisedUrls } = localeDetection || {};
|
|
23
23
|
const { enabled: backendEnabled = false } = backend || {};
|
|
24
24
|
let latestI18nInstance;
|
|
25
25
|
let I18nextProvider;
|
|
26
|
+
const loadReactI18nextIntegration = async ()=>{
|
|
27
|
+
if (!reactI18next) return null;
|
|
28
|
+
const { getReactI18nextIntegration } = await import("./i18n/react-i18next.mjs");
|
|
29
|
+
return getReactI18nextIntegration();
|
|
30
|
+
};
|
|
26
31
|
api.onBeforeRender(async (context)=>{
|
|
27
32
|
let i18nInstance = await getI18nInstance(userI18nInstance);
|
|
28
33
|
const { i18n: otherConfig } = api.getRuntimeConfig();
|
|
29
34
|
const { initOptions: otherInitOptions } = otherConfig || {};
|
|
30
35
|
const userInitOptions = merge(otherInitOptions || {}, initOptions || {});
|
|
31
|
-
const
|
|
32
|
-
I18nextProvider =
|
|
33
|
-
if (initReactI18next) i18nInstance.use(initReactI18next);
|
|
36
|
+
const reactI18nextIntegration = await loadReactI18nextIntegration();
|
|
37
|
+
I18nextProvider = reactI18nextIntegration?.I18nextProvider ?? null;
|
|
38
|
+
if (reactI18nextIntegration?.initReactI18next) i18nInstance.use(reactI18nextIntegration.initReactI18next);
|
|
34
39
|
const pathname = getPathname(context);
|
|
35
40
|
if (i18nextDetector) useI18nextLanguageDetector(i18nInstance);
|
|
36
41
|
const mergedDetection = mergeDetectionOptions(i18nextDetector, detection, localePathRedirect, userInitOptions);
|
|
@@ -90,16 +95,18 @@ const i18nPlugin = (options)=>({
|
|
|
90
95
|
]);
|
|
91
96
|
useSdkResourcesLoader(i18nInstance, setForceUpdate);
|
|
92
97
|
useLanguageSync(i18nInstance, localePathRedirect, languages, runtimeContextRef, prevLangRef, setLang);
|
|
93
|
-
useClientSideRedirect(i18nInstance, localePathRedirect, languages, fallbackLanguage, ignoreRedirectRoutes);
|
|
94
|
-
const contextValue = useMemo(()=>createContextValue(lang, i18nInstance, entryName, languages, localePathRedirect, ignoreRedirectRoutes, setLang), [
|
|
98
|
+
useClientSideRedirect(i18nInstance, localePathRedirect, languages, fallbackLanguage, ignoreRedirectRoutes, localisedUrls);
|
|
99
|
+
const contextValue = useMemo(()=>createContextValue(lang, i18nInstance, entryName, languages, localePathRedirect, ignoreRedirectRoutes, localisedUrls, setLang), [
|
|
95
100
|
lang,
|
|
96
101
|
i18nInstance,
|
|
97
102
|
entryName,
|
|
98
103
|
languages,
|
|
99
104
|
localePathRedirect,
|
|
100
105
|
ignoreRedirectRoutes,
|
|
106
|
+
localisedUrls,
|
|
101
107
|
forceUpdate
|
|
102
108
|
]);
|
|
109
|
+
const children = props.children;
|
|
103
110
|
const appContent = /*#__PURE__*/ jsxs(Fragment, {
|
|
104
111
|
children: [
|
|
105
112
|
Boolean(htmlLangAttr) && /*#__PURE__*/ jsx(Helmet, {
|
|
@@ -109,9 +116,10 @@ const i18nPlugin = (options)=>({
|
|
|
109
116
|
}),
|
|
110
117
|
/*#__PURE__*/ jsx(ModernI18nProvider, {
|
|
111
118
|
value: contextValue,
|
|
112
|
-
children: /*#__PURE__*/ jsx(App, {
|
|
113
|
-
...props
|
|
114
|
-
|
|
119
|
+
children: App ? /*#__PURE__*/ jsx(App, {
|
|
120
|
+
...props,
|
|
121
|
+
children: children
|
|
122
|
+
}) : children
|
|
115
123
|
})
|
|
116
124
|
]
|
|
117
125
|
});
|
|
@@ -129,5 +137,7 @@ const i18nPlugin = (options)=>({
|
|
|
129
137
|
});
|
|
130
138
|
const runtime = i18nPlugin;
|
|
131
139
|
export { I18nLink } from "./I18nLink.mjs";
|
|
140
|
+
export { Link } from "./Link.mjs";
|
|
141
|
+
export { canonicalPath, localizePath, useLocalizedLocation, useLocalizedPaths } from "./localizedPaths.mjs";
|
|
132
142
|
export default runtime;
|
|
133
|
-
export { i18nPlugin, useModernI18n };
|
|
143
|
+
export { buildLocalizedUrl, i18nPlugin, splitUrlTarget, useModernI18n };
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import "node:module";
|
|
2
|
+
import { useMemo } from "react";
|
|
3
|
+
import { resolveCanonicalLocalisedPath, resolveLocalisedUrlsConfig } from "../shared/localisedUrls.mjs";
|
|
4
|
+
import { useModernI18n } from "./context.mjs";
|
|
5
|
+
import { useI18nRouterAdapter } from "./routerAdapter.mjs";
|
|
6
|
+
import { buildLocalizedUrl, splitUrlTarget } from "./utils.mjs";
|
|
7
|
+
const localizePath = (pathname, language, config)=>buildLocalizedUrl(pathname, language, config.languages, config.localisedUrls);
|
|
8
|
+
const canonicalPath = (target, config)=>{
|
|
9
|
+
const { pathname, search, hash } = splitUrlTarget(target);
|
|
10
|
+
const segments = pathname.split('/').filter(Boolean);
|
|
11
|
+
const pathWithoutLanguage = segments.length > 0 && config.languages.includes(segments[0]) ? `/${segments.slice(1).join('/')}` : pathname || '/';
|
|
12
|
+
const localisedUrlsConfig = resolveLocalisedUrlsConfig(config.localisedUrls);
|
|
13
|
+
const resolvedPath = localisedUrlsConfig.enabled ? resolveCanonicalLocalisedPath(pathWithoutLanguage, config.languages, localisedUrlsConfig.map) : pathWithoutLanguage;
|
|
14
|
+
return `${resolvedPath}${search}${hash}`;
|
|
15
|
+
};
|
|
16
|
+
const useLocalizedPaths = ()=>{
|
|
17
|
+
const { supportedLanguages, localisedUrls } = useModernI18n();
|
|
18
|
+
return useMemo(()=>{
|
|
19
|
+
const config = {
|
|
20
|
+
languages: supportedLanguages,
|
|
21
|
+
localisedUrls
|
|
22
|
+
};
|
|
23
|
+
return {
|
|
24
|
+
localizePath: (pathname, language)=>localizePath(pathname, language, config),
|
|
25
|
+
canonicalPath: (pathname)=>canonicalPath(pathname, config)
|
|
26
|
+
};
|
|
27
|
+
}, [
|
|
28
|
+
supportedLanguages,
|
|
29
|
+
localisedUrls
|
|
30
|
+
]);
|
|
31
|
+
};
|
|
32
|
+
const useLocalizedLocation = ()=>{
|
|
33
|
+
const { language, supportedLanguages, localisedUrls } = useModernI18n();
|
|
34
|
+
const { location } = useI18nRouterAdapter();
|
|
35
|
+
const pathname = location?.pathname ?? '/';
|
|
36
|
+
const search = location?.search ?? '';
|
|
37
|
+
const hash = location?.hash ?? '';
|
|
38
|
+
return useMemo(()=>{
|
|
39
|
+
const config = {
|
|
40
|
+
languages: supportedLanguages,
|
|
41
|
+
localisedUrls
|
|
42
|
+
};
|
|
43
|
+
const alternates = {};
|
|
44
|
+
for (const supportedLanguage of supportedLanguages)alternates[supportedLanguage] = `${localizePath(pathname, supportedLanguage, config)}${search}${hash}`;
|
|
45
|
+
return {
|
|
46
|
+
language,
|
|
47
|
+
canonical: canonicalPath(pathname, config),
|
|
48
|
+
alternates
|
|
49
|
+
};
|
|
50
|
+
}, [
|
|
51
|
+
language,
|
|
52
|
+
supportedLanguages,
|
|
53
|
+
localisedUrls,
|
|
54
|
+
pathname,
|
|
55
|
+
search,
|
|
56
|
+
hash
|
|
57
|
+
]);
|
|
58
|
+
};
|
|
59
|
+
export { canonicalPath, localizePath, useLocalizedLocation, useLocalizedPaths };
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
import "node:module";
|
|
2
|
+
import { RuntimeContext, isBrowser } from "@modern-js/runtime";
|
|
3
|
+
import { InternalRuntimeContext } from "@modern-js/runtime/context";
|
|
4
|
+
import { Link as router_Link, useInRouterContext, useLocation, useNavigate, useParams } from "@modern-js/runtime/router";
|
|
5
|
+
import { useCallback, useContext, useEffect, useState } from "react";
|
|
6
|
+
const normalizeUrlPart = (value, prefix)=>{
|
|
7
|
+
if ('string' != typeof value || !value) return '';
|
|
8
|
+
return value.startsWith(prefix) ? value : `${prefix}${value}`;
|
|
9
|
+
};
|
|
10
|
+
const normalizeLocation = (location)=>{
|
|
11
|
+
if (!location || 'object' != typeof location) return null;
|
|
12
|
+
const locationValue = location;
|
|
13
|
+
if ('string' != typeof locationValue.pathname) return null;
|
|
14
|
+
return {
|
|
15
|
+
pathname: locationValue.pathname,
|
|
16
|
+
search: normalizeUrlPart('string' == typeof locationValue.search ? locationValue.search : locationValue.searchStr, '?'),
|
|
17
|
+
hash: normalizeUrlPart(locationValue.hash, '#')
|
|
18
|
+
};
|
|
19
|
+
};
|
|
20
|
+
const getWindowLocation = ()=>{
|
|
21
|
+
if (!isBrowser()) return null;
|
|
22
|
+
return {
|
|
23
|
+
pathname: window.location.pathname,
|
|
24
|
+
search: window.location.search,
|
|
25
|
+
hash: window.location.hash
|
|
26
|
+
};
|
|
27
|
+
};
|
|
28
|
+
const getRouterFramework = (runtimeContext, internalContext, inReactRouter)=>{
|
|
29
|
+
const framework = internalContext.routerFramework || internalContext.routerRuntime?.framework || runtimeContext.routerFramework;
|
|
30
|
+
if (framework) return framework;
|
|
31
|
+
if (internalContext.router?.useRouter || runtimeContext.router?.useRouter) return 'tanstack';
|
|
32
|
+
if (internalContext.router?.useLocation || internalContext.router?.useHref || runtimeContext.router?.useLocation || runtimeContext.router?.useHref) return 'react-router';
|
|
33
|
+
if (inReactRouter) return 'react-router';
|
|
34
|
+
};
|
|
35
|
+
const getRouterInstance = (internalContext, contextRouter)=>{
|
|
36
|
+
if (contextRouter) return contextRouter;
|
|
37
|
+
const router = internalContext.routerInstance || internalContext.routerRuntime?.instance;
|
|
38
|
+
if (!router || 'object' != typeof router) return null;
|
|
39
|
+
return router;
|
|
40
|
+
};
|
|
41
|
+
const getRouterStateLocation = (internalContext, contextRouter)=>{
|
|
42
|
+
const router = getRouterInstance(internalContext, contextRouter);
|
|
43
|
+
return normalizeLocation(router?.stores?.location?.get?.()) || normalizeLocation(router?.state?.location);
|
|
44
|
+
};
|
|
45
|
+
const getRouterParams = (internalContext, contextRouter)=>{
|
|
46
|
+
const router = getRouterInstance(internalContext, contextRouter);
|
|
47
|
+
const matches = router?.stores?.matches?.get?.() || router?.state?.matches;
|
|
48
|
+
if (!Array.isArray(matches)) return {};
|
|
49
|
+
return matches.reduce((params, match)=>{
|
|
50
|
+
if (match?.params) Object.assign(params, match.params);
|
|
51
|
+
return params;
|
|
52
|
+
}, {});
|
|
53
|
+
};
|
|
54
|
+
const useI18nRouterAdapter = ()=>{
|
|
55
|
+
const runtimeContext = useContext(RuntimeContext);
|
|
56
|
+
const internalContext = useContext(InternalRuntimeContext);
|
|
57
|
+
const inReactRouter = useInRouterContext();
|
|
58
|
+
const reactRouterNavigate = inReactRouter ? useNavigate() : null;
|
|
59
|
+
const reactRouterLocation = inReactRouter ? useLocation() : null;
|
|
60
|
+
const reactRouterParams = inReactRouter ? useParams() : {};
|
|
61
|
+
const framework = getRouterFramework(runtimeContext, internalContext, inReactRouter);
|
|
62
|
+
const contextUseRouter = inReactRouter || 'tanstack' !== framework ? void 0 : internalContext.router?.useRouter || runtimeContext.router?.useRouter;
|
|
63
|
+
const contextRouter = contextUseRouter ? contextUseRouter({
|
|
64
|
+
warn: false
|
|
65
|
+
}) : null;
|
|
66
|
+
const [, setRouterVersion] = useState(0);
|
|
67
|
+
const hasRouter = 'tanstack' === framework || 'react-router' === framework || Boolean(reactRouterNavigate);
|
|
68
|
+
useEffect(()=>{
|
|
69
|
+
if ('tanstack' !== framework) return;
|
|
70
|
+
const router = getRouterInstance(internalContext, contextRouter);
|
|
71
|
+
if (!router) return;
|
|
72
|
+
const update = ()=>setRouterVersion((version)=>version + 1);
|
|
73
|
+
const unsubscribers = [];
|
|
74
|
+
if ('function' == typeof router.stores?.location?.subscribe) {
|
|
75
|
+
const unsubscribe = router.stores.location.subscribe(update);
|
|
76
|
+
if ('function' == typeof unsubscribe) unsubscribers.push(unsubscribe);
|
|
77
|
+
}
|
|
78
|
+
if ('function' == typeof router.subscribe) for (const eventType of [
|
|
79
|
+
'onBeforeNavigate',
|
|
80
|
+
'onBeforeLoad'
|
|
81
|
+
]){
|
|
82
|
+
const unsubscribe = router.subscribe(eventType, update);
|
|
83
|
+
if ('function' == typeof unsubscribe) unsubscribers.push(unsubscribe);
|
|
84
|
+
}
|
|
85
|
+
return ()=>{
|
|
86
|
+
for (const unsubscribe of unsubscribers)unsubscribe();
|
|
87
|
+
};
|
|
88
|
+
}, [
|
|
89
|
+
contextRouter,
|
|
90
|
+
framework,
|
|
91
|
+
internalContext
|
|
92
|
+
]);
|
|
93
|
+
const navigate = useCallback((href, options)=>{
|
|
94
|
+
const router = getRouterInstance(internalContext, contextRouter);
|
|
95
|
+
const activeFramework = getRouterFramework(runtimeContext, internalContext, inReactRouter);
|
|
96
|
+
if ('tanstack' === activeFramework) {
|
|
97
|
+
if ('function' == typeof router?.navigate) return router.navigate({
|
|
98
|
+
to: href,
|
|
99
|
+
replace: options?.replace,
|
|
100
|
+
...options?.state === void 0 ? {} : {
|
|
101
|
+
state: options.state
|
|
102
|
+
}
|
|
103
|
+
});
|
|
104
|
+
throw new Error('TanStack router instance is not available.');
|
|
105
|
+
}
|
|
106
|
+
if (reactRouterNavigate) return reactRouterNavigate(href, options);
|
|
107
|
+
if ('react-router' === activeFramework) {
|
|
108
|
+
if ('function' == typeof router?.navigate) return router.navigate(href, options);
|
|
109
|
+
throw new Error('React Router instance is not available.');
|
|
110
|
+
}
|
|
111
|
+
}, [
|
|
112
|
+
contextRouter,
|
|
113
|
+
internalContext,
|
|
114
|
+
inReactRouter,
|
|
115
|
+
reactRouterNavigate,
|
|
116
|
+
runtimeContext
|
|
117
|
+
]);
|
|
118
|
+
const location = (reactRouterLocation ? normalizeLocation(reactRouterLocation) : getRouterStateLocation(internalContext, contextRouter)) || getWindowLocation();
|
|
119
|
+
const params = inReactRouter ? reactRouterParams : getRouterParams(internalContext, contextRouter);
|
|
120
|
+
const Link = 'tanstack' === framework ? internalContext.router?.Link || runtimeContext.router?.Link || null : 'react-router' === framework || inReactRouter ? router_Link : null;
|
|
121
|
+
return {
|
|
122
|
+
framework,
|
|
123
|
+
hasRouter,
|
|
124
|
+
location,
|
|
125
|
+
navigate: hasRouter ? navigate : null,
|
|
126
|
+
Link,
|
|
127
|
+
params
|
|
128
|
+
};
|
|
129
|
+
};
|
|
130
|
+
export { useI18nRouterAdapter };
|
|
@@ -1,13 +1,7 @@
|
|
|
1
1
|
import "node:module";
|
|
2
2
|
import { isBrowser } from "@modern-js/runtime";
|
|
3
3
|
import { getGlobalBasename } from "@modern-js/runtime/context";
|
|
4
|
-
import {
|
|
5
|
-
import * as __rspack_external__modern_js_runtime_router_2dfd0c78 from "@modern-js/runtime/router";
|
|
6
|
-
__webpack_require__.add({
|
|
7
|
-
"@modern-js/runtime/router?f1fa" (module) {
|
|
8
|
-
module.exports = __rspack_external__modern_js_runtime_router_2dfd0c78;
|
|
9
|
-
}
|
|
10
|
-
});
|
|
4
|
+
import { resolveLocalisedPath, resolveLocalisedUrlsConfig } from "../shared/localisedUrls.mjs";
|
|
11
5
|
const getPathname = (context)=>{
|
|
12
6
|
if (isBrowser()) return window.location.pathname;
|
|
13
7
|
return context.ssrContext?.request?.pathname || '/';
|
|
@@ -23,11 +17,30 @@ const getLanguageFromPath = (pathname, languages, fallbackLanguage)=>{
|
|
|
23
17
|
if (languages.includes(firstSegment)) return firstSegment;
|
|
24
18
|
return fallbackLanguage;
|
|
25
19
|
};
|
|
26
|
-
const
|
|
20
|
+
const splitUrlTarget = (target)=>{
|
|
21
|
+
const hashIndex = target.indexOf('#');
|
|
22
|
+
const hash = hashIndex >= 0 ? target.slice(hashIndex) : '';
|
|
23
|
+
const beforeHash = hashIndex >= 0 ? target.slice(0, hashIndex) : target;
|
|
24
|
+
const searchIndex = beforeHash.indexOf('?');
|
|
25
|
+
const search = searchIndex >= 0 ? beforeHash.slice(searchIndex) : '';
|
|
26
|
+
const pathname = searchIndex >= 0 ? beforeHash.slice(0, searchIndex) : beforeHash;
|
|
27
|
+
return {
|
|
28
|
+
pathname,
|
|
29
|
+
search,
|
|
30
|
+
hash
|
|
31
|
+
};
|
|
32
|
+
};
|
|
33
|
+
const buildLocalizedUrl = (target, language, languages, localisedUrls)=>{
|
|
34
|
+
const { pathname, search, hash } = splitUrlTarget(target);
|
|
27
35
|
const segments = pathname.split('/').filter(Boolean);
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
36
|
+
const localisedUrlsConfig = resolveLocalisedUrlsConfig(localisedUrls);
|
|
37
|
+
const pathWithoutLanguage = segments.length > 0 && languages.includes(segments[0]) ? `/${segments.slice(1).join('/')}` : pathname || '/';
|
|
38
|
+
const resolvedPath = localisedUrlsConfig.enabled ? resolveLocalisedPath(pathWithoutLanguage, language, languages, localisedUrlsConfig.map) : pathWithoutLanguage;
|
|
39
|
+
const resolvedSegments = resolvedPath.split('/').filter(Boolean);
|
|
40
|
+
return `/${[
|
|
41
|
+
language,
|
|
42
|
+
...resolvedSegments
|
|
43
|
+
].join('/')}${search}${hash}`;
|
|
31
44
|
};
|
|
32
45
|
const detectLanguageFromPath = (pathname, languages, localePathRedirect)=>{
|
|
33
46
|
if (!localePathRedirect) return {
|
|
@@ -55,22 +68,4 @@ const shouldIgnoreRedirect = (pathname, languages, ignoreRedirectRoutes)=>{
|
|
|
55
68
|
if ('function' == typeof ignoreRedirectRoutes) return ignoreRedirectRoutes(normalizedPath);
|
|
56
69
|
return ignoreRedirectRoutes.some((pattern)=>normalizedPath === pattern || normalizedPath.startsWith(`${pattern}/`));
|
|
57
70
|
};
|
|
58
|
-
|
|
59
|
-
try {
|
|
60
|
-
const { useLocation, useNavigate, useParams } = __webpack_require__("@modern-js/runtime/router?f1fa");
|
|
61
|
-
return {
|
|
62
|
-
navigate: useNavigate(),
|
|
63
|
-
location: useLocation(),
|
|
64
|
-
params: useParams(),
|
|
65
|
-
hasRouter: true
|
|
66
|
-
};
|
|
67
|
-
} catch (error) {
|
|
68
|
-
return {
|
|
69
|
-
navigate: null,
|
|
70
|
-
location: null,
|
|
71
|
-
params: {},
|
|
72
|
-
hasRouter: false
|
|
73
|
-
};
|
|
74
|
-
}
|
|
75
|
-
};
|
|
76
|
-
export { buildLocalizedUrl, detectLanguageFromPath, getEntryPath, getLanguageFromPath, getPathname, shouldIgnoreRedirect, useRouterHooks };
|
|
71
|
+
export { buildLocalizedUrl, detectLanguageFromPath, getEntryPath, getLanguageFromPath, getPathname, shouldIgnoreRedirect, splitUrlTarget };
|