pabal-resource-mcp 1.5.5 → 1.5.7

package/dist/bin/mcp-server.js

@@ -3448,127 +3448,26 @@ var DEVICE_ASPECT_RATIOS = {
   phone: "9:16",
   tablet: "3:4"
 };
-var GEMINI_SUPPORTED_LOCALES = {
-  // English variants
-  "en": "EN",
-  "en-US": "EN",
-  "en-GB": "EN",
-  "en-AU": "EN",
-  "en-CA": "EN",
-  // Arabic
-  "ar": "ar-EG",
-  "ar-EG": "ar-EG",
-  "ar-SA": "ar-EG",
-  // German
-  "de": "de-DE",
-  "de-DE": "de-DE",
-  // Spanish
-  "es": "es-MX",
-  "es-MX": "es-MX",
-  "es-ES": "es-MX",
-  "es-419": "es-MX",
-  // French
-  "fr": "fr-FR",
-  "fr-FR": "fr-FR",
-  "fr-CA": "fr-FR",
-  // Hindi
-  "hi": "hi-IN",
-  "hi-IN": "hi-IN",
-  // Indonesian
-  "id": "id-ID",
-  "id-ID": "id-ID",
-  // Italian
-  "it": "it-IT",
-  "it-IT": "it-IT",
-  // Japanese
-  "ja": "ja-JP",
-  "ja-JP": "ja-JP",
-  // Korean
-  "ko": "ko-KR",
-  "ko-KR": "ko-KR",
-  // Portuguese
-  "pt": "pt-BR",
-  "pt-BR": "pt-BR",
-  "pt-PT": "pt-BR",
-  // Russian
-  "ru": "ru-RU",
-  "ru-RU": "ru-RU",
-  // Ukrainian
-  "uk": "ua-UA",
-  "uk-UA": "ua-UA",
-  "ua-UA": "ua-UA",
-  // Vietnamese
-  "vi": "vi-VN",
-  "vi-VN": "vi-VN",
-  // Chinese
-  "zh": "zh-CN",
-  "zh-CN": "zh-CN",
-  "zh-Hans": "zh-CN",
-  "zh-TW": "zh-CN",
-  "zh-Hant": "zh-CN"
-};
-function isGeminiSupportedLocale(locale) {
-  return locale in GEMINI_SUPPORTED_LOCALES;
-}
-function getUnsupportedLocales(locales) {
-  return locales.filter((locale) => !isGeminiSupportedLocale(locale));
-}
-var LANGUAGE_NAMES = {
-  "en-US": "English (US)",
-  "en-GB": "English (UK)",
-  "en-AU": "English (Australia)",
-  "en-CA": "English (Canada)",
-  "ko-KR": "Korean",
-  "ja-JP": "Japanese",
-  "zh-Hans": "Simplified Chinese",
-  "zh-Hant": "Traditional Chinese",
-  "zh-CN": "Simplified Chinese",
-  "zh-TW": "Traditional Chinese",
-  "fr-FR": "French",
-  "fr-CA": "French (Canada)",
+var GEMINI_LANGUAGE_NAMES = {
+  "en-US": "English",
+  "ar-EG": "Arabic",
   "de-DE": "German",
-  "es-ES": "Spanish (Spain)",
-  "es-419": "Spanish (Latin America)",
-  "es-MX": "Spanish (Mexico)",
-  "pt-BR": "Portuguese (Brazil)",
-  "pt-PT": "Portuguese (Portugal)",
+  "es-MX": "Spanish",
+  "fr-FR": "French",
+  "hi-IN": "Hindi",
+  "id-ID": "Indonesian",
   "it-IT": "Italian",
-  "nl-NL": "Dutch",
+  "ja-JP": "Japanese",
+  "ko-KR": "Korean",
+  "pt-BR": "Portuguese",
   "ru-RU": "Russian",
-  "ar": "Arabic",
-  "ar-SA": "Arabic",
-  "hi-IN": "Hindi",
-  "th-TH": "Thai",
+  "ua-UA": "Ukrainian",
   "vi-VN": "Vietnamese",
-  "id-ID": "Indonesian",
-  "ms-MY": "Malay",
-  "tr-TR": "Turkish",
-  "pl-PL": "Polish",
-  "uk-UA": "Ukrainian",
-  "cs-CZ": "Czech",
-  "el-GR": "Greek",
-  "ro-RO": "Romanian",
-  "hu-HU": "Hungarian",
-  "sv-SE": "Swedish",
-  "da-DK": "Danish",
-  "fi-FI": "Finnish",
-  "no-NO": "Norwegian",
-  "he-IL": "Hebrew",
-  "sk-SK": "Slovak",
-  "bg-BG": "Bulgarian",
-  "hr-HR": "Croatian",
-  "ca-ES": "Catalan"
+  "zh-CN": "Chinese"
 };
 function getLanguageName(locale) {
-  if (LANGUAGE_NAMES[locale]) {
-    return LANGUAGE_NAMES[locale];
-  }
-  const baseCode = locale.split("-")[0];
-  const matchingKey = Object.keys(LANGUAGE_NAMES).find(
-    (key) => key.startsWith(baseCode + "-") || key === baseCode
-  );
-  if (matchingKey) {
-    return LANGUAGE_NAMES[matchingKey];
+  if (locale in GEMINI_LANGUAGE_NAMES) {
+    return GEMINI_LANGUAGE_NAMES[locale];
   }
   return locale;
 }
@@ -3591,7 +3490,7 @@ function readImageAsBase64(imagePath) {
 function getAspectRatioForDevice(deviceType) {
   return DEVICE_ASPECT_RATIOS[deviceType];
 }
-async function translateImage(sourcePath, sourceLocale, targetLocale, outputPath, deviceType, preserveWords) {
+async function translateImage(sourcePath, sourceLocale, targetLocale, outputPaths, deviceType, preserveWords) {
   try {
     const client = getGeminiClient();
     const sourceLanguage = getLanguageName(sourceLocale);
@@ -3650,14 +3549,17 @@ IMPORTANT INSTRUCTIONS:
     for (const part of parts) {
       if (part.inlineData?.data) {
         const imageBuffer = Buffer.from(part.inlineData.data, "base64");
-        const outputDir = path10.dirname(outputPath);
-        if (!fs10.existsSync(outputDir)) {
-          fs10.mkdirSync(outputDir, { recursive: true });
+        for (const outputPath of outputPaths) {
+          const outputDir = path10.dirname(outputPath);
+          if (!fs10.existsSync(outputDir)) {
+            fs10.mkdirSync(outputDir, { recursive: true });
+          }
+          await sharp(imageBuffer).png().toFile(outputPath);
         }
-        await sharp(imageBuffer).png().toFile(outputPath);
         return {
           success: true,
-          outputPath
+          outputPath: outputPaths[0]
+          // Return primary path
         };
       }
     }
@@ -3695,7 +3597,7 @@ async function translateImagesWithProgress(translations, onProgress, preserveWor
       translation.sourcePath,
       translation.sourceLocale,
       translation.targetLocale,
-      translation.outputPath,
+      translation.outputPaths,
       translation.deviceType,
       preserveWords
     );
@@ -3717,6 +3619,81 @@ async function translateImagesWithProgress(translations, onProgress, preserveWor
   return { successful, failed, errors };
 }
 
+// src/tools/aso/utils/localize-screenshots/locale-mapping.constants.ts
+var GEMINI_LOCALE_GROUPS = {
+  // English - covers all English variants
+  "en-US": ["en-US", "en-AU", "en-CA", "en-GB", "en-IN", "en-SG", "en-ZA"],
+  // Arabic - Gemini ar-EG → Unified ar
+  "ar-EG": ["ar"],
+  // German
+  "de-DE": ["de-DE"],
+  // Spanish - covers Latin America, Spain, and US Spanish
+  "es-MX": ["es-419", "es-ES", "es-US"],
+  // French - covers France and Canada
+  "fr-FR": ["fr-FR", "fr-CA"],
+  // Hindi
+  "hi-IN": ["hi-IN"],
+  // Indonesian
+  "id-ID": ["id-ID"],
+  // Italian
+  "it-IT": ["it-IT"],
+  // Japanese
+  "ja-JP": ["ja-JP"],
+  // Korean
+  "ko-KR": ["ko-KR"],
+  // Portuguese - covers Brazil and Portugal
+  "pt-BR": ["pt-BR", "pt-PT"],
+  // Russian
+  "ru-RU": ["ru-RU"],
+  // Ukrainian - Gemini ua-UA → Unified uk-UA
+  "ua-UA": ["uk-UA"],
+  // Vietnamese
+  "vi-VN": ["vi-VN"],
+  // Chinese - covers Simplified, Traditional, and Hong Kong
+  "zh-CN": ["zh-Hans", "zh-Hant", "zh-HK"]
+};
+function getGeminiLocale(unifiedLocale) {
+  for (const [geminiLocale, unifiedLocales] of Object.entries(
+    GEMINI_LOCALE_GROUPS
+  )) {
+    if (unifiedLocales.includes(unifiedLocale)) {
+      return geminiLocale;
+    }
+  }
+  return null;
+}
+function prepareLocalesForTranslation(locales, primaryLocale) {
+  const targetLocales = locales.filter((l) => l !== primaryLocale);
+  const localeMapping = /* @__PURE__ */ new Map();
+  const geminiLocalesNeeded = /* @__PURE__ */ new Set();
+  const skippedLocales = [];
+  for (const locale of targetLocales) {
+    const geminiLocale = getGeminiLocale(locale);
+    if (geminiLocale === null) {
+      skippedLocales.push(locale);
+      continue;
+    }
+    geminiLocalesNeeded.add(geminiLocale);
+    const existing = localeMapping.get(geminiLocale) || [];
+    if (!existing.includes(locale)) {
+      existing.push(locale);
+    }
+    localeMapping.set(geminiLocale, existing);
+  }
+  const groupedLocales = [];
+  for (const [, unifiedLocales] of localeMapping) {
+    if (unifiedLocales.length > 1) {
+      groupedLocales.push(...unifiedLocales.slice(1));
+    }
+  }
+  return {
+    translatableLocales: Array.from(geminiLocalesNeeded),
+    localeMapping,
+    skippedLocales,
+    groupedLocales
+  };
+}
+
 // src/tools/aso/utils/localize-screenshots/image-resizer.util.ts
 import sharp2 from "sharp";
 import fs11 from "fs";
@@ -3846,7 +3823,9 @@ var localizeScreenshotsInputSchema = z7.object({
     "Specific target locales to translate to. If not provided, all supported locales from the product will be used."
   ),
   deviceTypes: z7.array(z7.enum(["phone", "tablet"])).optional().default(["phone", "tablet"]).describe("Device types to process (default: both phone and tablet)"),
-  dryRun: z7.boolean().optional().default(false).describe("Preview mode - shows what would be translated without actually translating"),
+  dryRun: z7.boolean().optional().default(false).describe(
+    "Preview mode - shows what would be translated without actually translating"
+  ),
   skipExisting: z7.boolean().optional().default(true).describe("Skip translation if target file already exists (default: true)"),
   screenshotNumbers: z7.union([
     z7.array(z7.number().int().positive()),
@@ -3927,7 +3906,7 @@ function getSupportedLocales(slug) {
   };
 }
 function getTargetLocales(allLocales, primaryLocale, requestedTargets) {
-  let targets = allLocales.filter((locale) => locale !== primaryLocale);
+  let localesToProcess = allLocales;
   if (requestedTargets && requestedTargets.length > 0) {
     const validTargets = requestedTargets.filter((t) => allLocales.includes(t));
     const invalidTargets = requestedTargets.filter(
@@ -3938,31 +3917,43 @@ function getTargetLocales(allLocales, primaryLocale, requestedTargets) {
         `Warning: Some requested locales are not in product: ${invalidTargets.join(", ")}`
       );
     }
-    targets = validTargets.filter((t) => t !== primaryLocale);
+    localesToProcess = validTargets;
   }
-  const skippedLocales = getUnsupportedLocales(targets);
-  const supportedTargets = targets.filter((t) => isGeminiSupportedLocale(t));
-  return { targets: supportedTargets, skippedLocales };
+  localesToProcess = localesToProcess.filter((l) => l !== primaryLocale);
+  const { translatableLocales, localeMapping, skippedLocales, groupedLocales } = prepareLocalesForTranslation(localesToProcess, primaryLocale);
+  return {
+    targets: translatableLocales,
+    skippedLocales,
+    groupedLocales,
+    localeMapping
+  };
 }
-function buildTranslationTasks(slug, screenshots, primaryLocale, targetLocales, skipExisting) {
+function buildTranslationTasks(slug, screenshots, primaryLocale, targetLocales, localeMapping, skipExisting) {
   const tasks = [];
   const screenshotsDir = getScreenshotsDir(slug);
   for (const targetLocale of targetLocales) {
+    const outputLocales = localeMapping.get(targetLocale) || [];
     for (const screenshot of screenshots) {
-      const outputPath = path11.join(
-        screenshotsDir,
-        targetLocale,
-        screenshot.type,
-        screenshot.filename
-      );
-      if (skipExisting && fs12.existsSync(outputPath)) {
+      const outputPaths = [];
+      for (const locale of outputLocales) {
+        const outputPath = path11.join(
+          screenshotsDir,
+          locale,
+          screenshot.type,
+          screenshot.filename
+        );
+        if (!skipExisting || !fs12.existsSync(outputPath)) {
+          outputPaths.push(outputPath);
+        }
+      }
+      if (outputPaths.length === 0) {
         continue;
       }
       tasks.push({
         sourcePath: screenshot.fullPath,
         sourceLocale: primaryLocale,
         targetLocale,
-        outputPath,
+        outputPaths,
         deviceType: screenshot.type,
         filename: screenshot.filename
       });
@@ -4013,11 +4004,12 @@ async function handleLocalizeScreenshots(input) {
       ]
     };
   }
-  const { targets: targetLocales, skippedLocales } = getTargetLocales(
-    allLocales,
-    primaryLocale,
-    requestedTargetLocales
-  );
+  const {
+    targets: targetLocales,
+    skippedLocales,
+    groupedLocales,
+    localeMapping
+  } = getTargetLocales(allLocales, primaryLocale, requestedTargetLocales);
   if (targetLocales.length === 0) {
     const skippedMsg = skippedLocales.length > 0 ? ` (Skipped due to Gemini limitation: ${skippedLocales.join(", ")})` : "";
     return {
@@ -4029,9 +4021,16 @@ async function handleLocalizeScreenshots(input) {
       ]
     };
   }
-  results.push(`\u{1F3AF} Target locales: ${targetLocales.join(", ")}`);
+  results.push(`\u{1F3AF} Target locales to translate: ${targetLocales.join(", ")}`);
+  if (groupedLocales.length > 0) {
+    results.push(
+      `\u{1F4CB} Grouped locales (saved together): ${groupedLocales.join(", ")}`
+    );
+  }
   if (skippedLocales.length > 0) {
-    results.push(`\u26A0\uFE0F Skipped locales (not supported by Gemini): ${skippedLocales.join(", ")}`);
+    results.push(
+      `\u26A0\uFE0F Skipped locales (not supported by Gemini): ${skippedLocales.join(", ")}`
+    );
   }
   const sourceScreenshots = scanLocaleScreenshots(appInfo.slug, primaryLocale);
   let filteredScreenshots = sourceScreenshots.filter(
@@ -4081,14 +4080,21 @@ ${screenshotsDir2}/${primaryLocale}/tablet/1.png, 2.png, ...`
       ]
     };
   }
-  const phoneCount = filteredScreenshots.filter((s) => s.type === "phone").length;
-  const tabletCount = filteredScreenshots.filter((s) => s.type === "tablet").length;
-  results.push(`\u{1F4F8} Source screenshots: ${phoneCount} phone, ${tabletCount} tablet`);
+  const phoneCount = filteredScreenshots.filter(
+    (s) => s.type === "phone"
+  ).length;
+  const tabletCount = filteredScreenshots.filter(
+    (s) => s.type === "tablet"
+  ).length;
+  results.push(
+    `\u{1F4F8} Source screenshots: ${phoneCount} phone, ${tabletCount} tablet`
+  );
   const tasks = buildTranslationTasks(
     appInfo.slug,
     filteredScreenshots,
     primaryLocale,
     targetLocales,
+    localeMapping,
     skipExisting
   );
   if (tasks.length === 0) {
@@ -4117,8 +4123,11 @@ ${screenshotsDir2}/${primaryLocale}/tablet/1.png, 2.png, ...`
       tasksByLocale[task.targetLocale].push(task);
     }
     for (const [locale, localeTasks] of Object.entries(tasksByLocale)) {
+      const grouped = localeMapping.get(locale) || [];
+      const groupedOthers = grouped.filter((l) => l !== locale);
+      const groupInfo = groupedOthers.length > 0 ? ` \u2192 also: ${groupedOthers.join(", ")}` : "";
       results.push(`
-\u{1F4C1} ${locale}:`);
+\u{1F4C1} ${locale}${groupInfo}:`);
       for (const task of localeTasks) {
         results.push(`   - ${task.deviceType}/${task.filename}`);
       }
@@ -4168,20 +4177,30 @@ ${screenshotsDir2}/${primaryLocale}/tablet/1.png, 2.png, ...`
       results.push(`   - ${path11.basename(err.path)}: ${err.error}`);
     }
     if (translationResult.errors.length > 5) {
-      results.push(`   ... and ${translationResult.errors.length - 5} more errors`);
+      results.push(
+        `   ... and ${translationResult.errors.length - 5} more errors`
+      );
     }
   }
   if (translationResult.successful > 0) {
     results.push(`
 \u{1F50D} Validating image dimensions...`);
-    const successfulTasks = tasks.filter((t) => fs12.existsSync(t.outputPath));
-    const resizePairs = successfulTasks.map((t) => ({
-      sourcePath: t.sourcePath,
-      translatedPath: t.outputPath
-    }));
+    const resizePairs = [];
+    for (const task of tasks) {
+      for (const outputPath of task.outputPaths) {
+        if (fs12.existsSync(outputPath)) {
+          resizePairs.push({
+            sourcePath: task.sourcePath,
+            translatedPath: outputPath
+          });
+        }
+      }
+    }
     const resizeResult = await batchValidateAndResize(resizePairs);
     if (resizeResult.resized > 0) {
-      results.push(`   \u{1F527} Resized ${resizeResult.resized} images to match source dimensions`);
+      results.push(
+        `   \u{1F527} Resized ${resizeResult.resized} images to match source dimensions`
+      );
     } else {
       results.push(`   \u2705 All image dimensions match source`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pabal-resource-mcp",
-  "version": "1.5.5",
+  "version": "1.5.7",
   "type": "module",
   "description": "MCP server for ASO data management with shared types and utilities",
   "author": "skyu",