@bleedingdev/modern-js-plugin-i18n 3.5.0-ultramodern.9 → 3.5.0-ultramodern.91

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.
Files changed (221) hide show
  1. package/dist/cjs/cli/index.js +2 -1
  2. package/dist/cjs/cli/locales.js +15 -15
  3. package/dist/cjs/runtime/Link.js +8 -89
  4. package/dist/cjs/runtime/context.js +78 -91
  5. package/dist/cjs/runtime/contextHelpers.js +143 -0
  6. package/dist/cjs/runtime/core.js +32 -132
  7. package/dist/cjs/runtime/hooks.js +54 -21
  8. package/dist/cjs/runtime/i18n/backend/defaults.node.js +7 -7
  9. package/dist/cjs/runtime/i18n/detection/cache.js +150 -0
  10. package/dist/cjs/runtime/i18n/detection/detector.js +100 -0
  11. package/dist/cjs/runtime/i18n/detection/index.js +8 -263
  12. package/dist/cjs/runtime/i18n/detection/initOptions.js +69 -0
  13. package/dist/cjs/runtime/i18n/detection/language.js +62 -0
  14. package/dist/cjs/runtime/i18n/detection/path.js +49 -0
  15. package/dist/cjs/runtime/i18n/detection/priority.js +66 -0
  16. package/dist/cjs/runtime/i18n/detection/ssr.js +70 -0
  17. package/dist/cjs/runtime/i18n/detection/types.js +18 -0
  18. package/dist/cjs/runtime/i18n/instance.js +34 -10
  19. package/dist/cjs/runtime/linkHelpers.js +148 -0
  20. package/dist/cjs/runtime/pluginSetup.js +102 -0
  21. package/dist/cjs/runtime/providerComposition.js +115 -0
  22. package/dist/cjs/runtime/reactI18next.js +43 -0
  23. package/dist/cjs/runtime/routerAdapter.js +16 -8
  24. package/dist/cjs/runtime/utils.js +1 -9
  25. package/dist/cjs/server/apiPrefix.js +72 -0
  26. package/dist/cjs/server/detectorOptions.js +97 -0
  27. package/dist/cjs/server/index.js +17 -144
  28. package/dist/cjs/server/redirectPolicy.js +96 -0
  29. package/dist/cjs/shared/detection.js +2 -104
  30. package/dist/cjs/shared/localisedUrls/config.js +49 -0
  31. package/dist/cjs/shared/localisedUrls/index.js +91 -0
  32. package/dist/cjs/shared/localisedUrls/normalise.js +87 -0
  33. package/dist/cjs/shared/localisedUrls/pathname.js +68 -0
  34. package/dist/cjs/shared/localisedUrls/patterns.js +130 -0
  35. package/dist/cjs/shared/localisedUrls/redirect.js +103 -0
  36. package/dist/cjs/shared/localisedUrls/resolve.js +88 -0
  37. package/dist/cjs/shared/localisedUrls/routes.js +130 -0
  38. package/dist/cjs/shared/localisedUrls/types.js +18 -0
  39. package/dist/cjs/shared/localisedUrls.js +28 -294
  40. package/dist/cjs/shared/utils.js +2 -8
  41. package/dist/esm/cli/index.mjs +2 -1
  42. package/dist/esm/cli/locales.mjs +13 -13
  43. package/dist/esm/runtime/Link.mjs +1 -82
  44. package/dist/esm/runtime/context.mjs +76 -92
  45. package/dist/esm/runtime/contextHelpers.mjs +87 -0
  46. package/dist/esm/runtime/core.mjs +30 -133
  47. package/dist/esm/runtime/hooks.mjs +56 -23
  48. package/dist/esm/runtime/i18n/backend/defaults.node.mjs +5 -5
  49. package/dist/esm/runtime/i18n/detection/cache.mjs +103 -0
  50. package/dist/esm/runtime/i18n/detection/detector.mjs +62 -0
  51. package/dist/esm/runtime/i18n/detection/index.mjs +4 -260
  52. package/dist/esm/runtime/i18n/detection/initOptions.mjs +28 -0
  53. package/dist/esm/runtime/i18n/detection/language.mjs +21 -0
  54. package/dist/esm/runtime/i18n/detection/path.mjs +11 -0
  55. package/dist/esm/runtime/i18n/detection/priority.mjs +28 -0
  56. package/dist/esm/runtime/i18n/detection/ssr.mjs +26 -0
  57. package/dist/esm/runtime/i18n/detection/types.mjs +0 -0
  58. package/dist/esm/runtime/i18n/instance.mjs +35 -8
  59. package/dist/esm/runtime/linkHelpers.mjs +98 -0
  60. package/dist/esm/runtime/pluginSetup.mjs +64 -0
  61. package/dist/esm/runtime/providerComposition.mjs +77 -0
  62. package/dist/esm/runtime/reactI18next.mjs +5 -0
  63. package/dist/esm/runtime/routerAdapter.mjs +16 -8
  64. package/dist/esm/runtime/utils.mjs +2 -10
  65. package/dist/esm/server/apiPrefix.mjs +31 -0
  66. package/dist/esm/server/detectorOptions.mjs +59 -0
  67. package/dist/esm/server/index.mjs +8 -135
  68. package/dist/esm/server/redirectPolicy.mjs +46 -0
  69. package/dist/esm/shared/detection.mjs +1 -71
  70. package/dist/esm/shared/localisedUrls/config.mjs +11 -0
  71. package/dist/esm/shared/localisedUrls/index.mjs +7 -0
  72. package/dist/esm/shared/localisedUrls/normalise.mjs +37 -0
  73. package/dist/esm/shared/localisedUrls/pathname.mjs +24 -0
  74. package/dist/esm/shared/localisedUrls/patterns.mjs +86 -0
  75. package/dist/esm/shared/localisedUrls/redirect.mjs +56 -0
  76. package/dist/esm/shared/localisedUrls/resolve.mjs +47 -0
  77. package/dist/esm/shared/localisedUrls/routes.mjs +89 -0
  78. package/dist/esm/shared/localisedUrls/types.mjs +0 -0
  79. package/dist/esm/shared/localisedUrls.mjs +1 -283
  80. package/dist/esm/shared/utils.mjs +1 -1
  81. package/dist/esm-node/cli/index.mjs +2 -1
  82. package/dist/esm-node/cli/locales.mjs +13 -13
  83. package/dist/esm-node/runtime/Link.mjs +1 -82
  84. package/dist/esm-node/runtime/context.mjs +76 -92
  85. package/dist/esm-node/runtime/contextHelpers.mjs +88 -0
  86. package/dist/esm-node/runtime/core.mjs +30 -133
  87. package/dist/esm-node/runtime/hooks.mjs +56 -23
  88. package/dist/esm-node/runtime/i18n/backend/defaults.node.mjs +5 -5
  89. package/dist/esm-node/runtime/i18n/detection/cache.mjs +104 -0
  90. package/dist/esm-node/runtime/i18n/detection/detector.mjs +63 -0
  91. package/dist/esm-node/runtime/i18n/detection/index.mjs +4 -260
  92. package/dist/esm-node/runtime/i18n/detection/initOptions.mjs +29 -0
  93. package/dist/esm-node/runtime/i18n/detection/language.mjs +22 -0
  94. package/dist/esm-node/runtime/i18n/detection/path.mjs +12 -0
  95. package/dist/esm-node/runtime/i18n/detection/priority.mjs +29 -0
  96. package/dist/esm-node/runtime/i18n/detection/ssr.mjs +27 -0
  97. package/dist/esm-node/runtime/i18n/detection/types.mjs +1 -0
  98. package/dist/esm-node/runtime/i18n/instance.mjs +35 -8
  99. package/dist/esm-node/runtime/linkHelpers.mjs +99 -0
  100. package/dist/esm-node/runtime/pluginSetup.mjs +65 -0
  101. package/dist/esm-node/runtime/providerComposition.mjs +78 -0
  102. package/dist/esm-node/runtime/reactI18next.mjs +6 -0
  103. package/dist/esm-node/runtime/routerAdapter.mjs +16 -8
  104. package/dist/esm-node/runtime/utils.mjs +2 -10
  105. package/dist/esm-node/server/apiPrefix.mjs +32 -0
  106. package/dist/esm-node/server/detectorOptions.mjs +60 -0
  107. package/dist/esm-node/server/index.mjs +8 -135
  108. package/dist/esm-node/server/redirectPolicy.mjs +47 -0
  109. package/dist/esm-node/shared/detection.mjs +1 -71
  110. package/dist/esm-node/shared/localisedUrls/config.mjs +12 -0
  111. package/dist/esm-node/shared/localisedUrls/index.mjs +8 -0
  112. package/dist/esm-node/shared/localisedUrls/normalise.mjs +38 -0
  113. package/dist/esm-node/shared/localisedUrls/pathname.mjs +25 -0
  114. package/dist/esm-node/shared/localisedUrls/patterns.mjs +87 -0
  115. package/dist/esm-node/shared/localisedUrls/redirect.mjs +57 -0
  116. package/dist/esm-node/shared/localisedUrls/resolve.mjs +48 -0
  117. package/dist/esm-node/shared/localisedUrls/routes.mjs +90 -0
  118. package/dist/esm-node/shared/localisedUrls/types.mjs +1 -0
  119. package/dist/esm-node/shared/localisedUrls.mjs +1 -283
  120. package/dist/esm-node/shared/utils.mjs +1 -1
  121. package/dist/types/cli/locales.d.ts +1 -1
  122. package/dist/types/runtime/Link.d.ts +3 -7
  123. package/dist/types/runtime/context.d.ts +21 -5
  124. package/dist/types/runtime/contextHelpers.d.ts +29 -0
  125. package/dist/types/runtime/core.d.ts +4 -8
  126. package/dist/types/runtime/hooks.d.ts +3 -7
  127. package/dist/types/runtime/i18n/backend/middleware.common.d.ts +2 -1
  128. package/dist/types/runtime/i18n/detection/cache.d.ts +14 -0
  129. package/dist/types/runtime/i18n/detection/detector.d.ts +8 -0
  130. package/dist/types/runtime/i18n/detection/index.d.ts +5 -50
  131. package/dist/types/runtime/i18n/detection/initOptions.d.ts +10 -0
  132. package/dist/types/runtime/i18n/detection/language.d.ts +11 -0
  133. package/dist/types/runtime/i18n/detection/middleware.d.ts +4 -4
  134. package/dist/types/runtime/i18n/detection/middleware.node.d.ts +4 -4
  135. package/dist/types/runtime/i18n/detection/path.d.ts +5 -0
  136. package/dist/types/runtime/i18n/detection/priority.d.ts +10 -0
  137. package/dist/types/runtime/i18n/detection/ssr.d.ts +9 -0
  138. package/dist/types/runtime/i18n/detection/types.d.ts +32 -0
  139. package/dist/types/runtime/i18n/instance.d.ts +31 -27
  140. package/dist/types/runtime/i18n/react-i18next.d.ts +1 -6
  141. package/dist/types/runtime/i18n/utils.d.ts +14 -5
  142. package/dist/types/runtime/linkHelpers.d.ts +17 -0
  143. package/dist/types/runtime/pluginSetup.d.ts +32 -0
  144. package/dist/types/runtime/providerComposition.d.ts +16 -0
  145. package/dist/types/runtime/reactI18next.d.ts +7 -0
  146. package/dist/types/runtime/routerAdapter.d.ts +7 -6
  147. package/dist/types/runtime/utils.d.ts +7 -2
  148. package/dist/types/server/apiPrefix.d.ts +7 -0
  149. package/dist/types/server/detectorOptions.d.ts +21 -0
  150. package/dist/types/server/index.d.ts +1 -6
  151. package/dist/types/server/redirectPolicy.d.ts +22 -0
  152. package/dist/types/shared/detection.d.ts +1 -11
  153. package/dist/types/shared/localisedUrls/config.d.ts +9 -0
  154. package/dist/types/shared/localisedUrls/index.d.ts +9 -0
  155. package/dist/types/shared/localisedUrls/normalise.d.ts +10 -0
  156. package/dist/types/shared/localisedUrls/pathname.d.ts +4 -0
  157. package/dist/types/shared/localisedUrls/patterns.d.ts +5 -0
  158. package/dist/types/shared/localisedUrls/redirect.d.ts +11 -0
  159. package/dist/types/shared/localisedUrls/resolve.d.ts +7 -0
  160. package/dist/types/shared/localisedUrls/routes.d.ts +3 -0
  161. package/dist/types/shared/localisedUrls/types.d.ts +14 -0
  162. package/dist/types/shared/localisedUrls.d.ts +2 -36
  163. package/dist/types/shared/utils.d.ts +0 -2
  164. package/package.json +17 -20
  165. package/rstest.config.mts +8 -1
  166. package/src/cli/index.ts +5 -4
  167. package/src/cli/locales.ts +3 -3
  168. package/src/runtime/Link.tsx +11 -138
  169. package/src/runtime/context.tsx +170 -207
  170. package/src/runtime/contextHelpers.ts +242 -0
  171. package/src/runtime/core.tsx +48 -275
  172. package/src/runtime/hooks.ts +86 -24
  173. package/src/runtime/i18n/backend/defaults.node.ts +2 -2
  174. package/src/runtime/i18n/backend/middleware.common.ts +5 -4
  175. package/src/runtime/i18n/detection/cache.ts +189 -0
  176. package/src/runtime/i18n/detection/detector.ts +166 -0
  177. package/src/runtime/i18n/detection/index.ts +10 -641
  178. package/src/runtime/i18n/detection/initOptions.ts +74 -0
  179. package/src/runtime/i18n/detection/language.ts +64 -0
  180. package/src/runtime/i18n/detection/middleware.node.ts +26 -7
  181. package/src/runtime/i18n/detection/middleware.ts +15 -7
  182. package/src/runtime/i18n/detection/path.ts +41 -0
  183. package/src/runtime/i18n/detection/priority.ts +82 -0
  184. package/src/runtime/i18n/detection/ssr.ts +47 -0
  185. package/src/runtime/i18n/detection/types.ts +41 -0
  186. package/src/runtime/i18n/instance.ts +98 -34
  187. package/src/runtime/i18n/react-i18next.ts +1 -6
  188. package/src/runtime/i18n/utils.ts +18 -9
  189. package/src/runtime/linkHelpers.ts +174 -0
  190. package/src/runtime/pluginSetup.ts +189 -0
  191. package/src/runtime/providerComposition.tsx +148 -0
  192. package/src/runtime/reactI18next.ts +20 -0
  193. package/src/runtime/routerAdapter.tsx +36 -15
  194. package/src/runtime/utils.ts +13 -35
  195. package/src/server/apiPrefix.ts +67 -0
  196. package/src/server/detectorOptions.ts +105 -0
  197. package/src/server/index.ts +14 -319
  198. package/src/server/redirectPolicy.ts +127 -0
  199. package/src/shared/detection.ts +1 -1
  200. package/src/shared/localisedUrls/config.ts +18 -0
  201. package/src/shared/localisedUrls/index.ts +24 -0
  202. package/src/shared/localisedUrls/normalise.ts +67 -0
  203. package/src/shared/localisedUrls/pathname.ts +60 -0
  204. package/src/shared/localisedUrls/patterns.ts +160 -0
  205. package/src/shared/localisedUrls/redirect.ts +93 -0
  206. package/src/shared/localisedUrls/resolve.ts +135 -0
  207. package/src/shared/localisedUrls/routes.ts +234 -0
  208. package/src/shared/localisedUrls/types.ts +18 -0
  209. package/src/shared/localisedUrls.ts +26 -623
  210. package/src/shared/utils.ts +2 -2
  211. package/tests/federatedI18nBoundary.client.test.tsx +112 -0
  212. package/tests/federatedI18nBoundary.test.tsx +120 -0
  213. package/tests/fixtures/localised-routes.golden.json +156 -0
  214. package/tests/link.test.tsx +111 -0
  215. package/tests/localisedUrlRewriteMatrix.fork.test.ts +147 -0
  216. package/tests/localisedUrls.test.ts +148 -2
  217. package/tests/reactI18nextRuntimeBoundary.test.ts +6 -3
  218. package/tests/redirectPolicy.test.ts +45 -0
  219. package/tests/routerAdapter.test.tsx +603 -0
  220. package/tests/type-fixture/fixture-globals.d.ts +11 -0
  221. package/tests/type-fixture/tsconfig.json +1 -0
@@ -1,261 +1,5 @@
1
1
  import "node:module";
2
- import { isBrowser } from "@modern-js/runtime";
3
- import { detectLanguageFromPath } from "../../utils.mjs";
4
- import { isI18nWrapperInstance } from "../instance.mjs";
5
- import { mergeDetectionOptions } from "./config.mjs";
6
- import { cacheUserLanguage, detectLanguage, readLanguageFromStorage, useI18nextLanguageDetector } from "./middleware.mjs";
7
- const detectorInstanceCache = new WeakMap();
8
- const DETECTOR_SAFE_OPTION_KEYS = [
9
- 'lowerCaseLng',
10
- 'nonExplicitSupportedLngs',
11
- 'load',
12
- 'partialBundledLanguages',
13
- 'returnNull',
14
- 'returnEmptyString',
15
- 'returnObjects',
16
- 'joinArrays',
17
- 'keySeparator',
18
- 'nsSeparator',
19
- 'pluralSeparator',
20
- 'contextSeparator',
21
- 'fallbackNS',
22
- 'ns',
23
- 'defaultNS',
24
- 'debug'
25
- ];
26
- const stableStringify = (value)=>{
27
- if (null == value) return JSON.stringify(value);
28
- if ('object' != typeof value) return JSON.stringify(value);
29
- if (Array.isArray(value)) return `[${value.map((item)=>stableStringify(item)).join(',')}]`;
30
- const sortedKeys = Object.keys(value).sort();
31
- const sortedEntries = sortedKeys.map((key)=>{
32
- const stringifiedValue = stableStringify(value[key]);
33
- return `${JSON.stringify(key)}:${stringifiedValue}`;
34
- });
35
- return `{${sortedEntries.join(',')}}`;
36
- };
37
- const buildDetectorConfigKey = (languages, fallbackLanguage, mergedDetection)=>stableStringify({
38
- languages,
39
- fallbackLanguage,
40
- detection: mergedDetection
41
- });
42
- const pickSafeDetectionOptions = (userInitOptions)=>{
43
- if (!userInitOptions) return {};
44
- const safeOptions = {};
45
- for (const key of DETECTOR_SAFE_OPTION_KEYS){
46
- const value = userInitOptions[key];
47
- if (void 0 !== value) safeOptions[key] = value;
48
- }
49
- if (userInitOptions.interpolation) safeOptions.interpolation = {
50
- ...userInitOptions.interpolation
51
- };
52
- return safeOptions;
53
- };
54
- const cleanupDetectorCacheEntry = (entry)=>{
55
- if (!entry || !entry.isTemporary) return;
56
- const instance = entry.instance;
57
- try {
58
- instance?.removeAllListeners?.();
59
- } catch (error) {}
60
- try {
61
- instance?.off?.('*');
62
- } catch (error) {}
63
- try {
64
- instance?.services?.backendConnector?.backend?.stop?.();
65
- } catch (error) {}
66
- try {
67
- instance?.services?.backendConnector?.backend?.close?.();
68
- } catch (error) {}
69
- };
70
- function exportServerLngToWindow(context, lng) {
71
- context.__i18nData__ = {
72
- lng
73
- };
74
- }
75
- const getLanguageFromSSRData = (window1)=>{
76
- try {
77
- const ssrData = window1._SSR_DATA;
78
- if (!ssrData || !ssrData.data || !ssrData.data.i18nData) return;
79
- const lng = ssrData.data.i18nData.lng;
80
- return 'string' == typeof lng && '' !== lng.trim() ? lng : void 0;
81
- } catch (error) {
82
- return;
83
- }
84
- };
85
- const normalizeLanguageCode = (language)=>{
86
- if (!language) return language;
87
- const baseLang = language.split('-')[0];
88
- return baseLang;
89
- };
90
- const isLanguageSupported = (language, supportedLanguages)=>{
91
- if (!language) return false;
92
- if (0 === supportedLanguages.length) return true;
93
- if (supportedLanguages.includes(language)) return true;
94
- const baseLang = normalizeLanguageCode(language);
95
- if (baseLang !== language && supportedLanguages.includes(baseLang)) return true;
96
- return false;
97
- };
98
- const getSupportedLanguage = (language, supportedLanguages)=>{
99
- if (!language) return;
100
- if (0 === supportedLanguages.length) return language;
101
- if (supportedLanguages.includes(language)) return language;
102
- const baseLang = normalizeLanguageCode(language);
103
- if (baseLang !== language && supportedLanguages.includes(baseLang)) return baseLang;
104
- };
105
- const detectLanguageFromSSR = (languages)=>{
106
- if (!isBrowser()) return;
107
- try {
108
- const ssrLanguage = getLanguageFromSSRData(window);
109
- if (ssrLanguage && isLanguageSupported(ssrLanguage, languages)) return ssrLanguage;
110
- } catch (error) {}
111
- };
112
- const detectLanguageFromPathPriority = (pathname, languages, localePathRedirect)=>{
113
- if (!localePathRedirect) return;
114
- if (!languages || 0 === languages.length) return;
115
- if (!pathname || '' === pathname.trim()) return;
116
- try {
117
- const pathDetection = detectLanguageFromPath(pathname, languages, localePathRedirect);
118
- if (true === pathDetection.detected && pathDetection.language) return pathDetection.language;
119
- } catch (error) {}
120
- };
121
- const createDetectorInstance = (baseInstance, configKey)=>{
122
- const cached = detectorInstanceCache.get(baseInstance);
123
- if (cached && cached.configKey === configKey) return {
124
- instance: cached.instance,
125
- isTemporary: cached.isTemporary
126
- };
127
- if (cached) {
128
- cleanupDetectorCacheEntry(cached);
129
- detectorInstanceCache.delete(baseInstance);
130
- }
131
- const createNewInstance = ()=>{
132
- if ('function' == typeof baseInstance.createInstance) try {
133
- const created = baseInstance.createInstance();
134
- if (created) return {
135
- instance: created,
136
- isTemporary: true
137
- };
138
- } catch (error) {}
139
- if ('function' == typeof baseInstance.cloneInstance) try {
140
- const cloned = baseInstance.cloneInstance();
141
- if (cloned) return {
142
- instance: cloned,
143
- isTemporary: true
144
- };
145
- } catch (error) {}
146
- return {
147
- instance: baseInstance,
148
- isTemporary: false
149
- };
150
- };
151
- const created = createNewInstance();
152
- if (created.isTemporary) detectorInstanceCache.set(baseInstance, {
153
- instance: created.instance,
154
- isTemporary: true,
155
- configKey
156
- });
157
- return created;
158
- };
159
- const initializeI18nForDetector = async (i18nInstance, options)=>{
160
- const mergedDetection = detection_mergeDetectionOptions(options.i18nextDetector, options.detection, options.localePathRedirect, options.userInitOptions);
161
- const configKey = buildDetectorConfigKey(options.languages, options.fallbackLanguage, mergedDetection);
162
- const { instance, isTemporary } = createDetectorInstance(i18nInstance, configKey);
163
- const safeUserOptions = pickSafeDetectionOptions(options.userInitOptions);
164
- const initOptions = {
165
- ...safeUserOptions,
166
- fallbackLng: options.fallbackLanguage,
167
- supportedLngs: options.languages,
168
- detection: mergedDetection,
169
- initImmediate: true,
170
- interpolation: {
171
- ...safeUserOptions?.interpolation || {},
172
- escapeValue: safeUserOptions?.interpolation?.escapeValue ?? false
173
- },
174
- react: {
175
- useSuspense: false
176
- }
177
- };
178
- useI18nextLanguageDetector(instance);
179
- if (instance.isInitialized) {
180
- if (isTemporary) await instance.init(initOptions);
181
- } else await instance.init(initOptions);
182
- return {
183
- detectorInstance: instance,
184
- isTemporary
185
- };
186
- };
187
- const detectLanguageFromI18nextDetector = async (i18nInstance, options)=>{
188
- if (!options.i18nextDetector) return;
189
- const mergedDetection = detection_mergeDetectionOptions(options.i18nextDetector, options.detection, options.localePathRedirect, options.userInitOptions);
190
- const { detectorInstance, isTemporary } = await initializeI18nForDetector(i18nInstance, options);
191
- try {
192
- const request = options.ssrContext?.request;
193
- if (!isBrowser() && !request) return;
194
- const detectorLang = detectLanguage(detectorInstance, request, mergedDetection);
195
- if (detectorLang) {
196
- const supportedLang = getSupportedLanguage(detectorLang, options.languages);
197
- if (supportedLang) return supportedLang;
198
- }
199
- if (detectorInstance.isInitialized && detectorInstance.language) {
200
- const currentLang = detectorInstance.language;
201
- if (isLanguageSupported(currentLang, options.languages)) return currentLang;
202
- }
203
- } catch (error) {} finally{
204
- if (isTemporary && detectorInstance !== i18nInstance) detectorInstanceCache.set(i18nInstance, {
205
- instance: detectorInstance,
206
- isTemporary: true,
207
- configKey: buildDetectorConfigKey(options.languages, options.fallbackLanguage, mergedDetection)
208
- });
209
- else if (detectorInstance === i18nInstance) {
210
- i18nInstance.isInitialized = false;
211
- delete i18nInstance.language;
212
- }
213
- }
214
- };
215
- const detectLanguageWithPriority = async (i18nInstance, options)=>{
216
- const { languages, fallbackLanguage, localePathRedirect, i18nextDetector, detection, userInitOptions, pathname, ssrContext } = options;
217
- let detectedLanguage;
218
- detectedLanguage = detectLanguageFromSSR(languages);
219
- if (!detectedLanguage) detectedLanguage = detectLanguageFromPathPriority(pathname, languages, localePathRedirect);
220
- if (!detectedLanguage && i18nextDetector) detectedLanguage = isI18nWrapperInstance(i18nInstance) ? readLanguageFromStorage(detection_mergeDetectionOptions(i18nextDetector, detection, localePathRedirect, userInitOptions)) : await detectLanguageFromI18nextDetector(i18nInstance, {
221
- languages,
222
- fallbackLanguage,
223
- localePathRedirect,
224
- i18nextDetector,
225
- detection,
226
- userInitOptions,
227
- mergedBackend: options.mergedBackend,
228
- ssrContext
229
- });
230
- const finalLanguage = detectedLanguage || userInitOptions?.lng || fallbackLanguage;
231
- return {
232
- detectedLanguage,
233
- finalLanguage
234
- };
235
- };
236
- const buildInitOptions = (params)=>{
237
- const { finalLanguage, fallbackLanguage, languages, userInitOptions, mergedDetection, mergeBackend } = params;
238
- return {
239
- ...userInitOptions || {},
240
- lng: finalLanguage,
241
- fallbackLng: fallbackLanguage,
242
- supportedLngs: languages,
243
- detection: mergedDetection,
244
- backend: mergeBackend,
245
- interpolation: {
246
- ...userInitOptions?.interpolation || {},
247
- escapeValue: userInitOptions?.interpolation?.escapeValue ?? false
248
- },
249
- react: {
250
- useSuspense: isBrowser()
251
- }
252
- };
253
- };
254
- const detection_mergeDetectionOptions = (i18nextDetector, detection, localePathRedirect, userInitOptions)=>{
255
- let mergedDetection;
256
- mergedDetection = i18nextDetector ? mergeDetectionOptions(detection, userInitOptions?.detection) : userInitOptions?.detection || {};
257
- if (!mergedDetection || 'object' != typeof mergedDetection) mergedDetection = {};
258
- if (localePathRedirect && mergedDetection.order) mergedDetection.order = mergedDetection.order.filter((item)=>'path' !== item);
259
- return mergedDetection;
260
- };
261
- export { buildInitOptions, cacheUserLanguage, detectLanguageWithPriority, detection_mergeDetectionOptions as mergeDetectionOptions, exportServerLngToWindow, getLanguageFromSSRData };
2
+ export { buildInitOptions, mergeDetectionOptions } from "./initOptions.mjs";
3
+ export { cacheUserLanguage } from "./middleware.mjs";
4
+ export { detectLanguageWithPriority } from "./priority.mjs";
5
+ export { exportServerLngToWindow, getLanguageFromSSRData } from "./ssr.mjs";
@@ -0,0 +1,29 @@
1
+ import "node:module";
2
+ import { isBrowser } from "@modern-js/runtime";
3
+ import { mergeDetectionOptions } from "./config.mjs";
4
+ const buildInitOptions = (params)=>{
5
+ const { finalLanguage, fallbackLanguage, languages, userInitOptions, mergedDetection, mergeBackend } = params;
6
+ return {
7
+ ...userInitOptions || {},
8
+ lng: finalLanguage,
9
+ fallbackLng: fallbackLanguage,
10
+ supportedLngs: languages,
11
+ detection: mergedDetection,
12
+ backend: mergeBackend,
13
+ interpolation: {
14
+ ...userInitOptions?.interpolation || {},
15
+ escapeValue: userInitOptions?.interpolation?.escapeValue ?? false
16
+ },
17
+ react: {
18
+ useSuspense: isBrowser()
19
+ }
20
+ };
21
+ };
22
+ const initOptions_mergeDetectionOptions = (i18nextDetector, detection, localePathRedirect, userInitOptions)=>{
23
+ let mergedDetection;
24
+ mergedDetection = i18nextDetector ? mergeDetectionOptions(detection, userInitOptions?.detection) : userInitOptions?.detection || {};
25
+ if (!mergedDetection || 'object' != typeof mergedDetection) mergedDetection = {};
26
+ if (localePathRedirect && mergedDetection.order) mergedDetection.order = mergedDetection.order.filter((item)=>'path' !== item);
27
+ return mergedDetection;
28
+ };
29
+ export { buildInitOptions, initOptions_mergeDetectionOptions as mergeDetectionOptions };
@@ -0,0 +1,22 @@
1
+ import "node:module";
2
+ const normalizeLanguageCode = (language)=>{
3
+ if (!language) return language;
4
+ const baseLang = language.split('-')[0];
5
+ return baseLang;
6
+ };
7
+ const isLanguageSupported = (language, supportedLanguages)=>{
8
+ if (!language) return false;
9
+ if (0 === supportedLanguages.length) return true;
10
+ if (supportedLanguages.includes(language)) return true;
11
+ const baseLang = normalizeLanguageCode(language);
12
+ if (baseLang !== language && supportedLanguages.includes(baseLang)) return true;
13
+ return false;
14
+ };
15
+ const getSupportedLanguage = (language, supportedLanguages)=>{
16
+ if (!language) return;
17
+ if (0 === supportedLanguages.length) return language;
18
+ if (supportedLanguages.includes(language)) return language;
19
+ const baseLang = normalizeLanguageCode(language);
20
+ if (baseLang !== language && supportedLanguages.includes(baseLang)) return baseLang;
21
+ };
22
+ export { getSupportedLanguage, isLanguageSupported };
@@ -0,0 +1,12 @@
1
+ import "node:module";
2
+ import { detectLanguageFromPath } from "../../utils.mjs";
3
+ const detectLanguageFromPathPriority = (pathname, languages, localePathRedirect)=>{
4
+ if (!localePathRedirect) return;
5
+ if (!languages || 0 === languages.length) return;
6
+ if (!pathname || '' === pathname.trim()) return;
7
+ try {
8
+ const pathDetection = detectLanguageFromPath(pathname, languages, localePathRedirect);
9
+ if (true === pathDetection.detected && pathDetection.language) return pathDetection.language;
10
+ } catch (error) {}
11
+ };
12
+ export { detectLanguageFromPathPriority };
@@ -0,0 +1,29 @@
1
+ import "node:module";
2
+ import { isI18nWrapperInstance } from "../instance.mjs";
3
+ import { detectLanguageFromI18nextDetector } from "./detector.mjs";
4
+ import { mergeDetectionOptions } from "./initOptions.mjs";
5
+ import { readLanguageFromStorage } from "./middleware.mjs";
6
+ import { detectLanguageFromPathPriority } from "./path.mjs";
7
+ import { detectLanguageFromSSR } from "./ssr.mjs";
8
+ const detectLanguageWithPriority = async (i18nInstance, options)=>{
9
+ const { languages, fallbackLanguage, localePathRedirect, i18nextDetector, detection, userInitOptions, pathname, ssrContext } = options;
10
+ let detectedLanguage;
11
+ detectedLanguage = detectLanguageFromPathPriority(pathname, languages, localePathRedirect);
12
+ if (!detectedLanguage) detectedLanguage = detectLanguageFromSSR(languages);
13
+ if (!detectedLanguage && i18nextDetector) detectedLanguage = isI18nWrapperInstance(i18nInstance) ? readLanguageFromStorage(mergeDetectionOptions(i18nextDetector, detection, localePathRedirect, userInitOptions)) : await detectLanguageFromI18nextDetector(i18nInstance, {
14
+ languages,
15
+ fallbackLanguage,
16
+ localePathRedirect,
17
+ i18nextDetector,
18
+ detection,
19
+ userInitOptions,
20
+ mergedBackend: options.mergedBackend,
21
+ ssrContext
22
+ });
23
+ const finalLanguage = detectedLanguage || userInitOptions?.lng || fallbackLanguage;
24
+ return {
25
+ detectedLanguage,
26
+ finalLanguage
27
+ };
28
+ };
29
+ export { detectLanguageWithPriority };
@@ -0,0 +1,27 @@
1
+ import "node:module";
2
+ import { isBrowser } from "@modern-js/runtime";
3
+ import { getSupportedLanguage } from "./language.mjs";
4
+ function exportServerLngToWindow(context, lng) {
5
+ context.__i18nData__ = {
6
+ lng
7
+ };
8
+ }
9
+ const getLanguageFromSSRData = (window1)=>{
10
+ try {
11
+ const ssrData = window1._SSR_DATA;
12
+ if (!ssrData || !ssrData.data || !ssrData.data.i18nData) return;
13
+ const lng = ssrData.data.i18nData.lng;
14
+ return 'string' == typeof lng && '' !== lng.trim() ? lng : void 0;
15
+ } catch (error) {
16
+ return;
17
+ }
18
+ };
19
+ const detectLanguageFromSSR = (languages)=>{
20
+ if (!isBrowser()) return;
21
+ try {
22
+ const ssrLanguage = getLanguageFromSSRData(window);
23
+ const supportedLanguage = getSupportedLanguage(ssrLanguage, languages);
24
+ if (supportedLanguage) return supportedLanguage;
25
+ } catch (error) {}
26
+ };
27
+ export { detectLanguageFromSSR, exportServerLngToWindow, getLanguageFromSSRData };
@@ -0,0 +1 @@
1
+ import "node:module";
@@ -1,9 +1,11 @@
1
1
  import "node:module";
2
2
  function isI18nWrapperInstance(obj) {
3
3
  if (!obj || 'object' != typeof obj) return false;
4
- if (!obj.i18nInstance || 'object' != typeof obj.i18nInstance) return false;
5
- if (!obj.i18nInstance.instance) return false;
6
- if ('function' != typeof obj.init || 'function' != typeof obj.use) return false;
4
+ const candidate = obj;
5
+ if (!candidate.i18nInstance || 'object' != typeof candidate.i18nInstance) return false;
6
+ const wrapper = candidate.i18nInstance;
7
+ if (!wrapper.instance) return false;
8
+ if ('function' != typeof candidate.init || 'function' != typeof candidate.use) return false;
7
9
  return true;
8
10
  }
9
11
  function getI18nWrapperI18nextInstance(wrapperInstance) {
@@ -20,7 +22,8 @@ function getActualI18nextInstance(instance) {
20
22
  function isI18nInstance(obj) {
21
23
  if (!obj || 'object' != typeof obj) return false;
22
24
  if (isI18nWrapperInstance(obj)) return true;
23
- return 'function' == typeof obj.init && 'function' == typeof obj.use;
25
+ const candidate = obj;
26
+ return 'function' == typeof candidate.init && 'function' == typeof candidate.use;
24
27
  }
25
28
  async function tryImportI18next() {
26
29
  try {
@@ -41,12 +44,36 @@ async function createI18nextInstance() {
41
44
  return null;
42
45
  }
43
46
  }
44
- function getI18nextInstanceForProvider(instance) {
47
+ function getI18nextInstanceForProvider(instance, language) {
48
+ let providerInstance = instance;
45
49
  if (isI18nWrapperInstance(instance)) {
46
50
  const i18nextInstance = getI18nWrapperI18nextInstance(instance);
47
- if (i18nextInstance) return i18nextInstance;
51
+ if (i18nextInstance) providerInstance = i18nextInstance;
48
52
  }
49
- return instance;
53
+ if (!language || "u" < typeof Proxy) return providerInstance;
54
+ return new Proxy(providerInstance, {
55
+ get (target, property, receiver) {
56
+ if ('language' === property || 'resolvedLanguage' === property) return language;
57
+ if ('languages' === property) {
58
+ const languages = Reflect.get(target, property, receiver);
59
+ return Array.isArray(languages) ? [
60
+ language,
61
+ ...languages.filter((item)=>item !== language)
62
+ ] : [
63
+ language
64
+ ];
65
+ }
66
+ if ('t' === property && 'function' == typeof target.getFixedT) return target.getFixedT(language);
67
+ if ('hasLoadedNamespace' === property && 'function' == typeof target.hasLoadedNamespace) {
68
+ const hasLoadedNamespace = target.hasLoadedNamespace;
69
+ return (namespace, options)=>hasLoadedNamespace.call(target, namespace, {
70
+ ...options,
71
+ lng: options?.lng || language
72
+ });
73
+ }
74
+ return Reflect.get(target, property, receiver);
75
+ }
76
+ });
50
77
  }
51
78
  async function getI18nInstance(userInstance) {
52
79
  if (userInstance) {
@@ -57,4 +84,4 @@ async function getI18nInstance(userInstance) {
57
84
  if (i18nextInstance) return i18nextInstance;
58
85
  throw new Error('No i18n instance found');
59
86
  }
60
- export { getActualI18nextInstance, getI18nInstance, getI18nWrapperI18nextInstance, getI18nextInstanceForProvider, isI18nInstance, isI18nWrapperInstance };
87
+ export { getActualI18nextInstance, getI18nInstance, getI18nextInstanceForProvider, isI18nInstance, isI18nWrapperInstance };
@@ -0,0 +1,99 @@
1
+ import "node:module";
2
+ const warnedTargets = new Set();
3
+ const warnOnce = (key, message)=>{
4
+ if ('development' !== process.env.NODE_ENV || warnedTargets.has(key)) return;
5
+ warnedTargets.add(key);
6
+ console.warn(message);
7
+ };
8
+ const interpolateRouteParams = (pathname, params)=>{
9
+ if (!/[$:*{]/.test(pathname)) return pathname;
10
+ const resolveParam = (name)=>{
11
+ const value = params?.[name];
12
+ return void 0 === value ? void 0 : String(value);
13
+ };
14
+ const segments = pathname.split('/').map((segment)=>{
15
+ if (!segment) return segment;
16
+ if (segment.startsWith('{-$') && segment.endsWith('}')) {
17
+ const value = resolveParam(segment.slice(3, -1));
18
+ return void 0 === value ? null : encodeURIComponent(value);
19
+ }
20
+ if ('$' === segment || '*' === segment) {
21
+ const value = resolveParam('_splat') ?? resolveParam('*');
22
+ return void 0 === value ? null : value.split('/').map(encodeURIComponent).join('/');
23
+ }
24
+ if (segment.startsWith('$')) {
25
+ const value = resolveParam(segment.slice(1));
26
+ if (void 0 === value) {
27
+ warnOnce(`missing-param:${pathname}:${segment}`, `[plugin-i18n] <Link to="${pathname}"> is missing required param "${segment.slice(1)}".`);
28
+ return segment;
29
+ }
30
+ return encodeURIComponent(value);
31
+ }
32
+ if (segment.startsWith(':')) {
33
+ const optional = segment.endsWith('?');
34
+ const name = segment.slice(1, optional ? -1 : void 0);
35
+ const value = resolveParam(name);
36
+ if (void 0 === value) {
37
+ if (optional) return null;
38
+ warnOnce(`missing-param:${pathname}:${segment}`, `[plugin-i18n] <Link to="${pathname}"> is missing required param "${name}".`);
39
+ return segment;
40
+ }
41
+ return encodeURIComponent(value);
42
+ }
43
+ return segment;
44
+ }).filter((segment)=>null !== segment);
45
+ return segments.join('/') || '/';
46
+ };
47
+ const normalizeSearch = (search, searchFromTo)=>{
48
+ if (search && 'object' == typeof search) {
49
+ const searchObject = {};
50
+ const params = new URLSearchParams();
51
+ for (const [key, value] of Object.entries(search)){
52
+ if (null == value) continue;
53
+ if (Array.isArray(value)) {
54
+ const values = value.filter((item)=>null != item).map(String);
55
+ if (0 === values.length) continue;
56
+ searchObject[key] = values;
57
+ for (const item of values)params.append(key, item);
58
+ continue;
59
+ }
60
+ const stringValue = String(value);
61
+ searchObject[key] = stringValue;
62
+ params.append(key, stringValue);
63
+ }
64
+ const serialized = params.toString();
65
+ return {
66
+ searchString: serialized ? `?${serialized}` : '',
67
+ searchObject: Object.keys(searchObject).length > 0 ? searchObject : void 0
68
+ };
69
+ }
70
+ const raw = 'string' == typeof search ? search : searchFromTo;
71
+ if (!raw) return {
72
+ searchString: '',
73
+ searchObject: void 0
74
+ };
75
+ const searchString = raw.startsWith('?') ? raw : `?${raw}`;
76
+ const searchObject = {};
77
+ new URLSearchParams(searchString).forEach((value, key)=>{
78
+ const existing = searchObject[key];
79
+ if (void 0 === existing) searchObject[key] = value;
80
+ else if (Array.isArray(existing)) existing.push(value);
81
+ else searchObject[key] = [
82
+ existing,
83
+ value
84
+ ];
85
+ });
86
+ return {
87
+ searchString,
88
+ searchObject
89
+ };
90
+ };
91
+ const splitActiveProps = (active, activeProps)=>{
92
+ if (!active || !activeProps) return {};
93
+ return activeProps;
94
+ };
95
+ const mergeClassNames = (...values)=>{
96
+ const classNames = values.filter((value)=>'string' == typeof value && value.length > 0);
97
+ return classNames.length > 0 ? classNames.join(' ') : void 0;
98
+ };
99
+ export { interpolateRouteParams, mergeClassNames, normalizeSearch, splitActiveProps, warnOnce };
@@ -0,0 +1,65 @@
1
+ import "node:module";
2
+ import { isBrowser } from "@modern-js/runtime";
3
+ import { merge } from "@modern-js/runtime-utils/merge";
4
+ import { getI18nInstance } from "./i18n/index.mjs";
5
+ import { mergeBackendOptions } from "./i18n/backend/index.mjs";
6
+ import { detectLanguageWithPriority, exportServerLngToWindow, mergeDetectionOptions } from "./i18n/detection/index.mjs";
7
+ import { useI18nextLanguageDetector } from "./i18n/detection/middleware.mjs";
8
+ import { getPathname } from "./utils.mjs";
9
+ let i18nLifecycleHelpersPromise;
10
+ function loadI18nLifecycleHelpers() {
11
+ i18nLifecycleHelpersPromise ??= Promise.all([
12
+ import("./i18n/backend/middleware.mjs"),
13
+ import("./i18n/utils.mjs")
14
+ ]).then(([backendMiddleware, utils])=>({
15
+ useI18nextBackend: backendMiddleware.useI18nextBackend,
16
+ changeI18nLanguage: utils.changeI18nLanguage,
17
+ ensureLanguageMatch: utils.ensureLanguageMatch,
18
+ initializeI18nInstance: utils.initializeI18nInstance,
19
+ setupClonedInstance: utils.setupClonedInstance
20
+ }));
21
+ return i18nLifecycleHelpersPromise;
22
+ }
23
+ async function setupI18nBeforeRender(context, options) {
24
+ const { api, userI18nInstance, initOptions, backend, backendEnabled, i18nextDetector, detection, localePathRedirect, languages, fallbackLanguage, resolveReactI18nextIntegration, setI18nextProvider } = options;
25
+ const { useI18nextBackend, changeI18nLanguage, ensureLanguageMatch, initializeI18nInstance, setupClonedInstance } = await loadI18nLifecycleHelpers();
26
+ let i18nInstance = await getI18nInstance(userI18nInstance);
27
+ const { i18n: otherConfig } = api.getRuntimeConfig();
28
+ const { initOptions: otherInitOptions } = otherConfig || {};
29
+ const userInitOptions = merge(otherInitOptions || {}, initOptions || {});
30
+ const reactI18nextIntegration = await resolveReactI18nextIntegration();
31
+ setI18nextProvider(reactI18nextIntegration?.I18nextProvider ?? null);
32
+ if (reactI18nextIntegration?.initReactI18next) i18nInstance.use(reactI18nextIntegration.initReactI18next);
33
+ const pathname = getPathname(context);
34
+ if (i18nextDetector) useI18nextLanguageDetector(i18nInstance);
35
+ const mergedDetection = mergeDetectionOptions(i18nextDetector, detection, localePathRedirect, userInitOptions);
36
+ const mergedBackend = mergeBackendOptions(backend, userInitOptions);
37
+ const hasSdkConfig = 'function' == typeof userInitOptions?.backend?.sdk || mergedBackend?.sdk && 'function' == typeof mergedBackend.sdk;
38
+ if (mergedBackend && (backendEnabled || hasSdkConfig)) useI18nextBackend(i18nInstance, mergedBackend);
39
+ const { finalLanguage } = await detectLanguageWithPriority(i18nInstance, {
40
+ languages,
41
+ fallbackLanguage,
42
+ localePathRedirect,
43
+ i18nextDetector,
44
+ detection,
45
+ userInitOptions,
46
+ mergedBackend,
47
+ pathname,
48
+ ssrContext: context.ssrContext
49
+ });
50
+ await initializeI18nInstance(i18nInstance, finalLanguage, fallbackLanguage, languages, mergedDetection, mergedBackend, userInitOptions);
51
+ if (!isBrowser() && i18nInstance.cloneInstance) {
52
+ i18nInstance = i18nInstance.cloneInstance();
53
+ await setupClonedInstance(i18nInstance, finalLanguage, fallbackLanguage, languages, backendEnabled, backend, i18nextDetector, detection, localePathRedirect, userInitOptions);
54
+ }
55
+ if (localePathRedirect) await ensureLanguageMatch(i18nInstance, finalLanguage);
56
+ if (!isBrowser()) exportServerLngToWindow(context, finalLanguage);
57
+ context.i18nInstance = i18nInstance;
58
+ context.changeLanguage = async (newLang)=>{
59
+ await changeI18nLanguage(i18nInstance, newLang, {
60
+ detectionOptions: mergedDetection
61
+ });
62
+ };
63
+ return i18nInstance;
64
+ }
65
+ export { setupI18nBeforeRender };