@dialexjs/cli 0.9.1 → 0.9.2

package/dist/index.mjs

@@ -1,27 +1,18 @@
 #!/usr/bin/env node
-import { B as listLocales, C as isStale, D as record, E as readLock, G as saveDictionaryFile, K as setString, L as getString, M as scanFiles, N as TODO_PREFIX, O as writeLock, P as copyLeaf, R as hasPath, T as lockPath, V as loadDictionaryFile, a as renderGenerated, d as resolveDialexConfig, f as logger, i as generateDictionaries, m as analyzeProject, o as runGenerate, r as toKey, t as loadProject, w as lockFor, x as LOCK_FILE, z as listLeaves } from "./project-B27699T2.mjs";
+import { A as scanFiles, B as listLeaves, C as lockPath, E as writeLock, G as saveDictionaryFile, H as loadDictionaryFile, I as copyLeaf, K as TODO_PREFIX, L as setString, R as getString, S as lockFor, T as record, V as listLocales, a as generateDictionaries, d as resolveDialexConfig, f as logger, i as runGenerate, p as analyzeProject, r as toKey, s as renderGenerated, t as loadProject, w as readLock, x as isStale, y as LOCK_FILE, z as hasPath } from "./project-BTpZGNjh.mjs";
 import { Command } from "commander";
-import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";
-import { fileURLToPath } from "node:url";
+import fs from "node:fs";
 import { loadFile, parseModule, writeFile } from "magicast";
+import { fileURLToPath } from "node:url";
 import { argumentSignature, getArguments, isIcuStructured, parseMessage } from "dialexjs/icu";
 import * as p from "@clack/prompts";
 import { addNuxtModule } from "magicast/helpers";
 //#region package.json
-var version = "0.9.1";
+var version = "0.9.2";
 //#endregion
-//#region src/commands/check.ts
-function addIssue(diag, issue) {
-	const level = issue.level === "error" ? "error" : "warning";
-	(level === "error" ? diag.errors : diag.warnings).push(issue.message);
-	diag.annotations.push({
-		level,
-		message: issue.message,
-		line: issue.range ? issue.range.start.line + 1 : void 0
-	});
-}
+//#region src/commands/check/fix.ts
 /**
 * Inserts keys that exist in one locale but not in another, copying the default-locale value
 * (strings get a `[TODO]` prefix). Returns how many keys were inserted.
@@ -49,9 +40,22 @@ async function applyFixes(files, configuredLocales, defaultLocale) {
 	}
 	return fixed;
 }
+//#endregion
+//#region src/commands/check/report.ts
+function addIssue(diag, issue) {
+	const level = issue.level === "error" ? "error" : "warning";
+	(level === "error" ? diag.errors : diag.warnings).push(issue.message);
+	diag.annotations.push({
+		level,
+		message: issue.message,
+		line: issue.range ? issue.range.start.line + 1 : void 0
+	});
+}
 function escapeAnnotation(value) {
 	return value.replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A");
 }
+//#endregion
+//#region src/commands/check/stale-generated.ts
 /**
 * What a formatter (Prettier, Biome, oxfmt) can change without changing the code: whitespace,
 * quote style, quoted object keys and trailing commas. Comparing this form keeps `check` quiet
@@ -108,6 +112,8 @@ function staleGeneratedFiles(root, options) {
 		rewritten
 	};
 }
+//#endregion
+//#region src/commands/check/index.ts
 async function runCheck(options = {}) {
 	const root = options.cwd || process.cwd();
 	const quiet = options.json === true;
@@ -300,7 +306,7 @@ ${units.join("\n")}
 	return result;
 }
 //#endregion
-//#region src/commands/import.ts
+//#region src/commands/import/formats.ts
 const unescapeXml = (value) => value.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, "\"").replace(/&apos;/g, "'").replace(/&amp;/g, "&");
 function parseCsv(text) {
 	const rows = [];
@@ -383,6 +389,8 @@ function inferFormat(file) {
 	if (ext === ".xlf" || ext === ".xliff") return "xliff";
 	throw new Error(`Cannot infer format from "${ext}". Pass --format json|csv|xliff.`);
 }
+//#endregion
+//#region src/commands/import/icu-guard.ts
 /**
 * Why `value` must not replace the current text, if it is an ICU message that is invalid or uses
 * different arguments than the same key in another locale.
@@ -408,6 +416,8 @@ function icuProblem(df, defaultLocale, locale, keyPath, value) {
 		}
 	}
 }
+//#endregion
+//#region src/commands/import/index.ts
 async function runImport(options) {
 	const root = options.cwd || process.cwd();
 	const file = path.resolve(root, options.file);
@@ -627,6 +637,125 @@ function detectFramework(root) {
 	};
 }
 //#endregion
+//#region src/commands/init/ai-setup.ts
+/** Writes `.agents/skills/dialex/SKILL.md`, merges `.mcp.json` and adds a note to AGENTS.md. */
+function setupAiSupport(root) {
+	try {
+		const skillDir = path.join(root, ".agents/skills/dialex");
+		fs.mkdirSync(skillDir, { recursive: true });
+		fs.writeFileSync(path.join(skillDir, "SKILL.md"), `---
+name: dialex
+description: Guide for internationalizing JavaScript and TypeScript apps with Dialex. Use when adding translations, creating content dictionaries, configuring locales, or using Dialex with frameworks like Next.js, React, Express, Hono, Fastify, SvelteKit, and Nuxt.
+---
+
+# Dialex Internationalization
+
+Dialex is a high-performance, type-safe internationalization toolchain for JavaScript and TypeScript.
+
+## Core Concepts
+- Dictionaries are defined with \`defineDictionary("name", { ... })\` in \`*.content.ts\` files.
+- Keys must match across all locales.
+- ICU message syntax is supported for plurals and selects.
+- Parity is validated at compile time with \`dialex check\`.
+
+## Useful Commands
+- \`dialex check --json\`: Check dictionary parity and references.
+- \`dialex check --fix\`: Automatically insert missing keys marked with [TODO].
+- \`dialex generate\`: Rebuild standalone dictionary bundle and types.
+- \`dialex translate --locale <locale>\`: Automatically translate missing keys.
+`, "utf-8");
+		const mcpConfigPath = path.join(root, ".mcp.json");
+		let mcpConfig = {};
+		if (fs.existsSync(mcpConfigPath)) try {
+			mcpConfig = JSON.parse(fs.readFileSync(mcpConfigPath, "utf-8"));
+		} catch {
+			mcpConfig = {};
+		}
+		mcpConfig.mcpServers = mcpConfig.mcpServers || {};
+		mcpConfig.mcpServers.dialex = mcpConfig.mcpServers.dialex || {
+			command: "npx",
+			args: ["@dialexjs/mcp"]
+		};
+		fs.writeFileSync(mcpConfigPath, JSON.stringify(mcpConfig, null, 2) + "\n", "utf-8");
+		const agentsMdPath = path.join(root, "AGENTS.md");
+		const dialexAgentSnippet = `
+## Internationalization (Dialex)
+
+This project uses [Dialex](https://github.com/awaiden/dialex) for type-safe internationalization.
+- Dictionaries are in \`*.content.ts\` files using \`defineDictionary\`.
+- Run \`dialex check --json\` to verify parity.
+- Run \`dialex check --fix\` to insert missing keys marked with \`[TODO]\`.
+- Run \`dx generate\` (alias of \`dialex\`) or \`npm run dx:generate\` to compile dictionary bundles and update types.
+`;
+		if (!fs.existsSync(agentsMdPath)) fs.writeFileSync(agentsMdPath, dialexAgentSnippet.trimStart(), "utf-8");
+		else {
+			const existing = fs.readFileSync(agentsMdPath, "utf-8");
+			if (!existing.includes("Dialex")) fs.writeFileSync(agentsMdPath, existing.trimEnd() + "\n" + dialexAgentSnippet, "utf-8");
+		}
+		logger.success("Configured AI assistant support (.agents/skills, .mcp.json, AGENTS.md)");
+	} catch (err) {
+		logger.warn(`Could not finish AI configuration: ${err.message || String(err)}`);
+	}
+}
+//#endregion
+//#region src/commands/init/config-file.ts
+/** Creates `dialex.config.ts`, or updates the locales of the one that exists. */
+async function writeDialexConfig(root, framework, defaultLocale, localeList) {
+	const configPath = fs.existsSync(path.join(root, "dialex.config.ts")) ? path.join(root, "dialex.config.ts") : fs.existsSync(path.join(root, "i18n.config.ts")) ? path.join(root, "i18n.config.ts") : path.join(root, "dialex.config.ts");
+	const configFileName = path.basename(configPath);
+	const generatedOutput = framework === "react-router" ? "app/dialex.generated.ts" : framework === "adonis" ? "start/dialex.generated.ts" : void 0;
+	try {
+		if (fs.existsSync(configPath)) {
+			const mod = await loadFile(configPath);
+			if (mod && mod.exports.default) {
+				if (mod.exports.default.$args && mod.exports.default.$args[0]) {
+					mod.exports.default.$args[0].defaultLocale = defaultLocale;
+					mod.exports.default.$args[0].locales = localeList;
+					if (generatedOutput) mod.exports.default.$args[0].output = generatedOutput;
+				}
+				await writeFile(mod, configPath);
+				logger.success(`Updated ${pc.bold(configFileName)} via Magicast`);
+			}
+		} else {
+			const mod = parseModule(`import { defineConfig } from "dialexjs";
+
+export default defineConfig({});
+`);
+			mod.exports.default.$args[0].defaultLocale = defaultLocale;
+			mod.exports.default.$args[0].locales = localeList;
+			if (generatedOutput) mod.exports.default.$args[0].output = generatedOutput;
+			await writeFile(mod, configPath);
+			logger.success(`Created ${pc.bold(configFileName)} via Magicast`);
+		}
+	} catch (err) {
+		logger.warn(`Magicast config update notice: ${err.message || String(err)}`);
+		const fallback = `import { defineConfig } from "dialexjs";
+
+export default defineConfig({
+  defaultLocale: "${defaultLocale}",
+  locales: [${localeList.map((l) => `"${l}"`).join(", ")}],${generatedOutput ? `\n  output: "${generatedOutput}",` : ""}
+});
+`;
+		fs.writeFileSync(configPath, fallback, "utf-8");
+	}
+}
+/** Nuxt reads the generated file through its module; it has to be registered in the Nuxt config. */
+async function registerNuxtModule(root) {
+	const nuxtConfig = [
+		"nuxt.config.ts",
+		"nuxt.config.js",
+		"nuxt.config.mjs"
+	].map((f) => path.join(root, f)).find((f) => fs.existsSync(f));
+	if (nuxtConfig) try {
+		const nMod = await loadFile(nuxtConfig);
+		addNuxtModule(nMod, "dialexjs/nuxt", "dialex", {});
+		await writeFile(nMod, nuxtConfig);
+		logger.success(`Registered dialexjs/nuxt in ${pc.bold(path.basename(nuxtConfig))} via Magicast`);
+	} catch {
+		logger.warn("Could not update the Nuxt config; add the dialexjs/nuxt module manually.");
+	}
+}
+//#endregion
 //#region src/utils/package-json.ts
 /** Version of this CLI, which the other Dialex packages share. Read from the nearest package.json. */
 function cliVersion() {
@@ -678,237 +807,9 @@ function addRequiredPackages(pkg, version = cliVersion()) {
 	return added;
 }
 //#endregion
-//#region src/commands/init.ts
-async function runInit(options = {}) {
-	const root = options.cwd || process.cwd();
-	const detected = detectFramework(root);
-	const isInteractive = !options.yes && process.stdin.isTTY;
-	let framework = options.framework || detected.framework;
-	let defaultLocale = options.defaultLocale || "en";
-	let localesInput = options.locales || "en,tr";
-	if (isInteractive) {
-		p.intro(pc.bgCyan(pc.black(" dialex init ")));
-		const frameworkOptions = [
-			{
-				value: "hono",
-				label: "Hono",
-				hint: detected.framework === "hono" ? "detected" : void 0
-			},
-			{
-				value: "express",
-				label: "Express",
-				hint: detected.framework === "express" ? "detected" : void 0
-			},
-			{
-				value: "fastify",
-				label: "Fastify",
-				hint: detected.framework === "fastify" ? "detected" : void 0
-			},
-			{
-				value: "koa",
-				label: "Koa",
-				hint: detected.framework === "koa" ? "detected" : void 0
-			},
-			{
-				value: "nestjs",
-				label: "NestJS",
-				hint: detected.framework === "nestjs" ? "detected" : void 0
-			},
-			{
-				value: "next",
-				label: "Next.js",
-				hint: detected.framework === "next" ? "detected" : void 0
-			},
-			{
-				value: "react",
-				label: "React / Vite",
-				hint: detected.framework === "react" ? "detected" : void 0
-			},
-			{
-				value: "elysia",
-				label: "Elysia",
-				hint: detected.framework === "elysia" ? "detected" : void 0
-			},
-			{
-				value: "sveltekit",
-				label: "SvelteKit",
-				hint: detected.framework === "sveltekit" ? "detected" : void 0
-			},
-			{
-				value: "astro",
-				label: "Astro",
-				hint: detected.framework === "astro" ? "detected" : void 0
-			},
-			{
-				value: "vue",
-				label: "Vue / Vite",
-				hint: detected.framework === "vue" ? "detected" : void 0
-			},
-			{
-				value: "nuxt",
-				label: "Nuxt",
-				hint: detected.framework === "nuxt" ? "detected" : void 0
-			},
-			{
-				value: "svelte",
-				label: "Svelte / Vite",
-				hint: detected.framework === "svelte" ? "detected" : void 0
-			},
-			{
-				value: "solid",
-				label: "Solid / Vite",
-				hint: detected.framework === "solid" ? "detected" : void 0
-			},
-			{
-				value: "react-router",
-				label: "React Router",
-				hint: detected.framework === "react-router" ? "detected" : void 0
-			},
-			{
-				value: "react-native",
-				label: "React Native / Expo",
-				hint: detected.framework === "react-native" ? "detected" : void 0
-			},
-			{
-				value: "preact",
-				label: "Preact / Vite",
-				hint: detected.framework === "preact" ? "detected" : void 0
-			},
-			{
-				value: "qwik",
-				label: "Qwik",
-				hint: detected.framework === "qwik" ? "detected" : void 0
-			},
-			{
-				value: "lit",
-				label: "Lit / Web Components",
-				hint: detected.framework === "lit" ? "detected" : void 0
-			},
-			{
-				value: "hapi",
-				label: "Hapi",
-				hint: detected.framework === "hapi" ? "detected" : void 0
-			},
-			{
-				value: "adonis",
-				label: "AdonisJS",
-				hint: detected.framework === "adonis" ? "detected" : void 0
-			},
-			{
-				value: "trpc",
-				label: "tRPC",
-				hint: detected.framework === "trpc" ? "detected" : void 0
-			}
-		];
-		const selectedFramework = await p.select({
-			message: `Framework detected as ${pc.bold(detected.framework)} (${detected.matchedRule}). Select framework:`,
-			options: frameworkOptions,
-			initialValue: detected.framework
-		});
-		if (p.isCancel(selectedFramework)) {
-			p.cancel("Operation cancelled.");
-			return;
-		}
-		framework = selectedFramework;
-		const inputDefault = await p.text({
-			message: "What is your default locale?",
-			initialValue: "en",
-			validate: (v) => !v || !v.trim() ? "Default locale cannot be empty" : void 0
-		});
-		if (p.isCancel(inputDefault)) {
-			p.cancel("Operation cancelled.");
-			return;
-		}
-		defaultLocale = inputDefault.trim();
-		const inputLocales = await p.text({
-			message: "Comma-separated list of supported locales:",
-			initialValue: `${defaultLocale},tr`,
-			validate: (v) => !v || !v.trim() ? "Locales list cannot be empty" : void 0
-		});
-		if (p.isCancel(inputLocales)) {
-			p.cancel("Operation cancelled.");
-			return;
-		}
-		localesInput = inputLocales.trim();
-		if (options.ai === void 0 && options.noAi === void 0) {
-			const confirmAi = await p.confirm({
-				message: "Configure AI agent support (Claude/Cursor skills, .mcp.json, AGENTS.md)?",
-				initialValue: true
-			});
-			if (!p.isCancel(confirmAi)) options.ai = confirmAi;
-		}
-	} else logger.info(`Auto-detected framework: ${pc.bold(framework)} (${detected.matchedRule})`);
-	const localeList = Array.from(/* @__PURE__ */ new Set([defaultLocale, ...localesInput.split(",").map((s) => s.trim()).filter(Boolean)]));
-	const configPath = fs.existsSync(path.join(root, "dialex.config.ts")) ? path.join(root, "dialex.config.ts") : fs.existsSync(path.join(root, "i18n.config.ts")) ? path.join(root, "i18n.config.ts") : path.join(root, "dialex.config.ts");
-	const configFileName = path.basename(configPath);
-	const generatedOutput = framework === "react-router" ? "app/dialex.generated.ts" : framework === "adonis" ? "start/dialex.generated.ts" : void 0;
-	try {
-		if (fs.existsSync(configPath)) {
-			const mod = await loadFile(configPath);
-			if (mod && mod.exports.default) {
-				if (mod.exports.default.$args && mod.exports.default.$args[0]) {
-					mod.exports.default.$args[0].defaultLocale = defaultLocale;
-					mod.exports.default.$args[0].locales = localeList;
-					if (generatedOutput) mod.exports.default.$args[0].output = generatedOutput;
-				}
-				await writeFile(mod, configPath);
-				logger.success(`Updated ${pc.bold(configFileName)} via Magicast`);
-			}
-		} else {
-			const mod = parseModule(`import { defineConfig } from "dialexjs";
-
-export default defineConfig({});
-`);
-			mod.exports.default.$args[0].defaultLocale = defaultLocale;
-			mod.exports.default.$args[0].locales = localeList;
-			if (generatedOutput) mod.exports.default.$args[0].output = generatedOutput;
-			await writeFile(mod, configPath);
-			logger.success(`Created ${pc.bold(configFileName)} via Magicast`);
-		}
-	} catch (err) {
-		logger.warn(`Magicast config update notice: ${err.message || String(err)}`);
-		const fallback = `import { defineConfig } from "dialexjs";
-
-export default defineConfig({
-  defaultLocale: "${defaultLocale}",
-  locales: [${localeList.map((l) => `"${l}"`).join(", ")}],${generatedOutput ? `\n  output: "${generatedOutput}",` : ""}
-});
-`;
-		fs.writeFileSync(configPath, fallback, "utf-8");
-	}
-	if (framework === "nuxt") {
-		const nuxtConfig = [
-			"nuxt.config.ts",
-			"nuxt.config.js",
-			"nuxt.config.mjs"
-		].map((f) => path.join(root, f)).find((f) => fs.existsSync(f));
-		if (nuxtConfig) try {
-			const nMod = await loadFile(nuxtConfig);
-			addNuxtModule(nMod, "dialexjs/nuxt", "dialex", {});
-			await writeFile(nMod, nuxtConfig);
-			logger.success(`Registered dialexjs/nuxt in ${pc.bold(path.basename(nuxtConfig))} via Magicast`);
-		} catch {
-			logger.warn("Could not update the Nuxt config; add the dialexjs/nuxt module manually.");
-		}
-	}
-	const targetDir = (framework === "react-router" || framework === "adonis") && fs.existsSync(path.join(root, "app")) ? path.join(root, "app") : fs.existsSync(path.join(root, "src")) ? path.join(root, "src") : root;
-	const dictPath = path.join(targetDir, "home.content.ts");
-	if (!fs.existsSync(dictPath)) {
-		const dictContent = `import { defineDictionary } from "dialexjs";
-
-export default defineDictionary("home", {
-${localeList.map((loc) => `  ${loc}: {
-    title: "Welcome to Dialex (${loc})!",
-    description: "Type-safe internationalization.",
-    greeting: (name: string) => "Hello, " + name + "!",
-  },`).join("\n")}
-});
-`;
-		fs.writeFileSync(dictPath, dictContent, "utf-8");
-		logger.success(`Created starter dictionary at ${pc.bold(path.relative(root, dictPath))}`);
-	} else logger.info("home.content.ts already exists, skipping creation.");
-	generateDictionaries(root, { static: true });
-	logger.success("Generated types and standalone dictionary registry!");
+//#region src/commands/init/dependencies.ts
+/** Adds `dialexjs` and `@dialexjs/cli` to package.json, and the `dx:generate` script. */
+function updatePackageJson(root) {
 	const pkgPath = path.join(root, "package.json");
 	if (fs.existsSync(pkgPath)) try {
 		const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
@@ -926,67 +827,93 @@ ${localeList.map((loc) => `  ${loc}: {
 		logger.warn("Could not update package.json; add dialexjs and @dialexjs/cli manually.");
 	}
 	else logger.warn("No package.json found; install dialexjs and @dialexjs/cli in your project.");
-	if (options.ai === true || options.yes && options.ai !== false && options.noAi !== true) try {
-		const skillDir = path.join(root, ".agents/skills/dialex");
-		fs.mkdirSync(skillDir, { recursive: true });
-		fs.writeFileSync(path.join(skillDir, "SKILL.md"), `---
-name: dialex
-description: Guide for internationalizing JavaScript and TypeScript apps with Dialex. Use when adding translations, creating content dictionaries, configuring locales, or using Dialex with frameworks like Next.js, React, Express, Hono, Fastify, SvelteKit, and Nuxt.
----
-
-# Dialex Internationalization
-
-Dialex is a high-performance, type-safe internationalization toolchain for JavaScript and TypeScript.
-
-## Core Concepts
-- Dictionaries are defined with \`defineDictionary("name", { ... })\` in \`*.content.ts\` files.
-- Keys must match across all locales.
-- ICU message syntax is supported for plurals and selects.
-- Parity is validated at compile time with \`dialex check\`.
-
-## Useful Commands
-- \`dialex check --json\`: Check dictionary parity and references.
-- \`dialex check --fix\`: Automatically insert missing keys marked with [TODO].
-- \`dialex generate\`: Rebuild standalone dictionary bundle and types.
-- \`dialex translate --locale <locale>\`: Automatically translate missing keys.
-`, "utf-8");
-		const mcpConfigPath = path.join(root, ".mcp.json");
-		let mcpConfig = {};
-		if (fs.existsSync(mcpConfigPath)) try {
-			mcpConfig = JSON.parse(fs.readFileSync(mcpConfigPath, "utf-8"));
-		} catch {
-			mcpConfig = {};
-		}
-		mcpConfig.mcpServers = mcpConfig.mcpServers || {};
-		mcpConfig.mcpServers.dialex = mcpConfig.mcpServers.dialex || {
-			command: "npx",
-			args: ["@dialexjs/mcp"]
-		};
-		fs.writeFileSync(mcpConfigPath, JSON.stringify(mcpConfig, null, 2) + "\n", "utf-8");
-		const agentsMdPath = path.join(root, "AGENTS.md");
-		const dialexAgentSnippet = `
-## Internationalization (Dialex)
-
-This project uses [Dialex](https://github.com/awaiden/dialex) for type-safe internationalization.
-- Dictionaries are in \`*.content.ts\` files using \`defineDictionary\`.
-- Run \`dialex check --json\` to verify parity.
-- Run \`dialex check --fix\` to insert missing keys marked with \`[TODO]\`.
-- Run \`dx generate\` (alias of \`dialex\`) or \`npm run dx:generate\` to compile dictionary bundles and update types.
-`;
-		if (!fs.existsSync(agentsMdPath)) fs.writeFileSync(agentsMdPath, dialexAgentSnippet.trimStart(), "utf-8");
-		else {
-			const existing = fs.readFileSync(agentsMdPath, "utf-8");
-			if (!existing.includes("Dialex")) fs.writeFileSync(agentsMdPath, existing.trimEnd() + "\n" + dialexAgentSnippet, "utf-8");
-		}
-		logger.success("Configured AI assistant support (.agents/skills, .mcp.json, AGENTS.md)");
-	} catch (err) {
-		logger.warn(`Could not finish AI configuration: ${err.message || String(err)}`);
+}
+//#endregion
+//#region src/commands/init/prompts.ts
+/** The frameworks `dialex init` offers, in the order of the prompt: value and label. */
+const FRAMEWORKS = [
+	["hono", "Hono"],
+	["express", "Express"],
+	["fastify", "Fastify"],
+	["koa", "Koa"],
+	["nestjs", "NestJS"],
+	["next", "Next.js"],
+	["react", "React / Vite"],
+	["elysia", "Elysia"],
+	["sveltekit", "SvelteKit"],
+	["astro", "Astro"],
+	["vue", "Vue / Vite"],
+	["nuxt", "Nuxt"],
+	["svelte", "Svelte / Vite"],
+	["solid", "Solid / Vite"],
+	["react-router", "React Router"],
+	["react-native", "React Native / Expo"],
+	["preact", "Preact / Vite"],
+	["qwik", "Qwik"],
+	["lit", "Lit / Web Components"],
+	["hapi", "Hapi"],
+	["adonis", "AdonisJS"],
+	["trpc", "tRPC"]
+];
+/**
+* Asks for the framework, the locales and (when not decided by a flag) AI support. Returns
+* `undefined` when the user cancels. May set `options.ai`.
+*/
+async function askInit(options, detected) {
+	p.intro(pc.bgCyan(pc.black(" dialex init ")));
+	const frameworkOptions = FRAMEWORKS.map(([value, label]) => ({
+		value,
+		label,
+		hint: detected.framework === value ? "detected" : void 0
+	}));
+	const selectedFramework = await p.select({
+		message: `Framework detected as ${pc.bold(detected.framework)} (${detected.matchedRule}). Select framework:`,
+		options: frameworkOptions,
+		initialValue: detected.framework
+	});
+	if (p.isCancel(selectedFramework)) {
+		p.cancel("Operation cancelled.");
+		return;
 	}
-	logger.log("");
-	logger.info(pc.bold(`Quick start for ${framework.toUpperCase()}:`));
-	switch (framework) {
-		case "hono":
-			logger.log(`
+	const framework = selectedFramework;
+	const inputDefault = await p.text({
+		message: "What is your default locale?",
+		initialValue: "en",
+		validate: (v) => !v || !v.trim() ? "Default locale cannot be empty" : void 0
+	});
+	if (p.isCancel(inputDefault)) {
+		p.cancel("Operation cancelled.");
+		return;
+	}
+	const defaultLocale = inputDefault.trim();
+	const inputLocales = await p.text({
+		message: "Comma-separated list of supported locales:",
+		initialValue: `${defaultLocale},tr`,
+		validate: (v) => !v || !v.trim() ? "Locales list cannot be empty" : void 0
+	});
+	if (p.isCancel(inputLocales)) {
+		p.cancel("Operation cancelled.");
+		return;
+	}
+	const localesInput = inputLocales.trim();
+	if (options.ai === void 0 && options.noAi === void 0) {
+		const confirmAi = await p.confirm({
+			message: "Configure AI agent support (Claude/Cursor skills, .mcp.json, AGENTS.md)?",
+			initialValue: true
+		});
+		if (!p.isCancel(confirmAi)) options.ai = confirmAi;
+	}
+	return {
+		framework,
+		defaultLocale,
+		localesInput
+	};
+}
+//#endregion
+//#region src/commands/init/quickstart.ts
+/** What `dialex init` prints for each framework, after the files are written. */
+const SNIPPETS = {
+	hono: `
 import { Hono } from "hono";
 import { dialexHono } from "dialexjs/hono";
 import { dialex } from "./src/dialex.generated.js";
@@ -998,10 +925,8 @@ app.get("/", (c) => {
   const dict = c.var.getDictionary("home");
   return c.json({ title: dict.title });
 });
-`);
-			break;
-		case "fastify":
-			logger.log(`
+`,
+	fastify: `
 import Fastify from "fastify";
 import { dialexPlugin } from "dialexjs/fastify";
 import { dialex } from "./src/dialex.generated.js";
@@ -1013,10 +938,8 @@ app.get("/", (req) => {
   const dict = req.getDictionary("home");
   return { title: dict.title };
 });
-`);
-			break;
-		case "express":
-			logger.log(`
+`,
+	express: `
 import express from "express";
 import { dialexExpress } from "dialexjs/express";
 import { dialex } from "./src/dialex.generated.js";
@@ -1028,10 +951,8 @@ app.get("/", (req, res) => {
   const dict = req.getDictionary("home");
   res.json({ title: dict.title });
 });
-`);
-			break;
-		case "koa":
-			logger.log(`
+`,
+	koa: `
 import Koa from "koa";
 import { dialexKoa } from "dialexjs/koa";
 import { dialex } from "./src/dialex.generated.js";
@@ -1043,10 +964,8 @@ app.use((ctx) => {
   const dict = ctx.getDictionary("home");
   ctx.body = { title: dict.title };
 });
-`);
-			break;
-		case "nestjs":
-			logger.log(`
+`,
+	nestjs: `
 import { Module } from "@nestjs/common";
 import { DialexModule } from "dialexjs/nestjs";
 import { dialex } from "./src/dialex.generated.js";
@@ -1055,10 +974,8 @@ import { dialex } from "./src/dialex.generated.js";
   imports: [DialexModule.forRoot({ ...dialex })],
 })
 export class AppModule {}
-`);
-			break;
-		case "next":
-			logger.log(`
+`,
+	next: `
 // src/dialex.ts
 import { createDialexServer } from "dialexjs/server";
 import { dialex } from "./dialex.generated";
@@ -1079,10 +996,8 @@ export default async function Page({ params }: { params: Promise<{ locale: strin
 //   import { DialexProvider } from "dialexjs/react";
 //   import { dialex } from "./dialex.generated";
 //   export const Providers = ({ children }) => <DialexProvider {...dialex}>{children}</DialexProvider>;
-`);
-			break;
-		case "react":
-			logger.log(`
+`,
+	react: `
 // src/main.tsx
 import { createRoot } from "react-dom/client";
 import { DialexProvider } from "dialexjs/react";
@@ -1096,10 +1011,8 @@ createRoot(document.getElementById("root")!).render(
 );
 
 // In components: const dict = useDictionary("home")
-`);
-			break;
-		case "elysia":
-			logger.log(`
+`,
+	elysia: `
 import { Elysia } from "elysia";
 import { dialexElysia } from "dialexjs/elysia";
 import { dialex } from "./src/dialex.generated.js";
@@ -1108,10 +1021,8 @@ new Elysia()
   .use(dialexElysia({ ...dialex }))
   .get("/", ({ getDictionary }) => ({ title: getDictionary("home").title }))
   .listen(3000);
-`);
-			break;
-		case "sveltekit":
-			logger.log(`
+`,
+	sveltekit: `
 // src/hooks.server.ts
 import { dialexHandle } from "dialexjs/sveltekit";
 import { dialex } from "./dialex.generated.js";
@@ -1120,10 +1031,8 @@ export const handle = dialexHandle({ ...dialex });
 
 // src/app.html: <html lang="%dialex.lang%">
 // In load functions: locals.getDictionary("home")
-`);
-			break;
-		case "astro":
-			logger.log(`
+`,
+	astro: `
 // src/middleware.ts
 import { dialexAstro } from "dialexjs/astro";
 import { dialex } from "./dialex.generated.js";
@@ -1131,10 +1040,8 @@ import { dialex } from "./dialex.generated.js";
 export const onRequest = dialexAstro({ ...dialex });
 
 // In pages: Astro.locals.getDictionary("home")
-`);
-			break;
-		case "vue":
-			logger.log(`
+`,
+	vue: `
 // src/main.ts
 import { createApp } from "vue";
 import { createDialex } from "dialexjs/vue";
@@ -1144,10 +1051,8 @@ import App from "./App.vue";
 createApp(App).use(createDialex({ ...dialex })).mount("#app");
 
 // In components: const dict = useDictionary("home")
-`);
-			break;
-		case "svelte":
-			logger.log(`
+`,
+	svelte: `
 <!-- src/App.svelte -->
 <script lang="ts">
   import { provideDialex, useDictionary } from "dialexjs/svelte";
@@ -1159,10 +1064,8 @@ createApp(App).use(createDialex({ ...dialex })).mount("#app");
 
 <h1>{$home.title}</h1>
 <button onclick={() => setLocale("tr")}>TR</button>
-`);
-			break;
-		case "solid":
-			logger.log(`
+`,
+	solid: `
 // src/index.tsx
 import { render } from "solid-js/web";
 import { DialexProvider } from "dialexjs/solid";
@@ -1179,10 +1082,8 @@ render(
 );
 
 // In components: const home = useDictionary("home"); then {home().title}
-`);
-			break;
-		case "react-router":
-			logger.log(`
+`,
+	"react-router": `
 // app/dialex.server.ts
 import { createDialexHandler } from "dialexjs/web";
 import { dialex } from "./dialex.generated";
@@ -1208,10 +1109,8 @@ export default function App() {
     </DialexProvider>
   );
 }
-`);
-			break;
-		case "preact":
-			logger.log(`
+`,
+	preact: `
 // src/index.tsx
 import { render } from "preact";
 import { DialexProvider } from "dialexjs/preact";
@@ -1226,10 +1125,8 @@ render(
 );
 
 // In components: const dict = useDictionary("home")
-`);
-			break;
-		case "qwik":
-			logger.log(`
+`,
+	qwik: `
 // src/i18n.ts
 import { createDialexQwik } from "dialexjs/qwik";
 import { dialex } from "./dialex.generated";
@@ -1244,10 +1141,8 @@ export default component$(() => {
 });
 
 // In components: const home = useDictionary("home"); then {home().title}
-`);
-			break;
-		case "lit":
-			logger.log(`
+`,
+	lit: `
 // src/i18n.ts
 import { createDialex } from "dialexjs/lit";
 import { dialex } from "./dialex.generated";
@@ -1266,10 +1161,8 @@ class MyElement extends LitElement {
     return html\`<h1>\${this.dx.dictionary("home").title}</h1>\`;
   }
 }
-`);
-			break;
-		case "react-native":
-			logger.log(`
+`,
+	"react-native": `
 // App.tsx
 import AsyncStorage from "@react-native-async-storage/async-storage";
 import { getLocales } from "expo-localization";
@@ -1289,10 +1182,8 @@ export default function App() {
 }
 
 // In components: const dict = useDictionary("home")
-`);
-			break;
-		case "hapi":
-			logger.log(`
+`,
+	hapi: `
 import Hapi from "@hapi/hapi";
 import { dialexPlugin } from "dialexjs/hapi";
 import { dialex } from "./src/dialex.generated.js";
@@ -1305,10 +1196,8 @@ server.route({
   path: "/",
   handler: (request) => ({ title: request.getDictionary("home").title }),
 });
-`);
-			break;
-		case "adonis":
-			logger.log(`
+`,
+	adonis: `
 // app/middleware/dialex_middleware.ts
 import { createDialexMiddleware } from "dialexjs/adonis";
 import { dialex } from "#start/dialex.generated";
@@ -1319,10 +1208,8 @@ export default createDialexMiddleware({ ...dialex });
 router.use([() => import("#middleware/dialex_middleware")]);
 
 // In handlers: ctx.locale, ctx.getDictionary("home")
-`);
-			break;
-		case "trpc":
-			logger.log(`
+`,
+	trpc: `
 // src/trpc.ts
 import { initTRPC } from "@trpc/server";
 import { createDialexContext } from "dialexjs/trpc";
@@ -1337,23 +1224,70 @@ const t = initTRPC.context<Awaited<ReturnType<typeof createContext>>>().create()
 export const appRouter = t.router({
   greeting: t.procedure.query(({ ctx }) => ctx.getDictionary("home").title),
 });
-`);
-			break;
-		case "nuxt":
-			logger.log(`
+`,
+	nuxt: `
 // nuxt.config.ts
 export default defineNuxtConfig({
   modules: ["dialexjs/nuxt"],
 });
 
 // In components: const dict = useDictionary("home")
-`);
-			break;
-		default: logger.log(`
+`
+};
+/** Printed for a framework without a snippet of its own. */
+const FALLBACK = `
 Import dictionaries and register your framework middleware to begin!
 Run \`npm run dx:generate\` whenever you add new dictionary files.
-`);
-	}
+`;
+function printQuickstart(framework) {
+	logger.log("");
+	logger.info(pc.bold(`Quick start for ${framework.toUpperCase()}:`));
+	logger.log(Object.hasOwn(SNIPPETS, framework) ? SNIPPETS[framework] : FALLBACK);
+}
+//#endregion
+//#region src/commands/init/starter-dictionary.ts
+/** Writes `home.content.ts` with one entry per locale, unless it is already there. */
+function createStarterDictionary(root, framework, localeList) {
+	const targetDir = (framework === "react-router" || framework === "adonis") && fs.existsSync(path.join(root, "app")) ? path.join(root, "app") : fs.existsSync(path.join(root, "src")) ? path.join(root, "src") : root;
+	const dictPath = path.join(targetDir, "home.content.ts");
+	if (!fs.existsSync(dictPath)) {
+		const dictContent = `import { defineDictionary } from "dialexjs";
+
+export default defineDictionary("home", {
+${localeList.map((loc) => `  ${loc}: {
+    title: "Welcome to Dialex (${loc})!",
+    description: "Type-safe internationalization.",
+    greeting: (name: string) => "Hello, " + name + "!",
+  },`).join("\n")}
+});
+`;
+		fs.writeFileSync(dictPath, dictContent, "utf-8");
+		logger.success(`Created starter dictionary at ${pc.bold(path.relative(root, dictPath))}`);
+	} else logger.info("home.content.ts already exists, skipping creation.");
+}
+//#endregion
+//#region src/commands/init/index.ts
+async function runInit(options = {}) {
+	const root = options.cwd || process.cwd();
+	const detected = detectFramework(root);
+	const isInteractive = !options.yes && process.stdin.isTTY;
+	let framework = options.framework || detected.framework;
+	let defaultLocale = options.defaultLocale || "en";
+	let localesInput = options.locales || "en,tr";
+	if (isInteractive) {
+		const answers = await askInit(options, detected);
+		if (!answers) return;
+		({framework, defaultLocale, localesInput} = answers);
+	} else logger.info(`Auto-detected framework: ${pc.bold(framework)} (${detected.matchedRule})`);
+	const localeList = Array.from(/* @__PURE__ */ new Set([defaultLocale, ...localesInput.split(",").map((s) => s.trim()).filter(Boolean)]));
+	await writeDialexConfig(root, framework, defaultLocale, localeList);
+	if (framework === "nuxt") await registerNuxtModule(root);
+	createStarterDictionary(root, framework, localeList);
+	generateDictionaries(root, { static: true });
+	logger.success("Generated types and standalone dictionary registry!");
+	updatePackageJson(root);
+	if (options.ai === true || options.yes && options.ai !== false && options.noAi !== true) setupAiSupport(root);
+	printQuickstart(framework);
 	logger.info("Keep dialex.generated.ts current: run `dx generate --watch` while you develop, or use the Dialex VS Code extension, which regenerates on save.");
 	if (isInteractive) p.outro(pc.green("✔ dialex is configured and ready to go!"));
 }