@dialexjs/cli 0.7.1 → 0.9.1

package/dist/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { A as scanFiles, C as lockPath, E as writeLock, F as getString, I as hasPath, L as listLeaves, M as copyLeaf, R as listLocales, S as lockFor, T as record, U as saveDictionaryFile, W as setString, a as renderGenerated, d as resolveDialexConfig, f as logger, i as generateDictionaries, j as TODO_PREFIX, m as analyzeProject, o as runGenerate, r as toKey, t as loadProject, w as readLock, x as isStale, y as LOCK_FILE, z as loadDictionaryFile } from "./project-Dz0FbydQ.mjs";
+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 { Command } from "commander";
 import fs from "node:fs";
 import path from "node:path";
@@ -10,7 +10,7 @@ import { argumentSignature, getArguments, isIcuStructured, parseMessage } from "
 import * as p from "@clack/prompts";
 import { addNuxtModule } from "magicast/helpers";
 //#region package.json
-var version = "0.7.1";
+var version = "0.9.1";
 //#endregion
 //#region src/commands/check.ts
 function addIssue(diag, issue) {
@@ -510,6 +510,16 @@ function detectFramework(root) {
 			confidence: "high",
 			matchedRule: "package.json dependencies (@nestjs/core)"
 		};
+		if ("@adonisjs/core" in allDeps) return {
+			framework: "adonis",
+			confidence: "high",
+			matchedRule: "package.json dependencies (@adonisjs/core)"
+		};
+		if ("@hapi/hapi" in allDeps) return {
+			framework: "hapi",
+			confidence: "high",
+			matchedRule: "package.json dependencies (@hapi/hapi)"
+		};
 		if ("fastify" in allDeps) return {
 			framework: "fastify",
 			confidence: "high",
@@ -535,11 +545,51 @@ function detectFramework(root) {
 			confidence: "high",
 			matchedRule: "package.json dependencies (hono)"
 		};
+		if ("@trpc/server" in allDeps) return {
+			framework: "trpc",
+			confidence: "high",
+			matchedRule: "package.json dependencies (@trpc/server)"
+		};
+		if ("@builder.io/qwik" in allDeps) return {
+			framework: "qwik",
+			confidence: "high",
+			matchedRule: "package.json dependencies (@builder.io/qwik)"
+		};
+		if ("react-native" in allDeps || "expo" in allDeps) return {
+			framework: "react-native",
+			confidence: "high",
+			matchedRule: "package.json dependencies (react-native/expo)"
+		};
+		if ("@react-router/dev" in allDeps) return {
+			framework: "react-router",
+			confidence: "high",
+			matchedRule: "package.json dependencies (@react-router/dev)"
+		};
+		if ("solid-js" in allDeps) return {
+			framework: "solid",
+			confidence: "high",
+			matchedRule: "package.json dependencies (solid-js)"
+		};
+		if ("svelte" in allDeps) return {
+			framework: "svelte",
+			confidence: "high",
+			matchedRule: "package.json dependencies (svelte)"
+		};
 		if ("vue" in allDeps && !("react" in allDeps)) return {
 			framework: "vue",
 			confidence: "high",
 			matchedRule: "package.json dependencies (vue)"
 		};
+		if ("preact" in allDeps) return {
+			framework: "preact",
+			confidence: "high",
+			matchedRule: "package.json dependencies (preact)"
+		};
+		if ("lit" in allDeps && !("react" in allDeps)) return {
+			framework: "lit",
+			confidence: "high",
+			matchedRule: "package.json dependencies (lit)"
+		};
 		if ("react" in allDeps || "vite" in allDeps) return {
 			framework: "react",
 			confidence: "high",
@@ -554,7 +604,8 @@ function detectFramework(root) {
 	for (const [framework, base] of [
 		["nuxt", "nuxt.config"],
 		["sveltekit", "svelte.config"],
-		["astro", "astro.config"]
+		["astro", "astro.config"],
+		["react-router", "react-router.config"]
 	]) if ([
 		"js",
 		"mjs",
@@ -697,6 +748,56 @@ async function runInit(options = {}) {
 				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({
@@ -740,6 +841,7 @@ async function runInit(options = {}) {
 	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);
@@ -747,6 +849,7 @@ async function runInit(options = {}) {
 				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`);
@@ -758,6 +861,7 @@ 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`);
 		}
@@ -767,7 +871,7 @@ export default defineConfig({});
 
 export default defineConfig({
   defaultLocale: "${defaultLocale}",
-  locales: [${localeList.map((l) => `"${l}"`).join(", ")}],
+  locales: [${localeList.map((l) => `"${l}"`).join(", ")}],${generatedOutput ? `\n  output: "${generatedOutput}",` : ""}
 });
 `;
 		fs.writeFileSync(configPath, fallback, "utf-8");
@@ -787,7 +891,7 @@ export default defineConfig({
 			logger.warn("Could not update the Nuxt config; add the dialexjs/nuxt module manually.");
 		}
 	}
-	const targetDir = fs.existsSync(path.join(root, "src")) ? path.join(root, "src") : root;
+	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";
@@ -803,7 +907,7 @@ ${localeList.map((loc) => `  ${loc}: {
 		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);
+	generateDictionaries(root, { static: true });
 	logger.success("Generated types and standalone dictionary registry!");
 	const pkgPath = path.join(root, "package.json");
 	if (fs.existsSync(pkgPath)) try {
@@ -884,11 +988,11 @@ This project uses [Dialex](https://github.com/awaiden/dialex) for type-safe inte
 		case "hono":
 			logger.log(`
 import { Hono } from "hono";
-import { dialex } from "dialexjs/hono";
-import dictionaries from "./src/dialex.generated.js";
+import { dialexHono } from "dialexjs/hono";
+import { dialex } from "./src/dialex.generated.js";
 
 const app = new Hono();
-app.use("*", dialex({ dictionaries }));
+app.use("*", dialexHono({ ...dialex }));
 
 app.get("/", (c) => {
   const dict = c.var.getDictionary("home");
@@ -900,10 +1004,10 @@ app.get("/", (c) => {
 			logger.log(`
 import Fastify from "fastify";
 import { dialexPlugin } from "dialexjs/fastify";
-import dictionaries from "./src/dialex.generated.js";
+import { dialex } from "./src/dialex.generated.js";
 
 const app = Fastify();
-await app.register(dialexPlugin, { dictionaries });
+await app.register(dialexPlugin, { ...dialex });
 
 app.get("/", (req) => {
   const dict = req.getDictionary("home");
@@ -914,11 +1018,11 @@ app.get("/", (req) => {
 		case "express":
 			logger.log(`
 import express from "express";
-import { dialex } from "dialexjs/express";
-import dictionaries from "./src/dialex.generated.js";
+import { dialexExpress } from "dialexjs/express";
+import { dialex } from "./src/dialex.generated.js";
 
 const app = express();
-app.use(dialex({ dictionaries }));
+app.use(dialexExpress({ ...dialex }));
 
 app.get("/", (req, res) => {
   const dict = req.getDictionary("home");
@@ -929,11 +1033,11 @@ app.get("/", (req, res) => {
 		case "koa":
 			logger.log(`
 import Koa from "koa";
-import { dialex } from "dialexjs/koa";
-import dictionaries from "./src/dialex.generated.js";
+import { dialexKoa } from "dialexjs/koa";
+import { dialex } from "./src/dialex.generated.js";
 
 const app = new Koa();
-app.use(dialex({ dictionaries }));
+app.use(dialexKoa({ ...dialex }));
 
 app.use((ctx) => {
   const dict = ctx.getDictionary("home");
@@ -945,10 +1049,10 @@ app.use((ctx) => {
 			logger.log(`
 import { Module } from "@nestjs/common";
 import { DialexModule } from "dialexjs/nestjs";
-import dictionaries from "./src/dialex.generated.js";
+import { dialex } from "./src/dialex.generated.js";
 
 @Module({
-  imports: [DialexModule.forRoot({ dictionaries })],
+  imports: [DialexModule.forRoot({ ...dialex })],
 })
 export class AppModule {}
 `);
@@ -997,11 +1101,11 @@ createRoot(document.getElementById("root")!).render(
 		case "elysia":
 			logger.log(`
 import { Elysia } from "elysia";
-import { dialex } from "dialexjs/elysia";
-import dictionaries from "./src/dialex.generated.js";
+import { dialexElysia } from "dialexjs/elysia";
+import { dialex } from "./src/dialex.generated.js";
 
 new Elysia()
-  .use(dialex({ dictionaries }))
+  .use(dialexElysia({ ...dialex }))
   .get("/", ({ getDictionary }) => ({ title: getDictionary("home").title }))
   .listen(3000);
 `);
@@ -1010,9 +1114,9 @@ new Elysia()
 			logger.log(`
 // src/hooks.server.ts
 import { dialexHandle } from "dialexjs/sveltekit";
-import dictionaries from "./dialex.generated.js";
+import { dialex } from "./dialex.generated.js";
 
-export const handle = dialexHandle({ dictionaries });
+export const handle = dialexHandle({ ...dialex });
 
 // src/app.html: <html lang="%dialex.lang%">
 // In load functions: locals.getDictionary("home")
@@ -1021,10 +1125,10 @@ export const handle = dialexHandle({ dictionaries });
 		case "astro":
 			logger.log(`
 // src/middleware.ts
-import { dialex } from "dialexjs/astro";
-import dictionaries from "./dialex.generated.js";
+import { dialexAstro } from "dialexjs/astro";
+import { dialex } from "./dialex.generated.js";
 
-export const onRequest = dialex({ dictionaries });
+export const onRequest = dialexAstro({ ...dialex });
 
 // In pages: Astro.locals.getDictionary("home")
 `);
@@ -1040,6 +1144,199 @@ import App from "./App.vue";
 createApp(App).use(createDialex({ ...dialex })).mount("#app");
 
 // In components: const dict = useDictionary("home")
+`);
+			break;
+		case "svelte":
+			logger.log(`
+<!-- src/App.svelte -->
+<script lang="ts">
+  import { provideDialex, useDictionary } from "dialexjs/svelte";
+  import { dialex } from "./dialex.generated";
+
+  const { locale, setLocale } = provideDialex({ ...dialex });
+  const home = useDictionary("home");
+<\/script>
+
+<h1>{$home.title}</h1>
+<button onclick={() => setLocale("tr")}>TR</button>
+`);
+			break;
+		case "solid":
+			logger.log(`
+// src/index.tsx
+import { render } from "solid-js/web";
+import { DialexProvider } from "dialexjs/solid";
+import { dialex } from "./dialex.generated";
+import App from "./App";
+
+render(
+  () => (
+    <DialexProvider {...dialex}>
+      <App />
+    </DialexProvider>
+  ),
+  document.getElementById("root")!,
+);
+
+// In components: const home = useDictionary("home"); then {home().title}
+`);
+			break;
+		case "react-router":
+			logger.log(`
+// app/dialex.server.ts
+import { createDialexHandler } from "dialexjs/web";
+import { dialex } from "./dialex.generated";
+
+export const resolveDialex = createDialexHandler({ ...dialex });
+
+// app/root.tsx
+import { DialexProvider } from "dialexjs/react";
+import { useLoaderData } from "react-router";
+import { dialex } from "./dialex.generated";
+import { resolveDialex } from "./dialex.server";
+
+export async function loader({ request }: Route.LoaderArgs) {
+  const { locale } = await resolveDialex(request);
+  return { locale };
+}
+
+export default function App() {
+  const { locale } = useLoaderData<typeof loader>();
+  return (
+    <DialexProvider {...dialex} initialLocale={locale}>
+      <Outlet />
+    </DialexProvider>
+  );
+}
+`);
+			break;
+		case "preact":
+			logger.log(`
+// src/index.tsx
+import { render } from "preact";
+import { DialexProvider } from "dialexjs/preact";
+import { dialex } from "./dialex.generated";
+import { App } from "./app";
+
+render(
+  <DialexProvider {...dialex}>
+    <App />
+  </DialexProvider>,
+  document.getElementById("app")!,
+);
+
+// In components: const dict = useDictionary("home")
+`);
+			break;
+		case "qwik":
+			logger.log(`
+// src/i18n.ts
+import { createDialexQwik } from "dialexjs/qwik";
+import { dialex } from "./dialex.generated";
+
+export const { useDialexProvider, useDialex, setLocale, useDictionary, useT } =
+  createDialexQwik({ ...dialex });
+
+// src/routes/layout.tsx
+export default component$(() => {
+  useDialexProvider();
+  return <Slot />;
+});
+
+// In components: const home = useDictionary("home"); then {home().title}
+`);
+			break;
+		case "lit":
+			logger.log(`
+// src/i18n.ts
+import { createDialex } from "dialexjs/lit";
+import { dialex } from "./dialex.generated";
+
+export const i18n = createDialex({ ...dialex });
+
+// src/my-element.ts
+import { LitElement, html } from "lit";
+import { DialexController } from "dialexjs/lit";
+import { i18n } from "./i18n";
+
+class MyElement extends LitElement {
+  private dx = new DialexController(this, i18n);
+
+  render() {
+    return html\`<h1>\${this.dx.dictionary("home").title}</h1>\`;
+  }
+}
+`);
+			break;
+		case "react-native":
+			logger.log(`
+// App.tsx
+import AsyncStorage from "@react-native-async-storage/async-storage";
+import { getLocales } from "expo-localization";
+import { DialexProvider } from "dialexjs/react-native";
+import { dialex } from "./src/dialex.generated";
+
+export default function App() {
+  return (
+    <DialexProvider
+      {...dialex}
+      deviceLocales={getLocales().map((locale) => locale.languageTag)}
+      storage={AsyncStorage}
+    >
+      <Home />
+    </DialexProvider>
+  );
+}
+
+// In components: const dict = useDictionary("home")
+`);
+			break;
+		case "hapi":
+			logger.log(`
+import Hapi from "@hapi/hapi";
+import { dialexPlugin } from "dialexjs/hapi";
+import { dialex } from "./src/dialex.generated.js";
+
+const server = Hapi.server({ port: 3000 });
+await server.register({ plugin: dialexPlugin, options: { ...dialex } });
+
+server.route({
+  method: "GET",
+  path: "/",
+  handler: (request) => ({ title: request.getDictionary("home").title }),
+});
+`);
+			break;
+		case "adonis":
+			logger.log(`
+// app/middleware/dialex_middleware.ts
+import { createDialexMiddleware } from "dialexjs/adonis";
+import { dialex } from "#start/dialex.generated";
+
+export default createDialexMiddleware({ ...dialex });
+
+// start/kernel.ts
+router.use([() => import("#middleware/dialex_middleware")]);
+
+// In handlers: ctx.locale, ctx.getDictionary("home")
+`);
+			break;
+		case "trpc":
+			logger.log(`
+// src/trpc.ts
+import { initTRPC } from "@trpc/server";
+import { createDialexContext } from "dialexjs/trpc";
+import { dialex } from "./dialex.generated.js";
+
+const resolveDialex = createDialexContext({ ...dialex });
+
+export const createContext = ({ req }: { req: Request }) => ({ ...resolveDialex(req) });
+
+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":
@@ -1150,6 +1447,13 @@ function preservesPlaceholders(source, translated) {
 }
 //#endregion
 //#region src/commands/translate.ts
+/**
+* The JSON of a result. Tasks carry the parsed dictionary and the key path for the writing step;
+* those are not part of the output (the parsed file is large and not meant to be read).
+*/
+function printable(result) {
+	return JSON.stringify(result, (key, value) => key === "dict" || key === "path" ? void 0 : value, 2);
+}
 async function runTranslate(options = {}) {
 	const root = options.cwd || process.cwd();
 	const project = await loadProject(root, options.config);
@@ -1193,12 +1497,12 @@ async function runTranslate(options = {}) {
 		rejected: []
 	};
 	if (tasks.length === 0) {
-		if (quiet) console.log(JSON.stringify(result, null, 2));
+		if (quiet) console.log(printable(result));
 		else logger.success(`Nothing to translate from "${source}".`);
 		return result;
 	}
 	if (options.dryRun) {
-		if (quiet) console.log(JSON.stringify(result, null, 2));
+		if (quiet) console.log(printable(result));
 		else {
 			logger.info(`Would translate ${tasks.length} string${tasks.length === 1 ? "" : "s"} from "${source}":`);
 			for (const t of tasks) logger.log(`  ${pc.dim(t.locale)} ${t.key}  ${pc.dim(JSON.stringify(t.source))}${t.stale ? pc.yellow("  (out of date)") : ""}`);
@@ -1243,7 +1547,7 @@ async function runTranslate(options = {}) {
 	for (const dict of touched) await saveDictionaryFile(dict.df);
 	if (result.translated > 0) writeLock(root, lock);
 	if (result.rejected.length > 0) result.success = false;
-	if (quiet) console.log(JSON.stringify(result, null, 2));
+	if (quiet) console.log(printable(result));
 	else {
 		logger.success(`Translated ${result.translated} of ${tasks.length} string${tasks.length === 1 ? "" : "s"}.`);
 		if (result.rejected.length > 0) logger.warn(`${result.rejected.length} left unchanged: ${result.rejected.slice(0, 5).join("; ")}${result.rejected.length > 5 ? "; ..." : ""}`);
@@ -1257,7 +1561,7 @@ program.name("dialex").description("Dialex CLI - High-performance, type-safe int
 program.command("generate").alias("gen").description("Generate standalone dictionary bundle and TypeScript declarations").option("-w, --watch", "Watch dictionary files for changes").option("-o, --output <path>", "Custom output file path for generated dictionaries").option("-c, --config <path>", "Custom config path").option("--json", "Print machine-readable JSON").action(async (opts) => {
 	await runGenerate(opts);
 });
-program.command("init").description("Initialize Dialex in the current project").option("-f, --framework <framework>", "Target framework (hono, express, fastify, koa, nestjs, next, react)").option("-d, --default-locale <locale>", "Default locale (e.g. en)").option("-l, --locales <locales>", "Comma-separated supported locales (e.g. en,tr)").option("-y, --yes", "Skip prompts and use defaults").option("--ai", "Configure AI agent support (.agents/skills, .mcp.json, AGENTS.md)").option("--no-ai", "Skip AI agent configuration").action(async (opts) => {
+program.command("init").description("Initialize Dialex in the current project").option("-f, --framework <framework>", "Target framework (hono, express, fastify, koa, nestjs, elysia, sveltekit, astro, vue, nuxt, next, react, react-router, svelte, solid, preact, qwik, lit, react-native, hapi, adonis, trpc)").option("-d, --default-locale <locale>", "Default locale (e.g. en)").option("-l, --locales <locales>", "Comma-separated supported locales (e.g. en,tr)").option("-y, --yes", "Skip prompts and use defaults").option("--ai", "Configure AI agent support (.agents/skills, .mcp.json, AGENTS.md)").option("--no-ai", "Skip AI agent configuration").action(async (opts) => {
 	await runInit(opts);
 });
 program.command("check").alias("lint").description("Verify dictionary key parity and locale completeness").option("-c, --config <path>", "Custom config path").option("--json", "Print machine-readable JSON").option("--github", "Print GitHub Actions annotations").option("--fix", "Insert missing keys marked with [TODO]").option("--fail-on-stale", "Treat translations whose source text changed as errors").option("--src <globs...>", "Source globs to scan for dictionary references").action(async (opts) => {