@langapi/mcp-server 1.0.6 → 1.1.0

package/dist/utils/apple-common.js

@@ -0,0 +1,118 @@
+/**
+ * Common utilities for iOS/macOS localization file handling
+ *
+ * Apple localization uses several file formats:
+ * - Localizable.strings: Traditional key-value format ("key" = "value";)
+ * - String Catalogs (.xcstrings): Modern JSON-based format (Xcode 15+)
+ * - Localizable.stringsdict: XML plist for plurals/gender
+ *
+ * Files are typically organized in .lproj directories:
+ * - en.lproj/Localizable.strings
+ * - de.lproj/Localizable.strings
+ */
+/**
+ * Check if a file is an Apple .strings file
+ */
+export function isStringsFile(filePath) {
+    return filePath.toLowerCase().endsWith(".strings");
+}
+/**
+ * Check if a file is an Apple String Catalog (.xcstrings)
+ */
+export function isXCStringsFile(filePath) {
+    return filePath.toLowerCase().endsWith(".xcstrings");
+}
+/**
+ * Check if a file is an Apple stringsdict file
+ */
+export function isStringsDictFile(filePath) {
+    return filePath.toLowerCase().endsWith(".stringsdict");
+}
+/**
+ * Detect Apple file type from file path
+ * @returns The file type or null if not an Apple localization file
+ */
+export function detectAppleFileType(filePath) {
+    if (isStringsFile(filePath))
+        return "strings";
+    if (isXCStringsFile(filePath))
+        return "xcstrings";
+    if (isStringsDictFile(filePath))
+        return "stringsdict";
+    return null;
+}
+/**
+ * Check if a file path is any Apple localization file type
+ */
+export function isAppleLocalizationFile(filePath) {
+    return detectAppleFileType(filePath) !== null;
+}
+/**
+ * Extract language code from .lproj directory path
+ *
+ * Apple organizes locale files in language-specific directories:
+ * - en.lproj/Localizable.strings -> "en"
+ * - pt-BR.lproj/Main.strings -> "pt-BR"
+ * - Base.lproj/Main.strings -> null (Base is special, not a language)
+ *
+ * @param filePath Path containing .lproj directory
+ * @returns Language code or null if not found or is Base.lproj
+ */
+export function extractLanguageFromLproj(filePath) {
+    // Match language code before .lproj
+    // Supports: en.lproj, de.lproj, pt-BR.lproj, zh-Hans.lproj
+    const match = filePath.match(/\/([a-zA-Z]{2,3}(?:-[a-zA-Z]{2,4})?)\.lproj\//i);
+    if (!match) {
+        return null;
+    }
+    const lang = match[1];
+    // Skip Base.lproj - it's a special case for base internationalization
+    if (lang.toLowerCase() === "base") {
+        return null;
+    }
+    return lang;
+}
+/**
+ * Compute target file path for .lproj directory structure
+ *
+ * Replaces the source language directory with the target language:
+ * - /Project/en.lproj/Localizable.strings -> /Project/de.lproj/Localizable.strings
+ *
+ * @param sourcePath Original file path with source language .lproj
+ * @param sourceLang Source language code
+ * @param targetLang Target language code
+ * @returns Target file path or null if no .lproj pattern found
+ */
+export function computeAppleLprojTargetPath(sourcePath, sourceLang, targetLang) {
+    // Create regex that matches the source language .lproj directory
+    // Use case-insensitive matching for the language code
+    const lprojPattern = new RegExp(`(/)${escapeRegExp(sourceLang)}\\.lproj(/)`, "i");
+    if (!lprojPattern.test(sourcePath)) {
+        return null;
+    }
+    // Replace source language with target language in the .lproj directory name
+    return sourcePath.replace(lprojPattern, `$1${targetLang}.lproj$2`);
+}
+/**
+ * Get the file extension for Apple localization files
+ */
+export function getAppleFileExtension(filePath) {
+    const fileType = detectAppleFileType(filePath);
+    switch (fileType) {
+        case "strings":
+            return ".strings";
+        case "xcstrings":
+            return ".xcstrings";
+        case "stringsdict":
+            return ".stringsdict";
+        default:
+            return "";
+    }
+}
+/**
+ * Escape special regex characters in a string
+ */
+function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=apple-common.js.map

package/dist/utils/apple-common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-common.js","sourceRoot":"","sources":["../../src/utils/apple-common.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,IAAI,aAAa,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,eAAe,CAAC,QAAQ,CAAC;QAAE,OAAO,WAAW,CAAC;IAClD,IAAI,iBAAiB,CAAC,QAAQ,CAAC;QAAE,OAAO,aAAa,CAAC;IACtD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,OAAO,mBAAmB,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;AAChD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,oCAAoC;IACpC,2DAA2D;IAC3D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAE/E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEtB,sEAAsE;IACtE,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAAkB,EAClB,UAAkB,EAClB,UAAkB;IAElB,iEAAiE;IACjE,sDAAsD;IACtD,MAAM,YAAY,GAAG,IAAI,MAAM,CAC7B,MAAM,YAAY,CAAC,UAAU,CAAC,aAAa,EAC3C,GAAG,CACJ,CAAC;IAEF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4EAA4E;IAC5E,OAAO,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,UAAU,UAAU,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC/C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC;QACpB,KAAK,WAAW;YACd,OAAO,YAAY,CAAC;QACtB,KAAK,aAAa;YAChB,OAAO,cAAc,CAAC;QACxB;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}

package/dist/utils/apple-common.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=apple-common.test.d.ts.map

package/dist/utils/apple-common.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-common.test.d.ts","sourceRoot":"","sources":["../../src/utils/apple-common.test.ts"],"names":[],"mappings":""}

package/dist/utils/apple-common.test.js

@@ -0,0 +1,108 @@
+import { describe, it, expect } from "vitest";
+import { isStringsFile, isXCStringsFile, isStringsDictFile, detectAppleFileType, isAppleLocalizationFile, extractLanguageFromLproj, computeAppleLprojTargetPath, } from "./apple-common.js";
+describe("Apple Common Utilities", () => {
+    describe("isStringsFile", () => {
+        it("should return true for .strings files", () => {
+            expect(isStringsFile("Localizable.strings")).toBe(true);
+            expect(isStringsFile("/path/to/en.lproj/Localizable.strings")).toBe(true);
+        });
+        it("should be case-insensitive", () => {
+            expect(isStringsFile("Localizable.STRINGS")).toBe(true);
+            expect(isStringsFile("file.Strings")).toBe(true);
+        });
+        it("should return false for other files", () => {
+            expect(isStringsFile("file.json")).toBe(false);
+            expect(isStringsFile("file.xcstrings")).toBe(false);
+        });
+    });
+    describe("isXCStringsFile", () => {
+        it("should return true for .xcstrings files", () => {
+            expect(isXCStringsFile("Localizable.xcstrings")).toBe(true);
+            expect(isXCStringsFile("/path/to/Localizable.xcstrings")).toBe(true);
+        });
+        it("should be case-insensitive", () => {
+            expect(isXCStringsFile("File.XCSTRINGS")).toBe(true);
+        });
+        it("should return false for other files", () => {
+            expect(isXCStringsFile("file.strings")).toBe(false);
+            expect(isXCStringsFile("file.json")).toBe(false);
+        });
+    });
+    describe("isStringsDictFile", () => {
+        it("should return true for .stringsdict files", () => {
+            expect(isStringsDictFile("Localizable.stringsdict")).toBe(true);
+            expect(isStringsDictFile("/path/to/en.lproj/Localizable.stringsdict")).toBe(true);
+        });
+        it("should be case-insensitive", () => {
+            expect(isStringsDictFile("File.STRINGSDICT")).toBe(true);
+        });
+        it("should return false for other files", () => {
+            expect(isStringsDictFile("file.strings")).toBe(false);
+            expect(isStringsDictFile("file.json")).toBe(false);
+        });
+    });
+    describe("detectAppleFileType", () => {
+        it("should detect .strings files", () => {
+            expect(detectAppleFileType("Localizable.strings")).toBe("strings");
+        });
+        it("should detect .xcstrings files", () => {
+            expect(detectAppleFileType("Localizable.xcstrings")).toBe("xcstrings");
+        });
+        it("should detect .stringsdict files", () => {
+            expect(detectAppleFileType("Localizable.stringsdict")).toBe("stringsdict");
+        });
+        it("should return null for non-Apple files", () => {
+            expect(detectAppleFileType("file.json")).toBeNull();
+            expect(detectAppleFileType("file.arb")).toBeNull();
+        });
+    });
+    describe("isAppleLocalizationFile", () => {
+        it("should return true for Apple files", () => {
+            expect(isAppleLocalizationFile("file.strings")).toBe(true);
+            expect(isAppleLocalizationFile("file.xcstrings")).toBe(true);
+            expect(isAppleLocalizationFile("file.stringsdict")).toBe(true);
+        });
+        it("should return false for non-Apple files", () => {
+            expect(isAppleLocalizationFile("file.json")).toBe(false);
+            expect(isAppleLocalizationFile("file.arb")).toBe(false);
+        });
+    });
+    describe("extractLanguageFromLproj", () => {
+        it("should extract language from en.lproj path", () => {
+            expect(extractLanguageFromLproj("/Project/en.lproj/Localizable.strings")).toBe("en");
+        });
+        it("should handle regional codes like pt-BR.lproj", () => {
+            expect(extractLanguageFromLproj("/Project/pt-BR.lproj/Localizable.strings")).toBe("pt-BR");
+            expect(extractLanguageFromLproj("/Project/zh-Hans.lproj/Main.strings")).toBe("zh-Hans");
+        });
+        it("should return null for Base.lproj", () => {
+            expect(extractLanguageFromLproj("/Project/Base.lproj/Localizable.strings")).toBeNull();
+        });
+        it("should return null for non-lproj paths", () => {
+            expect(extractLanguageFromLproj("/Project/locales/en/file.json")).toBeNull();
+            expect(extractLanguageFromLproj("/Project/en/file.strings")).toBeNull();
+        });
+        it("should handle case-insensitive matching", () => {
+            expect(extractLanguageFromLproj("/Project/EN.lproj/file.strings")).toBe("EN");
+        });
+    });
+    describe("computeAppleLprojTargetPath", () => {
+        it("should compute correct target for .lproj structure", () => {
+            const result = computeAppleLprojTargetPath("/Project/en.lproj/Localizable.strings", "en", "de");
+            expect(result).toBe("/Project/de.lproj/Localizable.strings");
+        });
+        it("should handle nested paths", () => {
+            const result = computeAppleLprojTargetPath("/Project/Resources/en.lproj/Main.strings", "en", "fr");
+            expect(result).toBe("/Project/Resources/fr.lproj/Main.strings");
+        });
+        it("should handle regional codes", () => {
+            const result = computeAppleLprojTargetPath("/Project/pt-BR.lproj/Localizable.strings", "pt-BR", "es-MX");
+            expect(result).toBe("/Project/es-MX.lproj/Localizable.strings");
+        });
+        it("should return null for non-lproj paths", () => {
+            const result = computeAppleLprojTargetPath("/Project/locales/en/file.json", "en", "de");
+            expect(result).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=apple-common.test.js.map

package/dist/utils/apple-common.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-common.test.js","sourceRoot":"","sources":["../../src/utils/apple-common.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/arb-parser.d.ts

@@ -0,0 +1,77 @@
+/**
+ * ARB (Application Resource Bundle) parsing utilities
+ *
+ * ARB files are JSON-based localization files used by Flutter.
+ * They contain:
+ * - @@locale: the locale identifier (e.g., "en", "de")
+ * - Regular keys: translatable strings (e.g., "greeting": "Hello")
+ * - Metadata keys: start with @ (e.g., "@greeting": { description: "..." })
+ *
+ * Metadata should be preserved but NOT translated.
+ */
+import type { KeyValue } from "../api/types.js";
+/**
+ * Check if a file is an ARB file based on extension (case-insensitive)
+ */
+export declare function isArbFile(filePath: string): boolean;
+/**
+ * Get the file extension for locale files (.json or .arb)
+ */
+export declare function getLocaleFileExtension(filePath: string): string;
+/**
+ * Check if a key is ARB metadata (starts with @)
+ */
+export declare function isArbMetadataKey(key: string): boolean;
+/**
+ * Check if a key is the ARB locale identifier (@@locale)
+ */
+export declare function isArbLocaleKey(key: string): boolean;
+/**
+ * Parsed ARB content with translatable strings separated from metadata
+ */
+export interface ArbContent {
+    /** Locale identifier from @@locale, if present */
+    locale: string | null;
+    /** Keys to translate (non-@ prefixed string values) */
+    translatableKeys: KeyValue[];
+    /** Metadata entries (@ prefixed keys with their full values preserved) */
+    metadata: Record<string, unknown>;
+}
+/**
+ * Separate ARB content into translatable strings and metadata
+ *
+ * @param obj - Parsed ARB JSON object
+ * @returns ArbContent with separated translatable keys and preserved metadata
+ */
+export declare function parseArbContent(obj: Record<string, unknown>): ArbContent;
+/**
+ * Reconstruct ARB file content from translations and preserved metadata
+ *
+ * The output maintains ARB conventions:
+ * - @@locale is set to the target locale
+ * - Each translatable key is followed by its @metadata if it exists
+ *
+ * @param translations - Translated key-value pairs
+ * @param metadata - Original metadata from source ARB file
+ * @param targetLocale - Target language code
+ * @returns Reconstructed ARB object ready to be serialized
+ */
+export declare function reconstructArbContent(translations: KeyValue[], metadata: Record<string, unknown>, targetLocale: string): Record<string, unknown>;
+/**
+ * Merge new translations into existing ARB content (incremental update)
+ *
+ * This function supports partial syncs by:
+ * - Preserving existing translations that weren't updated
+ * - Overriding with new translations from API
+ * - Using source metadata for all keys (source is authoritative for metadata)
+ * - Removing keys that no longer exist in source
+ *
+ * @param existingContent - Existing target ARB file content (parsed JSON)
+ * @param newTranslations - New/updated translations from API
+ * @param sourceMetadata - Metadata from source ARB file (authoritative)
+ * @param sourceKeys - Set of all keys in source file (to detect removed keys)
+ * @param targetLocale - Target language code
+ * @returns Merged ARB object ready to be serialized
+ */
+export declare function mergeArbContent(existingContent: Record<string, unknown>, newTranslations: KeyValue[], sourceMetadata: Record<string, unknown>, sourceKeys: Set<string>, targetLocale: string): Record<string, unknown>;
+//# sourceMappingURL=arb-parser.d.ts.map

package/dist/utils/arb-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arb-parser.d.ts","sourceRoot":"","sources":["../../src/utils/arb-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kDAAkD;IAClD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uDAAuD;IACvD,gBAAgB,EAAE,QAAQ,EAAE,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAuBxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,QAAQ,EAAE,EACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,YAAY,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,eAAe,EAAE,QAAQ,EAAE,EAC3B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,YAAY,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmCzB"}

package/dist/utils/arb-parser.js

@@ -0,0 +1,142 @@
+/**
+ * ARB (Application Resource Bundle) parsing utilities
+ *
+ * ARB files are JSON-based localization files used by Flutter.
+ * They contain:
+ * - @@locale: the locale identifier (e.g., "en", "de")
+ * - Regular keys: translatable strings (e.g., "greeting": "Hello")
+ * - Metadata keys: start with @ (e.g., "@greeting": { description: "..." })
+ *
+ * Metadata should be preserved but NOT translated.
+ */
+/**
+ * Check if a file is an ARB file based on extension (case-insensitive)
+ */
+export function isArbFile(filePath) {
+    return filePath.toLowerCase().endsWith(".arb");
+}
+/**
+ * Get the file extension for locale files (.json or .arb)
+ */
+export function getLocaleFileExtension(filePath) {
+    if (isArbFile(filePath))
+        return ".arb";
+    return ".json";
+}
+/**
+ * Check if a key is ARB metadata (starts with @)
+ */
+export function isArbMetadataKey(key) {
+    return key.startsWith("@");
+}
+/**
+ * Check if a key is the ARB locale identifier (@@locale)
+ */
+export function isArbLocaleKey(key) {
+    return key === "@@locale";
+}
+/**
+ * Separate ARB content into translatable strings and metadata
+ *
+ * @param obj - Parsed ARB JSON object
+ * @returns ArbContent with separated translatable keys and preserved metadata
+ */
+export function parseArbContent(obj) {
+    const translatableKeys = [];
+    const metadata = {};
+    let locale = null;
+    for (const [key, value] of Object.entries(obj)) {
+        if (key === "@@locale") {
+            // Extract locale identifier
+            locale = String(value);
+            metadata[key] = value; // Also preserve in metadata for reconstruction
+        }
+        else if (key.startsWith("@")) {
+            // Metadata key - preserve as-is (including nested objects)
+            metadata[key] = value;
+        }
+        else {
+            // Translatable key - must be a string
+            if (typeof value === "string") {
+                translatableKeys.push({ key, value });
+            }
+            // Skip non-string values (shouldn't happen in valid ARB files)
+        }
+    }
+    return { locale, translatableKeys, metadata };
+}
+/**
+ * Reconstruct ARB file content from translations and preserved metadata
+ *
+ * The output maintains ARB conventions:
+ * - @@locale is set to the target locale
+ * - Each translatable key is followed by its @metadata if it exists
+ *
+ * @param translations - Translated key-value pairs
+ * @param metadata - Original metadata from source ARB file
+ * @param targetLocale - Target language code
+ * @returns Reconstructed ARB object ready to be serialized
+ */
+export function reconstructArbContent(translations, metadata, targetLocale) {
+    const result = {};
+    // Add @@locale first (update to target locale)
+    result["@@locale"] = targetLocale;
+    // Interleave translations with their metadata
+    for (const { key, value } of translations) {
+        result[key] = value;
+        // Add corresponding metadata if it exists
+        const metaKey = `@${key}`;
+        if (metaKey in metadata) {
+            result[metaKey] = metadata[metaKey];
+        }
+    }
+    return result;
+}
+/**
+ * Merge new translations into existing ARB content (incremental update)
+ *
+ * This function supports partial syncs by:
+ * - Preserving existing translations that weren't updated
+ * - Overriding with new translations from API
+ * - Using source metadata for all keys (source is authoritative for metadata)
+ * - Removing keys that no longer exist in source
+ *
+ * @param existingContent - Existing target ARB file content (parsed JSON)
+ * @param newTranslations - New/updated translations from API
+ * @param sourceMetadata - Metadata from source ARB file (authoritative)
+ * @param sourceKeys - Set of all keys in source file (to detect removed keys)
+ * @param targetLocale - Target language code
+ * @returns Merged ARB object ready to be serialized
+ */
+export function mergeArbContent(existingContent, newTranslations, sourceMetadata, sourceKeys, targetLocale) {
+    const result = {};
+    // Add @@locale first (update to target locale)
+    result["@@locale"] = targetLocale;
+    // Parse existing content to get current translations
+    const existingArb = parseArbContent(existingContent);
+    const existingTranslationsMap = new Map();
+    for (const { key, value } of existingArb.translatableKeys) {
+        existingTranslationsMap.set(key, value);
+    }
+    // Create map of new translations for quick lookup
+    const newTranslationsMap = new Map();
+    for (const { key, value } of newTranslations) {
+        newTranslationsMap.set(key, value);
+    }
+    // Process all source keys in order
+    // This ensures we only include keys that exist in source (removes deleted keys)
+    for (const key of sourceKeys) {
+        // Use new translation if available, otherwise keep existing, otherwise skip
+        const value = newTranslationsMap.get(key) ?? existingTranslationsMap.get(key);
+        if (value !== undefined) {
+            result[key] = value;
+            // Add metadata from source (source metadata is authoritative)
+            const metaKey = `@${key}`;
+            if (metaKey in sourceMetadata) {
+                result[metaKey] = sourceMetadata[metaKey];
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=arb-parser.js.map

package/dist/utils/arb-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arb-parser.js","sourceRoot":"","sources":["../../src/utils/arb-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,IAAI,SAAS,CAAC,QAAQ,CAAC;QAAE,OAAO,MAAM,CAAC;IACvC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,GAAG,KAAK,UAAU,CAAC;AAC5B,CAAC;AAcD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAA4B;IAC1D,MAAM,gBAAgB,GAAe,EAAE,CAAC;IACxC,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,IAAI,MAAM,GAAkB,IAAI,CAAC;IAEjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YACvB,4BAA4B;YAC5B,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YACvB,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,+CAA+C;QACxE,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,2DAA2D;YAC3D,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,sCAAsC;YACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,gBAAgB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;YACxC,CAAC;YACD,+DAA+D;QACjE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC;AAChD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAAwB,EACxB,QAAiC,EACjC,YAAoB;IAEpB,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,+CAA+C;IAC/C,MAAM,CAAC,UAAU,CAAC,GAAG,YAAY,CAAC;IAElC,8CAA8C;IAC9C,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,YAAY,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACpB,0CAA0C;QAC1C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;YACxB,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAC7B,eAAwC,EACxC,eAA2B,EAC3B,cAAuC,EACvC,UAAuB,EACvB,YAAoB;IAEpB,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,+CAA+C;IAC/C,MAAM,CAAC,UAAU,CAAC,GAAG,YAAY,CAAC;IAElC,qDAAqD;IACrD,MAAM,WAAW,GAAG,eAAe,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,uBAAuB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1D,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,WAAW,CAAC,gBAAgB,EAAE,CAAC;QAC1D,uBAAuB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,kDAAkD;IAClD,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACrD,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,eAAe,EAAE,CAAC;QAC7C,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,mCAAmC;IACnC,gFAAgF;IAChF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,4EAA4E;QAC5E,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,uBAAuB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACpB,8DAA8D;YAC9D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;YAC1B,IAAI,OAAO,IAAI,cAAc,EAAE,CAAC;gBAC9B,MAAM,CAAC,OAAO,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/arb-parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=arb-parser.test.d.ts.map

package/dist/utils/arb-parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arb-parser.test.d.ts","sourceRoot":"","sources":["../../src/utils/arb-parser.test.ts"],"names":[],"mappings":""}