@intlayer/engine 9.5.9 → 9.5.10

package/dist/cjs/init/index.cjs

@@ -4,146 +4,27 @@ const require_init_utils_configManipulation = require('./utils/configManipulatio
 const require_init_utils_fileSystem = require('./utils/fileSystem.cjs');
 const require_init_cms = require('./cms.cjs');
 const require_initConfig_index = require('../initConfig/index.cjs');
+const require_init_documentationRouter = require('./documentationRouter.cjs');
 const require_init_frameworkSetup_index = require('./frameworkSetup/index.cjs');
 const require_init_utils_devScript = require('./utils/devScript.cjs');
 const require_init_utils_packageManager = require('./utils/packageManager.cjs');
 const require_init_utils_githubActions = require('./utils/githubActions.cjs');
 const require_init_utils_jsonParser = require('./utils/jsonParser.cjs');
+const require_init_utils_lintConfig = require('./utils/lintConfig.cjs');
 const require_init_utils_nextCompilerBabel = require('./utils/nextCompilerBabel.cjs');
 const require_init_utils_tsConfig = require('./utils/tsConfig.cjs');
+const require_init_utils_urlRoutingFramework = require('./utils/urlRoutingFramework.cjs');
 const require_init_upgradeIntlayerPackages = require('./upgradeIntlayerPackages.cjs');
 let node_path = require("node:path");
 let _intlayer_config_colors = require("@intlayer/config/colors");
 _intlayer_config_colors = require_runtime.__toESM(_intlayer_config_colors);
 let _intlayer_config_logger = require("@intlayer/config/logger");
 let _intlayer_config_node = require("@intlayer/config/node");
+let _intlayer_config_defaultValues = require("@intlayer/config/defaultValues");
 let _intlayer_config_utils = require("@intlayer/config/utils");
 
 //#region src/init/index.ts
 /**
-* Documentation URL Constants
-*/
-const DocumentationRouter = {
-	NextJS: "https://intlayer.org/doc/environment/nextjs.md",
-	NextJS_15: "https://intlayer.org/doc/environment/nextjs/15.md",
-	NextJS_14: "https://intlayer.org/doc/environment/nextjs/14.md",
-	CRA: "https://intlayer.org/doc/environment/create-react-app.md",
-	Astro: "https://intlayer.org/doc/environment/astro.md",
-	ViteAndReact: "https://intlayer.org/doc/environment/vite-and-react.md",
-	ViteAndReact_ReactRouterV7: "https://intlayer.org/doc/environment/vite-and-react/react-router-v7.md",
-	ViteAndVue: "https://intlayer.org/doc/environment/vite-and-vue.md",
-	ViteAndSolid: "https://intlayer.org/doc/environment/vite-and-solid.md",
-	ViteAndSvelte: "https://intlayer.org/doc/environment/vite-and-svelte.md",
-	ViteAndPreact: "https://intlayer.org/doc/environment/vite-and-preact.md",
-	ViteAndLit: "https://intlayer.org/doc/environment/vite-and-lit.md",
-	ViteAndVanilla: "https://intlayer.org/doc/environment/vite-and-vanilla.md",
-	Vanilla: "https://intlayer.org/doc/environment/vanilla.md",
-	TanStackRouter: "https://intlayer.org/doc/environment/tanstack-start.md",
-	TanStackRouterAndSolid: "https://intlayer.org/doc/environment/tanstack-start/solid.md",
-	SolidStart: "https://intlayer.org/doc/environment/solid-start.md",
-	Analog: "https://intlayer.org/doc/environment/analog.md",
-	Remix: "https://intlayer.org/doc/environment/remix-3.md",
-	NuxtAndVue: "https://intlayer.org/doc/environment/nuxt-and-vue.md",
-	Angular: "https://intlayer.org/doc/environment/angular.md",
-	SvelteKit: "https://intlayer.org/doc/environment/sveltekit.md",
-	ReactNativeAndExpo: "https://intlayer.org/doc/environment/react-native-and-expo.md",
-	Lynx: "https://intlayer.org/doc/environment/lynx-and-react.md",
-	Express: "https://intlayer.org/doc/environment/express.md",
-	NestJS: "https://intlayer.org/doc/environment/nest.md",
-	Fastify: "https://intlayer.org/doc/environment/fastify.md",
-	Hono: "https://intlayer.org/doc/environment/hono.md",
-	AdonisJS: "https://intlayer.org/doc/environment/adonisjs.md",
-	Elysia: "https://intlayer.org/doc/environment/elysia.md",
-	Default: "https://intlayer.org/doc/get-started",
-	LSP: "https://intlayer.org/doc/lsp.md",
-	ESLint: "https://intlayer.org/doc/eslint.md",
-	NextIntl: "https://intlayer.org/blog/intlayer-with-next-intl.md",
-	ReactI18Next: "https://intlayer.org/blog/intlayer-with-react-i18next.md",
-	ReactIntl: "https://intlayer.org/blog/intlayer-with-react-intl.md",
-	NextI18Next: "https://intlayer.org/blog/intlayer-with-next-i18next.md",
-	VueI18n: "https://intlayer.org/blog/intlayer-with-vue-i18n.md"
-};
-/**
-* The Intlayer lint setup, as `intlayer init` writes it into `.oxlintrc.json`.
-*
-* Declared locally on purpose: `@intlayer/engine` is installed by every Intlayer
-* user, so it must not depend on a lint plugin to write a handful of strings
-* into a JSON file. oxlint resolves a plugin's *rules* but not its shipped
-* *configs*, so the preset cannot be referenced by name there either.
-*
-* Mirrors the `recommended` preset of `eslint-plugin-intlayer`; keep in sync
-* when a rule is enabled by default there.
-*/
-const LINT_PLUGIN_PACKAGE_NAME = "eslint-plugin-intlayer";
-/** Intlayer's generated output — never source, never worth linting. */
-const GENERATED_OUTPUT_GLOBS = ["**/.intlayer/**"];
-/** Rules of the `recommended` preset, prefixed by the plugin namespace. */
-const getRecommendedRules = () => ({
-	"intlayer/no-raw-text": "warn",
-	"intlayer/static-dictionary-key": "error",
-	"intlayer/no-dynamic-field-access": "error"
-});
-/**
-* Helper: Detects the environment and returns the doc URL
-*/
-const getDocumentationUrl = (packageJson) => {
-	const deps = {
-		...packageJson.dependencies,
-		...packageJson.devDependencies
-	};
-	/**
-	* Helper to check if a version string matches a specific major version
-	* Matches: "15", "^15.0.0", "~15.2", "15.0.0-beta"
-	*/
-	const isVersion = (versionString, major) => {
-		if (!versionString || typeof versionString !== "string") return false;
-		return new RegExp(`^[\\^~]?${major}(?:\\.|$)`).test(versionString);
-	};
-	if (deps["@lynx-js/react"] || deps["@lynx-js/core"]) return DocumentationRouter.Lynx;
-	if (deps["react-native"] || deps.expo) return DocumentationRouter.ReactNativeAndExpo;
-	if (deps.next) {
-		const version = deps.next;
-		if (isVersion(version, 14)) return DocumentationRouter.NextJS_14;
-		if (isVersion(version, 15)) return DocumentationRouter.NextJS_15;
-		return DocumentationRouter.NextJS;
-	}
-	if (deps.nuxt) return DocumentationRouter.NuxtAndVue;
-	if (deps.astro) return DocumentationRouter.Astro;
-	if (deps["@sveltejs/kit"]) return DocumentationRouter.SvelteKit;
-	if (deps["@analogjs/platform"]) return DocumentationRouter.Analog;
-	if (deps["@solidjs/start"]) return DocumentationRouter.SolidStart;
-	if (deps.remix || deps["remix-intlayer"]) return DocumentationRouter.Remix;
-	if (deps["@tanstack/react-router"]) return DocumentationRouter.TanStackRouter;
-	if (deps["@tanstack/solid-router"]) return DocumentationRouter.TanStackRouterAndSolid;
-	const reactRouterVersion = deps["react-router"];
-	if (typeof reactRouterVersion === "string" && (deps["@react-router/fs-routes"] || isVersion(reactRouterVersion, 7))) return DocumentationRouter.ViteAndReact_ReactRouterV7;
-	if (deps.vite) {
-		if (deps.vue) return DocumentationRouter.ViteAndVue;
-		if (deps["solid-js"]) return DocumentationRouter.ViteAndSolid;
-		if (deps.svelte) return DocumentationRouter.ViteAndSvelte;
-		if (deps.preact) return DocumentationRouter.ViteAndPreact;
-		if (deps.lit) return DocumentationRouter.ViteAndLit;
-		if (deps["vanilla-intlayer"]) return DocumentationRouter.ViteAndVanilla;
-		return DocumentationRouter.ViteAndReact;
-	}
-	if (deps["react-scripts"]) return DocumentationRouter.CRA;
-	if (deps["@angular/core"]) return DocumentationRouter.Angular;
-	if (deps.lit) return DocumentationRouter.ViteAndLit;
-	if (deps["vanilla-intlayer"]) return DocumentationRouter.Vanilla;
-	if (deps["@nestjs/core"]) return DocumentationRouter.NestJS;
-	if (deps["@adonisjs/core"]) return DocumentationRouter.AdonisJS;
-	if (deps.elysia) return DocumentationRouter.Elysia;
-	if (deps.hono) return DocumentationRouter.Hono;
-	if (deps.express) return DocumentationRouter.Express;
-	if (deps.fastify) return DocumentationRouter.Fastify;
-	if (deps["next-intl"]) return DocumentationRouter.NextIntl;
-	if (deps["react-i18next"] || deps.i18next) return DocumentationRouter.ReactI18Next;
-	if (deps["react-intl"]) return DocumentationRouter.ReactIntl;
-	if (deps["next-i18next"]) return DocumentationRouter.NextI18Next;
-	if (deps["vue-i18n"]) return DocumentationRouter.VueI18n;
-	return DocumentationRouter.Default;
-};
-/**
 * Resolves the default dev-server URL of the detected framework, used as the
 * `editor.applicationURL` of the generated configuration file. Frameworks that
 * embed Vite (Astro, SvelteKit, …) are checked before the bare Vite fallback so
@@ -177,7 +58,7 @@ const initIntlayer = async (rootDir, options) => {
 		(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Could not parse ${(0, _intlayer_config_logger.colorizePath)("package.json")}.`, { level: "error" });
 		process.exit(1);
 	}
-	const guideUrl = getDocumentationUrl(packageJson);
+	const guideUrl = require_init_documentationRouter.getDocumentationUrl(packageJson);
 	const allDeps = {
 		...packageJson.dependencies ?? {},
 		...packageJson.devDependencies ?? {}
@@ -193,11 +74,14 @@ const initIntlayer = async (rootDir, options) => {
 	const linguiPresent = Boolean(allDeps["@lingui/core"] || allDeps["@lingui/react"] || allDeps["@intlayer/lingui"]);
 	const linguiCatalog = linguiPresent ? await require_init_utils_fileSystem.detectLinguiCatalogPattern(rootDir) : null;
 	const linguiCatalogFormat = linguiCatalog?.format ?? (linguiPresent ? "po" : null);
-	const { packagesToInstall, devPackagesToInstall, compatSyncConfig, compatVitePluginConfig } = require_init_utils_packageManager.detectMissingIntlayerPackages(allDeps, {
+	const { packagesToInstall, devPackagesToInstall, compatSyncConfig, compatVitePluginConfig, pendingCompatAdapters } = require_init_utils_packageManager.detectMissingIntlayerPackages(allDeps, {
 		linguiCatalogFormat,
 		dependencies: packageJson.dependencies,
 		devDependencies: packageJson.devDependencies
 	});
+	/** Whether the compat adapter for a library is not released yet. */
+	const isCompatAdapterPending = (adapterPackage) => pendingCompatAdapters.includes(adapterPackage);
+	if (pendingCompatAdapters.length > 0) (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} No released Intlayer adapter yet for ${pendingCompatAdapters.map((adapterPackage) => (0, _intlayer_config_logger.colorize)(adapterPackage, _intlayer_config_colors.MAGENTA)).join(", ")} — keeping your current i18n library and only syncing its catalogs with Intlayer.`, { level: "warn" });
 	const wantsJsonNamespaces = options?.contentStrategy === "json-namespaces" && !compatSyncConfig;
 	if (wantsJsonNamespaces && !allDeps["@intlayer/sync-json-plugin"] && !devPackagesToInstall.includes("@intlayer/sync-json-plugin")) devPackagesToInstall.push("@intlayer/sync-json-plugin");
 	if (!options?.noInstallPackages) {
@@ -223,7 +107,7 @@ const initIntlayer = async (rootDir, options) => {
 		await require_init_upgradeIntlayerPackages.upgradeIntlayerPackages(rootDir);
 	}
 	const gitignorePath = ".gitignore";
-	if (!options?.noGitignore && await require_init_utils_fileSystem.exists(rootDir, gitignorePath)) {
+	if (!options?.noGitignore && !options?.noFrameworkSetup && await require_init_utils_fileSystem.exists(rootDir, gitignorePath)) {
 		const gitignoreContent = await require_init_utils_fileSystem.readFileFromRoot(rootDir, gitignorePath);
 		if (!gitignoreContent.includes("intlayer")) {
 			const newContent = `${gitignoreContent}\n# Intlayer\n.intlayer\n`;
@@ -289,39 +173,25 @@ const initIntlayer = async (rootDir, options) => {
 	} catch {
 		(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Could not update ${(0, _intlayer_config_logger.colorizePath)(settingsJsonPath)}. You may need to add the LSP settings manually.`, { level: "warn" });
 	}
+	if (!options?.noEslint && require_init_utils_packageManager.hasLegacyEslint(allDeps)) (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} ${(0, _intlayer_config_logger.colorize)(require_init_utils_lintConfig.LINT_PLUGIN_PACKAGE_NAME, _intlayer_config_colors.MAGENTA)} needs ESLint ${9}+ (flat config) — skipped the Intlayer lint rules. Upgrade ESLint to enable them: ${(0, _intlayer_config_logger.colorizePath)(require_init_documentationRouter.DocumentationRouter.ESLint)}`, { level: "warn" });
 	if (!options?.noEslint && require_init_utils_packageManager.hasLintTooling(allDeps)) {
 		const oxlintConfigPath = ".oxlintrc.json";
-		if (await require_init_utils_fileSystem.exists(rootDir, oxlintConfigPath)) try {
-			const content = await require_init_utils_fileSystem.readFileFromRoot(rootDir, oxlintConfigPath);
-			const oxlintConfig = require_init_utils_jsonParser.parseJSONWithComments(content);
-			oxlintConfig.jsPlugins ??= [];
-			oxlintConfig.rules ??= {};
-			oxlintConfig.ignorePatterns ??= [];
-			let oxlintUpdated = false;
-			for (const glob of GENERATED_OUTPUT_GLOBS) if (!oxlintConfig.ignorePatterns.includes(glob)) {
-				oxlintConfig.ignorePatterns.push(glob);
-				oxlintUpdated = true;
-			}
-			if (!oxlintConfig.jsPlugins.includes(LINT_PLUGIN_PACKAGE_NAME)) {
-				oxlintConfig.jsPlugins.push(LINT_PLUGIN_PACKAGE_NAME);
-				oxlintUpdated = true;
-			}
-			for (const [ruleName, severity] of Object.entries(getRecommendedRules())) if (!oxlintConfig.rules[ruleName]) {
-				oxlintConfig.rules[ruleName] = severity;
-				oxlintUpdated = true;
-			}
-			if (oxlintUpdated) {
+		const hasOxlintConfig = await require_init_utils_fileSystem.exists(rootDir, oxlintConfigPath);
+		const shouldCreateOxlintConfig = !hasOxlintConfig && Boolean(allDeps.oxlint) && !allDeps.eslint;
+		if (hasOxlintConfig || shouldCreateOxlintConfig) try {
+			const oxlintConfig = hasOxlintConfig ? require_init_utils_jsonParser.parseJSONWithComments(await require_init_utils_fileSystem.readFileFromRoot(rootDir, oxlintConfigPath)) : {};
+			if (require_init_utils_lintConfig.addIntlayerRulesToOxlintConfig(oxlintConfig)) {
 				await require_init_utils_fileSystem.writeFileToRoot(rootDir, oxlintConfigPath, JSON.stringify(oxlintConfig, null, 2));
-				(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Added the Intlayer lint rules to ${(0, _intlayer_config_logger.colorizePath)(oxlintConfigPath)}`);
+				(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${hasOxlintConfig ? "Added the Intlayer lint rules to" : "Created"} ${(0, _intlayer_config_logger.colorizePath)(oxlintConfigPath)}`);
 			} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(oxlintConfigPath)} already includes the Intlayer lint rules`);
 		} catch {
-			(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Could not update ${(0, _intlayer_config_logger.colorizePath)(oxlintConfigPath)}. You may need to add ${(0, _intlayer_config_logger.colorize)(LINT_PLUGIN_PACKAGE_NAME, _intlayer_config_colors.MAGENTA)} manually.`, { level: "warn" });
+			(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Could not update ${(0, _intlayer_config_logger.colorizePath)(oxlintConfigPath)}. You may need to add ${(0, _intlayer_config_logger.colorize)(require_init_utils_lintConfig.LINT_PLUGIN_PACKAGE_NAME, _intlayer_config_colors.MAGENTA)} manually.`, { level: "warn" });
 		}
 		else (0, _intlayer_config_logger.logger)([
 			(0, _intlayer_config_logger.colorize)("Intlayer lint rules →", _intlayer_config_colors.MAGENTA),
-			(0, _intlayer_config_logger.colorize)(`Add ${LINT_PLUGIN_PACKAGE_NAME} to your ESLint flat config to catch hardcoded text and dynamic calls the compiler cannot optimize:`, _intlayer_config_colors.GREY_LIGHT),
-			(0, _intlayer_config_logger.colorize)(`  import intlayer from '${LINT_PLUGIN_PACKAGE_NAME}';\n  export default [...intlayer.configs.recommended];`, _intlayer_config_colors.GREY_LIGHT),
-			(0, _intlayer_config_logger.colorizePath)(DocumentationRouter.ESLint)
+			(0, _intlayer_config_logger.colorize)(`Add the ${require_init_utils_lintConfig.LINT_PLUGIN_PACKAGE_NAME} preset to the array your ESLint flat config exports, to catch hardcoded text and dynamic calls the compiler cannot optimize:`, _intlayer_config_colors.GREY_LIGHT),
+			(0, _intlayer_config_logger.colorize)(`  import intlayer from '${require_init_utils_lintConfig.LINT_PLUGIN_PACKAGE_NAME}';\n\n  export default [\n    // ...your existing config\n    ...intlayer.configs.recommended,\n  ];`, _intlayer_config_colors.GREY_LIGHT),
+			(0, _intlayer_config_logger.colorizePath)(require_init_documentationRouter.DocumentationRouter.ESLint)
 		]);
 	}
 	if (!options?.noFrameworkSetup) {
@@ -348,7 +218,7 @@ const initIntlayer = async (rootDir, options) => {
 		}
 		const format = hasTsConfig ? "intlayer.config.ts" : "intlayer.config.mjs";
 		const detectedPattern = await require_init_utils_fileSystem.detectJsonLocalePattern(rootDir);
-		await require_initConfig_index.initConfig(format, rootDir, {
+		const isConfigCreated = await require_initConfig_index.initConfig(format, rootDir, {
 			locales: detectedPattern?.locales,
 			applicationURL: getDefaultApplicationURL(allDeps)
 		});
@@ -383,7 +253,14 @@ const initIntlayer = async (rootDir, options) => {
 				break;
 			}
 		}
-		if (options?.routingMode) await require_init_cms.setRoutingModeInConfig(rootDir, options.routingMode);
+		const hasUrlRouting = require_init_utils_urlRoutingFramework.hasUrlRoutingFramework(allDeps);
+		const hasCompatI18nLibrary = require_init_utils_packageManager.detectCompatI18nLibraries(allDeps).length > 0;
+		const shouldApplyDefaultRouting = isConfigCreated && options?.routingMode === void 0 && !hasCompatI18nLibrary;
+		if (shouldApplyDefaultRouting && !hasUrlRouting) await require_init_cms.setRoutingStorageOnlyInConfig(rootDir);
+		const routingMode = options?.routingMode ?? (shouldApplyDefaultRouting && hasUrlRouting ? _intlayer_config_defaultValues.ROUTING_MODE : void 0);
+		const enableProxy = options?.enableProxy ?? (shouldApplyDefaultRouting && hasUrlRouting ? true : void 0);
+		if (routingMode) await require_init_cms.setRoutingModeInConfig(rootDir, routingMode);
+		if (enableProxy !== void 0) await require_init_cms.setEnableProxyInConfig(rootDir, enableProxy);
 		let hasAliasConfiguration = false;
 		for (const file of [
 			"vite.config.ts",
@@ -436,7 +313,8 @@ const initIntlayer = async (rootDir, options) => {
 					await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, updatedContent);
 					(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Updated ${(0, _intlayer_config_logger.colorizePath)(file)} to include Intlayer next-intl compat plugin`);
 				} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(file)} already includes @intlayer/next-intl/plugin`);
-			} else if (allDeps["next-translate"] || allDeps["@intlayer/next-translate"]) {
+			} else if (isCompatAdapterPending("@intlayer/next-translate")) (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Kept ${(0, _intlayer_config_logger.colorizePath)(file)} untouched (next-translate stays in charge)`);
+			else if (allDeps["next-translate"] || allDeps["@intlayer/next-translate"]) {
 				if (!content.includes("@intlayer/next-translate")) {
 					const updatedContent = require_init_utils_configManipulation.updateNextConfigForNextTranslate(content, extension);
 					await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, updatedContent);
@@ -476,7 +354,8 @@ const initIntlayer = async (rootDir, options) => {
 		for (const file of ["nuxt.config.js", "nuxt.config.ts"]) if (await require_init_utils_fileSystem.exists(rootDir, file)) {
 			hasAliasConfiguration = true;
 			const content = await require_init_utils_fileSystem.readFileFromRoot(rootDir, file);
-			if (allDeps["@nuxtjs/i18n"]) {
+			if (isCompatAdapterPending("@intlayer/nuxtjs-i18n")) (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Kept ${(0, _intlayer_config_logger.colorizePath)(file)} untouched (@nuxtjs/i18n stays in charge)`);
+			else if (allDeps["@nuxtjs/i18n"]) {
 				if (!content.includes("@intlayer/nuxtjs-i18n")) {
 					const updatedContent = require_init_utils_configManipulation.updateNuxtConfigForNuxtjsI18n(content);
 					await require_init_utils_fileSystem.writeFileToRoot(rootDir, file, updatedContent);
@@ -511,7 +390,7 @@ const initIntlayer = async (rootDir, options) => {
 					if (updatedContent !== content) {
 						await require_init_utils_fileSystem.writeFileToRoot(rootDir, metroConfigFile, updatedContent);
 						(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Updated ${(0, _intlayer_config_logger.colorizePath)(metroConfigFile)} to include the Intlayer Metro plugin`);
-					} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Could not automatically update ${(0, _intlayer_config_logger.colorizePath)(metroConfigFile)}. Wrap your exported config with ${(0, _intlayer_config_logger.colorize)("configMetroIntlayer", _intlayer_config_colors.MAGENTA)}: ${(0, _intlayer_config_logger.colorizePath)(DocumentationRouter.ReactNativeAndExpo)}`, { level: "warn" });
+					} else (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Could not automatically update ${(0, _intlayer_config_logger.colorizePath)(metroConfigFile)}. Wrap your exported config with ${(0, _intlayer_config_logger.colorize)("configMetroIntlayer", _intlayer_config_colors.MAGENTA)}: ${(0, _intlayer_config_logger.colorizePath)(require_init_documentationRouter.DocumentationRouter.ReactNativeAndExpo)}`, { level: "warn" });
 				}
 			} else {
 				const newMetroConfigFile = "metro.config.js";
@@ -610,27 +489,35 @@ const initIntlayer = async (rootDir, options) => {
 		const hasCompatLibrary = Boolean(compatSyncConfig || compatVitePluginConfig);
 		if (hasCompatLibrary) (0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Compat i18n library detected — keeping the app structure untouched (no route restructure, no provider injection)`);
 		if (!hasCompatLibrary) try {
-			const routingMode = options?.routingMode ?? (0, _intlayer_config_node.getConfiguration)({ baseDir: rootDir }).routing.mode;
+			const { routing } = (0, _intlayer_config_node.getConfiguration)({ baseDir: rootDir });
 			await require_init_frameworkSetup_index.setupFramework({
 				rootDir,
 				allDeps,
 				packageManager,
 				useTypeScript: hasTsConfig,
-				routingMode
+				routingMode: routingMode ?? routing.mode,
+				enableProxy: enableProxy ?? routing.enableProxy !== false
 			});
 		} catch {
 			(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.x} Framework-specific scaffolding failed. Your existing files were left untouched; follow the documentation to finish the setup.`, { level: "warn" });
 		}
 	}
+	if (!options?.skipFinalMessage) logInitSuccessMessage(guideUrl);
+	return { guideUrl };
+};
+const logInitSuccessMessage = (guideUrl) => {
 	(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorize)("Intlayer init setup complete.", _intlayer_config_colors.GREEN)}`);
 	(0, _intlayer_config_logger.logger)([
 		(0, _intlayer_config_logger.colorize)("Next →", _intlayer_config_colors.MAGENTA),
-		(0, _intlayer_config_logger.colorize)(`Follow the instructions in the documentation to complete the setup:`, _intlayer_config_colors.GREY_LIGHT),
+		(0, _intlayer_config_logger.colorize)("Follow the instructions in the documentation to complete the setup:", _intlayer_config_colors.GREY_LIGHT),
 		(0, _intlayer_config_logger.colorizePath)(guideUrl)
 	]);
 };
 
 //#endregion
+exports.DocumentationRouter = require_init_documentationRouter.DocumentationRouter;
 exports.getDefaultApplicationURL = getDefaultApplicationURL;
+exports.getDocumentationUrl = require_init_documentationRouter.getDocumentationUrl;
 exports.initIntlayer = initIntlayer;
+exports.logInitSuccessMessage = logInitSuccessMessage;
 //# sourceMappingURL=index.cjs.map