@bleedingdev/modern-js-i18n-integration 0.0.0 → 3.9.0-ultramodern.10

package/dist/esm/federation/boundary.mjs

@@ -0,0 +1,62 @@
+import { jsx } from "react/jsx-runtime";
+import { ModernI18nContext, ModernI18nProvider, ReactI18nextProviderContext, getActualI18nextInstance } from "@modern-js/plugin-i18n/runtime/consumer";
+import { useContext, useMemo } from "react";
+const FederatedI18nBoundary = ({ children, defaultNamespace, fallbackLanguage, resources, supportedLanguages })=>{
+    const parent = useContext(ModernI18nContext);
+    const I18nextProvider = useContext(ReactI18nextProviderContext);
+    if (!parent) throw new Error('FederatedI18nBoundary must be used within ModernI18nProvider');
+    const languages = supportedLanguages ?? parent.languages ?? Object.keys(resources);
+    const scopedInstance = useMemo(()=>{
+        const parentInstance = getActualI18nextInstance(parent.i18nInstance);
+        const clone = parentInstance.cloneInstance?.({
+            defaultNS: defaultNamespace,
+            fallbackLng: fallbackLanguage ?? languages[0] ?? parent.language,
+            forkResourceStore: true,
+            initImmediate: false,
+            lng: parent.language,
+            ns: [
+                defaultNamespace
+            ],
+            resources,
+            supportedLngs: languages
+        });
+        if (!clone) throw new Error('FederatedI18nBoundary requires an i18n instance with cloneInstance support');
+        const resourceStore = clone.store;
+        const parentResourceStore = parentInstance.store;
+        const sharesNestedResourceState = Object.entries(resourceStore?.data ?? {}).some(([language, namespaces])=>{
+            const parentNamespaces = parentResourceStore?.data?.[language];
+            return namespaces === parentNamespaces || Object.entries(namespaces).some(([namespace, resource])=>null !== resource && 'object' == typeof resource && resource === parentNamespaces?.[namespace]);
+        });
+        if (clone === parentInstance || resourceStore === parentResourceStore || resourceStore?.data === parentResourceStore?.data || sharesNestedResourceState) throw new Error('FederatedI18nBoundary cloneInstance did not isolate the host resource store');
+        if (!resourceStore?.addResourceBundle || !clone.removeResourceBundle || !resourceStore.data) throw new Error('FederatedI18nBoundary requires an isolated mutable i18n resource store');
+        for (const [language, namespaces] of Object.entries(resourceStore.data))for (const namespace of Object.keys(namespaces))clone.removeResourceBundle(language, namespace);
+        for (const [language, namespaces] of Object.entries(resources))for (const [namespace, resource] of Object.entries(namespaces))resourceStore.addResourceBundle(language, namespace, resource, true, true);
+        return clone;
+    }, [
+        defaultNamespace,
+        fallbackLanguage,
+        languages,
+        parent.i18nInstance,
+        parent.language,
+        resources
+    ]);
+    const value = useMemo(()=>({
+            ...parent,
+            i18nInstance: scopedInstance,
+            language: parent.language,
+            languages
+        }), [
+        languages,
+        parent,
+        scopedInstance
+    ]);
+    const scopedContent = /*#__PURE__*/ jsx(ModernI18nProvider, {
+        value: value,
+        children: children
+    });
+    return I18nextProvider ? /*#__PURE__*/ jsx(I18nextProvider, {
+        i18n: scopedInstance,
+        children: scopedContent
+    }) : scopedContent;
+};
+export { FederatedI18nBoundary };

package/dist/esm/federation/registration.mjs

@@ -0,0 +1,5 @@
+import { FederatedI18nBoundary } from "./boundary.mjs";
+function registerFederatedI18nBoundary(api) {
+    api.resolveComponent((component, { name })=>'i18n.FederatedI18nBoundary' === name ? FederatedI18nBoundary : component);
+}
+export { registerFederatedI18nBoundary };

package/dist/esm/languageSynchronization.mjs

@@ -0,0 +1,6 @@
+import { useLanguageSync } from "@modern-js/i18n-runtime-extensions";
+const I18nLanguageSynchronization = ({ i18nInstance, localePathRedirect, languages, pathname, prevLangRef, setLang, children })=>{
+    const synchronizeLanguage = useLanguageSync(i18nInstance, localePathRedirect, languages, pathname, prevLangRef, setLang);
+    return children(synchronizeLanguage);
+};
+export { I18nLanguageSynchronization };

package/dist/esm/navigation.mjs

@@ -0,0 +1 @@
+export { I18nRouterNavigationProvider, useIntegratedRouterAdapter } from "@modern-js/plugin-i18n/runtime/no-react-i18next";

package/dist/esm/runtime-no-react-i18next.mjs

@@ -0,0 +1,6 @@
+import { i18nPlugin } from "@modern-js/plugin-i18n/runtime/no-react-i18next";
+import { composeI18nPlugin } from "./runtimeComposition.mjs";
+const runtime_no_react_i18next_i18nPlugin = composeI18nPlugin(i18nPlugin);
+const runtime_no_react_i18next = runtime_no_react_i18next_i18nPlugin;
+export default runtime_no_react_i18next;
+export { runtime_no_react_i18next_i18nPlugin as i18nPlugin };

package/dist/esm/runtime.mjs

@@ -0,0 +1,6 @@
+import { i18nPlugin } from "@modern-js/plugin-i18n/runtime";
+import { composeI18nPlugin } from "./runtimeComposition.mjs";
+const runtime_i18nPlugin = composeI18nPlugin(i18nPlugin);
+const runtime = runtime_i18nPlugin;
+export default runtime;
+export { runtime_i18nPlugin as i18nPlugin };

package/dist/esm/runtimeComposition.mjs

@@ -0,0 +1,22 @@
+import { registerFederatedI18nBoundary } from "./federation/registration.mjs";
+import { I18nLanguageSynchronization } from "./languageSynchronization.mjs";
+import { I18nRouterNavigationProvider } from "./navigation.mjs";
+import { createI18nUrlStrategy } from "./urlStrategy.mjs";
+const composeI18nPlugin = (nativeI18nPlugin)=>(options = {})=>{
+        const { localisedUrls, localeDetectionByEntry: _entryOptions, ...nativeLocaleDetection } = options.localeDetection ?? {};
+        const native = nativeI18nPlugin({
+            ...options,
+            localeDetection: nativeLocaleDetection,
+            urlStrategy: options.urlStrategy ?? createI18nUrlStrategy(localisedUrls),
+            NavigationProvider: options.NavigationProvider ?? I18nRouterNavigationProvider,
+            LanguageSynchronization: options.LanguageSynchronization ?? I18nLanguageSynchronization
+        });
+        return {
+            ...native,
+            setup (api) {
+                registerFederatedI18nBoundary(api);
+                return native.setup?.(api);
+            }
+        };
+    };
+export { composeI18nPlugin };

package/dist/esm/server.mjs

@@ -0,0 +1,10 @@
+import { getLocaleDetectionOptions } from "@modern-js/plugin-i18n/config";
+import { i18nServerPlugin } from "@modern-js/plugin-i18n/server";
+import { createI18nUrlStrategy } from "./urlStrategy.mjs";
+const server_i18nServerPlugin = (options)=>i18nServerPlugin({
+        ...options,
+        resolveUrlStrategy: options.resolveUrlStrategy ?? ((entryName)=>createI18nUrlStrategy(options.localeDetection ? getLocaleDetectionOptions(entryName, options.localeDetection).localisedUrls : void 0))
+    });
+const server = server_i18nServerPlugin;
+export default server;
+export { server_i18nServerPlugin as i18nServerPlugin };

package/dist/esm/urlStrategy.mjs

@@ -0,0 +1,13 @@
+import { canonicalTargetPathname, isDefaultLocaleRedirectSkipPath, localiseTargetPathname } from "@modern-js/i18n-runtime-extensions";
+const createI18nUrlStrategy = (localisedUrls)=>({
+        localizePathname: (pathname, language, languages)=>localiseTargetPathname(pathname, language, [
+                ...languages
+            ], localisedUrls),
+        canonicalPathname: (pathname, languages)=>canonicalTargetPathname(pathname, [
+                ...languages
+            ], localisedUrls),
+        shouldSkipRedirect: (pathname, languages)=>isDefaultLocaleRedirectSkipPath(pathname, [
+                ...languages
+            ])
+    });
+export { createI18nUrlStrategy };

package/dist/esm-node/cli.mjs

@@ -0,0 +1,32 @@
+import "node:module";
+const runtimePaths = new Map([
+    [
+        '@modern-js/plugin-i18n/runtime',
+        '@modern-js/i18n-integration/runtime'
+    ],
+    [
+        '@modern-js/plugin-i18n/runtime/no-react-i18next',
+        '@modern-js/i18n-integration/runtime/no-react-i18next'
+    ]
+]);
+const ultramodernI18nIntegrationPlugin = ()=>({
+        name: '@modern-js/i18n-integration',
+        pre: [
+            '@modern-js/plugin-i18n'
+        ],
+        setup (api) {
+            api._internalRuntimePlugins(({ entrypoint, plugins })=>({
+                    entrypoint,
+                    plugins: plugins.map((plugin)=>{
+                        const path = runtimePaths.get(plugin.path);
+                        return path ? {
+                            ...plugin,
+                            path
+                        } : plugin;
+                    })
+                }));
+        }
+    });
+const cli = ultramodernI18nIntegrationPlugin;
+export default cli;
+export { ultramodernI18nIntegrationPlugin };

package/dist/esm-node/federation/boundary.mjs

@@ -0,0 +1,63 @@
+import "node:module";
+import { jsx } from "react/jsx-runtime";
+import { ModernI18nContext, ModernI18nProvider, ReactI18nextProviderContext, getActualI18nextInstance } from "@modern-js/plugin-i18n/runtime/consumer";
+import { useContext, useMemo } from "react";
+const FederatedI18nBoundary = ({ children, defaultNamespace, fallbackLanguage, resources, supportedLanguages })=>{
+    const parent = useContext(ModernI18nContext);
+    const I18nextProvider = useContext(ReactI18nextProviderContext);
+    if (!parent) throw new Error('FederatedI18nBoundary must be used within ModernI18nProvider');
+    const languages = supportedLanguages ?? parent.languages ?? Object.keys(resources);
+    const scopedInstance = useMemo(()=>{
+        const parentInstance = getActualI18nextInstance(parent.i18nInstance);
+        const clone = parentInstance.cloneInstance?.({
+            defaultNS: defaultNamespace,
+            fallbackLng: fallbackLanguage ?? languages[0] ?? parent.language,
+            forkResourceStore: true,
+            initImmediate: false,
+            lng: parent.language,
+            ns: [
+                defaultNamespace
+            ],
+            resources,
+            supportedLngs: languages
+        });
+        if (!clone) throw new Error('FederatedI18nBoundary requires an i18n instance with cloneInstance support');
+        const resourceStore = clone.store;
+        const parentResourceStore = parentInstance.store;
+        const sharesNestedResourceState = Object.entries(resourceStore?.data ?? {}).some(([language, namespaces])=>{
+            const parentNamespaces = parentResourceStore?.data?.[language];
+            return namespaces === parentNamespaces || Object.entries(namespaces).some(([namespace, resource])=>null !== resource && 'object' == typeof resource && resource === parentNamespaces?.[namespace]);
+        });
+        if (clone === parentInstance || resourceStore === parentResourceStore || resourceStore?.data === parentResourceStore?.data || sharesNestedResourceState) throw new Error('FederatedI18nBoundary cloneInstance did not isolate the host resource store');
+        if (!resourceStore?.addResourceBundle || !clone.removeResourceBundle || !resourceStore.data) throw new Error('FederatedI18nBoundary requires an isolated mutable i18n resource store');
+        for (const [language, namespaces] of Object.entries(resourceStore.data))for (const namespace of Object.keys(namespaces))clone.removeResourceBundle(language, namespace);
+        for (const [language, namespaces] of Object.entries(resources))for (const [namespace, resource] of Object.entries(namespaces))resourceStore.addResourceBundle(language, namespace, resource, true, true);
+        return clone;
+    }, [
+        defaultNamespace,
+        fallbackLanguage,
+        languages,
+        parent.i18nInstance,
+        parent.language,
+        resources
+    ]);
+    const value = useMemo(()=>({
+            ...parent,
+            i18nInstance: scopedInstance,
+            language: parent.language,
+            languages
+        }), [
+        languages,
+        parent,
+        scopedInstance
+    ]);
+    const scopedContent = /*#__PURE__*/ jsx(ModernI18nProvider, {
+        value: value,
+        children: children
+    });
+    return I18nextProvider ? /*#__PURE__*/ jsx(I18nextProvider, {
+        i18n: scopedInstance,
+        children: scopedContent
+    }) : scopedContent;
+};
+export { FederatedI18nBoundary };

package/dist/esm-node/federation/registration.mjs

@@ -0,0 +1,6 @@
+import "node:module";
+import { FederatedI18nBoundary } from "./boundary.mjs";
+function registerFederatedI18nBoundary(api) {
+    api.resolveComponent((component, { name })=>'i18n.FederatedI18nBoundary' === name ? FederatedI18nBoundary : component);
+}
+export { registerFederatedI18nBoundary };

package/dist/esm-node/languageSynchronization.mjs

@@ -0,0 +1,7 @@
+import "node:module";
+import { useLanguageSync } from "@modern-js/i18n-runtime-extensions";
+const I18nLanguageSynchronization = ({ i18nInstance, localePathRedirect, languages, pathname, prevLangRef, setLang, children })=>{
+    const synchronizeLanguage = useLanguageSync(i18nInstance, localePathRedirect, languages, pathname, prevLangRef, setLang);
+    return children(synchronizeLanguage);
+};
+export { I18nLanguageSynchronization };

package/dist/esm-node/navigation.mjs

@@ -0,0 +1,2 @@
+import "node:module";
+export { I18nRouterNavigationProvider, useIntegratedRouterAdapter } from "@modern-js/plugin-i18n/runtime/no-react-i18next";

package/dist/esm-node/options.mjs

@@ -0,0 +1 @@
+import "node:module";

package/dist/esm-node/runtime-no-react-i18next.mjs

@@ -0,0 +1,7 @@
+import "node:module";
+import { i18nPlugin } from "@modern-js/plugin-i18n/runtime/no-react-i18next";
+import { composeI18nPlugin } from "./runtimeComposition.mjs";
+const runtime_no_react_i18next_i18nPlugin = composeI18nPlugin(i18nPlugin);
+const runtime_no_react_i18next = runtime_no_react_i18next_i18nPlugin;
+export default runtime_no_react_i18next;
+export { runtime_no_react_i18next_i18nPlugin as i18nPlugin };

package/dist/esm-node/runtime.mjs

@@ -0,0 +1,7 @@
+import "node:module";
+import { i18nPlugin } from "@modern-js/plugin-i18n/runtime";
+import { composeI18nPlugin } from "./runtimeComposition.mjs";
+const runtime_i18nPlugin = composeI18nPlugin(i18nPlugin);
+const runtime = runtime_i18nPlugin;
+export default runtime;
+export { runtime_i18nPlugin as i18nPlugin };

package/dist/esm-node/runtimeComposition.mjs

@@ -0,0 +1,23 @@
+import "node:module";
+import { registerFederatedI18nBoundary } from "./federation/registration.mjs";
+import { I18nLanguageSynchronization } from "./languageSynchronization.mjs";
+import { I18nRouterNavigationProvider } from "./navigation.mjs";
+import { createI18nUrlStrategy } from "./urlStrategy.mjs";
+const composeI18nPlugin = (nativeI18nPlugin)=>(options = {})=>{
+        const { localisedUrls, localeDetectionByEntry: _entryOptions, ...nativeLocaleDetection } = options.localeDetection ?? {};
+        const native = nativeI18nPlugin({
+            ...options,
+            localeDetection: nativeLocaleDetection,
+            urlStrategy: options.urlStrategy ?? createI18nUrlStrategy(localisedUrls),
+            NavigationProvider: options.NavigationProvider ?? I18nRouterNavigationProvider,
+            LanguageSynchronization: options.LanguageSynchronization ?? I18nLanguageSynchronization
+        });
+        return {
+            ...native,
+            setup (api) {
+                registerFederatedI18nBoundary(api);
+                return native.setup?.(api);
+            }
+        };
+    };
+export { composeI18nPlugin };

package/dist/esm-node/server.mjs

@@ -0,0 +1,11 @@
+import "node:module";
+import { getLocaleDetectionOptions } from "@modern-js/plugin-i18n/config";
+import { i18nServerPlugin } from "@modern-js/plugin-i18n/server";
+import { createI18nUrlStrategy } from "./urlStrategy.mjs";
+const server_i18nServerPlugin = (options)=>i18nServerPlugin({
+        ...options,
+        resolveUrlStrategy: options.resolveUrlStrategy ?? ((entryName)=>createI18nUrlStrategy(options.localeDetection ? getLocaleDetectionOptions(entryName, options.localeDetection).localisedUrls : void 0))
+    });
+const server = server_i18nServerPlugin;
+export default server;
+export { server_i18nServerPlugin as i18nServerPlugin };

package/dist/esm-node/urlStrategy.mjs

@@ -0,0 +1,14 @@
+import "node:module";
+import { canonicalTargetPathname, isDefaultLocaleRedirectSkipPath, localiseTargetPathname } from "@modern-js/i18n-runtime-extensions";
+const createI18nUrlStrategy = (localisedUrls)=>({
+        localizePathname: (pathname, language, languages)=>localiseTargetPathname(pathname, language, [
+                ...languages
+            ], localisedUrls),
+        canonicalPathname: (pathname, languages)=>canonicalTargetPathname(pathname, [
+                ...languages
+            ], localisedUrls),
+        shouldSkipRedirect: (pathname, languages)=>isDefaultLocaleRedirectSkipPath(pathname, [
+                ...languages
+            ])
+    });
+export { createI18nUrlStrategy };

package/dist/types/cli.d.ts

@@ -0,0 +1,4 @@
+import type { AppTools, CliPlugin } from '@modern-js/app-tools';
+/** Compose fork policy with the native plugin's own descriptor generation. */
+export declare const ultramodernI18nIntegrationPlugin: () => CliPlugin<AppTools>;
+export default ultramodernI18nIntegrationPlugin;

package/dist/types/federation/boundary.d.ts

@@ -0,0 +1,9 @@
+import { type FederatedI18nBoundaryProps } from '@modern-js/plugin-i18n/runtime/consumer';
+import { type FC } from 'react';
+export type { FederatedI18nBoundaryProps } from '@modern-js/plugin-i18n/runtime/consumer';
+/**
+ * Keeps a federated surface's translation resources inside its delivery unit.
+ * The host supplies only the active language; the remote owns and versions the
+ * resources used below this boundary.
+ */
+export declare const FederatedI18nBoundary: FC<FederatedI18nBoundaryProps>;

package/dist/types/federation/registration.d.ts

@@ -0,0 +1,2 @@
+import type { RuntimePluginAPI } from '@modern-js/plugin/runtime';
+export declare function registerFederatedI18nBoundary(api: RuntimePluginAPI<{}>): void;

package/dist/types/languageSynchronization.d.ts

@@ -0,0 +1,3 @@
+import type { I18nLanguageSynchronizationProps } from '@modern-js/plugin-i18n/runtime/no-react-i18next';
+/** Bind the shared controller to this native provider's instance and state. */
+export declare const I18nLanguageSynchronization: ({ i18nInstance, localePathRedirect, languages, pathname, prevLangRef, setLang, children, }: I18nLanguageSynchronizationProps) => import("react").ReactNode;

package/dist/types/navigation.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The selected-router navigation adapter now lives in
+ * `@modern-js/plugin-i18n`, so a bare `appTools() + i18nPlugin()` app gets
+ * mapped `<Link>` navigation and language-invariant active state without this
+ * integration package. Re-exported here so the composed
+ * `ultramodernI18nIntegrationPlugin` keeps its own entry point and any consumer
+ * importing it from this package continues to work.
+ */
+export { I18nRouterNavigationProvider, useIntegratedRouterAdapter, } from '@modern-js/plugin-i18n/runtime/no-react-i18next';

package/dist/types/options.d.ts

@@ -0,0 +1,13 @@
+import type { LocalisedUrlsOption } from '@modern-js/i18n-runtime-extensions';
+import type { I18nPluginOptions as NativeRuntimeOptions } from '@modern-js/plugin-i18n/runtime/no-react-i18next';
+import type { I18nPluginOptions as NativeServerOptions } from '@modern-js/plugin-i18n/server';
+export type IntegratedLocaleDetectionOptions = NonNullable<NativeRuntimeOptions['localeDetection']> & {
+    localisedUrls?: LocalisedUrlsOption;
+    localeDetectionByEntry?: Record<string, IntegratedLocaleDetectionOptions>;
+};
+export type I18nPluginOptions = NativeRuntimeOptions & {
+    localeDetection?: IntegratedLocaleDetectionOptions;
+};
+export type I18nServerPluginOptions = NativeServerOptions & {
+    localeDetection: IntegratedLocaleDetectionOptions;
+};

package/dist/types/runtime-no-react-i18next.d.ts

@@ -0,0 +1,2 @@
+export declare const i18nPlugin: (options?: import("./options.js").I18nPluginOptions) => import("@modern-js/runtime").RuntimePlugin;
+export default i18nPlugin;

package/dist/types/runtime.d.ts

@@ -0,0 +1,2 @@
+export declare const i18nPlugin: (options?: import("./options.js").I18nPluginOptions) => import("@modern-js/runtime").RuntimePlugin;
+export default i18nPlugin;

package/dist/types/runtimeComposition.d.ts

@@ -0,0 +1,4 @@
+import type { I18nPluginOptions as NativeI18nPluginOptions } from '@modern-js/plugin-i18n/runtime/no-react-i18next';
+import type { RuntimePlugin } from '@modern-js/runtime';
+import type { I18nPluginOptions } from './options.js';
+export declare const composeI18nPlugin: (nativeI18nPlugin: (options: NativeI18nPluginOptions) => RuntimePlugin) => (options?: I18nPluginOptions) => RuntimePlugin;

package/dist/types/server.d.ts

@@ -0,0 +1,3 @@
+import type { I18nServerPluginOptions } from './options.js';
+export declare const i18nServerPlugin: (options: I18nServerPluginOptions) => import("@modern-js/server-core").ServerPlugin;
+export default i18nServerPlugin;

package/dist/types/urlStrategy.d.ts

@@ -0,0 +1,4 @@
+import { type LocalisedUrlsOption } from '@modern-js/i18n-runtime-extensions';
+import type { I18nUrlStrategy } from '@modern-js/plugin-i18n/runtime/no-react-i18next';
+/** Each integration owns its map; no process-wide configuration is installed. */
+export declare const createI18nUrlStrategy: (localisedUrls?: LocalisedUrlsOption) => I18nUrlStrategy;

package/package.json

@@ -1,16 +1,150 @@
 {
   "name": "@bleedingdev/modern-js-i18n-integration",
-  "version": "0.0.0",
-  "description": "Package-name registration for the forthcoming UltraModern.js release. This setup version contains no runtime implementation.",
-  "license": "MIT",
+  "description": "UltraModern.js localized routing and federated resource integration through native Modern.js i18n plugins.",
+  "homepage": "https://github.com/BleedingDev/ultramodern.js#readme",
+  "bugs": {
+    "url": "https://github.com/BleedingDev/ultramodern.js/issues"
+  },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/BleedingDev/ultramodern.js.git"
+    "url": "git+https://github.com/BleedingDev/ultramodern.js.git",
+    "directory": "packages/runtime/i18n-integration"
   },
+  "license": "MIT",
+  "version": "3.9.0-ultramodern.10",
   "files": [
-    "README.md"
+    "dist",
+    "src"
   ],
+  "engines": {
+    "node": ">=26.7.0"
+  },
+  "types": "./dist/types/cli.d.ts",
+  "main": "./dist/cjs/cli.js",
+  "exports": {
+    ".": {
+      "types": "./dist/types/cli.d.ts",
+      "node": {
+        "import": "./dist/esm-node/cli.mjs",
+        "require": "./dist/cjs/cli.js"
+      },
+      "default": "./dist/cjs/cli.js"
+    },
+    "./cli": {
+      "types": "./dist/types/cli.d.ts",
+      "node": {
+        "import": "./dist/esm-node/cli.mjs",
+        "require": "./dist/cjs/cli.js"
+      },
+      "default": "./dist/cjs/cli.js"
+    },
+    "./runtime": {
+      "types": "./dist/types/runtime.d.ts",
+      "node": {
+        "import": "./dist/esm-node/runtime.mjs",
+        "require": "./dist/cjs/runtime.js"
+      },
+      "default": "./dist/esm/runtime.mjs"
+    },
+    "./runtime/no-react-i18next": {
+      "types": "./dist/types/runtime-no-react-i18next.d.ts",
+      "node": {
+        "import": "./dist/esm-node/runtime-no-react-i18next.mjs",
+        "require": "./dist/cjs/runtime-no-react-i18next.js"
+      },
+      "default": "./dist/esm/runtime-no-react-i18next.mjs"
+    },
+    "./server": {
+      "types": "./dist/types/server.d.ts",
+      "node": {
+        "import": "./dist/esm-node/server.mjs",
+        "require": "./dist/cjs/server.js"
+      },
+      "default": "./dist/cjs/server.js"
+    },
+    "./federation": {
+      "types": "./dist/types/federation/boundary.d.ts",
+      "node": {
+        "import": "./dist/esm-node/federation/boundary.mjs",
+        "require": "./dist/cjs/federation/boundary.js"
+      },
+      "default": "./dist/esm/federation/boundary.mjs"
+    },
+    "./package.json": "./package.json",
+    "./options": {
+      "types": "./dist/types/options.d.ts",
+      "node": {
+        "import": "./dist/esm-node/options.mjs",
+        "require": "./dist/cjs/options.js"
+      },
+      "default": "./dist/esm/options.mjs"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/types/cli.d.ts"
+      ],
+      "cli": [
+        "./dist/types/cli.d.ts"
+      ],
+      "runtime": [
+        "./dist/types/runtime.d.ts"
+      ],
+      "runtime/no-react-i18next": [
+        "./dist/types/runtime-no-react-i18next.d.ts"
+      ],
+      "server": [
+        "./dist/types/server.d.ts"
+      ],
+      "federation": [
+        "./dist/types/federation/boundary.d.ts"
+      ],
+      "options": [
+        "./dist/types/options.d.ts"
+      ]
+    }
+  },
+  "dependencies": {
+    "@modern-js/i18n-runtime-extensions": "npm:@bleedingdev/modern-js-i18n-runtime-extensions@3.9.0-ultramodern.10",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.0-ultramodern.10",
+    "@modern-js/plugin-i18n": "npm:@bleedingdev/modern-js-plugin-i18n@3.9.0-ultramodern.10",
+    "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.0-ultramodern.10",
+    "@modern-js/server-runtime": "npm:@bleedingdev/modern-js-server-runtime@3.9.0-ultramodern.10",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.10"
+  },
+  "peerDependencies": {
+    "@modern-js/app-tools": "3.9.0-ultramodern.10",
+    "@modern-js/runtime": "3.9.0-ultramodern.10",
+    "react": "^19.2.8"
+  },
+  "peerDependenciesMeta": {},
+  "optionalDependencies": {},
+  "devDependencies": {
+    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.9.0-ultramodern.10",
+    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.9.0-ultramodern.10",
+    "@modern-js/tsconfig": "npm:@bleedingdev/modern-js-tsconfig@3.9.0-ultramodern.10",
+    "@rslib/core": "1.0.0",
+    "@rstest/core": "0.11.12",
+    "@scripts/rstest-config": "2.66.0",
+    "@types/node": "^26.4.1",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.7",
+    "@typescript/native-preview": "7.0.0-dev.20260707.2",
+    "esbuild": "^0.28.2",
+    "i18next": "26.4.2",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "react-i18next": "17.0.13",
+    "typescript": "^7.0.2"
+  },
+  "sideEffects": false,
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "dev": "rslib build --watch",
+    "build": "rslib build",
+    "test": "rstest"
   }
 }

package/src/cli.ts

@@ -0,0 +1,38 @@
+import type { AppTools, CliPlugin } from '@modern-js/app-tools';
+
+const runtimePaths = new Map([
+  ['@modern-js/plugin-i18n/runtime', '@modern-js/i18n-integration/runtime'],
+  [
+    '@modern-js/plugin-i18n/runtime/no-react-i18next',
+    '@modern-js/i18n-integration/runtime/no-react-i18next',
+  ],
+]);
+
+/** Compose fork policy with the native plugin's own descriptor generation. */
+export const ultramodernI18nIntegrationPlugin = (): CliPlugin<AppTools> => ({
+  name: '@modern-js/i18n-integration',
+  pre: ['@modern-js/plugin-i18n'],
+  setup(api) {
+    api._internalRuntimePlugins(({ entrypoint, plugins }) => ({
+      entrypoint,
+      plugins: plugins.map(plugin => {
+        const path = runtimePaths.get(plugin.path);
+        return path ? { ...plugin, path } : plugin;
+      }),
+    }));
+
+    // The native server plugin derives its URL policy from
+    // `localeDetection.localisedUrls` on its own, so the descriptor is left
+    // alone. Rewriting it to `@modern-js/i18n-integration/server` would make
+    // the server unbootable for an app that only declares
+    // `@modern-js/ultramodern-app-tools`.
+
+    // Localised route generation used to live here. It now ships in
+    // `@modern-js/plugin-i18n`'s own CLI plugin so a bare `appTools()`
+    // consumer gets it too; registering it in both places would expand the
+    // route tree twice. This plugin keeps only the fork's runtime-module
+    // swap, which is the part that genuinely needs the integration runtime.
+  },
+});
+
+export default ultramodernI18nIntegrationPlugin;