@bleedingdev/modern-js-app-tools 3.5.0-ultramodern.17 → 3.5.0-ultramodern.19

package/dist/cjs/plugins/deploy/platforms/cloudflare.js

@@ -151,6 +151,102 @@ const DEFAULT_CSP_DIRECTIVES = {
         'blob:'
     ]
 };
+const I18N_SERVER_PLUGIN_NAME = 'plugin-i18n/server';
+const DEFAULT_I18NEXT_DETECTION_OPTIONS = {
+    order: [
+        'querystring',
+        'cookie',
+        'localStorage',
+        'header',
+        'navigator',
+        'htmlTag',
+        'path',
+        'subdomain'
+    ],
+    lookupQuerystring: 'lng',
+    lookupCookie: 'i18next',
+    lookupHeader: 'accept-language'
+};
+const SERVER_SIDE_I18N_DETECTORS = new Set([
+    'querystring',
+    'cookie',
+    'header'
+]);
+const isRecord = (value)=>null !== value && 'object' == typeof value && !Array.isArray(value);
+const toStringArray = (value)=>Array.isArray(value) ? value.filter((entry)=>'string' == typeof entry) : [];
+const getI18nServerPlugin = (appContext)=>appContext.serverPlugins?.find((plugin)=>plugin.name.includes(I18N_SERVER_PLUGIN_NAME));
+const removeLocaleDetectionByEntry = (config)=>{
+    const { localeDetectionByEntry: _localeDetectionByEntry, ...rest } = config;
+    return rest;
+};
+const getEntryLocaleDetection = (entryName, localeDetection)=>{
+    const byEntry = isRecord(localeDetection.localeDetectionByEntry) ? localeDetection.localeDetectionByEntry : void 0;
+    const entryConfig = byEntry?.[entryName];
+    const globalConfig = removeLocaleDetectionByEntry(localeDetection);
+    return isRecord(entryConfig) ? {
+        ...globalConfig,
+        ...entryConfig
+    } : globalConfig;
+};
+const normalizeI18nDetection = (detection)=>{
+    const configured = isRecord(detection) ? detection : {};
+    const rawOrder = Array.isArray(configured.order) ? configured.order : DEFAULT_I18NEXT_DETECTION_OPTIONS.order;
+    const order = rawOrder.filter((entry)=>'string' == typeof entry && SERVER_SIDE_I18N_DETECTORS.has(entry));
+    return {
+        order: order.length > 0 ? order : [
+            'querystring',
+            'cookie',
+            'header'
+        ],
+        lookupQuerystring: 'string' == typeof configured.lookupQuerystring && configured.lookupQuerystring ? configured.lookupQuerystring : DEFAULT_I18NEXT_DETECTION_OPTIONS.lookupQuerystring,
+        lookupCookie: 'string' == typeof configured.lookupCookie && configured.lookupCookie ? configured.lookupCookie : DEFAULT_I18NEXT_DETECTION_OPTIONS.lookupCookie,
+        lookupHeader: 'string' == typeof configured.lookupHeader && configured.lookupHeader ? configured.lookupHeader : DEFAULT_I18NEXT_DETECTION_OPTIONS.lookupHeader
+    };
+};
+const normalizeLocalisedUrls = (localisedUrls)=>{
+    if (!isRecord(localisedUrls) || 0 === Object.keys(localisedUrls).length) return;
+    const normalized = {};
+    for (const [canonicalPath, languageMap] of Object.entries(localisedUrls)){
+        if (!isRecord(languageMap)) continue;
+        const normalizedLanguageMap = Object.fromEntries(Object.entries(languageMap).filter((entry)=>'string' == typeof entry[1] && entry[1].length > 0));
+        if (Object.keys(normalizedLanguageMap).length > 0) normalized[canonicalPath] = normalizedLanguageMap;
+    }
+    return Object.keys(normalized).length > 0 ? normalized : void 0;
+};
+const normalizeWorkerI18nEntry = (entryName, localeDetection, staticRoutePrefixes)=>{
+    const entryConfig = getEntryLocaleDetection(entryName, localeDetection);
+    const languages = toStringArray(entryConfig.languages);
+    if (true !== entryConfig.localePathRedirect || 0 === languages.length) return;
+    const fallbackLanguage = 'string' == typeof entryConfig.fallbackLanguage && entryConfig.fallbackLanguage ? entryConfig.fallbackLanguage : 'en';
+    const ignoreRedirectRoutes = Array.isArray(entryConfig.ignoreRedirectRoutes) ? toStringArray(entryConfig.ignoreRedirectRoutes) : [];
+    const localisedUrls = normalizeLocalisedUrls(entryConfig.localisedUrls);
+    return {
+        i18nextDetector: false !== entryConfig.i18nextDetector,
+        languages,
+        fallbackLanguage,
+        detection: normalizeI18nDetection(entryConfig.detection),
+        ignoreRedirectRoutes,
+        staticRoutePrefixes,
+        ...localisedUrls ? {
+            localisedUrls
+        } : {}
+    };
+};
+const createI18nWorkerManifest = (routeSpec, appContext)=>{
+    const i18nServerPlugin = getI18nServerPlugin(appContext);
+    const localeDetection = i18nServerPlugin?.options?.localeDetection;
+    if (!isRecord(localeDetection)) return;
+    const staticRoutePrefixes = toStringArray(i18nServerPlugin?.options?.staticRoutePrefixes);
+    const entries = {};
+    for (const route of routeSpec.routes){
+        if ('string' != typeof route.entryName || entries[route.entryName]) continue;
+        const entry = normalizeWorkerI18nEntry(route.entryName, localeDetection, staticRoutePrefixes);
+        if (entry) entries[route.entryName] = entry;
+    }
+    return Object.keys(entries).length > 0 ? {
+        entries
+    } : void 0;
+};
 const getCompatibilityDate = (modernConfig)=>{
     const configuredDate = modernConfig.deploy?.worker?.compatibilityDate?.trim();
     const compatibilityDate = configuredDate || DEFAULT_COMPATIBILITY_DATE;
@@ -381,7 +477,7 @@ const readRouteSpec = async (outputDirectory)=>{
     };
 };
 const createMissingEffectBffWorkerError = (outputDirectory, worker)=>new Error(`Cloudflare Effect API runtime is configured, but the BFF worker bundle is missing: ${external_node_path_default().join(outputDirectory, worker)}. ${EFFECT_BFF_CLOUDFLARE_IMPORT_GUIDANCE}`);
-const createWorkerManifest = async (outputDirectory, modernConfig)=>{
+const createWorkerManifest = async (outputDirectory, modernConfig, appContext)=>{
     const routeSpec = await readRouteSpec(outputDirectory);
     const routes = await Promise.all(routeSpec.routes.map(async (route)=>{
         const worker = 'string' == typeof route.worker ? route.worker : void 0;
@@ -427,6 +523,7 @@ const createWorkerManifest = async (outputDirectory, modernConfig)=>{
             routeManifest: ROUTE_MANIFEST_FILE
         },
         security: createCloudflareWorkerSecurityPolicy(modernConfig),
+        i18n: createI18nWorkerManifest(routeSpec, appContext),
         bff: isEffectApi && primaryBffPrefix && effectApiWorkerExists ? {
             runtimeFramework: 'effect',
             prefix: primaryBffPrefix,
@@ -517,7 +614,7 @@ const createCloudflarePreset = ({ appContext, modernConfig })=>{
             await utils_namespaceObject.fs.writeJSON(wranglerConfigPath, createWranglerConfig(appDirectory, modernConfig), {
                 spaces: 2
             });
-            await utils_namespaceObject.fs.writeJSON(workerManifestPath, await createWorkerManifest(outputDirectory, modernConfig), {
+            await utils_namespaceObject.fs.writeJSON(workerManifestPath, await createWorkerManifest(outputDirectory, modernConfig, appContext), {
                 spaces: 2
             });
             await utils_namespaceObject.fs.writeJSON(external_node_path_default().join(outputDirectory, OUTPUT_PACKAGE_FILE), {

package/dist/cjs/plugins/deploy/platforms/templates/cloudflare-entry.mjs

@@ -223,6 +223,255 @@ function routeMatches(route, pathname) {
     const requestPath = normalizeRoutePath(pathname);
     return routePath === requestPath || '/' === routePath && route.isSSR || requestPath.startsWith(`${routePath}/`);
 }
+function getRouteI18nEntry(route) {
+    if (!route || 'string' != typeof route.entryName) return;
+    return MODERN_WORKER_MANIFEST.i18n?.entries?.[route.entryName];
+}
+function getRouteBasePath(route) {
+    const routePath = 'string' == typeof route?.urlPath ? normalizeRoutePath(route.urlPath) : '/';
+    return routePath || '/';
+}
+function getRouteRemainingPathname(route, pathname) {
+    const basePath = getRouteBasePath(route);
+    if ('/' === basePath) return pathname || '/';
+    if (!matchesPrefix(pathname, basePath)) return pathname || '/';
+    const remaining = pathname.slice(basePath.length);
+    return remaining ? remaining.startsWith('/') ? remaining : `/${remaining}` : '/';
+}
+function normalizeLanguage(value, languages) {
+    if ('string' != typeof value || '' === value.trim()) return null;
+    const normalized = value.trim().toLowerCase();
+    const exact = languages.find((language)=>language.toLowerCase() === normalized);
+    if (exact) return exact;
+    const baseLanguage = normalized.split(/[-_]/u)[0];
+    return languages.find((language)=>language.toLowerCase() === baseLanguage) || null;
+}
+function getLanguageFromPath(route, pathname, languages) {
+    const remainingPathname = getRouteRemainingPathname(route, pathname);
+    const firstSegment = remainingPathname.split('/').filter(Boolean)[0];
+    return normalizeLanguage(firstSegment, languages);
+}
+function safeDecodeURIComponent(value) {
+    try {
+        return decodeURIComponent(value);
+    } catch  {
+        return value;
+    }
+}
+function detectLanguageFromCookie(cookieHeader, lookupCookie, languages) {
+    if (!cookieHeader) return null;
+    for (const cookiePart of cookieHeader.split(';')){
+        const [rawName, ...rawValue] = cookiePart.trim().split('=');
+        if (rawName === lookupCookie && 0 !== rawValue.length) return normalizeLanguage(safeDecodeURIComponent(rawValue.join('=')), languages);
+    }
+    return null;
+}
+function detectLanguageFromAcceptLanguage(acceptLanguage, languages) {
+    if (!acceptLanguage) return null;
+    return acceptLanguage.split(',').map((entry, index)=>{
+        const [rawRange, ...rawParameters] = entry.trim().split(';');
+        const qualityParameter = rawParameters.find((parameter)=>parameter.trim().startsWith('q='));
+        const quality = qualityParameter ? Number.parseFloat(qualityParameter.split('=')[1] || '') : 1;
+        return {
+            index,
+            language: normalizeLanguage(rawRange, languages),
+            quality: Number.isFinite(quality) ? quality : 1
+        };
+    }).filter((candidate)=>candidate.language && candidate.quality > 0).sort((left, right)=>right.quality - left.quality || left.index - right.index)[0]?.language || null;
+}
+function detectRedirectLanguage(request, entry) {
+    if (!entry.i18nextDetector) return null;
+    const url = new URL(request.url);
+    const detection = entry.detection || {};
+    const order = Array.isArray(detection.order) ? detection.order : [
+        'querystring',
+        'cookie',
+        'header'
+    ];
+    for (const method of order){
+        const language = 'querystring' === method ? normalizeLanguage(url.searchParams.get(detection.lookupQuerystring || 'lng'), entry.languages) : 'cookie' === method ? detectLanguageFromCookie(request.headers.get('cookie'), detection.lookupCookie || 'i18next', entry.languages) : 'header' === method ? detectLanguageFromAcceptLanguage(request.headers.get(detection.lookupHeader || 'accept-language'), entry.languages) : null;
+        if (language) return language;
+    }
+    return null;
+}
+function normaliseSlashes(pathname) {
+    const withoutDuplicateSlashes = pathname.replace(/\/+/g, '/');
+    const withLeadingSlash = withoutDuplicateSlashes.startsWith('/') ? withoutDuplicateSlashes : `/${withoutDuplicateSlashes}`;
+    return withLeadingSlash.length > 1 ? withLeadingSlash.replace(/\/+$/u, '') : withLeadingSlash;
+}
+function normalisePathPattern(pathname) {
+    return normaliseSlashes(pathname).replace(/\[(.+?)\]/g, ':$1');
+}
+function stripLanguagePrefix(pathname, languages) {
+    const segments = pathname.split('/').filter(Boolean);
+    const firstSegment = segments[0];
+    if (firstSegment && normalizeLanguage(firstSegment, languages)) return `/${segments.slice(1).join('/')}` || '/';
+    return pathname || '/';
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function getPatternParamName(segment) {
+    return segment.slice(1).replace(/\?$/, '');
+}
+function compilePathPattern(pattern) {
+    const names = [];
+    const segments = normalisePathPattern(pattern).split('/').filter(Boolean);
+    const source = segments.map((segment)=>{
+        if (segment.startsWith(':')) {
+            names.push(getPatternParamName(segment));
+            return segment.endsWith('?') ? '(?:/([^/]+))?' : '/([^/]+)';
+        }
+        if ('*' === segment) {
+            names.push('*');
+            return '/(.*)';
+        }
+        return `/${escapeRegExp(segment)}`;
+    }).join('');
+    return {
+        names,
+        regexp: new RegExp(`^${source || '/'}$`)
+    };
+}
+function matchPathPattern(pathname, pattern) {
+    const { names, regexp } = compilePathPattern(pattern);
+    const match = regexp.exec(normaliseSlashes(pathname));
+    if (!match) return null;
+    const params = {};
+    for(let index = 0; index < names.length; index++)try {
+        params[names[index]] = decodeURIComponent(match[index + 1] || '');
+    } catch  {
+        return null;
+    }
+    return params;
+}
+function buildPathFromPattern(pattern, params) {
+    const path = normalisePathPattern(pattern).split('/').filter(Boolean).map((segment)=>{
+        if (segment.startsWith(':')) {
+            const param = params[getPatternParamName(segment)];
+            return param ? encodeURIComponent(param) : '';
+        }
+        if ('*' === segment) return params['*'] || '';
+        return segment;
+    }).filter(Boolean).join('/');
+    return `/${path}`;
+}
+function patternSpecificity(pattern) {
+    const segments = normalisePathPattern(pattern).split('/').filter(Boolean);
+    let staticSegments = 0;
+    let dynamicSegments = 0;
+    let splatSegments = 0;
+    for (const segment of segments)if ('*' === segment) splatSegments++;
+    else if (segment.startsWith(':')) dynamicSegments++;
+    else staticSegments++;
+    return {
+        dynamicSegments,
+        splatSegments,
+        staticSegments,
+        totalSegments: segments.length
+    };
+}
+function comparePatternSpecificity(left, right) {
+    const leftSpecificity = patternSpecificity(left);
+    const rightSpecificity = patternSpecificity(right);
+    return rightSpecificity.staticSegments - leftSpecificity.staticSegments || rightSpecificity.totalSegments - leftSpecificity.totalSegments || leftSpecificity.splatSegments - rightSpecificity.splatSegments || leftSpecificity.dynamicSegments - rightSpecificity.dynamicSegments;
+}
+function sortLocalisedPatterns(patterns) {
+    return patterns.map((pattern, index)=>({
+            pattern,
+            index
+        })).sort((left, right)=>comparePatternSpecificity(left.pattern.pattern, right.pattern.pattern) || left.index - right.index).map(({ pattern })=>pattern);
+}
+function resolveLocalisedPath(pathname, targetLanguage, languages, localisedUrls) {
+    const normalizedPathname = normaliseSlashes(pathname);
+    const canonicalCandidates = sortLocalisedPatterns(Object.entries(localisedUrls || {}).map(([canonicalPattern, localisedUrlEntry])=>({
+            canonicalPattern,
+            localisedUrlEntry,
+            pattern: canonicalPattern
+        })));
+    for (const { canonicalPattern, localisedUrlEntry } of canonicalCandidates){
+        const targetPattern = localisedUrlEntry[targetLanguage];
+        const params = targetPattern ? matchPathPattern(normalizedPathname, canonicalPattern) : null;
+        if (params) return buildPathFromPattern(targetPattern, params);
+    }
+    const localisedCandidates = sortLocalisedPatterns(Object.values(localisedUrls || {}).flatMap((localisedUrlEntry)=>{
+        const targetPattern = localisedUrlEntry[targetLanguage];
+        if (!targetPattern) return [];
+        return languages.map((language)=>localisedUrlEntry[language]).filter(Boolean).map((sourcePattern)=>({
+                pattern: sourcePattern,
+                sourcePattern,
+                targetPattern
+            }));
+    }));
+    for (const { sourcePattern, targetPattern } of localisedCandidates){
+        const params = matchPathPattern(normalizedPathname, sourcePattern);
+        if (params) return buildPathFromPattern(targetPattern, params);
+    }
+    return normalizedPathname;
+}
+function localiseTargetPathname(pathname, language, languages, localisedUrls) {
+    const pathWithoutLanguage = stripLanguagePrefix(pathname, languages);
+    const resolvedPath = localisedUrls ? resolveLocalisedPath(pathWithoutLanguage, language, languages, localisedUrls) : pathWithoutLanguage;
+    const resolvedSegments = resolvedPath.split('/').filter(Boolean);
+    return `/${[
+        language,
+        ...resolvedSegments
+    ].join('/')}`;
+}
+function shouldIgnoreLocaleRedirect(pathname, route, entry) {
+    const remainingPathname = getRouteRemainingPathname(route, pathname);
+    const normalizedPathname = remainingPathname.startsWith('/') ? remainingPathname : `/${remainingPathname}`;
+    const ignoredPrefixes = [
+        ...entry.ignoreRedirectRoutes || [],
+        ...entry.staticRoutePrefixes || [],
+        '/static',
+        '/upload'
+    ];
+    return ignoredPrefixes.some((prefix)=>{
+        const normalizedPrefix = normaliseSlashes(prefix);
+        return normalizedPathname === normalizedPrefix || normalizedPathname.startsWith(`${normalizedPrefix}/`);
+    });
+}
+function buildLocalizedUrl(route, request, language, entry) {
+    const url = new URL(request.url);
+    const basePath = getRouteBasePath(route);
+    const remainingPathname = getRouteRemainingPathname(route, url.pathname);
+    const localizedPathname = localiseTargetPathname(remainingPathname, language, entry.languages, entry.localisedUrls);
+    const nextPathname = '/' === basePath ? localizedPathname : normaliseSlashes(`${basePath}/${localizedPathname}`);
+    return `${nextPathname}${url.search}`;
+}
+function createLocaleRedirectResponse(location, entry) {
+    const headers = new Headers({
+        'cache-control': 'private, no-store',
+        location
+    });
+    const vary = [];
+    const detectionOrder = entry.i18nextDetector ? entry.detection?.order || [] : [];
+    if (detectionOrder.includes('header')) vary.push('Accept-Language');
+    if (detectionOrder.includes('cookie')) vary.push('Cookie');
+    if (vary.length > 0) headers.set('vary', vary.join(', '));
+    return new Response(null, {
+        headers,
+        status: 302
+    });
+}
+function createLocaleRedirectResponseForRequest(route, request) {
+    const entry = getRouteI18nEntry(route);
+    if (!entry || !Array.isArray(entry.languages) || 0 === entry.languages.length) return null;
+    const { pathname, search } = new URL(request.url);
+    if (isAssetLikePathname(pathname)) return null;
+    if (shouldIgnoreLocaleRedirect(pathname, route, entry)) return null;
+    const language = getLanguageFromPath(route, pathname, entry.languages);
+    if (!language) {
+        const targetLanguage = detectRedirectLanguage(request, entry) || entry.fallbackLanguage;
+        return createLocaleRedirectResponse(buildLocalizedUrl(route, request, targetLanguage, entry), entry);
+    }
+    if (entry.localisedUrls) {
+        const expectedUrl = buildLocalizedUrl(route, request, language, entry);
+        if (expectedUrl !== `${pathname}${search}`) return createLocaleRedirectResponse(expectedUrl, entry);
+    }
+    return null;
+}
 function findRoute(request) {
     const { pathname } = new URL(request.url);
     const routes = MODERN_WORKER_MANIFEST.routeSpec.routes;
@@ -565,6 +814,8 @@ export default {
                 status: 404
             }), request), request);
         }
+        const localeRedirectResponse = createLocaleRedirectResponseForRequest(route, request);
+        if (localeRedirectResponse) return finalizeResponseForRequest(withAppCorsHeaders(localeRedirectResponse, request), request);
         if (route?.worker) {
             const renderableRequest = createRenderableRequest(request);
             return finalizeResponseForRequest(withAppCorsHeaders(await dispatchRouteWorker(route, renderableRequest, env, ctx), request), request);

package/dist/esm/plugins/deploy/platforms/cloudflare.mjs

@@ -109,6 +109,102 @@ const DEFAULT_CSP_DIRECTIVES = {
         'blob:'
     ]
 };
+const I18N_SERVER_PLUGIN_NAME = 'plugin-i18n/server';
+const DEFAULT_I18NEXT_DETECTION_OPTIONS = {
+    order: [
+        'querystring',
+        'cookie',
+        'localStorage',
+        'header',
+        'navigator',
+        'htmlTag',
+        'path',
+        'subdomain'
+    ],
+    lookupQuerystring: 'lng',
+    lookupCookie: 'i18next',
+    lookupHeader: 'accept-language'
+};
+const SERVER_SIDE_I18N_DETECTORS = new Set([
+    'querystring',
+    'cookie',
+    'header'
+]);
+const isRecord = (value)=>null !== value && 'object' == typeof value && !Array.isArray(value);
+const toStringArray = (value)=>Array.isArray(value) ? value.filter((entry)=>'string' == typeof entry) : [];
+const getI18nServerPlugin = (appContext)=>appContext.serverPlugins?.find((plugin)=>plugin.name.includes(I18N_SERVER_PLUGIN_NAME));
+const removeLocaleDetectionByEntry = (config)=>{
+    const { localeDetectionByEntry: _localeDetectionByEntry, ...rest } = config;
+    return rest;
+};
+const getEntryLocaleDetection = (entryName, localeDetection)=>{
+    const byEntry = isRecord(localeDetection.localeDetectionByEntry) ? localeDetection.localeDetectionByEntry : void 0;
+    const entryConfig = byEntry?.[entryName];
+    const globalConfig = removeLocaleDetectionByEntry(localeDetection);
+    return isRecord(entryConfig) ? {
+        ...globalConfig,
+        ...entryConfig
+    } : globalConfig;
+};
+const normalizeI18nDetection = (detection)=>{
+    const configured = isRecord(detection) ? detection : {};
+    const rawOrder = Array.isArray(configured.order) ? configured.order : DEFAULT_I18NEXT_DETECTION_OPTIONS.order;
+    const order = rawOrder.filter((entry)=>'string' == typeof entry && SERVER_SIDE_I18N_DETECTORS.has(entry));
+    return {
+        order: order.length > 0 ? order : [
+            'querystring',
+            'cookie',
+            'header'
+        ],
+        lookupQuerystring: 'string' == typeof configured.lookupQuerystring && configured.lookupQuerystring ? configured.lookupQuerystring : DEFAULT_I18NEXT_DETECTION_OPTIONS.lookupQuerystring,
+        lookupCookie: 'string' == typeof configured.lookupCookie && configured.lookupCookie ? configured.lookupCookie : DEFAULT_I18NEXT_DETECTION_OPTIONS.lookupCookie,
+        lookupHeader: 'string' == typeof configured.lookupHeader && configured.lookupHeader ? configured.lookupHeader : DEFAULT_I18NEXT_DETECTION_OPTIONS.lookupHeader
+    };
+};
+const normalizeLocalisedUrls = (localisedUrls)=>{
+    if (!isRecord(localisedUrls) || 0 === Object.keys(localisedUrls).length) return;
+    const normalized = {};
+    for (const [canonicalPath, languageMap] of Object.entries(localisedUrls)){
+        if (!isRecord(languageMap)) continue;
+        const normalizedLanguageMap = Object.fromEntries(Object.entries(languageMap).filter((entry)=>'string' == typeof entry[1] && entry[1].length > 0));
+        if (Object.keys(normalizedLanguageMap).length > 0) normalized[canonicalPath] = normalizedLanguageMap;
+    }
+    return Object.keys(normalized).length > 0 ? normalized : void 0;
+};
+const normalizeWorkerI18nEntry = (entryName, localeDetection, staticRoutePrefixes)=>{
+    const entryConfig = getEntryLocaleDetection(entryName, localeDetection);
+    const languages = toStringArray(entryConfig.languages);
+    if (true !== entryConfig.localePathRedirect || 0 === languages.length) return;
+    const fallbackLanguage = 'string' == typeof entryConfig.fallbackLanguage && entryConfig.fallbackLanguage ? entryConfig.fallbackLanguage : 'en';
+    const ignoreRedirectRoutes = Array.isArray(entryConfig.ignoreRedirectRoutes) ? toStringArray(entryConfig.ignoreRedirectRoutes) : [];
+    const localisedUrls = normalizeLocalisedUrls(entryConfig.localisedUrls);
+    return {
+        i18nextDetector: false !== entryConfig.i18nextDetector,
+        languages,
+        fallbackLanguage,
+        detection: normalizeI18nDetection(entryConfig.detection),
+        ignoreRedirectRoutes,
+        staticRoutePrefixes,
+        ...localisedUrls ? {
+            localisedUrls
+        } : {}
+    };
+};
+const createI18nWorkerManifest = (routeSpec, appContext)=>{
+    const i18nServerPlugin = getI18nServerPlugin(appContext);
+    const localeDetection = i18nServerPlugin?.options?.localeDetection;
+    if (!isRecord(localeDetection)) return;
+    const staticRoutePrefixes = toStringArray(i18nServerPlugin?.options?.staticRoutePrefixes);
+    const entries = {};
+    for (const route of routeSpec.routes){
+        if ('string' != typeof route.entryName || entries[route.entryName]) continue;
+        const entry = normalizeWorkerI18nEntry(route.entryName, localeDetection, staticRoutePrefixes);
+        if (entry) entries[route.entryName] = entry;
+    }
+    return Object.keys(entries).length > 0 ? {
+        entries
+    } : void 0;
+};
 const getCompatibilityDate = (modernConfig)=>{
     const configuredDate = modernConfig.deploy?.worker?.compatibilityDate?.trim();
     const compatibilityDate = configuredDate || DEFAULT_COMPATIBILITY_DATE;
@@ -339,7 +435,7 @@ const readRouteSpec = async (outputDirectory)=>{
     };
 };
 const createMissingEffectBffWorkerError = (outputDirectory, worker)=>new Error(`Cloudflare Effect API runtime is configured, but the BFF worker bundle is missing: ${node_path.join(outputDirectory, worker)}. ${EFFECT_BFF_CLOUDFLARE_IMPORT_GUIDANCE}`);
-const createWorkerManifest = async (outputDirectory, modernConfig)=>{
+const createWorkerManifest = async (outputDirectory, modernConfig, appContext)=>{
     const routeSpec = await readRouteSpec(outputDirectory);
     const routes = await Promise.all(routeSpec.routes.map(async (route)=>{
         const worker = 'string' == typeof route.worker ? route.worker : void 0;
@@ -385,6 +481,7 @@ const createWorkerManifest = async (outputDirectory, modernConfig)=>{
             routeManifest: ROUTE_MANIFEST_FILE
         },
         security: createCloudflareWorkerSecurityPolicy(modernConfig),
+        i18n: createI18nWorkerManifest(routeSpec, appContext),
         bff: isEffectApi && primaryBffPrefix && effectApiWorkerExists ? {
             runtimeFramework: 'effect',
             prefix: primaryBffPrefix,
@@ -475,7 +572,7 @@ const createCloudflarePreset = ({ appContext, modernConfig })=>{
             await fs.writeJSON(wranglerConfigPath, createWranglerConfig(appDirectory, modernConfig), {
                 spaces: 2
             });
-            await fs.writeJSON(workerManifestPath, await createWorkerManifest(outputDirectory, modernConfig), {
+            await fs.writeJSON(workerManifestPath, await createWorkerManifest(outputDirectory, modernConfig, appContext), {
                 spaces: 2
             });
             await fs.writeJSON(node_path.join(outputDirectory, OUTPUT_PACKAGE_FILE), {

package/dist/esm/plugins/deploy/platforms/templates/cloudflare-entry.mjs

@@ -223,6 +223,255 @@ function routeMatches(route, pathname) {
     const requestPath = normalizeRoutePath(pathname);
     return routePath === requestPath || '/' === routePath && route.isSSR || requestPath.startsWith(`${routePath}/`);
 }
+function getRouteI18nEntry(route) {
+    if (!route || 'string' != typeof route.entryName) return;
+    return MODERN_WORKER_MANIFEST.i18n?.entries?.[route.entryName];
+}
+function getRouteBasePath(route) {
+    const routePath = 'string' == typeof route?.urlPath ? normalizeRoutePath(route.urlPath) : '/';
+    return routePath || '/';
+}
+function getRouteRemainingPathname(route, pathname) {
+    const basePath = getRouteBasePath(route);
+    if ('/' === basePath) return pathname || '/';
+    if (!matchesPrefix(pathname, basePath)) return pathname || '/';
+    const remaining = pathname.slice(basePath.length);
+    return remaining ? remaining.startsWith('/') ? remaining : `/${remaining}` : '/';
+}
+function normalizeLanguage(value, languages) {
+    if ('string' != typeof value || '' === value.trim()) return null;
+    const normalized = value.trim().toLowerCase();
+    const exact = languages.find((language)=>language.toLowerCase() === normalized);
+    if (exact) return exact;
+    const baseLanguage = normalized.split(/[-_]/u)[0];
+    return languages.find((language)=>language.toLowerCase() === baseLanguage) || null;
+}
+function getLanguageFromPath(route, pathname, languages) {
+    const remainingPathname = getRouteRemainingPathname(route, pathname);
+    const firstSegment = remainingPathname.split('/').filter(Boolean)[0];
+    return normalizeLanguage(firstSegment, languages);
+}
+function safeDecodeURIComponent(value) {
+    try {
+        return decodeURIComponent(value);
+    } catch  {
+        return value;
+    }
+}
+function detectLanguageFromCookie(cookieHeader, lookupCookie, languages) {
+    if (!cookieHeader) return null;
+    for (const cookiePart of cookieHeader.split(';')){
+        const [rawName, ...rawValue] = cookiePart.trim().split('=');
+        if (rawName === lookupCookie && 0 !== rawValue.length) return normalizeLanguage(safeDecodeURIComponent(rawValue.join('=')), languages);
+    }
+    return null;
+}
+function detectLanguageFromAcceptLanguage(acceptLanguage, languages) {
+    if (!acceptLanguage) return null;
+    return acceptLanguage.split(',').map((entry, index)=>{
+        const [rawRange, ...rawParameters] = entry.trim().split(';');
+        const qualityParameter = rawParameters.find((parameter)=>parameter.trim().startsWith('q='));
+        const quality = qualityParameter ? Number.parseFloat(qualityParameter.split('=')[1] || '') : 1;
+        return {
+            index,
+            language: normalizeLanguage(rawRange, languages),
+            quality: Number.isFinite(quality) ? quality : 1
+        };
+    }).filter((candidate)=>candidate.language && candidate.quality > 0).sort((left, right)=>right.quality - left.quality || left.index - right.index)[0]?.language || null;
+}
+function detectRedirectLanguage(request, entry) {
+    if (!entry.i18nextDetector) return null;
+    const url = new URL(request.url);
+    const detection = entry.detection || {};
+    const order = Array.isArray(detection.order) ? detection.order : [
+        'querystring',
+        'cookie',
+        'header'
+    ];
+    for (const method of order){
+        const language = 'querystring' === method ? normalizeLanguage(url.searchParams.get(detection.lookupQuerystring || 'lng'), entry.languages) : 'cookie' === method ? detectLanguageFromCookie(request.headers.get('cookie'), detection.lookupCookie || 'i18next', entry.languages) : 'header' === method ? detectLanguageFromAcceptLanguage(request.headers.get(detection.lookupHeader || 'accept-language'), entry.languages) : null;
+        if (language) return language;
+    }
+    return null;
+}
+function normaliseSlashes(pathname) {
+    const withoutDuplicateSlashes = pathname.replace(/\/+/g, '/');
+    const withLeadingSlash = withoutDuplicateSlashes.startsWith('/') ? withoutDuplicateSlashes : `/${withoutDuplicateSlashes}`;
+    return withLeadingSlash.length > 1 ? withLeadingSlash.replace(/\/+$/u, '') : withLeadingSlash;
+}
+function normalisePathPattern(pathname) {
+    return normaliseSlashes(pathname).replace(/\[(.+?)\]/g, ':$1');
+}
+function stripLanguagePrefix(pathname, languages) {
+    const segments = pathname.split('/').filter(Boolean);
+    const firstSegment = segments[0];
+    if (firstSegment && normalizeLanguage(firstSegment, languages)) return `/${segments.slice(1).join('/')}` || '/';
+    return pathname || '/';
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function getPatternParamName(segment) {
+    return segment.slice(1).replace(/\?$/, '');
+}
+function compilePathPattern(pattern) {
+    const names = [];
+    const segments = normalisePathPattern(pattern).split('/').filter(Boolean);
+    const source = segments.map((segment)=>{
+        if (segment.startsWith(':')) {
+            names.push(getPatternParamName(segment));
+            return segment.endsWith('?') ? '(?:/([^/]+))?' : '/([^/]+)';
+        }
+        if ('*' === segment) {
+            names.push('*');
+            return '/(.*)';
+        }
+        return `/${escapeRegExp(segment)}`;
+    }).join('');
+    return {
+        names,
+        regexp: new RegExp(`^${source || '/'}$`)
+    };
+}
+function matchPathPattern(pathname, pattern) {
+    const { names, regexp } = compilePathPattern(pattern);
+    const match = regexp.exec(normaliseSlashes(pathname));
+    if (!match) return null;
+    const params = {};
+    for(let index = 0; index < names.length; index++)try {
+        params[names[index]] = decodeURIComponent(match[index + 1] || '');
+    } catch  {
+        return null;
+    }
+    return params;
+}
+function buildPathFromPattern(pattern, params) {
+    const path = normalisePathPattern(pattern).split('/').filter(Boolean).map((segment)=>{
+        if (segment.startsWith(':')) {
+            const param = params[getPatternParamName(segment)];
+            return param ? encodeURIComponent(param) : '';
+        }
+        if ('*' === segment) return params['*'] || '';
+        return segment;
+    }).filter(Boolean).join('/');
+    return `/${path}`;
+}
+function patternSpecificity(pattern) {
+    const segments = normalisePathPattern(pattern).split('/').filter(Boolean);
+    let staticSegments = 0;
+    let dynamicSegments = 0;
+    let splatSegments = 0;
+    for (const segment of segments)if ('*' === segment) splatSegments++;
+    else if (segment.startsWith(':')) dynamicSegments++;
+    else staticSegments++;
+    return {
+        dynamicSegments,
+        splatSegments,
+        staticSegments,
+        totalSegments: segments.length
+    };
+}
+function comparePatternSpecificity(left, right) {
+    const leftSpecificity = patternSpecificity(left);
+    const rightSpecificity = patternSpecificity(right);
+    return rightSpecificity.staticSegments - leftSpecificity.staticSegments || rightSpecificity.totalSegments - leftSpecificity.totalSegments || leftSpecificity.splatSegments - rightSpecificity.splatSegments || leftSpecificity.dynamicSegments - rightSpecificity.dynamicSegments;
+}
+function sortLocalisedPatterns(patterns) {
+    return patterns.map((pattern, index)=>({
+            pattern,
+            index
+        })).sort((left, right)=>comparePatternSpecificity(left.pattern.pattern, right.pattern.pattern) || left.index - right.index).map(({ pattern })=>pattern);
+}
+function resolveLocalisedPath(pathname, targetLanguage, languages, localisedUrls) {
+    const normalizedPathname = normaliseSlashes(pathname);
+    const canonicalCandidates = sortLocalisedPatterns(Object.entries(localisedUrls || {}).map(([canonicalPattern, localisedUrlEntry])=>({
+            canonicalPattern,
+            localisedUrlEntry,
+            pattern: canonicalPattern
+        })));
+    for (const { canonicalPattern, localisedUrlEntry } of canonicalCandidates){
+        const targetPattern = localisedUrlEntry[targetLanguage];
+        const params = targetPattern ? matchPathPattern(normalizedPathname, canonicalPattern) : null;
+        if (params) return buildPathFromPattern(targetPattern, params);
+    }
+    const localisedCandidates = sortLocalisedPatterns(Object.values(localisedUrls || {}).flatMap((localisedUrlEntry)=>{
+        const targetPattern = localisedUrlEntry[targetLanguage];
+        if (!targetPattern) return [];
+        return languages.map((language)=>localisedUrlEntry[language]).filter(Boolean).map((sourcePattern)=>({
+                pattern: sourcePattern,
+                sourcePattern,
+                targetPattern
+            }));
+    }));
+    for (const { sourcePattern, targetPattern } of localisedCandidates){
+        const params = matchPathPattern(normalizedPathname, sourcePattern);
+        if (params) return buildPathFromPattern(targetPattern, params);
+    }
+    return normalizedPathname;
+}
+function localiseTargetPathname(pathname, language, languages, localisedUrls) {
+    const pathWithoutLanguage = stripLanguagePrefix(pathname, languages);
+    const resolvedPath = localisedUrls ? resolveLocalisedPath(pathWithoutLanguage, language, languages, localisedUrls) : pathWithoutLanguage;
+    const resolvedSegments = resolvedPath.split('/').filter(Boolean);
+    return `/${[
+        language,
+        ...resolvedSegments
+    ].join('/')}`;
+}
+function shouldIgnoreLocaleRedirect(pathname, route, entry) {
+    const remainingPathname = getRouteRemainingPathname(route, pathname);
+    const normalizedPathname = remainingPathname.startsWith('/') ? remainingPathname : `/${remainingPathname}`;
+    const ignoredPrefixes = [
+        ...entry.ignoreRedirectRoutes || [],
+        ...entry.staticRoutePrefixes || [],
+        '/static',
+        '/upload'
+    ];
+    return ignoredPrefixes.some((prefix)=>{
+        const normalizedPrefix = normaliseSlashes(prefix);
+        return normalizedPathname === normalizedPrefix || normalizedPathname.startsWith(`${normalizedPrefix}/`);
+    });
+}
+function buildLocalizedUrl(route, request, language, entry) {
+    const url = new URL(request.url);
+    const basePath = getRouteBasePath(route);
+    const remainingPathname = getRouteRemainingPathname(route, url.pathname);
+    const localizedPathname = localiseTargetPathname(remainingPathname, language, entry.languages, entry.localisedUrls);
+    const nextPathname = '/' === basePath ? localizedPathname : normaliseSlashes(`${basePath}/${localizedPathname}`);
+    return `${nextPathname}${url.search}`;
+}
+function createLocaleRedirectResponse(location, entry) {
+    const headers = new Headers({
+        'cache-control': 'private, no-store',
+        location
+    });
+    const vary = [];
+    const detectionOrder = entry.i18nextDetector ? entry.detection?.order || [] : [];
+    if (detectionOrder.includes('header')) vary.push('Accept-Language');
+    if (detectionOrder.includes('cookie')) vary.push('Cookie');
+    if (vary.length > 0) headers.set('vary', vary.join(', '));
+    return new Response(null, {
+        headers,
+        status: 302
+    });
+}
+function createLocaleRedirectResponseForRequest(route, request) {
+    const entry = getRouteI18nEntry(route);
+    if (!entry || !Array.isArray(entry.languages) || 0 === entry.languages.length) return null;
+    const { pathname, search } = new URL(request.url);
+    if (isAssetLikePathname(pathname)) return null;
+    if (shouldIgnoreLocaleRedirect(pathname, route, entry)) return null;
+    const language = getLanguageFromPath(route, pathname, entry.languages);
+    if (!language) {
+        const targetLanguage = detectRedirectLanguage(request, entry) || entry.fallbackLanguage;
+        return createLocaleRedirectResponse(buildLocalizedUrl(route, request, targetLanguage, entry), entry);
+    }
+    if (entry.localisedUrls) {
+        const expectedUrl = buildLocalizedUrl(route, request, language, entry);
+        if (expectedUrl !== `${pathname}${search}`) return createLocaleRedirectResponse(expectedUrl, entry);
+    }
+    return null;
+}
 function findRoute(request) {
     const { pathname } = new URL(request.url);
     const routes = MODERN_WORKER_MANIFEST.routeSpec.routes;
@@ -565,6 +814,8 @@ export default {
                 status: 404
             }), request), request);
         }
+        const localeRedirectResponse = createLocaleRedirectResponseForRequest(route, request);
+        if (localeRedirectResponse) return finalizeResponseForRequest(withAppCorsHeaders(localeRedirectResponse, request), request);
         if (route?.worker) {
             const renderableRequest = createRenderableRequest(request);
             return finalizeResponseForRequest(withAppCorsHeaders(await dispatchRouteWorker(route, renderableRequest, env, ctx), request), request);

package/dist/esm-node/plugins/deploy/platforms/cloudflare.mjs

@@ -110,6 +110,102 @@ const DEFAULT_CSP_DIRECTIVES = {
         'blob:'
     ]
 };
+const I18N_SERVER_PLUGIN_NAME = 'plugin-i18n/server';
+const DEFAULT_I18NEXT_DETECTION_OPTIONS = {
+    order: [
+        'querystring',
+        'cookie',
+        'localStorage',
+        'header',
+        'navigator',
+        'htmlTag',
+        'path',
+        'subdomain'
+    ],
+    lookupQuerystring: 'lng',
+    lookupCookie: 'i18next',
+    lookupHeader: 'accept-language'
+};
+const SERVER_SIDE_I18N_DETECTORS = new Set([
+    'querystring',
+    'cookie',
+    'header'
+]);
+const isRecord = (value)=>null !== value && 'object' == typeof value && !Array.isArray(value);
+const toStringArray = (value)=>Array.isArray(value) ? value.filter((entry)=>'string' == typeof entry) : [];
+const getI18nServerPlugin = (appContext)=>appContext.serverPlugins?.find((plugin)=>plugin.name.includes(I18N_SERVER_PLUGIN_NAME));
+const removeLocaleDetectionByEntry = (config)=>{
+    const { localeDetectionByEntry: _localeDetectionByEntry, ...rest } = config;
+    return rest;
+};
+const getEntryLocaleDetection = (entryName, localeDetection)=>{
+    const byEntry = isRecord(localeDetection.localeDetectionByEntry) ? localeDetection.localeDetectionByEntry : void 0;
+    const entryConfig = byEntry?.[entryName];
+    const globalConfig = removeLocaleDetectionByEntry(localeDetection);
+    return isRecord(entryConfig) ? {
+        ...globalConfig,
+        ...entryConfig
+    } : globalConfig;
+};
+const normalizeI18nDetection = (detection)=>{
+    const configured = isRecord(detection) ? detection : {};
+    const rawOrder = Array.isArray(configured.order) ? configured.order : DEFAULT_I18NEXT_DETECTION_OPTIONS.order;
+    const order = rawOrder.filter((entry)=>'string' == typeof entry && SERVER_SIDE_I18N_DETECTORS.has(entry));
+    return {
+        order: order.length > 0 ? order : [
+            'querystring',
+            'cookie',
+            'header'
+        ],
+        lookupQuerystring: 'string' == typeof configured.lookupQuerystring && configured.lookupQuerystring ? configured.lookupQuerystring : DEFAULT_I18NEXT_DETECTION_OPTIONS.lookupQuerystring,
+        lookupCookie: 'string' == typeof configured.lookupCookie && configured.lookupCookie ? configured.lookupCookie : DEFAULT_I18NEXT_DETECTION_OPTIONS.lookupCookie,
+        lookupHeader: 'string' == typeof configured.lookupHeader && configured.lookupHeader ? configured.lookupHeader : DEFAULT_I18NEXT_DETECTION_OPTIONS.lookupHeader
+    };
+};
+const normalizeLocalisedUrls = (localisedUrls)=>{
+    if (!isRecord(localisedUrls) || 0 === Object.keys(localisedUrls).length) return;
+    const normalized = {};
+    for (const [canonicalPath, languageMap] of Object.entries(localisedUrls)){
+        if (!isRecord(languageMap)) continue;
+        const normalizedLanguageMap = Object.fromEntries(Object.entries(languageMap).filter((entry)=>'string' == typeof entry[1] && entry[1].length > 0));
+        if (Object.keys(normalizedLanguageMap).length > 0) normalized[canonicalPath] = normalizedLanguageMap;
+    }
+    return Object.keys(normalized).length > 0 ? normalized : void 0;
+};
+const normalizeWorkerI18nEntry = (entryName, localeDetection, staticRoutePrefixes)=>{
+    const entryConfig = getEntryLocaleDetection(entryName, localeDetection);
+    const languages = toStringArray(entryConfig.languages);
+    if (true !== entryConfig.localePathRedirect || 0 === languages.length) return;
+    const fallbackLanguage = 'string' == typeof entryConfig.fallbackLanguage && entryConfig.fallbackLanguage ? entryConfig.fallbackLanguage : 'en';
+    const ignoreRedirectRoutes = Array.isArray(entryConfig.ignoreRedirectRoutes) ? toStringArray(entryConfig.ignoreRedirectRoutes) : [];
+    const localisedUrls = normalizeLocalisedUrls(entryConfig.localisedUrls);
+    return {
+        i18nextDetector: false !== entryConfig.i18nextDetector,
+        languages,
+        fallbackLanguage,
+        detection: normalizeI18nDetection(entryConfig.detection),
+        ignoreRedirectRoutes,
+        staticRoutePrefixes,
+        ...localisedUrls ? {
+            localisedUrls
+        } : {}
+    };
+};
+const createI18nWorkerManifest = (routeSpec, appContext)=>{
+    const i18nServerPlugin = getI18nServerPlugin(appContext);
+    const localeDetection = i18nServerPlugin?.options?.localeDetection;
+    if (!isRecord(localeDetection)) return;
+    const staticRoutePrefixes = toStringArray(i18nServerPlugin?.options?.staticRoutePrefixes);
+    const entries = {};
+    for (const route of routeSpec.routes){
+        if ('string' != typeof route.entryName || entries[route.entryName]) continue;
+        const entry = normalizeWorkerI18nEntry(route.entryName, localeDetection, staticRoutePrefixes);
+        if (entry) entries[route.entryName] = entry;
+    }
+    return Object.keys(entries).length > 0 ? {
+        entries
+    } : void 0;
+};
 const getCompatibilityDate = (modernConfig)=>{
     const configuredDate = modernConfig.deploy?.worker?.compatibilityDate?.trim();
     const compatibilityDate = configuredDate || DEFAULT_COMPATIBILITY_DATE;
@@ -340,7 +436,7 @@ const readRouteSpec = async (outputDirectory)=>{
     };
 };
 const createMissingEffectBffWorkerError = (outputDirectory, worker)=>new Error(`Cloudflare Effect API runtime is configured, but the BFF worker bundle is missing: ${node_path.join(outputDirectory, worker)}. ${EFFECT_BFF_CLOUDFLARE_IMPORT_GUIDANCE}`);
-const createWorkerManifest = async (outputDirectory, modernConfig)=>{
+const createWorkerManifest = async (outputDirectory, modernConfig, appContext)=>{
     const routeSpec = await readRouteSpec(outputDirectory);
     const routes = await Promise.all(routeSpec.routes.map(async (route)=>{
         const worker = 'string' == typeof route.worker ? route.worker : void 0;
@@ -386,6 +482,7 @@ const createWorkerManifest = async (outputDirectory, modernConfig)=>{
             routeManifest: ROUTE_MANIFEST_FILE
         },
         security: createCloudflareWorkerSecurityPolicy(modernConfig),
+        i18n: createI18nWorkerManifest(routeSpec, appContext),
         bff: isEffectApi && primaryBffPrefix && effectApiWorkerExists ? {
             runtimeFramework: 'effect',
             prefix: primaryBffPrefix,
@@ -476,7 +573,7 @@ const createCloudflarePreset = ({ appContext, modernConfig })=>{
             await fs.writeJSON(wranglerConfigPath, createWranglerConfig(appDirectory, modernConfig), {
                 spaces: 2
             });
-            await fs.writeJSON(workerManifestPath, await createWorkerManifest(outputDirectory, modernConfig), {
+            await fs.writeJSON(workerManifestPath, await createWorkerManifest(outputDirectory, modernConfig, appContext), {
                 spaces: 2
             });
             await fs.writeJSON(node_path.join(outputDirectory, OUTPUT_PACKAGE_FILE), {

package/dist/esm-node/plugins/deploy/platforms/templates/cloudflare-entry.mjs

@@ -223,6 +223,255 @@ function routeMatches(route, pathname) {
     const requestPath = normalizeRoutePath(pathname);
     return routePath === requestPath || '/' === routePath && route.isSSR || requestPath.startsWith(`${routePath}/`);
 }
+function getRouteI18nEntry(route) {
+    if (!route || 'string' != typeof route.entryName) return;
+    return MODERN_WORKER_MANIFEST.i18n?.entries?.[route.entryName];
+}
+function getRouteBasePath(route) {
+    const routePath = 'string' == typeof route?.urlPath ? normalizeRoutePath(route.urlPath) : '/';
+    return routePath || '/';
+}
+function getRouteRemainingPathname(route, pathname) {
+    const basePath = getRouteBasePath(route);
+    if ('/' === basePath) return pathname || '/';
+    if (!matchesPrefix(pathname, basePath)) return pathname || '/';
+    const remaining = pathname.slice(basePath.length);
+    return remaining ? remaining.startsWith('/') ? remaining : `/${remaining}` : '/';
+}
+function normalizeLanguage(value, languages) {
+    if ('string' != typeof value || '' === value.trim()) return null;
+    const normalized = value.trim().toLowerCase();
+    const exact = languages.find((language)=>language.toLowerCase() === normalized);
+    if (exact) return exact;
+    const baseLanguage = normalized.split(/[-_]/u)[0];
+    return languages.find((language)=>language.toLowerCase() === baseLanguage) || null;
+}
+function getLanguageFromPath(route, pathname, languages) {
+    const remainingPathname = getRouteRemainingPathname(route, pathname);
+    const firstSegment = remainingPathname.split('/').filter(Boolean)[0];
+    return normalizeLanguage(firstSegment, languages);
+}
+function safeDecodeURIComponent(value) {
+    try {
+        return decodeURIComponent(value);
+    } catch  {
+        return value;
+    }
+}
+function detectLanguageFromCookie(cookieHeader, lookupCookie, languages) {
+    if (!cookieHeader) return null;
+    for (const cookiePart of cookieHeader.split(';')){
+        const [rawName, ...rawValue] = cookiePart.trim().split('=');
+        if (rawName === lookupCookie && 0 !== rawValue.length) return normalizeLanguage(safeDecodeURIComponent(rawValue.join('=')), languages);
+    }
+    return null;
+}
+function detectLanguageFromAcceptLanguage(acceptLanguage, languages) {
+    if (!acceptLanguage) return null;
+    return acceptLanguage.split(',').map((entry, index)=>{
+        const [rawRange, ...rawParameters] = entry.trim().split(';');
+        const qualityParameter = rawParameters.find((parameter)=>parameter.trim().startsWith('q='));
+        const quality = qualityParameter ? Number.parseFloat(qualityParameter.split('=')[1] || '') : 1;
+        return {
+            index,
+            language: normalizeLanguage(rawRange, languages),
+            quality: Number.isFinite(quality) ? quality : 1
+        };
+    }).filter((candidate)=>candidate.language && candidate.quality > 0).sort((left, right)=>right.quality - left.quality || left.index - right.index)[0]?.language || null;
+}
+function detectRedirectLanguage(request, entry) {
+    if (!entry.i18nextDetector) return null;
+    const url = new URL(request.url);
+    const detection = entry.detection || {};
+    const order = Array.isArray(detection.order) ? detection.order : [
+        'querystring',
+        'cookie',
+        'header'
+    ];
+    for (const method of order){
+        const language = 'querystring' === method ? normalizeLanguage(url.searchParams.get(detection.lookupQuerystring || 'lng'), entry.languages) : 'cookie' === method ? detectLanguageFromCookie(request.headers.get('cookie'), detection.lookupCookie || 'i18next', entry.languages) : 'header' === method ? detectLanguageFromAcceptLanguage(request.headers.get(detection.lookupHeader || 'accept-language'), entry.languages) : null;
+        if (language) return language;
+    }
+    return null;
+}
+function normaliseSlashes(pathname) {
+    const withoutDuplicateSlashes = pathname.replace(/\/+/g, '/');
+    const withLeadingSlash = withoutDuplicateSlashes.startsWith('/') ? withoutDuplicateSlashes : `/${withoutDuplicateSlashes}`;
+    return withLeadingSlash.length > 1 ? withLeadingSlash.replace(/\/+$/u, '') : withLeadingSlash;
+}
+function normalisePathPattern(pathname) {
+    return normaliseSlashes(pathname).replace(/\[(.+?)\]/g, ':$1');
+}
+function stripLanguagePrefix(pathname, languages) {
+    const segments = pathname.split('/').filter(Boolean);
+    const firstSegment = segments[0];
+    if (firstSegment && normalizeLanguage(firstSegment, languages)) return `/${segments.slice(1).join('/')}` || '/';
+    return pathname || '/';
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function getPatternParamName(segment) {
+    return segment.slice(1).replace(/\?$/, '');
+}
+function compilePathPattern(pattern) {
+    const names = [];
+    const segments = normalisePathPattern(pattern).split('/').filter(Boolean);
+    const source = segments.map((segment)=>{
+        if (segment.startsWith(':')) {
+            names.push(getPatternParamName(segment));
+            return segment.endsWith('?') ? '(?:/([^/]+))?' : '/([^/]+)';
+        }
+        if ('*' === segment) {
+            names.push('*');
+            return '/(.*)';
+        }
+        return `/${escapeRegExp(segment)}`;
+    }).join('');
+    return {
+        names,
+        regexp: new RegExp(`^${source || '/'}$`)
+    };
+}
+function matchPathPattern(pathname, pattern) {
+    const { names, regexp } = compilePathPattern(pattern);
+    const match = regexp.exec(normaliseSlashes(pathname));
+    if (!match) return null;
+    const params = {};
+    for(let index = 0; index < names.length; index++)try {
+        params[names[index]] = decodeURIComponent(match[index + 1] || '');
+    } catch  {
+        return null;
+    }
+    return params;
+}
+function buildPathFromPattern(pattern, params) {
+    const path = normalisePathPattern(pattern).split('/').filter(Boolean).map((segment)=>{
+        if (segment.startsWith(':')) {
+            const param = params[getPatternParamName(segment)];
+            return param ? encodeURIComponent(param) : '';
+        }
+        if ('*' === segment) return params['*'] || '';
+        return segment;
+    }).filter(Boolean).join('/');
+    return `/${path}`;
+}
+function patternSpecificity(pattern) {
+    const segments = normalisePathPattern(pattern).split('/').filter(Boolean);
+    let staticSegments = 0;
+    let dynamicSegments = 0;
+    let splatSegments = 0;
+    for (const segment of segments)if ('*' === segment) splatSegments++;
+    else if (segment.startsWith(':')) dynamicSegments++;
+    else staticSegments++;
+    return {
+        dynamicSegments,
+        splatSegments,
+        staticSegments,
+        totalSegments: segments.length
+    };
+}
+function comparePatternSpecificity(left, right) {
+    const leftSpecificity = patternSpecificity(left);
+    const rightSpecificity = patternSpecificity(right);
+    return rightSpecificity.staticSegments - leftSpecificity.staticSegments || rightSpecificity.totalSegments - leftSpecificity.totalSegments || leftSpecificity.splatSegments - rightSpecificity.splatSegments || leftSpecificity.dynamicSegments - rightSpecificity.dynamicSegments;
+}
+function sortLocalisedPatterns(patterns) {
+    return patterns.map((pattern, index)=>({
+            pattern,
+            index
+        })).sort((left, right)=>comparePatternSpecificity(left.pattern.pattern, right.pattern.pattern) || left.index - right.index).map(({ pattern })=>pattern);
+}
+function resolveLocalisedPath(pathname, targetLanguage, languages, localisedUrls) {
+    const normalizedPathname = normaliseSlashes(pathname);
+    const canonicalCandidates = sortLocalisedPatterns(Object.entries(localisedUrls || {}).map(([canonicalPattern, localisedUrlEntry])=>({
+            canonicalPattern,
+            localisedUrlEntry,
+            pattern: canonicalPattern
+        })));
+    for (const { canonicalPattern, localisedUrlEntry } of canonicalCandidates){
+        const targetPattern = localisedUrlEntry[targetLanguage];
+        const params = targetPattern ? matchPathPattern(normalizedPathname, canonicalPattern) : null;
+        if (params) return buildPathFromPattern(targetPattern, params);
+    }
+    const localisedCandidates = sortLocalisedPatterns(Object.values(localisedUrls || {}).flatMap((localisedUrlEntry)=>{
+        const targetPattern = localisedUrlEntry[targetLanguage];
+        if (!targetPattern) return [];
+        return languages.map((language)=>localisedUrlEntry[language]).filter(Boolean).map((sourcePattern)=>({
+                pattern: sourcePattern,
+                sourcePattern,
+                targetPattern
+            }));
+    }));
+    for (const { sourcePattern, targetPattern } of localisedCandidates){
+        const params = matchPathPattern(normalizedPathname, sourcePattern);
+        if (params) return buildPathFromPattern(targetPattern, params);
+    }
+    return normalizedPathname;
+}
+function localiseTargetPathname(pathname, language, languages, localisedUrls) {
+    const pathWithoutLanguage = stripLanguagePrefix(pathname, languages);
+    const resolvedPath = localisedUrls ? resolveLocalisedPath(pathWithoutLanguage, language, languages, localisedUrls) : pathWithoutLanguage;
+    const resolvedSegments = resolvedPath.split('/').filter(Boolean);
+    return `/${[
+        language,
+        ...resolvedSegments
+    ].join('/')}`;
+}
+function shouldIgnoreLocaleRedirect(pathname, route, entry) {
+    const remainingPathname = getRouteRemainingPathname(route, pathname);
+    const normalizedPathname = remainingPathname.startsWith('/') ? remainingPathname : `/${remainingPathname}`;
+    const ignoredPrefixes = [
+        ...entry.ignoreRedirectRoutes || [],
+        ...entry.staticRoutePrefixes || [],
+        '/static',
+        '/upload'
+    ];
+    return ignoredPrefixes.some((prefix)=>{
+        const normalizedPrefix = normaliseSlashes(prefix);
+        return normalizedPathname === normalizedPrefix || normalizedPathname.startsWith(`${normalizedPrefix}/`);
+    });
+}
+function buildLocalizedUrl(route, request, language, entry) {
+    const url = new URL(request.url);
+    const basePath = getRouteBasePath(route);
+    const remainingPathname = getRouteRemainingPathname(route, url.pathname);
+    const localizedPathname = localiseTargetPathname(remainingPathname, language, entry.languages, entry.localisedUrls);
+    const nextPathname = '/' === basePath ? localizedPathname : normaliseSlashes(`${basePath}/${localizedPathname}`);
+    return `${nextPathname}${url.search}`;
+}
+function createLocaleRedirectResponse(location, entry) {
+    const headers = new Headers({
+        'cache-control': 'private, no-store',
+        location
+    });
+    const vary = [];
+    const detectionOrder = entry.i18nextDetector ? entry.detection?.order || [] : [];
+    if (detectionOrder.includes('header')) vary.push('Accept-Language');
+    if (detectionOrder.includes('cookie')) vary.push('Cookie');
+    if (vary.length > 0) headers.set('vary', vary.join(', '));
+    return new Response(null, {
+        headers,
+        status: 302
+    });
+}
+function createLocaleRedirectResponseForRequest(route, request) {
+    const entry = getRouteI18nEntry(route);
+    if (!entry || !Array.isArray(entry.languages) || 0 === entry.languages.length) return null;
+    const { pathname, search } = new URL(request.url);
+    if (isAssetLikePathname(pathname)) return null;
+    if (shouldIgnoreLocaleRedirect(pathname, route, entry)) return null;
+    const language = getLanguageFromPath(route, pathname, entry.languages);
+    if (!language) {
+        const targetLanguage = detectRedirectLanguage(request, entry) || entry.fallbackLanguage;
+        return createLocaleRedirectResponse(buildLocalizedUrl(route, request, targetLanguage, entry), entry);
+    }
+    if (entry.localisedUrls) {
+        const expectedUrl = buildLocalizedUrl(route, request, language, entry);
+        if (expectedUrl !== `${pathname}${search}`) return createLocaleRedirectResponse(expectedUrl, entry);
+    }
+    return null;
+}
 function findRoute(request) {
     const { pathname } = new URL(request.url);
     const routes = MODERN_WORKER_MANIFEST.routeSpec.routes;
@@ -565,6 +814,8 @@ export default {
                 status: 404
             }), request), request);
         }
+        const localeRedirectResponse = createLocaleRedirectResponseForRequest(route, request);
+        if (localeRedirectResponse) return finalizeResponseForRequest(withAppCorsHeaders(localeRedirectResponse, request), request);
         if (route?.worker) {
             const renderableRequest = createRenderableRequest(request);
             return finalizeResponseForRequest(withAppCorsHeaders(await dispatchRouteWorker(route, renderableRequest, env, ctx), request), request);

package/package.json

@@ -17,7 +17,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.5.0-ultramodern.17",
+  "version": "3.5.0-ultramodern.19",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/cjs/index.js",
   "exports": {
@@ -90,16 +90,16 @@
     "ndepe": "^0.1.13",
     "pkg-types": "^2.3.1",
     "std-env": "4.1.0",
-    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.5.0-ultramodern.17",
-    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.5.0-ultramodern.17",
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.5.0-ultramodern.17",
-    "@modern-js/plugin-data-loader": "npm:@bleedingdev/modern-js-plugin-data-loader@3.5.0-ultramodern.17",
-    "@modern-js/prod-server": "npm:@bleedingdev/modern-js-prod-server@3.5.0-ultramodern.17",
-    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.5.0-ultramodern.17",
-    "@modern-js/server": "npm:@bleedingdev/modern-js-server@3.5.0-ultramodern.17",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.5.0-ultramodern.17",
-    "@modern-js/server-utils": "npm:@bleedingdev/modern-js-server-utils@3.5.0-ultramodern.17",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.5.0-ultramodern.17"
+    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.5.0-ultramodern.19",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.5.0-ultramodern.19",
+    "@modern-js/plugin-data-loader": "npm:@bleedingdev/modern-js-plugin-data-loader@3.5.0-ultramodern.19",
+    "@modern-js/prod-server": "npm:@bleedingdev/modern-js-prod-server@3.5.0-ultramodern.19",
+    "@modern-js/server": "npm:@bleedingdev/modern-js-server@3.5.0-ultramodern.19",
+    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.5.0-ultramodern.19",
+    "@modern-js/server-utils": "npm:@bleedingdev/modern-js-server-utils@3.5.0-ultramodern.19",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.5.0-ultramodern.19",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.5.0-ultramodern.19",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.5.0-ultramodern.19"
   },
   "devDependencies": {
     "@rslib/core": "0.23.1",