@bleedingdev/modern-js-plugin-i18n 3.5.0-ultramodern.30 → 3.5.0-ultramodern.31

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 (161) hide show
  1. package/dist/cjs/cli/index.js +2 -1
  2. package/dist/cjs/runtime/Link.js +8 -89
  3. package/dist/cjs/runtime/context.js +18 -82
  4. package/dist/cjs/runtime/contextHelpers.js +137 -0
  5. package/dist/cjs/runtime/core.js +29 -132
  6. package/dist/cjs/runtime/i18n/detection/cache.js +149 -0
  7. package/dist/cjs/runtime/i18n/detection/detector.js +100 -0
  8. package/dist/cjs/runtime/i18n/detection/index.js +8 -263
  9. package/dist/cjs/runtime/i18n/detection/initOptions.js +69 -0
  10. package/dist/cjs/runtime/i18n/detection/language.js +62 -0
  11. package/dist/cjs/runtime/i18n/detection/path.js +49 -0
  12. package/dist/cjs/runtime/i18n/detection/priority.js +66 -0
  13. package/dist/cjs/runtime/i18n/detection/ssr.js +70 -0
  14. package/dist/cjs/runtime/i18n/detection/types.js +18 -0
  15. package/dist/cjs/runtime/linkHelpers.js +148 -0
  16. package/dist/cjs/runtime/pluginSetup.js +102 -0
  17. package/dist/cjs/runtime/providerComposition.js +113 -0
  18. package/dist/cjs/runtime/reactI18next.js +43 -0
  19. package/dist/cjs/server/apiPrefix.js +72 -0
  20. package/dist/cjs/server/detectorOptions.js +97 -0
  21. package/dist/cjs/server/index.js +17 -152
  22. package/dist/cjs/server/redirectPolicy.js +102 -0
  23. package/dist/cjs/shared/localisedUrls/config.js +49 -0
  24. package/dist/cjs/shared/localisedUrls/index.js +75 -0
  25. package/dist/cjs/shared/localisedUrls/normalise.js +87 -0
  26. package/dist/cjs/shared/localisedUrls/pathname.js +65 -0
  27. package/dist/cjs/shared/localisedUrls/patterns.js +130 -0
  28. package/dist/cjs/shared/localisedUrls/resolve.js +91 -0
  29. package/dist/cjs/shared/localisedUrls/routes.js +129 -0
  30. package/dist/cjs/shared/localisedUrls/types.js +18 -0
  31. package/dist/cjs/shared/localisedUrls.js +13 -294
  32. package/dist/esm/cli/index.mjs +2 -1
  33. package/dist/esm/runtime/Link.mjs +1 -82
  34. package/dist/esm/runtime/context.mjs +18 -82
  35. package/dist/esm/runtime/contextHelpers.mjs +84 -0
  36. package/dist/esm/runtime/core.mjs +30 -133
  37. package/dist/esm/runtime/i18n/detection/cache.mjs +102 -0
  38. package/dist/esm/runtime/i18n/detection/detector.mjs +62 -0
  39. package/dist/esm/runtime/i18n/detection/index.mjs +4 -260
  40. package/dist/esm/runtime/i18n/detection/initOptions.mjs +28 -0
  41. package/dist/esm/runtime/i18n/detection/language.mjs +21 -0
  42. package/dist/esm/runtime/i18n/detection/path.mjs +11 -0
  43. package/dist/esm/runtime/i18n/detection/priority.mjs +28 -0
  44. package/dist/esm/runtime/i18n/detection/ssr.mjs +26 -0
  45. package/dist/esm/runtime/i18n/detection/types.mjs +0 -0
  46. package/dist/esm/runtime/linkHelpers.mjs +98 -0
  47. package/dist/esm/runtime/pluginSetup.mjs +64 -0
  48. package/dist/esm/runtime/providerComposition.mjs +75 -0
  49. package/dist/esm/runtime/reactI18next.mjs +5 -0
  50. package/dist/esm/server/apiPrefix.mjs +31 -0
  51. package/dist/esm/server/detectorOptions.mjs +59 -0
  52. package/dist/esm/server/index.mjs +4 -139
  53. package/dist/esm/server/redirectPolicy.mjs +52 -0
  54. package/dist/esm/shared/localisedUrls/config.mjs +11 -0
  55. package/dist/esm/shared/localisedUrls/index.mjs +6 -0
  56. package/dist/esm/shared/localisedUrls/normalise.mjs +37 -0
  57. package/dist/esm/shared/localisedUrls/pathname.mjs +24 -0
  58. package/dist/esm/shared/localisedUrls/patterns.mjs +86 -0
  59. package/dist/esm/shared/localisedUrls/resolve.mjs +50 -0
  60. package/dist/esm/shared/localisedUrls/routes.mjs +88 -0
  61. package/dist/esm/shared/localisedUrls/types.mjs +0 -0
  62. package/dist/esm/shared/localisedUrls.mjs +1 -283
  63. package/dist/esm-node/cli/index.mjs +2 -1
  64. package/dist/esm-node/runtime/Link.mjs +1 -82
  65. package/dist/esm-node/runtime/context.mjs +18 -82
  66. package/dist/esm-node/runtime/contextHelpers.mjs +85 -0
  67. package/dist/esm-node/runtime/core.mjs +30 -133
  68. package/dist/esm-node/runtime/i18n/detection/cache.mjs +103 -0
  69. package/dist/esm-node/runtime/i18n/detection/detector.mjs +63 -0
  70. package/dist/esm-node/runtime/i18n/detection/index.mjs +4 -260
  71. package/dist/esm-node/runtime/i18n/detection/initOptions.mjs +29 -0
  72. package/dist/esm-node/runtime/i18n/detection/language.mjs +22 -0
  73. package/dist/esm-node/runtime/i18n/detection/path.mjs +12 -0
  74. package/dist/esm-node/runtime/i18n/detection/priority.mjs +29 -0
  75. package/dist/esm-node/runtime/i18n/detection/ssr.mjs +27 -0
  76. package/dist/esm-node/runtime/i18n/detection/types.mjs +1 -0
  77. package/dist/esm-node/runtime/linkHelpers.mjs +99 -0
  78. package/dist/esm-node/runtime/pluginSetup.mjs +65 -0
  79. package/dist/esm-node/runtime/providerComposition.mjs +76 -0
  80. package/dist/esm-node/runtime/reactI18next.mjs +6 -0
  81. package/dist/esm-node/server/apiPrefix.mjs +32 -0
  82. package/dist/esm-node/server/detectorOptions.mjs +60 -0
  83. package/dist/esm-node/server/index.mjs +4 -139
  84. package/dist/esm-node/server/redirectPolicy.mjs +53 -0
  85. package/dist/esm-node/shared/localisedUrls/config.mjs +12 -0
  86. package/dist/esm-node/shared/localisedUrls/index.mjs +7 -0
  87. package/dist/esm-node/shared/localisedUrls/normalise.mjs +38 -0
  88. package/dist/esm-node/shared/localisedUrls/pathname.mjs +25 -0
  89. package/dist/esm-node/shared/localisedUrls/patterns.mjs +87 -0
  90. package/dist/esm-node/shared/localisedUrls/resolve.mjs +51 -0
  91. package/dist/esm-node/shared/localisedUrls/routes.mjs +89 -0
  92. package/dist/esm-node/shared/localisedUrls/types.mjs +1 -0
  93. package/dist/esm-node/shared/localisedUrls.mjs +1 -283
  94. package/dist/types/runtime/Link.d.ts +3 -7
  95. package/dist/types/runtime/context.d.ts +2 -2
  96. package/dist/types/runtime/contextHelpers.d.ts +28 -0
  97. package/dist/types/runtime/core.d.ts +3 -7
  98. package/dist/types/runtime/i18n/detection/cache.d.ts +14 -0
  99. package/dist/types/runtime/i18n/detection/detector.d.ts +8 -0
  100. package/dist/types/runtime/i18n/detection/index.d.ts +5 -50
  101. package/dist/types/runtime/i18n/detection/initOptions.d.ts +10 -0
  102. package/dist/types/runtime/i18n/detection/language.d.ts +11 -0
  103. package/dist/types/runtime/i18n/detection/path.d.ts +5 -0
  104. package/dist/types/runtime/i18n/detection/priority.d.ts +10 -0
  105. package/dist/types/runtime/i18n/detection/ssr.d.ts +9 -0
  106. package/dist/types/runtime/i18n/detection/types.d.ts +29 -0
  107. package/dist/types/runtime/i18n/react-i18next.d.ts +1 -6
  108. package/dist/types/runtime/linkHelpers.d.ts +17 -0
  109. package/dist/types/runtime/pluginSetup.d.ts +32 -0
  110. package/dist/types/runtime/providerComposition.d.ts +15 -0
  111. package/dist/types/runtime/reactI18next.d.ts +7 -0
  112. package/dist/types/server/apiPrefix.d.ts +7 -0
  113. package/dist/types/server/detectorOptions.d.ts +21 -0
  114. package/dist/types/server/index.d.ts +1 -6
  115. package/dist/types/server/redirectPolicy.d.ts +16 -0
  116. package/dist/types/shared/localisedUrls/config.d.ts +9 -0
  117. package/dist/types/shared/localisedUrls/index.d.ts +7 -0
  118. package/dist/types/shared/localisedUrls/normalise.d.ts +10 -0
  119. package/dist/types/shared/localisedUrls/pathname.d.ts +3 -0
  120. package/dist/types/shared/localisedUrls/patterns.d.ts +5 -0
  121. package/dist/types/shared/localisedUrls/resolve.d.ts +8 -0
  122. package/dist/types/shared/localisedUrls/routes.d.ts +3 -0
  123. package/dist/types/shared/localisedUrls/types.d.ts +14 -0
  124. package/dist/types/shared/localisedUrls.d.ts +2 -42
  125. package/package.json +10 -10
  126. package/src/cli/index.ts +3 -2
  127. package/src/runtime/Link.tsx +11 -138
  128. package/src/runtime/context.tsx +42 -196
  129. package/src/runtime/contextHelpers.ts +232 -0
  130. package/src/runtime/core.tsx +42 -273
  131. package/src/runtime/i18n/detection/cache.ts +175 -0
  132. package/src/runtime/i18n/detection/detector.ts +157 -0
  133. package/src/runtime/i18n/detection/index.ts +10 -641
  134. package/src/runtime/i18n/detection/initOptions.ts +74 -0
  135. package/src/runtime/i18n/detection/language.ts +64 -0
  136. package/src/runtime/i18n/detection/path.ts +41 -0
  137. package/src/runtime/i18n/detection/priority.ts +82 -0
  138. package/src/runtime/i18n/detection/ssr.ts +47 -0
  139. package/src/runtime/i18n/detection/types.ts +33 -0
  140. package/src/runtime/i18n/react-i18next.ts +1 -6
  141. package/src/runtime/linkHelpers.ts +174 -0
  142. package/src/runtime/pluginSetup.ts +189 -0
  143. package/src/runtime/providerComposition.tsx +142 -0
  144. package/src/runtime/reactI18next.ts +20 -0
  145. package/src/server/apiPrefix.ts +67 -0
  146. package/src/server/detectorOptions.ts +105 -0
  147. package/src/server/index.ts +12 -327
  148. package/src/server/redirectPolicy.ts +152 -0
  149. package/src/shared/localisedUrls/config.ts +18 -0
  150. package/src/shared/localisedUrls/index.ts +13 -0
  151. package/src/shared/localisedUrls/normalise.ts +67 -0
  152. package/src/shared/localisedUrls/pathname.ts +57 -0
  153. package/src/shared/localisedUrls/patterns.ts +160 -0
  154. package/src/shared/localisedUrls/resolve.ts +118 -0
  155. package/src/shared/localisedUrls/routes.ts +226 -0
  156. package/src/shared/localisedUrls/types.ts +18 -0
  157. package/src/shared/localisedUrls.ts +20 -629
  158. package/tests/link.test.tsx +111 -0
  159. package/tests/localisedUrls.test.ts +50 -0
  160. package/tests/reactI18nextRuntimeBoundary.test.ts +5 -2
  161. package/tests/routerAdapter.test.tsx +56 -0
@@ -0,0 +1,24 @@
1
+ import { resolveLocalisedUrlsConfig } from "./config.mjs";
2
+ import { resolveCanonicalLocalisedPath, resolveLocalisedPath } from "./resolve.mjs";
3
+ const stripLanguagePrefix = (pathname, languages)=>{
4
+ const segments = pathname.split('/').filter(Boolean);
5
+ const firstSegment = segments[0]?.toLowerCase();
6
+ if (firstSegment && languages.some((language)=>language.toLowerCase() === firstSegment)) return `/${segments.slice(1).join('/')}`;
7
+ return pathname || '/';
8
+ };
9
+ const localiseTargetPathname = (pathname, language, languages, localisedUrls)=>{
10
+ const pathWithoutLanguage = stripLanguagePrefix(pathname, languages);
11
+ const localisedUrlsConfig = resolveLocalisedUrlsConfig(localisedUrls);
12
+ const resolvedPath = localisedUrlsConfig.enabled ? resolveLocalisedPath(pathWithoutLanguage, language, languages, localisedUrlsConfig.map) : pathWithoutLanguage;
13
+ const resolvedSegments = resolvedPath.split('/').filter(Boolean);
14
+ return `/${[
15
+ language,
16
+ ...resolvedSegments
17
+ ].join('/')}`;
18
+ };
19
+ const canonicalTargetPathname = (pathname, languages, localisedUrls)=>{
20
+ const pathWithoutLanguage = stripLanguagePrefix(pathname, languages);
21
+ const localisedUrlsConfig = resolveLocalisedUrlsConfig(localisedUrls);
22
+ return localisedUrlsConfig.enabled ? resolveCanonicalLocalisedPath(pathWithoutLanguage, languages, localisedUrlsConfig.map) : pathWithoutLanguage;
23
+ };
24
+ export { canonicalTargetPathname, localiseTargetPathname };
@@ -0,0 +1,86 @@
1
+ import { normalisePathPattern, normalisePathname } from "./normalise.mjs";
2
+ const escapeRegExp = (value)=>value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
3
+ const getParamName = (segment)=>segment.slice(1).replace(/\?$/, '');
4
+ const compiledPathPatternCache = new Map();
5
+ const compilePathPattern = (pattern)=>{
6
+ const normalizedPattern = normalisePathPattern(pattern);
7
+ const cached = compiledPathPatternCache.get(normalizedPattern);
8
+ if (cached) return cached;
9
+ const names = [];
10
+ const segments = normalizedPattern.split('/').filter(Boolean);
11
+ const source = segments.map((segment)=>{
12
+ if (segment.startsWith(':')) {
13
+ names.push(getParamName(segment));
14
+ const paramPattern = '([^/]+)';
15
+ return segment.endsWith('?') ? `(?:/${paramPattern})?` : `/${paramPattern}`;
16
+ }
17
+ if ('*' === segment) {
18
+ names.push('*');
19
+ return '/(.*)';
20
+ }
21
+ return `/${escapeRegExp(segment)}`;
22
+ }).join('');
23
+ const compiled = {
24
+ names,
25
+ regexp: new RegExp(`^${source || '/'}$`)
26
+ };
27
+ compiledPathPatternCache.set(normalizedPattern, compiled);
28
+ return compiled;
29
+ };
30
+ const getPatternSpecificity = (pattern)=>{
31
+ const segments = normalisePathPattern(pattern).split('/').filter(Boolean);
32
+ let staticSegments = 0;
33
+ let dynamicSegments = 0;
34
+ let splatSegments = 0;
35
+ for (const segment of segments)if ('*' === segment) splatSegments++;
36
+ else if (segment.startsWith(':')) dynamicSegments++;
37
+ else staticSegments++;
38
+ return {
39
+ staticSegments,
40
+ dynamicSegments,
41
+ splatSegments,
42
+ totalSegments: segments.length
43
+ };
44
+ };
45
+ const comparePatternSpecificity = (left, right)=>{
46
+ const a = getPatternSpecificity(left);
47
+ const b = getPatternSpecificity(right);
48
+ return b.staticSegments - a.staticSegments || b.totalSegments - a.totalSegments || a.splatSegments - b.splatSegments || a.dynamicSegments - b.dynamicSegments;
49
+ };
50
+ const sortPatternsBySpecificity = (patterns)=>patterns.map((pattern, index)=>({
51
+ pattern,
52
+ index
53
+ })).sort((left, right)=>comparePatternSpecificity(left.pattern.pattern, right.pattern.pattern) || left.index - right.index).map(({ pattern })=>pattern);
54
+ const decodePathParam = (value)=>{
55
+ try {
56
+ return decodeURIComponent(value);
57
+ } catch {
58
+ return null;
59
+ }
60
+ };
61
+ const encodeSplatParam = (value)=>value.split('/').map(encodeURIComponent).join('/');
62
+ const matchPathPattern = (pathname, pattern)=>{
63
+ const { names, regexp } = compilePathPattern(pattern);
64
+ const match = regexp.exec(normalisePathname(pathname));
65
+ if (!match) return null;
66
+ const params = {};
67
+ for(let index = 0; index < names.length; index++){
68
+ const decoded = decodePathParam(match[index + 1] || '');
69
+ if (null === decoded) return null;
70
+ params[names[index]] = decoded;
71
+ }
72
+ return params;
73
+ };
74
+ const buildPathFromPattern = (pattern, params)=>{
75
+ const segments = normalisePathPattern(pattern).split('/').filter(Boolean);
76
+ const path = segments.map((segment)=>{
77
+ if (segment.startsWith(':')) {
78
+ const param = params[getParamName(segment)];
79
+ return param ? encodeURIComponent(param) : '';
80
+ }
81
+ if ('*' === segment) return encodeSplatParam(params['*'] || '');
82
+ return segment;
83
+ }).filter(Boolean).join('/');
84
+ return `/${path}`;
85
+ };
86
+ export { buildPathFromPattern, matchPathPattern, sortPatternsBySpecificity };
@@ -0,0 +1,50 @@
1
+ import { normalisePathname } from "./normalise.mjs";
2
+ import { buildPathFromPattern, matchPathPattern, sortPatternsBySpecificity } from "./patterns.mjs";
3
+ const resolveLocalisedPath = (pathname, targetLanguage, languages, localisedUrls)=>{
4
+ const normalizedPathname = normalisePathname(pathname);
5
+ const canonicalCandidates = sortPatternsBySpecificity(Object.entries(localisedUrls).map(([canonicalPattern, localisedUrlEntry])=>({
6
+ pattern: canonicalPattern,
7
+ canonicalPattern,
8
+ localisedUrlEntry
9
+ })));
10
+ for (const { canonicalPattern, localisedUrlEntry } of canonicalCandidates){
11
+ const targetPattern = localisedUrlEntry[targetLanguage];
12
+ if (!targetPattern) continue;
13
+ const params = matchPathPattern(normalizedPathname, canonicalPattern);
14
+ if (params) return buildPathFromPattern(targetPattern, params);
15
+ }
16
+ const localisedCandidates = sortPatternsBySpecificity(Object.values(localisedUrls).flatMap((localisedUrlEntry)=>{
17
+ const targetPattern = localisedUrlEntry[targetLanguage];
18
+ if (!targetPattern) return [];
19
+ return languages.map((language)=>localisedUrlEntry[language]).filter((sourcePattern)=>Boolean(sourcePattern)).map((sourcePattern)=>({
20
+ pattern: sourcePattern,
21
+ sourcePattern,
22
+ targetPattern
23
+ }));
24
+ }));
25
+ for (const { sourcePattern, targetPattern } of localisedCandidates){
26
+ const params = matchPathPattern(normalizedPathname, sourcePattern);
27
+ if (params) return buildPathFromPattern(targetPattern, params);
28
+ }
29
+ return normalizedPathname;
30
+ };
31
+ const resolveCanonicalLocalisedPath = (pathname, languages, localisedUrls)=>{
32
+ const normalizedPathname = normalisePathname(pathname);
33
+ const canonicalCandidates = sortPatternsBySpecificity(Object.entries(localisedUrls).map(([canonicalPattern, localisedUrlEntry])=>({
34
+ pattern: canonicalPattern,
35
+ canonicalPattern,
36
+ localisedUrlEntry
37
+ })));
38
+ for (const { canonicalPattern, localisedUrlEntry } of canonicalCandidates){
39
+ const canonicalParams = matchPathPattern(normalizedPathname, canonicalPattern);
40
+ if (canonicalParams) return buildPathFromPattern(canonicalPattern, canonicalParams);
41
+ for (const language of languages){
42
+ const sourcePattern = localisedUrlEntry[language];
43
+ if (!sourcePattern) continue;
44
+ const params = matchPathPattern(normalizedPathname, sourcePattern);
45
+ if (params) return buildPathFromPattern(canonicalPattern, params);
46
+ }
47
+ }
48
+ return normalizedPathname;
49
+ };
50
+ export { resolveCanonicalLocalisedPath, resolveLocalisedPath };
@@ -0,0 +1,88 @@
1
+ import { getLeadingLocaleParam, normalisePathPattern, normaliseRoutePath, stripLeadingLocaleParam } from "./normalise.mjs";
2
+ const isLocalisableRoutePath = (path)=>{
3
+ const pathWithoutLocale = stripLeadingLocaleParam(path);
4
+ if (!pathWithoutLocale || '/' === pathWithoutLocale || '*' === pathWithoutLocale) return false;
5
+ return true;
6
+ };
7
+ const joinPath = (parentPath, routePath)=>{
8
+ if (!isLocalisableRoutePath(routePath)) return parentPath;
9
+ const segment = normaliseRoutePath(stripLeadingLocaleParam(routePath) || '');
10
+ return normalisePathPattern(`${parentPath}/${segment}`);
11
+ };
12
+ const ensureLocalisedUrlsForPath = (canonicalPath, languages, localisedUrls)=>{
13
+ const entry = localisedUrls[canonicalPath];
14
+ if (!entry) throw new Error(`localisedUrls is enabled, but route "${canonicalPath}" does not define localised URLs for languages: ${languages.join(', ')}. Add localisedUrls["${canonicalPath}"] or set localeDetection.localisedUrls to false.`);
15
+ const missingLanguages = languages.filter((language)=>!entry[language]);
16
+ if (missingLanguages.length > 0) throw new Error(`localisedUrls["${canonicalPath}"] is missing languages: ${missingLanguages.join(', ')}. Every configured language must have a localised URL.`);
17
+ return entry;
18
+ };
19
+ const validateLocalisedUrls = (routes, languages, localisedUrls)=>{
20
+ const visit = (route, parentPath)=>{
21
+ const canonicalPath = joinPath(parentPath, route.path);
22
+ if (isLocalisableRoutePath(route.path)) ensureLocalisedUrlsForPath(canonicalPath, languages, localisedUrls);
23
+ if ('children' in route && route.children) route.children.forEach((child)=>visit(child, canonicalPath));
24
+ };
25
+ routes.forEach((route)=>visit(route, ''));
26
+ };
27
+ const getLocalisedRoutePaths = (canonicalPath, parentLocalisedPaths, languages, entry)=>{
28
+ const paths = languages.map((language)=>{
29
+ const fullPath = normalisePathPattern(entry[language]);
30
+ const parentPath = normalisePathPattern(parentLocalisedPaths[language] || '/');
31
+ if ('/' === parentPath) return normaliseRoutePath(fullPath) || void 0;
32
+ const parentPrefix = `${parentPath}/`;
33
+ if (!fullPath.startsWith(parentPrefix)) throw new Error(`localisedUrls["${canonicalPath}"].${language} must be nested under "${parentPath}" because its parent route is localised there.`);
34
+ return normaliseRoutePath(fullPath.slice(parentPath.length));
35
+ });
36
+ return Array.from(new Set(paths.filter(Boolean)));
37
+ };
38
+ const transformLocalisedRoute = (route, parentCanonicalPath, parentLocalisedPaths, languages, localisedUrls)=>{
39
+ const canonicalPath = joinPath(parentCanonicalPath, route.path);
40
+ const localisedUrlEntry = isLocalisableRoutePath(route.path) ? ensureLocalisedUrlsForPath(canonicalPath, languages, localisedUrls) : void 0;
41
+ const routeLocalisedPaths = localisedUrlEntry ? languages.reduce((acc, language)=>{
42
+ acc[language] = normalisePathPattern(localisedUrlEntry[language]);
43
+ return acc;
44
+ }, {}) : parentLocalisedPaths;
45
+ const children = 'children' in route && route.children ? route.children.flatMap((child)=>transformLocalisedRoute(child, canonicalPath, routeLocalisedPaths, languages, localisedUrls)) : void 0;
46
+ const baseRoute = {
47
+ ...route,
48
+ ...children ? {
49
+ children
50
+ } : {}
51
+ };
52
+ if (!localisedUrlEntry) return [
53
+ baseRoute
54
+ ];
55
+ return getLocalisedRoutePaths(canonicalPath, parentLocalisedPaths, languages, localisedUrlEntry).map((localisedPath, index)=>cloneRouteWithLocalisedPath(baseRoute, localisedPath, index, canonicalPath));
56
+ };
57
+ const legalRouteIdPart = (value)=>value.replace(/[^a-zA-Z0-9_$-]+/g, '_').replace(/^_+|_+$/g, '') || 'index';
58
+ const suffixRouteIds = (route, suffix)=>{
59
+ const children = 'children' in route && route.children ? route.children.map((child)=>suffixRouteIds(child, suffix)) : void 0;
60
+ return {
61
+ ...route,
62
+ ...route.id ? {
63
+ id: `${route.id}__localised_${suffix}`
64
+ } : {},
65
+ ...children ? {
66
+ children
67
+ } : {}
68
+ };
69
+ };
70
+ const cloneRouteWithLocalisedPath = (route, path, index, canonicalPath)=>{
71
+ const leadingLocaleParam = getLeadingLocaleParam(route.path);
72
+ const localisedPath = leadingLocaleParam ? normaliseRoutePath(`${leadingLocaleParam}/${path}`) : path;
73
+ const routeWithPath = {
74
+ ...route,
75
+ path: localisedPath
76
+ };
77
+ routeWithPath.modernCanonicalPath = canonicalPath;
78
+ return 0 === index ? routeWithPath : suffixRouteIds(routeWithPath, legalRouteIdPart(localisedPath));
79
+ };
80
+ const applyLocalisedUrlsToRoutes = (routes, languages, localisedUrls)=>{
81
+ const rootLocalisedPaths = languages.reduce((acc, language)=>{
82
+ acc[language] = '/';
83
+ return acc;
84
+ }, {});
85
+ validateLocalisedUrls(routes, languages, localisedUrls);
86
+ return routes.flatMap((route)=>transformLocalisedRoute(route, '', rootLocalisedPaths, languages, localisedUrls));
87
+ };
88
+ export { applyLocalisedUrlsToRoutes, validateLocalisedUrls };
File without changes
@@ -1,283 +1 @@
1
- const LOCALE_PARAM_NAMES = new Set([
2
- 'lang',
3
- 'locale',
4
- 'language'
5
- ]);
6
- const normaliseSlashes = (path)=>{
7
- const withoutDuplicateSlashes = path.replace(/\/+/g, '/');
8
- const withLeadingSlash = withoutDuplicateSlashes.startsWith('/') ? withoutDuplicateSlashes : `/${withoutDuplicateSlashes}`;
9
- return withLeadingSlash.length > 1 ? withLeadingSlash.replace(/\/+$/, '') : withLeadingSlash;
10
- };
11
- const normalisePathPattern = (path)=>normaliseSlashes(path).replace(/\[(.+?)\]/g, ':$1');
12
- const normalisePathname = (pathname)=>normaliseSlashes(pathname);
13
- const normaliseRoutePath = (path)=>{
14
- const normalized = normalisePathPattern(path);
15
- return '/' === normalized ? '' : normalized.slice(1);
16
- };
17
- const getLocaleParamSegment = (segment)=>{
18
- if (!segment.startsWith(':')) return null;
19
- const paramName = segment.slice(1).replace(/\?$/, '');
20
- return LOCALE_PARAM_NAMES.has(paramName) ? segment : null;
21
- };
22
- const splitPathSegments = (path)=>{
23
- if (!path) return [];
24
- return normalisePathPattern(path).split('/').filter(Boolean);
25
- };
26
- const stripLeadingLocaleParam = (path)=>{
27
- const segments = splitPathSegments(path);
28
- const leadingLocaleParam = getLocaleParamSegment(segments[0] || '');
29
- if (!leadingLocaleParam) return path;
30
- const remainingPath = segments.slice(1).join('/');
31
- return remainingPath ? `/${remainingPath}` : void 0;
32
- };
33
- const getLeadingLocaleParam = (path)=>{
34
- const segments = splitPathSegments(path);
35
- return getLocaleParamSegment(segments[0] || '');
36
- };
37
- const resolveLocalisedUrlsConfig = (option)=>{
38
- if (option && 'object' == typeof option && Object.keys(option).length > 0) return {
39
- enabled: true,
40
- map: option
41
- };
42
- return {
43
- enabled: false,
44
- map: {}
45
- };
46
- };
47
- const isLocalisableRoutePath = (path)=>{
48
- const pathWithoutLocale = stripLeadingLocaleParam(path);
49
- if (!pathWithoutLocale || '/' === pathWithoutLocale || '*' === pathWithoutLocale) return false;
50
- return true;
51
- };
52
- const joinPath = (parentPath, routePath)=>{
53
- if (!isLocalisableRoutePath(routePath)) return parentPath;
54
- const segment = normaliseRoutePath(stripLeadingLocaleParam(routePath) || '');
55
- return normalisePathPattern(`${parentPath}/${segment}`);
56
- };
57
- const ensureLocalisedUrlsForPath = (canonicalPath, languages, localisedUrls)=>{
58
- const entry = localisedUrls[canonicalPath];
59
- if (!entry) throw new Error(`localisedUrls is enabled, but route "${canonicalPath}" does not define localised URLs for languages: ${languages.join(', ')}. Add localisedUrls["${canonicalPath}"] or set localeDetection.localisedUrls to false.`);
60
- const missingLanguages = languages.filter((language)=>!entry[language]);
61
- if (missingLanguages.length > 0) throw new Error(`localisedUrls["${canonicalPath}"] is missing languages: ${missingLanguages.join(', ')}. Every configured language must have a localised URL.`);
62
- return entry;
63
- };
64
- const validateLocalisedUrls = (routes, languages, localisedUrls)=>{
65
- const visit = (route, parentPath)=>{
66
- const canonicalPath = joinPath(parentPath, route.path);
67
- if (isLocalisableRoutePath(route.path)) ensureLocalisedUrlsForPath(canonicalPath, languages, localisedUrls);
68
- if ('children' in route && route.children) route.children.forEach((child)=>visit(child, canonicalPath));
69
- };
70
- routes.forEach((route)=>visit(route, ''));
71
- };
72
- const getLocalisedRoutePaths = (canonicalPath, parentLocalisedPaths, languages, entry)=>{
73
- const paths = languages.map((language)=>{
74
- const fullPath = normalisePathPattern(entry[language]);
75
- const parentPath = normalisePathPattern(parentLocalisedPaths[language] || '/');
76
- if ('/' === parentPath) return normaliseRoutePath(fullPath) || void 0;
77
- const parentPrefix = `${parentPath}/`;
78
- if (!fullPath.startsWith(parentPrefix)) throw new Error(`localisedUrls["${canonicalPath}"].${language} must be nested under "${parentPath}" because its parent route is localised there.`);
79
- return normaliseRoutePath(fullPath.slice(parentPath.length));
80
- });
81
- return Array.from(new Set(paths.filter(Boolean)));
82
- };
83
- const transformLocalisedRoute = (route, parentCanonicalPath, parentLocalisedPaths, languages, localisedUrls)=>{
84
- const canonicalPath = joinPath(parentCanonicalPath, route.path);
85
- const localisedUrlEntry = isLocalisableRoutePath(route.path) ? ensureLocalisedUrlsForPath(canonicalPath, languages, localisedUrls) : void 0;
86
- const routeLocalisedPaths = localisedUrlEntry ? languages.reduce((acc, language)=>{
87
- acc[language] = normalisePathPattern(localisedUrlEntry[language]);
88
- return acc;
89
- }, {}) : parentLocalisedPaths;
90
- const children = 'children' in route && route.children ? route.children.flatMap((child)=>transformLocalisedRoute(child, canonicalPath, routeLocalisedPaths, languages, localisedUrls)) : void 0;
91
- const baseRoute = {
92
- ...route,
93
- ...children ? {
94
- children
95
- } : {}
96
- };
97
- if (!localisedUrlEntry) return [
98
- baseRoute
99
- ];
100
- return getLocalisedRoutePaths(canonicalPath, parentLocalisedPaths, languages, localisedUrlEntry).map((localisedPath, index)=>cloneRouteWithLocalisedPath(baseRoute, localisedPath, index, canonicalPath));
101
- };
102
- const legalRouteIdPart = (value)=>value.replace(/[^a-zA-Z0-9_$-]+/g, '_').replace(/^_+|_+$/g, '') || 'index';
103
- const suffixRouteIds = (route, suffix)=>{
104
- const children = 'children' in route && route.children ? route.children.map((child)=>suffixRouteIds(child, suffix)) : void 0;
105
- return {
106
- ...route,
107
- ...route.id ? {
108
- id: `${route.id}__localised_${suffix}`
109
- } : {},
110
- ...children ? {
111
- children
112
- } : {}
113
- };
114
- };
115
- const cloneRouteWithLocalisedPath = (route, path, index, canonicalPath)=>{
116
- const leadingLocaleParam = getLeadingLocaleParam(route.path);
117
- const localisedPath = leadingLocaleParam ? normaliseRoutePath(`${leadingLocaleParam}/${path}`) : path;
118
- const routeWithPath = {
119
- ...route,
120
- path: localisedPath
121
- };
122
- routeWithPath.modernCanonicalPath = canonicalPath;
123
- return 0 === index ? routeWithPath : suffixRouteIds(routeWithPath, legalRouteIdPart(localisedPath));
124
- };
125
- const applyLocalisedUrlsToRoutes = (routes, languages, localisedUrls)=>{
126
- const rootLocalisedPaths = languages.reduce((acc, language)=>{
127
- acc[language] = '/';
128
- return acc;
129
- }, {});
130
- validateLocalisedUrls(routes, languages, localisedUrls);
131
- return routes.flatMap((route)=>transformLocalisedRoute(route, '', rootLocalisedPaths, languages, localisedUrls));
132
- };
133
- const escapeRegExp = (value)=>value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
134
- const getParamName = (segment)=>segment.slice(1).replace(/\?$/, '');
135
- const compiledPathPatternCache = new Map();
136
- const compilePathPattern = (pattern)=>{
137
- const normalizedPattern = normalisePathPattern(pattern);
138
- const cached = compiledPathPatternCache.get(normalizedPattern);
139
- if (cached) return cached;
140
- const names = [];
141
- const segments = normalizedPattern.split('/').filter(Boolean);
142
- const source = segments.map((segment)=>{
143
- if (segment.startsWith(':')) {
144
- names.push(getParamName(segment));
145
- const paramPattern = '([^/]+)';
146
- return segment.endsWith('?') ? `(?:/${paramPattern})?` : `/${paramPattern}`;
147
- }
148
- if ('*' === segment) {
149
- names.push('*');
150
- return '/(.*)';
151
- }
152
- return `/${escapeRegExp(segment)}`;
153
- }).join('');
154
- const compiled = {
155
- names,
156
- regexp: new RegExp(`^${source || '/'}$`)
157
- };
158
- compiledPathPatternCache.set(normalizedPattern, compiled);
159
- return compiled;
160
- };
161
- const getPatternSpecificity = (pattern)=>{
162
- const segments = normalisePathPattern(pattern).split('/').filter(Boolean);
163
- let staticSegments = 0;
164
- let dynamicSegments = 0;
165
- let splatSegments = 0;
166
- for (const segment of segments)if ('*' === segment) splatSegments++;
167
- else if (segment.startsWith(':')) dynamicSegments++;
168
- else staticSegments++;
169
- return {
170
- staticSegments,
171
- dynamicSegments,
172
- splatSegments,
173
- totalSegments: segments.length
174
- };
175
- };
176
- const comparePatternSpecificity = (left, right)=>{
177
- const a = getPatternSpecificity(left);
178
- const b = getPatternSpecificity(right);
179
- return b.staticSegments - a.staticSegments || b.totalSegments - a.totalSegments || a.splatSegments - b.splatSegments || a.dynamicSegments - b.dynamicSegments;
180
- };
181
- const sortPatternsBySpecificity = (patterns)=>patterns.map((pattern, index)=>({
182
- pattern,
183
- index
184
- })).sort((left, right)=>comparePatternSpecificity(left.pattern.pattern, right.pattern.pattern) || left.index - right.index).map(({ pattern })=>pattern);
185
- const decodePathParam = (value)=>{
186
- try {
187
- return decodeURIComponent(value);
188
- } catch {
189
- return null;
190
- }
191
- };
192
- const matchPathPattern = (pathname, pattern)=>{
193
- const { names, regexp } = compilePathPattern(pattern);
194
- const match = regexp.exec(normalisePathname(pathname));
195
- if (!match) return null;
196
- const params = {};
197
- for(let index = 0; index < names.length; index++){
198
- const decoded = decodePathParam(match[index + 1] || '');
199
- if (null === decoded) return null;
200
- params[names[index]] = decoded;
201
- }
202
- return params;
203
- };
204
- const buildPathFromPattern = (pattern, params)=>{
205
- const segments = normalisePathPattern(pattern).split('/').filter(Boolean);
206
- const path = segments.map((segment)=>{
207
- if (segment.startsWith(':')) {
208
- const param = params[getParamName(segment)];
209
- return param ? encodeURIComponent(param) : '';
210
- }
211
- if ('*' === segment) return params['*'] || '';
212
- return segment;
213
- }).filter(Boolean).join('/');
214
- return `/${path}`;
215
- };
216
- const resolveLocalisedPath = (pathname, targetLanguage, languages, localisedUrls)=>{
217
- const normalizedPathname = normalisePathname(pathname);
218
- const canonicalCandidates = sortPatternsBySpecificity(Object.entries(localisedUrls).map(([canonicalPattern, localisedUrlEntry])=>({
219
- pattern: canonicalPattern,
220
- canonicalPattern,
221
- localisedUrlEntry
222
- })));
223
- for (const { canonicalPattern, localisedUrlEntry } of canonicalCandidates){
224
- const targetPattern = localisedUrlEntry[targetLanguage];
225
- if (!targetPattern) continue;
226
- const params = matchPathPattern(normalizedPathname, canonicalPattern);
227
- if (params) return buildPathFromPattern(targetPattern, params);
228
- }
229
- const localisedCandidates = sortPatternsBySpecificity(Object.values(localisedUrls).flatMap((localisedUrlEntry)=>{
230
- const targetPattern = localisedUrlEntry[targetLanguage];
231
- if (!targetPattern) return [];
232
- return languages.map((language)=>localisedUrlEntry[language]).filter((sourcePattern)=>Boolean(sourcePattern)).map((sourcePattern)=>({
233
- pattern: sourcePattern,
234
- sourcePattern,
235
- targetPattern
236
- }));
237
- }));
238
- for (const { sourcePattern, targetPattern } of localisedCandidates){
239
- const params = matchPathPattern(normalizedPathname, sourcePattern);
240
- if (params) return buildPathFromPattern(targetPattern, params);
241
- }
242
- return normalizedPathname;
243
- };
244
- const resolveCanonicalLocalisedPath = (pathname, languages, localisedUrls)=>{
245
- const normalizedPathname = normalisePathname(pathname);
246
- const canonicalCandidates = sortPatternsBySpecificity(Object.entries(localisedUrls).map(([canonicalPattern, localisedUrlEntry])=>({
247
- pattern: canonicalPattern,
248
- canonicalPattern,
249
- localisedUrlEntry
250
- })));
251
- for (const { canonicalPattern, localisedUrlEntry } of canonicalCandidates){
252
- const canonicalParams = matchPathPattern(normalizedPathname, canonicalPattern);
253
- if (canonicalParams) return buildPathFromPattern(canonicalPattern, canonicalParams);
254
- for (const language of languages){
255
- const sourcePattern = localisedUrlEntry[language];
256
- if (!sourcePattern) continue;
257
- const params = matchPathPattern(normalizedPathname, sourcePattern);
258
- if (params) return buildPathFromPattern(canonicalPattern, params);
259
- }
260
- }
261
- return normalizedPathname;
262
- };
263
- const stripLanguagePrefix = (pathname, languages)=>{
264
- const segments = pathname.split('/').filter(Boolean);
265
- if (segments.length > 0 && languages.includes(segments[0])) return `/${segments.slice(1).join('/')}`;
266
- return pathname || '/';
267
- };
268
- const localiseTargetPathname = (pathname, language, languages, localisedUrls)=>{
269
- const pathWithoutLanguage = stripLanguagePrefix(pathname, languages);
270
- const localisedUrlsConfig = resolveLocalisedUrlsConfig(localisedUrls);
271
- const resolvedPath = localisedUrlsConfig.enabled ? resolveLocalisedPath(pathWithoutLanguage, language, languages, localisedUrlsConfig.map) : pathWithoutLanguage;
272
- const resolvedSegments = resolvedPath.split('/').filter(Boolean);
273
- return `/${[
274
- language,
275
- ...resolvedSegments
276
- ].join('/')}`;
277
- };
278
- const canonicalTargetPathname = (pathname, languages, localisedUrls)=>{
279
- const pathWithoutLanguage = stripLanguagePrefix(pathname, languages);
280
- const localisedUrlsConfig = resolveLocalisedUrlsConfig(localisedUrls);
281
- return localisedUrlsConfig.enabled ? resolveCanonicalLocalisedPath(pathWithoutLanguage, languages, localisedUrlsConfig.map) : pathWithoutLanguage;
282
- };
283
- export { applyLocalisedUrlsToRoutes, buildPathFromPattern, canonicalTargetPathname, localiseTargetPathname, matchPathPattern, normalisePathPattern, normalisePathname, resolveCanonicalLocalisedPath, resolveLocalisedPath, resolveLocalisedUrlsConfig, validateLocalisedUrls };
1
+ export { applyLocalisedUrlsToRoutes, buildPathFromPattern, canonicalTargetPathname, localiseTargetPathname, matchPathPattern, normalisePathPattern, normalisePathname, resolveCanonicalLocalisedPath, resolveLocalisedPath, resolveLocalisedUrlsConfig, validateLocalisedUrls } from "./localisedUrls/index.mjs";
@@ -32,7 +32,8 @@ const i18nPlugin = (options = {})=>({
32
32
  backend: backendOptions,
33
33
  ...extendedConfig
34
34
  };
35
- const runtimePluginPath = customPlugin?.runtime?.path || (false === config.reactI18next ? `@${metaName}/plugin-i18n/runtime/no-react-i18next` : `@${metaName}/plugin-i18n/runtime`);
35
+ const { reactI18next } = extendedConfig;
36
+ const runtimePluginPath = customPlugin?.runtime?.path || (false === reactI18next ? `@${metaName}/plugin-i18n/runtime/no-react-i18next` : `@${metaName}/plugin-i18n/runtime`);
36
37
  plugins.push({
37
38
  name: customPlugin?.runtime?.name || 'i18n',
38
39
  path: runtimePluginPath,
@@ -2,92 +2,11 @@ import "node:module";
2
2
  import { jsx } from "react/jsx-runtime";
3
3
  import { useMemo } from "react";
4
4
  import { useModernI18n } from "./context.mjs";
5
+ import { interpolateRouteParams, mergeClassNames, normalizeSearch, splitActiveProps, warnOnce } from "./linkHelpers.mjs";
5
6
  import { canonicalPath } from "./localizedPaths.mjs";
6
7
  import { useI18nRouterAdapter } from "./routerAdapter.mjs";
7
8
  import { buildLocalizedUrl, splitUrlTarget } from "./utils.mjs";
8
9
  const EXTERNAL_TARGET_RE = /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i;
9
- const warnedTargets = new Set();
10
- const warnOnce = (key, message)=>{
11
- if ('development' !== process.env.NODE_ENV || warnedTargets.has(key)) return;
12
- warnedTargets.add(key);
13
- console.warn(message);
14
- };
15
- const interpolateRouteParams = (pathname, params)=>{
16
- if (!/[$:*{]/.test(pathname)) return pathname;
17
- const resolveParam = (name)=>{
18
- const value = params?.[name];
19
- return void 0 === value ? void 0 : String(value);
20
- };
21
- const segments = pathname.split('/').map((segment)=>{
22
- if (!segment) return segment;
23
- if (segment.startsWith('{-$') && segment.endsWith('}')) {
24
- const value = resolveParam(segment.slice(3, -1));
25
- return void 0 === value ? null : encodeURIComponent(value);
26
- }
27
- if ('$' === segment || '*' === segment) {
28
- const value = resolveParam('_splat') ?? resolveParam('*');
29
- return void 0 === value ? null : value.split('/').map(encodeURIComponent).join('/');
30
- }
31
- if (segment.startsWith('$')) {
32
- const value = resolveParam(segment.slice(1));
33
- if (void 0 === value) {
34
- warnOnce(`missing-param:${pathname}:${segment}`, `[plugin-i18n] <Link to="${pathname}"> is missing required param "${segment.slice(1)}".`);
35
- return segment;
36
- }
37
- return encodeURIComponent(value);
38
- }
39
- if (segment.startsWith(':')) {
40
- const optional = segment.endsWith('?');
41
- const name = segment.slice(1, optional ? -1 : void 0);
42
- const value = resolveParam(name);
43
- if (void 0 === value) {
44
- if (optional) return null;
45
- warnOnce(`missing-param:${pathname}:${segment}`, `[plugin-i18n] <Link to="${pathname}"> is missing required param "${name}".`);
46
- return segment;
47
- }
48
- return encodeURIComponent(value);
49
- }
50
- return segment;
51
- }).filter((segment)=>null !== segment);
52
- return segments.join('/') || '/';
53
- };
54
- const normalizeSearch = (search, searchFromTo)=>{
55
- if (search && 'object' == typeof search) {
56
- const entries = Object.entries(search).filter(([, value])=>null != value);
57
- const searchObject = Object.fromEntries(entries.map(([key, value])=>[
58
- key,
59
- String(value)
60
- ]));
61
- const params = new URLSearchParams(searchObject);
62
- const serialized = params.toString();
63
- return {
64
- searchString: serialized ? `?${serialized}` : '',
65
- searchObject
66
- };
67
- }
68
- const raw = 'string' == typeof search && search ? search : searchFromTo;
69
- if (!raw) return {
70
- searchString: '',
71
- searchObject: void 0
72
- };
73
- const searchString = raw.startsWith('?') ? raw : `?${raw}`;
74
- const searchObject = {};
75
- new URLSearchParams(searchString).forEach((value, key)=>{
76
- searchObject[key] = value;
77
- });
78
- return {
79
- searchString,
80
- searchObject
81
- };
82
- };
83
- const splitActiveProps = (active, activeProps)=>{
84
- if (!active || !activeProps) return {};
85
- return activeProps;
86
- };
87
- const mergeClassNames = (...values)=>{
88
- const classNames = values.filter((value)=>'string' == typeof value && value.length > 0);
89
- return classNames.length > 0 ? classNames.join(' ') : void 0;
90
- };
91
10
  const Link = (props)=>{
92
11
  const { to, params, children, hash: hashProp, search: searchProp, hashScrollIntoView, activeOptions, activeProps, prefetch, preload, ...rest } = props;
93
12
  const adapter = useI18nRouterAdapter();