@scoutello/i18n-magic 0.53.0 → 0.54.0

package/src/mcp-server.ts

@@ -67,7 +67,8 @@ function resolveProjectRoot(): string {
 // Zod schema for the add_translation_key tool parameters
 const AddTranslationKeySchema = z.object({
   key: z.string().describe("The translation key to add (e.g., \"welcomeMessage\")"),
-  value: z.string().describe("The English text value for this translation key"),
+  value: z.string().describe("The text value for this translation key"),
+  language: z.string().optional().describe("The language code of the provided value (e.g., \"en\", \"de\", \"fr\"). Defaults to \"en\" (English) if not specified."),
 })
 
 // Zod schema for the list_untranslated_keys tool parameters
@@ -94,7 +95,8 @@ const GetTranslationKeySchema = z.object({
 // Zod schema for the update_translation_key tool parameters
 const UpdateTranslationKeySchema = z.object({
   key: z.string().describe("The translation key to update (e.g., \"welcomeMessage\")"),
-  value: z.string().describe("The new English text value for this translation key"),
+  value: z.string().describe("The new text value for this translation key"),
+  language: z.string().optional().describe("The language code of the provided value (e.g., \"en\", \"de\", \"fr\"). Defaults to \"en\" (English) if not specified."),
   namespace: z
     .string()
     .optional()
@@ -182,7 +184,7 @@ class I18nMagicServer {
         tools: [
           {
             name: "add_translation_key",
-            description:  "Add a new translation key with an English value.",
+            description:  "Add a new translation key with a text value. You can optionally specify the language of the value you're providing (defaults to English).",
             inputSchema: {
               type: "object",
               properties: {
@@ -194,7 +196,12 @@ class I18nMagicServer {
                 value: {
                   type: "string",
                   description:
-                    "The English text value for this translation key",
+                    "The text value for this translation key",
+                },
+                language: {
+                  type: "string",
+                  description:
+                    "The language code of the provided value (e.g., \"en\" for English, \"de\" for German, \"fr\" for French). Defaults to \"en\" if not specified.",
                 },
               },
               required: ["key", "value"],
@@ -240,7 +247,7 @@ class I18nMagicServer {
           {
             name: "update_translation_key",
             description:
-              "Update an existing translation key with a new English value. This will update the key across all locales (translating automatically to other languages) and all namespaces where the key exists. Use this when you need to fix typos, improve wording, or change the text of an existing translation. If you're not sure if a key exists, use get_translation_key or search_translations first.",
+              "Update an existing translation key with a new text value. You can optionally specify the language of the value you're providing (defaults to English). This will update the key across all locales (translating automatically to other languages) and all namespaces where the key exists. Use this when you need to fix typos, improve wording, or change the text of an existing translation. If you're not sure if a key exists, use get_translation_key or search_translations first.",
             inputSchema: {
               type: "object",
               properties: {
@@ -252,7 +259,12 @@ class I18nMagicServer {
                 value: {
                   type: "string",
                   description:
-                    "The new English text value for this translation key",
+                    "The new text value for this translation key",
+                },
+                language: {
+                  type: "string",
+                  description:
+                    "The language code of the provided value (e.g., \"en\" for English, \"de\" for German, \"fr\" for French). Defaults to \"en\" if not specified.",
                 },
                 namespace: {
                   type: "string",
@@ -311,6 +323,7 @@ class I18nMagicServer {
             result = await addTranslationKey({
               key: params.key,
               value: params.value,
+              language: params.language || "en",
               config,
             })
           } finally {
@@ -325,14 +338,15 @@ class I18nMagicServer {
                 text: JSON.stringify(
                   {
                     success: true,
-                    message: `Successfully added translation key "${result.key}" to affected namespaces: ${result.namespace} (${result.locale})`,
+                    message: `Successfully added translation key "${result.key}" to affected namespaces: ${result.namespace} (locales: ${result.locale})`,
                     key: result.key,
                     value: result.value,
+                    providedLanguage: params.language || "en",
                     namespace: result.namespace,
-                    locale: result.locale,
+                    locales: result.locale,
                     nextStep: result.locale.includes(',')
-                      ? "Run 'i18n-magic sync' to translate this key to other locales"
-                      : "Key was translated to default locale. Run 'i18n-magic sync' to translate to other locales",
+                      ? "Key was automatically translated to multiple locales"
+                      : "Run 'i18n-magic sync' to translate this key to other locales",
                     diagnostics: logMessages.join('\n'),
                   },
                   null,
@@ -681,20 +695,21 @@ class I18nMagicServer {
             }
 
             // Build translation cache with new value
+            const inputLanguage = params.language || "en"
             const translationCache: Record<string, string> = {
-              en: params.value,
+              [inputLanguage]: params.value,
             }
 
             // Translate to all other locales
-            const nonEnglishLocales = config.locales.filter((l) => l !== "en")
-            if (nonEnglishLocales.length > 0 && config.openai) {
+            const otherLocales = config.locales.filter((l) => l !== inputLanguage)
+            if (otherLocales.length > 0 && config.openai) {
               const { translateKey } = await import("./lib/utils.js")
               
               await Promise.all(
-                nonEnglishLocales.map(async (locale) => {
+                otherLocales.map(async (locale) => {
                   const translation = await translateKey({
                     context: config.context || "",
-                    inputLanguage: "en",
+                    inputLanguage: inputLanguage,
                     outputLanguage: locale,
                     object: {
                       [params.key]: params.value,
@@ -730,6 +745,7 @@ class I18nMagicServer {
                       message: `Successfully updated translation key "${params.key}" in ${targetNamespaces.length} namespace(s) and ${config.locales.length} locale(s)`,
                       key: params.key,
                       newValue: params.value,
+                      providedLanguage: params.language || "en",
                       namespaces: targetNamespaces,
                       locales: config.locales,
                       diagnostics: logMessages.join('\n'),