@bleedingdev/modern-js-plugin-i18n 3.9.0-ultramodern.7 → 3.9.0-ultramodern.9

package/dist/cjs/cli/index.js

@@ -32,8 +32,11 @@ __webpack_require__.d(__webpack_exports__, {
     i18nPlugin: ()=>i18nPlugin
 });
 const server_core_namespaceObject = require("@modern-js/server-core");
+const utils_namespaceObject = require("@modern-js/utils");
+const urlStrategy_js_namespaceObject = require("../shared/urlStrategy.js");
 const utils_js_namespaceObject = require("../shared/utils.js");
 const external_locales_js_namespaceObject = require("./locales.js");
+const external_localisedRoutes_js_namespaceObject = require("./localisedRoutes.js");
 require("../runtime/types.js");
 const i18nPlugin = (options = {})=>({
         name: '@modern-js/plugin-i18n',
@@ -63,6 +66,10 @@ const i18nPlugin = (options = {})=>({
                     backend: backendOptions,
                     ...extendedConfig
                 };
+                if ((0, urlStrategy_js_namespaceObject.isUnusableI18nUrlStrategy)(config.urlStrategy)) {
+                    delete config.urlStrategy;
+                    utils_namespaceObject.logger.warn("[i18n] `urlStrategy` cannot be passed through `modern.config.ts`: the generated runtime registration carries plugin options as JSON, which drops its methods. Configure `localeDetection.localisedUrls` instead — the runtime and the server both derive the URL policy from it — or register a runtime plugin that supplies the strategy directly.");
+                }
                 const { reactI18next } = extendedConfig;
                 const runtimePluginPath = customPlugin?.runtime?.path || (false === reactI18next ? `@${metaName}/plugin-i18n/runtime/no-react-i18next` : `@${metaName}/plugin-i18n/runtime`);
                 plugins.push({
@@ -75,6 +82,10 @@ const i18nPlugin = (options = {})=>({
                     plugins
                 };
             });
+            api.modifyFileSystemRoutes(({ entrypoint, routes })=>({
+                    entrypoint,
+                    routes: (0, external_localisedRoutes_js_namespaceObject.applyLocalisedRoutes)(routes, localeDetection ? (0, utils_js_namespaceObject.getLocaleDetectionOptions)(entrypoint.entryName, localeDetection) : void 0)
+                }));
             api._internalServerPlugins(({ plugins })=>{
                 const { serverRoutes, metaName } = api.getAppContext();
                 const normalizedConfig = api.getNormalizedConfig();

package/dist/cjs/cli/localisedRoutes.js

@@ -0,0 +1,46 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    applyLocalisedRoutes: ()=>applyLocalisedRoutes
+});
+const i18n_runtime_extensions_namespaceObject = require("@modern-js/i18n-runtime-extensions");
+const applyLocalisedRoutes = (routes, localeDetection)=>{
+    const { localePathRedirect, languages = [], localisedUrls } = localeDetection ?? {};
+    const resolved = (0, i18n_runtime_extensions_namespaceObject.resolveLocalisedUrlsConfig)(localisedUrls);
+    if (!localePathRedirect || !languages.length || !resolved.enabled) return routes;
+    return (0, i18n_runtime_extensions_namespaceObject.applyLocalisedUrlsToRoutes)(routes, languages, resolved.map);
+};
+exports.applyLocalisedRoutes = __webpack_exports__.applyLocalisedRoutes;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "applyLocalisedRoutes"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/runtime/core.js

@@ -40,6 +40,8 @@ __webpack_require__.d(__webpack_exports__, {
     useModernI18n: ()=>external_context_js_namespaceObject.useModernI18n,
     useNativeI18nRouterAdapter: ()=>external_routerAdapter_js_namespaceObject.useNativeI18nRouterAdapter
 });
+const mappedUrlStrategy_js_namespaceObject = require("../shared/mappedUrlStrategy.js");
+const urlStrategy_js_namespaceObject = require("../shared/urlStrategy.js");
 const external_pluginSetup_js_namespaceObject = require("./pluginSetup.js");
 const external_providerComposition_js_namespaceObject = require("./providerComposition.js");
 const external_reactI18next_js_namespaceObject = require("./reactI18next.js");
@@ -56,6 +58,7 @@ const createI18nPlugin = (loadReactI18nextIntegration)=>(options)=>({
                 const { entryName, i18nInstance: userI18nInstance, initOptions, localeDetection, backend, htmlLangAttr = false, reactI18next = true, urlStrategy, NavigationProvider, LanguageSynchronization } = options;
                 const { localePathRedirect = false, i18nextDetector = true, languages = [], fallbackLanguage = 'en', detection, ignoreRedirectRoutes } = localeDetection || {};
                 const { enabled: backendEnabled = false } = backend || {};
+                const resolvedUrlStrategy = (0, urlStrategy_js_namespaceObject.asI18nUrlStrategy)(urlStrategy) ?? (0, mappedUrlStrategy_js_namespaceObject.resolveMappedUrlStrategy)(localeDetection);
                 let latestI18nInstance;
                 let I18nextProvider;
                 api.onBeforeRender(async (context)=>{
@@ -83,7 +86,7 @@ const createI18nPlugin = (loadReactI18nextIntegration)=>(options)=>({
                     languages,
                     fallbackLanguage,
                     ignoreRedirectRoutes,
-                    urlStrategy,
+                    urlStrategy: resolvedUrlStrategy,
                     NavigationProvider,
                     LanguageSynchronization,
                     getLatestI18nInstance: ()=>latestI18nInstance,

package/dist/cjs/runtime/utils.js

@@ -39,6 +39,8 @@ __webpack_require__.d(__webpack_exports__, {
 const runtime_namespaceObject = require("@modern-js/runtime");
 const context_namespaceObject = require("@modern-js/runtime/context");
 const url_namespaceObject = require("@modern-js/runtime-utils/url");
+const mappedUrlStrategy_js_namespaceObject = require("../shared/mappedUrlStrategy.js");
+const urlStrategy_js_namespaceObject = require("../shared/urlStrategy.js");
 const getPathname = (context)=>{
     if ((0, runtime_namespaceObject.isBrowser)()) return window.location.pathname;
     return context.ssrContext?.request?.pathname || '/';
@@ -56,7 +58,8 @@ const getLanguageFromPath = (pathname, languages, fallbackLanguage)=>{
 };
 const buildLocalizedUrl = (target, language, languages, urlStrategy)=>{
     const { pathname, search, hash } = (0, url_namespaceObject.splitUrlTarget)(target);
-    if (urlStrategy) return `${urlStrategy.localizePathname(pathname, language, languages)}${search}${hash}`;
+    const strategy = (0, urlStrategy_js_namespaceObject.asI18nUrlStrategy)(urlStrategy);
+    if (strategy) return `${strategy.localizePathname(pathname, language, languages)}${search}${hash}`;
     const segments = pathname.split('/').filter(Boolean);
     if (segments[0] && languages.some((item)=>item.toLowerCase() === segments[0].toLowerCase())) segments[0] = language;
     else segments.unshift(language);
@@ -81,7 +84,8 @@ const detectLanguageFromPath = (pathname, languages, localePathRedirect)=>{
     };
 };
 const shouldIgnoreRedirect = (pathname, languages, ignoreRedirectRoutes, urlStrategy)=>{
-    if (urlStrategy?.shouldSkipRedirect?.(pathname, languages)) return true;
+    if ((0, mappedUrlStrategy_js_namespaceObject.isDefaultLocaleRedirectSkipPath)(pathname, languages)) return true;
+    if ((0, urlStrategy_js_namespaceObject.asI18nUrlStrategy)(urlStrategy)?.shouldSkipRedirect?.(pathname, languages)) return true;
     if (!ignoreRedirectRoutes) return false;
     const segments = pathname.split('/').filter(Boolean);
     if (segments[0] && languages.some((item)=>item.toLowerCase() === segments[0].toLowerCase())) segments.shift();

package/dist/cjs/server/defaultUrlStrategy.js

@@ -0,0 +1,48 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    createDefaultUrlStrategy: ()=>createDefaultUrlStrategy,
+    resolveDefaultUrlStrategy: ()=>resolveDefaultUrlStrategy
+});
+const external_mappedUrlStrategy_js_namespaceObject = require("./mappedUrlStrategy.js");
+const createDefaultUrlStrategy = (localisedUrls)=>(0, external_mappedUrlStrategy_js_namespaceObject.createMappedUrlStrategy)(localisedUrls);
+const resolveDefaultUrlStrategy = (localisedUrls)=>{
+    if (!localisedUrls || 'object' != typeof localisedUrls || 0 === Object.keys(localisedUrls).length) return;
+    return createDefaultUrlStrategy(localisedUrls);
+};
+exports.createDefaultUrlStrategy = __webpack_exports__.createDefaultUrlStrategy;
+exports.resolveDefaultUrlStrategy = __webpack_exports__.resolveDefaultUrlStrategy;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createDefaultUrlStrategy",
+    "resolveDefaultUrlStrategy"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/server/index.js

@@ -34,8 +34,10 @@ __webpack_require__.d(__webpack_exports__, {
     matchesApiPrefix: ()=>external_apiPrefix_js_namespaceObject.matchesApiPrefix
 });
 const hono_namespaceObject = require("@modern-js/server-core/hono");
+const urlStrategy_js_namespaceObject = require("../shared/urlStrategy.js");
 const utils_js_namespaceObject = require("../shared/utils.js");
 const external_apiPrefix_js_namespaceObject = require("./apiPrefix.js");
+const external_defaultUrlStrategy_js_namespaceObject = require("./defaultUrlStrategy.js");
 const external_detectorOptions_js_namespaceObject = require("./detectorOptions.js");
 const external_redirectPolicy_js_namespaceObject = require("./redirectPolicy.js");
 const { languageDetector } = hono_namespaceObject;
@@ -61,8 +63,7 @@ const i18nServerPlugin = (options)=>({
                     const entryLocaleDetection = (0, utils_js_namespaceObject.getLocaleDetectionOptions)(entryName, options.localeDetection);
                     const { localePathRedirect, i18nextDetector = true, languages = [], fallbackLanguage = 'en', detection, ignoreRedirectRoutes } = entryLocaleDetection;
                     const legacyLocalisedUrls = Reflect.get(entryLocaleDetection, 'localisedUrls');
-                    const urlStrategy = options.resolveUrlStrategy?.(entryName);
-                    if (legacyLocalisedUrls && 'object' == typeof legacyLocalisedUrls && Object.keys(legacyLocalisedUrls).length > 0 && !urlStrategy) throw new Error('Mapped locale URLs require a URL strategy. Use the i18n integration server plugin or supply resolveUrlStrategy.');
+                    const urlStrategy = (0, urlStrategy_js_namespaceObject.asI18nUrlStrategy)(options.resolveUrlStrategy?.(entryName)) ?? (0, external_defaultUrlStrategy_js_namespaceObject.resolveDefaultUrlStrategy)(legacyLocalisedUrls);
                     const staticRoutePrefixes = options.staticRoutePrefixes;
                     const originUrlPath = route.urlPath;
                     const urlPath = originUrlPath.endsWith('/') ? `${originUrlPath}*` : `${originUrlPath}/*`;

package/dist/cjs/server/mappedUrlStrategy.js

@@ -0,0 +1,43 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    createMappedUrlStrategy: ()=>mappedUrlStrategy_js_namespaceObject.createMappedUrlStrategy,
+    resolveMappedUrlStrategy: ()=>mappedUrlStrategy_js_namespaceObject.resolveMappedUrlStrategy
+});
+const mappedUrlStrategy_js_namespaceObject = require("../shared/mappedUrlStrategy.js");
+exports.createMappedUrlStrategy = __webpack_exports__.createMappedUrlStrategy;
+exports.resolveMappedUrlStrategy = __webpack_exports__.resolveMappedUrlStrategy;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createMappedUrlStrategy",
+    "resolveMappedUrlStrategy"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/server/redirectPolicy.js

@@ -27,6 +27,15 @@ var __webpack_require__ = {};
 })();
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    buildLocalizedUrl: ()=>buildLocalizedUrl,
+    createLocaleRedirectResponse: ()=>createLocaleRedirectResponse,
+    getLanguageFromPath: ()=>getLanguageFromPath,
+    isStaticResourceRequest: ()=>isStaticResourceRequest,
+    shouldIgnoreRedirect: ()=>shouldIgnoreRedirect
+});
+const mappedUrlStrategy_js_namespaceObject = require("../shared/mappedUrlStrategy.js");
+const urlStrategy_js_namespaceObject = require("../shared/urlStrategy.js");
 const stripUrlPathPrefix = (pathname, urlPath)=>{
     const basePath = urlPath.replace('/*', '');
     if (!basePath || '/' === basePath) return pathname;
@@ -34,7 +43,8 @@ const stripUrlPathPrefix = (pathname, urlPath)=>{
 };
 const shouldIgnoreRedirect = (pathname, urlPath, ignoreRedirectRoutes, urlStrategy, languages = [])=>{
     const remainingPath = stripUrlPathPrefix(pathname, urlPath);
-    if (urlStrategy?.shouldSkipRedirect?.(remainingPath, languages)) return true;
+    if ((0, mappedUrlStrategy_js_namespaceObject.isDefaultLocaleRedirectSkipPath)(remainingPath, languages)) return true;
+    if ((0, urlStrategy_js_namespaceObject.asI18nUrlStrategy)(urlStrategy)?.shouldSkipRedirect?.(remainingPath, languages)) return true;
     if (!ignoreRedirectRoutes) return false;
     const segments = remainingPath.split('/').filter(Boolean);
     if (segments[0] && languages.some((language)=>language.toLowerCase() === segments[0].toLowerCase())) segments.shift();
@@ -66,7 +76,8 @@ const buildLocalizedUrl = (req, urlPath, language, languages, urlStrategy)=>{
     const segments = remainingPath.split('/').filter(Boolean);
     if (segments[0] && languages.some((item)=>item.toLowerCase() === segments[0].toLowerCase())) segments[0] = language;
     else segments.unshift(language);
-    const pathname = urlStrategy ? urlStrategy.localizePathname(remainingPath, language, languages) : `/${segments.join('/')}`;
+    const strategy = (0, urlStrategy_js_namespaceObject.asI18nUrlStrategy)(urlStrategy);
+    const pathname = strategy ? strategy.localizePathname(remainingPath, language, languages) : `/${segments.join('/')}`;
     return `${'/' === basePath ? '' : basePath}${pathname}${url.search}${url.hash}`;
 };
 const createLocaleRedirectResponse = (location)=>new Response(null, {
@@ -77,13 +88,6 @@ const createLocaleRedirectResponse = (location)=>new Response(null, {
             Vary: 'Accept-Language, Cookie'
         }
     });
-__webpack_require__.d(__webpack_exports__, {}, {
-    buildLocalizedUrl: buildLocalizedUrl,
-    createLocaleRedirectResponse: createLocaleRedirectResponse,
-    getLanguageFromPath: getLanguageFromPath,
-    isStaticResourceRequest: isStaticResourceRequest,
-    shouldIgnoreRedirect: shouldIgnoreRedirect
-});
 exports.buildLocalizedUrl = __webpack_exports__.buildLocalizedUrl;
 exports.createLocaleRedirectResponse = __webpack_exports__.createLocaleRedirectResponse;
 exports.getLanguageFromPath = __webpack_exports__.getLanguageFromPath;

package/dist/cjs/shared/mappedUrlStrategy.js

@@ -0,0 +1,63 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    createMappedUrlStrategy: ()=>createMappedUrlStrategy,
+    isDefaultLocaleRedirectSkipPath: ()=>i18n_runtime_extensions_namespaceObject.isDefaultLocaleRedirectSkipPath,
+    resolveMappedUrlStrategy: ()=>resolveMappedUrlStrategy
+});
+const i18n_runtime_extensions_namespaceObject = require("@modern-js/i18n-runtime-extensions");
+const createMappedUrlStrategy = (localisedUrls)=>({
+        localizePathname: (pathname, language, languages)=>(0, i18n_runtime_extensions_namespaceObject.localiseTargetPathname)(pathname, language, [
+                ...languages
+            ], localisedUrls),
+        canonicalPathname: (pathname, languages)=>(0, i18n_runtime_extensions_namespaceObject.canonicalTargetPathname)(pathname, [
+                ...languages
+            ], localisedUrls),
+        shouldSkipRedirect: (pathname, languages)=>(0, i18n_runtime_extensions_namespaceObject.isDefaultLocaleRedirectSkipPath)(pathname, [
+                ...languages
+            ])
+    });
+const resolveMappedUrlStrategy = (localeDetection)=>{
+    if (!localeDetection || 'object' != typeof localeDetection) return;
+    const localisedUrls = Reflect.get(localeDetection, 'localisedUrls');
+    if (!localisedUrls || 'object' != typeof localisedUrls || 0 === Object.keys(localisedUrls).length) return;
+    return createMappedUrlStrategy(localisedUrls);
+};
+exports.createMappedUrlStrategy = __webpack_exports__.createMappedUrlStrategy;
+exports.isDefaultLocaleRedirectSkipPath = __webpack_exports__.isDefaultLocaleRedirectSkipPath;
+exports.resolveMappedUrlStrategy = __webpack_exports__.resolveMappedUrlStrategy;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createMappedUrlStrategy",
+    "isDefaultLocaleRedirectSkipPath",
+    "resolveMappedUrlStrategy"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/shared/urlStrategy.js

@@ -1,5 +1,20 @@
 "use strict";
 var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
 (()=>{
     __webpack_require__.r = (exports1)=>{
         if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
@@ -12,7 +27,22 @@ var __webpack_require__ = {};
 })();
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
-for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
+const asI18nUrlStrategy = (candidate)=>{
+    if (!candidate || 'object' != typeof candidate) return;
+    const strategy = candidate;
+    return 'function' == typeof strategy.localizePathname && 'function' == typeof strategy.canonicalPathname ? strategy : void 0;
+};
+const isUnusableI18nUrlStrategy = (candidate)=>Boolean(candidate) && 'object' == typeof candidate && void 0 === asI18nUrlStrategy(candidate);
+__webpack_require__.d(__webpack_exports__, {}, {
+    asI18nUrlStrategy: asI18nUrlStrategy,
+    isUnusableI18nUrlStrategy: isUnusableI18nUrlStrategy
+});
+exports.asI18nUrlStrategy = __webpack_exports__.asI18nUrlStrategy;
+exports.isUnusableI18nUrlStrategy = __webpack_exports__.isUnusableI18nUrlStrategy;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "asI18nUrlStrategy",
+    "isUnusableI18nUrlStrategy"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true
 });

package/dist/esm/cli/index.mjs

@@ -1,6 +1,9 @@
 import { getPublicDirRoutePrefixes } from "@modern-js/server-core";
+import { logger } from "@modern-js/utils";
+import { isUnusableI18nUrlStrategy } from "../shared/urlStrategy.mjs";
 import { getBackendOptions, getLocaleDetectionOptions } from "../shared/utils.mjs";
 import { applyDetectedBackendPaths, detectLocalesDirectory } from "./locales.mjs";
+import { applyLocalisedRoutes } from "./localisedRoutes.mjs";
 import "../runtime/types.mjs";
 const i18nPlugin = (options = {})=>({
         name: '@modern-js/plugin-i18n',
@@ -30,6 +33,10 @@ const i18nPlugin = (options = {})=>({
                     backend: backendOptions,
                     ...extendedConfig
                 };
+                if (isUnusableI18nUrlStrategy(config.urlStrategy)) {
+                    delete config.urlStrategy;
+                    logger.warn("[i18n] `urlStrategy` cannot be passed through `modern.config.ts`: the generated runtime registration carries plugin options as JSON, which drops its methods. Configure `localeDetection.localisedUrls` instead — the runtime and the server both derive the URL policy from it — or register a runtime plugin that supplies the strategy directly.");
+                }
                 const { reactI18next } = extendedConfig;
                 const runtimePluginPath = customPlugin?.runtime?.path || (false === reactI18next ? `@${metaName}/plugin-i18n/runtime/no-react-i18next` : `@${metaName}/plugin-i18n/runtime`);
                 plugins.push({
@@ -42,6 +49,10 @@ const i18nPlugin = (options = {})=>({
                     plugins
                 };
             });
+            api.modifyFileSystemRoutes(({ entrypoint, routes })=>({
+                    entrypoint,
+                    routes: applyLocalisedRoutes(routes, localeDetection ? getLocaleDetectionOptions(entrypoint.entryName, localeDetection) : void 0)
+                }));
             api._internalServerPlugins(({ plugins })=>{
                 const { serverRoutes, metaName } = api.getAppContext();
                 const normalizedConfig = api.getNormalizedConfig();

package/dist/esm/cli/localisedRoutes.mjs

@@ -0,0 +1,8 @@
+import { applyLocalisedUrlsToRoutes, resolveLocalisedUrlsConfig } from "@modern-js/i18n-runtime-extensions";
+const applyLocalisedRoutes = (routes, localeDetection)=>{
+    const { localePathRedirect, languages = [], localisedUrls } = localeDetection ?? {};
+    const resolved = resolveLocalisedUrlsConfig(localisedUrls);
+    if (!localePathRedirect || !languages.length || !resolved.enabled) return routes;
+    return applyLocalisedUrlsToRoutes(routes, languages, resolved.map);
+};
+export { applyLocalisedRoutes };

package/dist/esm/runtime/core.mjs

@@ -1,3 +1,5 @@
+import { resolveMappedUrlStrategy } from "../shared/mappedUrlStrategy.mjs";
+import { asI18nUrlStrategy } from "../shared/urlStrategy.mjs";
 import { setupI18nBeforeRender } from "./pluginSetup.mjs";
 import { createI18nRootWrapper } from "./providerComposition.mjs";
 import { resolveReactI18nextIntegration } from "./reactI18next.mjs";
@@ -8,6 +10,7 @@ const createI18nPlugin = (loadReactI18nextIntegration)=>(options)=>({
                 const { entryName, i18nInstance: userI18nInstance, initOptions, localeDetection, backend, htmlLangAttr = false, reactI18next = true, urlStrategy, NavigationProvider, LanguageSynchronization } = options;
                 const { localePathRedirect = false, i18nextDetector = true, languages = [], fallbackLanguage = 'en', detection, ignoreRedirectRoutes } = localeDetection || {};
                 const { enabled: backendEnabled = false } = backend || {};
+                const resolvedUrlStrategy = asI18nUrlStrategy(urlStrategy) ?? resolveMappedUrlStrategy(localeDetection);
                 let latestI18nInstance;
                 let I18nextProvider;
                 api.onBeforeRender(async (context)=>{
@@ -35,7 +38,7 @@ const createI18nPlugin = (loadReactI18nextIntegration)=>(options)=>({
                     languages,
                     fallbackLanguage,
                     ignoreRedirectRoutes,
-                    urlStrategy,
+                    urlStrategy: resolvedUrlStrategy,
                     NavigationProvider,
                     LanguageSynchronization,
                     getLatestI18nInstance: ()=>latestI18nInstance,

package/dist/esm/runtime/utils.mjs

@@ -1,6 +1,8 @@
 import { isBrowser } from "@modern-js/runtime";
 import { getGlobalBasename } from "@modern-js/runtime/context";
 import { splitUrlTarget } from "@modern-js/runtime-utils/url";
+import { isDefaultLocaleRedirectSkipPath } from "../shared/mappedUrlStrategy.mjs";
+import { asI18nUrlStrategy } from "../shared/urlStrategy.mjs";
 const getPathname = (context)=>{
     if (isBrowser()) return window.location.pathname;
     return context.ssrContext?.request?.pathname || '/';
@@ -18,7 +20,8 @@ const getLanguageFromPath = (pathname, languages, fallbackLanguage)=>{
 };
 const buildLocalizedUrl = (target, language, languages, urlStrategy)=>{
     const { pathname, search, hash } = splitUrlTarget(target);
-    if (urlStrategy) return `${urlStrategy.localizePathname(pathname, language, languages)}${search}${hash}`;
+    const strategy = asI18nUrlStrategy(urlStrategy);
+    if (strategy) return `${strategy.localizePathname(pathname, language, languages)}${search}${hash}`;
     const segments = pathname.split('/').filter(Boolean);
     if (segments[0] && languages.some((item)=>item.toLowerCase() === segments[0].toLowerCase())) segments[0] = language;
     else segments.unshift(language);
@@ -43,7 +46,8 @@ const detectLanguageFromPath = (pathname, languages, localePathRedirect)=>{
     };
 };
 const shouldIgnoreRedirect = (pathname, languages, ignoreRedirectRoutes, urlStrategy)=>{
-    if (urlStrategy?.shouldSkipRedirect?.(pathname, languages)) return true;
+    if (isDefaultLocaleRedirectSkipPath(pathname, languages)) return true;
+    if (asI18nUrlStrategy(urlStrategy)?.shouldSkipRedirect?.(pathname, languages)) return true;
     if (!ignoreRedirectRoutes) return false;
     const segments = pathname.split('/').filter(Boolean);
     if (segments[0] && languages.some((item)=>item.toLowerCase() === segments[0].toLowerCase())) segments.shift();

package/dist/esm/server/defaultUrlStrategy.mjs

@@ -0,0 +1,7 @@
+import { createMappedUrlStrategy } from "./mappedUrlStrategy.mjs";
+const createDefaultUrlStrategy = (localisedUrls)=>createMappedUrlStrategy(localisedUrls);
+const resolveDefaultUrlStrategy = (localisedUrls)=>{
+    if (!localisedUrls || 'object' != typeof localisedUrls || 0 === Object.keys(localisedUrls).length) return;
+    return createDefaultUrlStrategy(localisedUrls);
+};
+export { createDefaultUrlStrategy, resolveDefaultUrlStrategy };

package/dist/esm/server/index.mjs

@@ -1,5 +1,7 @@
+import { asI18nUrlStrategy } from "../shared/urlStrategy.mjs";
 import { getLocaleDetectionOptions } from "../shared/utils.mjs";
 import { collectApiPrefixes, matchesApiPrefix } from "./apiPrefix.mjs";
+import { resolveDefaultUrlStrategy } from "./defaultUrlStrategy.mjs";
 import { convertToHonoLanguageDetectorOptions } from "./detectorOptions.mjs";
 import { buildLocalizedUrl, createLocaleRedirectResponse, getLanguageFromPath, isStaticResourceRequest, shouldIgnoreRedirect } from "./redirectPolicy.mjs";
 import * as __rspack_external__modern_js_server_core_hono_0af3baa7 from "@modern-js/server-core/hono";
@@ -26,8 +28,7 @@ const i18nServerPlugin = (options)=>({
                     const entryLocaleDetection = getLocaleDetectionOptions(entryName, options.localeDetection);
                     const { localePathRedirect, i18nextDetector = true, languages = [], fallbackLanguage = 'en', detection, ignoreRedirectRoutes } = entryLocaleDetection;
                     const legacyLocalisedUrls = Reflect.get(entryLocaleDetection, 'localisedUrls');
-                    const urlStrategy = options.resolveUrlStrategy?.(entryName);
-                    if (legacyLocalisedUrls && 'object' == typeof legacyLocalisedUrls && Object.keys(legacyLocalisedUrls).length > 0 && !urlStrategy) throw new Error('Mapped locale URLs require a URL strategy. Use the i18n integration server plugin or supply resolveUrlStrategy.');
+                    const urlStrategy = asI18nUrlStrategy(options.resolveUrlStrategy?.(entryName)) ?? resolveDefaultUrlStrategy(legacyLocalisedUrls);
                     const staticRoutePrefixes = options.staticRoutePrefixes;
                     const originUrlPath = route.urlPath;
                     const urlPath = originUrlPath.endsWith('/') ? `${originUrlPath}*` : `${originUrlPath}/*`;

package/dist/esm/server/mappedUrlStrategy.mjs

@@ -0,0 +1 @@
+export { createMappedUrlStrategy, resolveMappedUrlStrategy } from "../shared/mappedUrlStrategy.mjs";

package/dist/esm/server/redirectPolicy.mjs

@@ -1,3 +1,5 @@
+import { isDefaultLocaleRedirectSkipPath } from "../shared/mappedUrlStrategy.mjs";
+import { asI18nUrlStrategy } from "../shared/urlStrategy.mjs";
 const stripUrlPathPrefix = (pathname, urlPath)=>{
     const basePath = urlPath.replace('/*', '');
     if (!basePath || '/' === basePath) return pathname;
@@ -5,7 +7,8 @@ const stripUrlPathPrefix = (pathname, urlPath)=>{
 };
 const shouldIgnoreRedirect = (pathname, urlPath, ignoreRedirectRoutes, urlStrategy, languages = [])=>{
     const remainingPath = stripUrlPathPrefix(pathname, urlPath);
-    if (urlStrategy?.shouldSkipRedirect?.(remainingPath, languages)) return true;
+    if (isDefaultLocaleRedirectSkipPath(remainingPath, languages)) return true;
+    if (asI18nUrlStrategy(urlStrategy)?.shouldSkipRedirect?.(remainingPath, languages)) return true;
     if (!ignoreRedirectRoutes) return false;
     const segments = remainingPath.split('/').filter(Boolean);
     if (segments[0] && languages.some((language)=>language.toLowerCase() === segments[0].toLowerCase())) segments.shift();
@@ -37,7 +40,8 @@ const buildLocalizedUrl = (req, urlPath, language, languages, urlStrategy)=>{
     const segments = remainingPath.split('/').filter(Boolean);
     if (segments[0] && languages.some((item)=>item.toLowerCase() === segments[0].toLowerCase())) segments[0] = language;
     else segments.unshift(language);
-    const pathname = urlStrategy ? urlStrategy.localizePathname(remainingPath, language, languages) : `/${segments.join('/')}`;
+    const strategy = asI18nUrlStrategy(urlStrategy);
+    const pathname = strategy ? strategy.localizePathname(remainingPath, language, languages) : `/${segments.join('/')}`;
     return `${'/' === basePath ? '' : basePath}${pathname}${url.search}${url.hash}`;
 };
 const createLocaleRedirectResponse = (location)=>new Response(null, {

package/dist/esm/shared/mappedUrlStrategy.mjs

@@ -0,0 +1,19 @@
+import { canonicalTargetPathname, isDefaultLocaleRedirectSkipPath, localiseTargetPathname } from "@modern-js/i18n-runtime-extensions";
+const createMappedUrlStrategy = (localisedUrls)=>({
+        localizePathname: (pathname, language, languages)=>localiseTargetPathname(pathname, language, [
+                ...languages
+            ], localisedUrls),
+        canonicalPathname: (pathname, languages)=>canonicalTargetPathname(pathname, [
+                ...languages
+            ], localisedUrls),
+        shouldSkipRedirect: (pathname, languages)=>isDefaultLocaleRedirectSkipPath(pathname, [
+                ...languages
+            ])
+    });
+const resolveMappedUrlStrategy = (localeDetection)=>{
+    if (!localeDetection || 'object' != typeof localeDetection) return;
+    const localisedUrls = Reflect.get(localeDetection, 'localisedUrls');
+    if (!localisedUrls || 'object' != typeof localisedUrls || 0 === Object.keys(localisedUrls).length) return;
+    return createMappedUrlStrategy(localisedUrls);
+};
+export { createMappedUrlStrategy, isDefaultLocaleRedirectSkipPath, resolveMappedUrlStrategy };

package/dist/esm/shared/urlStrategy.mjs

@@ -0,0 +1,7 @@
+const asI18nUrlStrategy = (candidate)=>{
+    if (!candidate || 'object' != typeof candidate) return;
+    const strategy = candidate;
+    return 'function' == typeof strategy.localizePathname && 'function' == typeof strategy.canonicalPathname ? strategy : void 0;
+};
+const isUnusableI18nUrlStrategy = (candidate)=>Boolean(candidate) && 'object' == typeof candidate && void 0 === asI18nUrlStrategy(candidate);
+export { asI18nUrlStrategy, isUnusableI18nUrlStrategy };

package/dist/esm-node/cli/index.mjs

@@ -1,7 +1,10 @@
 import "node:module";
 import { getPublicDirRoutePrefixes } from "@modern-js/server-core";
+import { logger } from "@modern-js/utils";
+import { isUnusableI18nUrlStrategy } from "../shared/urlStrategy.mjs";
 import { getBackendOptions, getLocaleDetectionOptions } from "../shared/utils.mjs";
 import { applyDetectedBackendPaths, detectLocalesDirectory } from "./locales.mjs";
+import { applyLocalisedRoutes } from "./localisedRoutes.mjs";
 import "../runtime/types.mjs";
 const i18nPlugin = (options = {})=>({
         name: '@modern-js/plugin-i18n',
@@ -31,6 +34,10 @@ const i18nPlugin = (options = {})=>({
                     backend: backendOptions,
                     ...extendedConfig
                 };
+                if (isUnusableI18nUrlStrategy(config.urlStrategy)) {
+                    delete config.urlStrategy;
+                    logger.warn("[i18n] `urlStrategy` cannot be passed through `modern.config.ts`: the generated runtime registration carries plugin options as JSON, which drops its methods. Configure `localeDetection.localisedUrls` instead — the runtime and the server both derive the URL policy from it — or register a runtime plugin that supplies the strategy directly.");
+                }
                 const { reactI18next } = extendedConfig;
                 const runtimePluginPath = customPlugin?.runtime?.path || (false === reactI18next ? `@${metaName}/plugin-i18n/runtime/no-react-i18next` : `@${metaName}/plugin-i18n/runtime`);
                 plugins.push({
@@ -43,6 +50,10 @@ const i18nPlugin = (options = {})=>({
                     plugins
                 };
             });
+            api.modifyFileSystemRoutes(({ entrypoint, routes })=>({
+                    entrypoint,
+                    routes: applyLocalisedRoutes(routes, localeDetection ? getLocaleDetectionOptions(entrypoint.entryName, localeDetection) : void 0)
+                }));
             api._internalServerPlugins(({ plugins })=>{
                 const { serverRoutes, metaName } = api.getAppContext();
                 const normalizedConfig = api.getNormalizedConfig();

package/dist/esm-node/cli/localisedRoutes.mjs

@@ -0,0 +1,9 @@
+import "node:module";
+import { applyLocalisedUrlsToRoutes, resolveLocalisedUrlsConfig } from "@modern-js/i18n-runtime-extensions";
+const applyLocalisedRoutes = (routes, localeDetection)=>{
+    const { localePathRedirect, languages = [], localisedUrls } = localeDetection ?? {};
+    const resolved = resolveLocalisedUrlsConfig(localisedUrls);
+    if (!localePathRedirect || !languages.length || !resolved.enabled) return routes;
+    return applyLocalisedUrlsToRoutes(routes, languages, resolved.map);
+};
+export { applyLocalisedRoutes };