@langapi/mcp-server 1.0.7 → 1.1.0

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/strings-parser.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Localizable.strings file parser
+ *
+ * Handles Apple's traditional localization format:
+ * - Key-value pairs: "key" = "value";
+ * - Comments: block and line comments
+ * - Escaped characters: quotes, newlines, tabs, backslashes, Unicode
+ */
+import type { KeyValue } from "../api/types.js";
+/**
+ * Parsed content from a .strings file
+ */
+export interface StringsContent {
+    /** Key-value translation pairs */
+    entries: KeyValue[];
+    /** Comments associated with keys (key -> comment text) */
+    comments: Map<string, string>;
+    /** File-level header comment (at top of file) */
+    headerComment: string | null;
+}
+/**
+ * Parse a Localizable.strings file content
+ *
+ * Handles:
+ * - Basic key-value pairs: "key" = "value";
+ * - Block comments above entries for descriptions
+ * - Escaped quotes and special characters
+ * - Multi-line values
+ *
+ * @param content Raw file content
+ * @returns Parsed content with entries, comments, and header
+ */
+export declare function parseStringsContent(content: string): StringsContent;
+/**
+ * Escape a string for use in a .strings file
+ */
+export declare function escapeStringsValue(value: string): string;
+/**
+ * Reconstruct a .strings file from parsed content
+ *
+ * @param entries Translation key-value pairs
+ * @param comments Comments to associate with keys
+ * @param headerComment Optional file-level header comment
+ * @returns Formatted .strings file content
+ */
+export declare function reconstructStringsContent(entries: KeyValue[], comments: Map<string, string>, headerComment: string | null): string;
+/**
+ * Merge new translations into existing .strings content
+ *
+ * - Preserves existing translations not in newTranslations
+ * - Updates with new translations
+ * - Removes keys not in sourceKeys
+ * - Preserves comments from source
+ *
+ * @param existingContent Existing target file content (raw string)
+ * @param newTranslations New/updated translations from API
+ * @param sourceComments Comments from source file
+ * @param sourceKeys Set of all keys in source file
+ * @returns Merged .strings file content
+ */
+export declare function mergeStringsContent(existingContent: string, newTranslations: KeyValue[], sourceComments: Map<string, string>, sourceKeys: Set<string>): string;
+//# sourceMappingURL=strings-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strings-parser.d.ts","sourceRoot":"","sources":["../../src/utils/strings-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,iDAAiD;IACjD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAmInE;AA2ED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOxD;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,QAAQ,EAAE,EACnB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,CAoBR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,QAAQ,EAAE,EAC3B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,MAAM,CA8BR"}

package/dist/utils/strings-parser.js

@@ -0,0 +1,276 @@
+/**
+ * Localizable.strings file parser
+ *
+ * Handles Apple's traditional localization format:
+ * - Key-value pairs: "key" = "value";
+ * - Comments: block and line comments
+ * - Escaped characters: quotes, newlines, tabs, backslashes, Unicode
+ */
+/**
+ * Parse a Localizable.strings file content
+ *
+ * Handles:
+ * - Basic key-value pairs: "key" = "value";
+ * - Block comments above entries for descriptions
+ * - Escaped quotes and special characters
+ * - Multi-line values
+ *
+ * @param content Raw file content
+ * @returns Parsed content with entries, comments, and header
+ */
+export function parseStringsContent(content) {
+    const entries = [];
+    const comments = new Map();
+    let headerComment = null;
+    // Track current position
+    let pos = 0;
+    let pendingComment = null;
+    let isFirstEntry = true;
+    while (pos < content.length) {
+        // Skip whitespace
+        while (pos < content.length && /\s/.test(content[pos])) {
+            pos++;
+        }
+        if (pos >= content.length)
+            break;
+        // Check for block comment /* ... */
+        if (content.slice(pos, pos + 2) === "/*") {
+            const commentEnd = content.indexOf("*/", pos + 2);
+            if (commentEnd === -1) {
+                // Unterminated comment, skip to end
+                break;
+            }
+            const commentText = content.slice(pos + 2, commentEnd).trim();
+            pendingComment = commentText;
+            pos = commentEnd + 2;
+            continue;
+        }
+        // Check for line comment // ...
+        if (content.slice(pos, pos + 2) === "//") {
+            const lineEnd = content.indexOf("\n", pos);
+            const commentText = lineEnd === -1
+                ? content.slice(pos + 2).trim()
+                : content.slice(pos + 2, lineEnd).trim();
+            pendingComment = commentText;
+            pos = lineEnd === -1 ? content.length : lineEnd + 1;
+            continue;
+        }
+        // Check for quoted key
+        if (content[pos] === '"') {
+            const keyResult = parseQuotedString(content, pos);
+            if (!keyResult) {
+                // Malformed, skip character
+                pos++;
+                continue;
+            }
+            const key = keyResult.value;
+            pos = keyResult.end;
+            // Skip whitespace
+            while (pos < content.length && /\s/.test(content[pos])) {
+                pos++;
+            }
+            // Expect '='
+            if (content[pos] !== "=") {
+                // Malformed, continue
+                continue;
+            }
+            pos++;
+            // Skip whitespace
+            while (pos < content.length && /\s/.test(content[pos])) {
+                pos++;
+            }
+            // Expect quoted value
+            if (content[pos] !== '"') {
+                // Malformed, continue
+                continue;
+            }
+            const valueResult = parseQuotedString(content, pos);
+            if (!valueResult) {
+                // Malformed, skip
+                pos++;
+                continue;
+            }
+            const value = valueResult.value;
+            pos = valueResult.end;
+            // Skip whitespace
+            while (pos < content.length && /\s/.test(content[pos])) {
+                pos++;
+            }
+            // Expect ';'
+            if (content[pos] === ";") {
+                pos++;
+            }
+            // Store entry
+            entries.push({ key, value });
+            // Handle comment
+            if (pendingComment !== null) {
+                if (isFirstEntry && entries.length === 1) {
+                    // Check if this looks like a file header comment (contains copyright, license, etc.)
+                    if (/copyright|license|generated|created by/i.test(pendingComment)) {
+                        headerComment = pendingComment;
+                    }
+                    else {
+                        comments.set(key, pendingComment);
+                    }
+                }
+                else {
+                    comments.set(key, pendingComment);
+                }
+                pendingComment = null;
+            }
+            isFirstEntry = false;
+        }
+        else {
+            // Skip unknown character
+            pos++;
+        }
+    }
+    // If there's a pending comment at the end with no entry, it might be a header
+    if (pendingComment !== null && entries.length === 0) {
+        headerComment = pendingComment;
+    }
+    return { entries, comments, headerComment };
+}
+/**
+ * Parse a quoted string starting at the given position
+ *
+ * @returns Object with unescaped value and end position, or null if malformed
+ */
+function parseQuotedString(content, start) {
+    if (content[start] !== '"')
+        return null;
+    let pos = start + 1;
+    let value = "";
+    while (pos < content.length) {
+        const char = content[pos];
+        if (char === '"') {
+            // End of string
+            return { value, end: pos + 1 };
+        }
+        if (char === "\\") {
+            // Escape sequence
+            pos++;
+            if (pos >= content.length)
+                break;
+            const escaped = content[pos];
+            switch (escaped) {
+                case "n":
+                    value += "\n";
+                    break;
+                case "t":
+                    value += "\t";
+                    break;
+                case "r":
+                    value += "\r";
+                    break;
+                case '"':
+                    value += '"';
+                    break;
+                case "\\":
+                    value += "\\";
+                    break;
+                case "U":
+                case "u":
+                    // Unicode escape: \U0000 or \u0000
+                    const hexLength = escaped === "U" ? 4 : 4;
+                    const hex = content.slice(pos + 1, pos + 1 + hexLength);
+                    if (/^[0-9A-Fa-f]+$/.test(hex)) {
+                        const codePoint = parseInt(hex, 16);
+                        value += String.fromCodePoint(codePoint);
+                        pos += hexLength;
+                    }
+                    else {
+                        // Invalid unicode, keep as-is
+                        value += "\\" + escaped;
+                    }
+                    break;
+                default:
+                    // Unknown escape, keep both characters
+                    value += "\\" + escaped;
+            }
+            pos++;
+        }
+        else {
+            value += char;
+            pos++;
+        }
+    }
+    // Unterminated string
+    return null;
+}
+/**
+ * Escape a string for use in a .strings file
+ */
+export function escapeStringsValue(value) {
+    return value
+        .replace(/\\/g, "\\\\")
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, "\\n")
+        .replace(/\r/g, "\\r")
+        .replace(/\t/g, "\\t");
+}
+/**
+ * Reconstruct a .strings file from parsed content
+ *
+ * @param entries Translation key-value pairs
+ * @param comments Comments to associate with keys
+ * @param headerComment Optional file-level header comment
+ * @returns Formatted .strings file content
+ */
+export function reconstructStringsContent(entries, comments, headerComment) {
+    const lines = [];
+    // Add header comment if present
+    if (headerComment) {
+        lines.push(`/* ${headerComment} */`);
+        lines.push("");
+    }
+    // Add each entry with its comment
+    for (const { key, value } of entries) {
+        const comment = comments.get(key);
+        if (comment) {
+            lines.push(`/* ${comment} */`);
+        }
+        lines.push(`"${escapeStringsValue(key)}" = "${escapeStringsValue(value)}";`);
+    }
+    // Ensure trailing newline
+    return lines.join("\n") + "\n";
+}
+/**
+ * Merge new translations into existing .strings content
+ *
+ * - Preserves existing translations not in newTranslations
+ * - Updates with new translations
+ * - Removes keys not in sourceKeys
+ * - Preserves comments from source
+ *
+ * @param existingContent Existing target file content (raw string)
+ * @param newTranslations New/updated translations from API
+ * @param sourceComments Comments from source file
+ * @param sourceKeys Set of all keys in source file
+ * @returns Merged .strings file content
+ */
+export function mergeStringsContent(existingContent, newTranslations, sourceComments, sourceKeys) {
+    // Parse existing content
+    const existing = parseStringsContent(existingContent);
+    const existingMap = new Map();
+    for (const { key, value } of existing.entries) {
+        existingMap.set(key, value);
+    }
+    // Create map of new translations
+    const newMap = new Map();
+    for (const { key, value } of newTranslations) {
+        newMap.set(key, value);
+    }
+    // Build merged entries - only include keys from source
+    const mergedEntries = [];
+    for (const key of sourceKeys) {
+        // Prefer new translation, then existing, skip if neither
+        const value = newMap.get(key) ?? existingMap.get(key);
+        if (value !== undefined) {
+            mergedEntries.push({ key, value });
+        }
+    }
+    // Use source comments, preserve existing header
+    return reconstructStringsContent(mergedEntries, sourceComments, existing.headerComment);
+}
+//# sourceMappingURL=strings-parser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strings-parser.js","sourceRoot":"","sources":["../../src/utils/strings-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,IAAI,aAAa,GAAkB,IAAI,CAAC;IAExC,yBAAyB;IACzB,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,cAAc,GAAkB,IAAI,CAAC;IACzC,IAAI,YAAY,GAAG,IAAI,CAAC;IAExB,OAAO,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5B,kBAAkB;QAClB,OAAO,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,EAAE,CAAC;QACR,CAAC;QAED,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM;QAEjC,oCAAoC;QACpC,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACzC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;YAClD,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;gBACtB,oCAAoC;gBACpC,MAAM;YACR,CAAC;YACD,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9D,cAAc,GAAG,WAAW,CAAC;YAC7B,GAAG,GAAG,UAAU,GAAG,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QAED,gCAAgC;QAChC,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC3C,MAAM,WAAW,GACf,OAAO,KAAK,CAAC,CAAC;gBACZ,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;gBAC/B,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7C,cAAc,GAAG,WAAW,CAAC;YAC7B,GAAG,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;YACpD,SAAS;QACX,CAAC;QAED,uBAAuB;QACvB,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAClD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,4BAA4B;gBAC5B,GAAG,EAAE,CAAC;gBACN,SAAS;YACX,CAAC;YAED,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC;YAC5B,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC;YAEpB,kBAAkB;YAClB,OAAO,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACvD,GAAG,EAAE,CAAC;YACR,CAAC;YAED,aAAa;YACb,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;gBACzB,sBAAsB;gBACtB,SAAS;YACX,CAAC;YACD,GAAG,EAAE,CAAC;YAEN,kBAAkB;YAClB,OAAO,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACvD,GAAG,EAAE,CAAC;YACR,CAAC;YAED,sBAAsB;YACtB,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;gBACzB,sBAAsB;gBACtB,SAAS;YACX,CAAC;YAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACpD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,kBAAkB;gBAClB,GAAG,EAAE,CAAC;gBACN,SAAS;YACX,CAAC;YAED,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;YAChC,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC;YAEtB,kBAAkB;YAClB,OAAO,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACvD,GAAG,EAAE,CAAC;YACR,CAAC;YAED,aAAa;YACb,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;gBACzB,GAAG,EAAE,CAAC;YACR,CAAC;YAED,cAAc;YACd,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;YAE7B,iBAAiB;YACjB,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;gBAC5B,IAAI,YAAY,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzC,qFAAqF;oBACrF,IACE,yCAAyC,CAAC,IAAI,CAAC,cAAc,CAAC,EAC9D,CAAC;wBACD,aAAa,GAAG,cAAc,CAAC;oBACjC,CAAC;yBAAM,CAAC;wBACN,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;oBACpC,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;gBACpC,CAAC;gBACD,cAAc,GAAG,IAAI,CAAC;YACxB,CAAC;YAED,YAAY,GAAG,KAAK,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,yBAAyB;YACzB,GAAG,EAAE,CAAC;QACR,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,IAAI,cAAc,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,aAAa,GAAG,cAAc,CAAC;IACjC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CACxB,OAAe,EACf,KAAa;IAEb,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAExC,IAAI,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC;IACpB,IAAI,KAAK,GAAG,EAAE,CAAC;IAEf,OAAO,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAE1B,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,gBAAgB;YAChB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;QACjC,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,kBAAkB;YAClB,GAAG,EAAE,CAAC;YACN,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM;gBAAE,MAAM;YAEjC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7B,QAAQ,OAAO,EAAE,CAAC;gBAChB,KAAK,GAAG;oBACN,KAAK,IAAI,IAAI,CAAC;oBACd,MAAM;gBACR,KAAK,GAAG;oBACN,KAAK,IAAI,IAAI,CAAC;oBACd,MAAM;gBACR,KAAK,GAAG;oBACN,KAAK,IAAI,IAAI,CAAC;oBACd,MAAM;gBACR,KAAK,GAAG;oBACN,KAAK,IAAI,GAAG,CAAC;oBACb,MAAM;gBACR,KAAK,IAAI;oBACP,KAAK,IAAI,IAAI,CAAC;oBACd,MAAM;gBACR,KAAK,GAAG,CAAC;gBACT,KAAK,GAAG;oBACN,mCAAmC;oBACnC,MAAM,SAAS,GAAG,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;oBACxD,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC/B,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;wBACpC,KAAK,IAAI,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;wBACzC,GAAG,IAAI,SAAS,CAAC;oBACnB,CAAC;yBAAM,CAAC;wBACN,8BAA8B;wBAC9B,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC;oBAC1B,CAAC;oBACD,MAAM;gBACR;oBACE,uCAAuC;oBACvC,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC;YAC5B,CAAC;YACD,GAAG,EAAE,CAAC;QACR,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,IAAI,CAAC;YACd,GAAG,EAAE,CAAC;QACR,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,KAAK;SACT,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAmB,EACnB,QAA6B,EAC7B,aAA4B;IAE5B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,gCAAgC;IAChC,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,MAAM,aAAa,KAAK,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,kCAAkC;IAClC,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,QAAQ,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/E,CAAC;IAED,0BAA0B;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CACjC,eAAuB,EACvB,eAA2B,EAC3B,cAAmC,EACnC,UAAuB;IAEvB,yBAAyB;IACzB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,eAAe,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC9C,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,iCAAiC;IACjC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,eAAe,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,uDAAuD;IACvD,MAAM,aAAa,GAAe,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,yDAAyD;QACzD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,OAAO,yBAAyB,CAC9B,aAAa,EACb,cAAc,EACd,QAAQ,CAAC,aAAa,CACvB,CAAC;AACJ,CAAC"}

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

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

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

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

package/dist/utils/strings-parser.test.js

@@ -0,0 +1,143 @@
+import { describe, it, expect } from "vitest";
+import { parseStringsContent, reconstructStringsContent, mergeStringsContent, escapeStringsValue, } from "./strings-parser.js";
+describe("Strings Parser", () => {
+    describe("parseStringsContent", () => {
+        it("should parse simple key-value pairs", () => {
+            const content = `"greeting" = "Hello";
+"farewell" = "Goodbye";`;
+            const result = parseStringsContent(content);
+            expect(result.entries).toEqual([
+                { key: "greeting", value: "Hello" },
+                { key: "farewell", value: "Goodbye" },
+            ]);
+        });
+        it("should handle escaped quotes", () => {
+            const content = `"message" = "He said \\"Hello\\"";`;
+            const result = parseStringsContent(content);
+            expect(result.entries).toEqual([
+                { key: "message", value: 'He said "Hello"' },
+            ]);
+        });
+        it("should handle escaped special characters", () => {
+            const content = `"message" = "Line1\\nLine2\\tTabbed";`;
+            const result = parseStringsContent(content);
+            expect(result.entries).toEqual([
+                { key: "message", value: "Line1\nLine2\tTabbed" },
+            ]);
+        });
+        it("should preserve comments above entries", () => {
+            const content = `/* User greeting */
+"greeting" = "Hello";
+/* User farewell */
+"farewell" = "Goodbye";`;
+            const result = parseStringsContent(content);
+            expect(result.entries).toHaveLength(2);
+            expect(result.comments.get("greeting")).toBe("User greeting");
+            expect(result.comments.get("farewell")).toBe("User farewell");
+        });
+        it("should handle empty file", () => {
+            const result = parseStringsContent("");
+            expect(result.entries).toEqual([]);
+            expect(result.comments.size).toBe(0);
+        });
+        it("should handle file-level header comment", () => {
+            const content = `/* Copyright 2024 Company */
+"greeting" = "Hello";`;
+            const result = parseStringsContent(content);
+            expect(result.headerComment).toBe("Copyright 2024 Company");
+            expect(result.entries).toHaveLength(1);
+        });
+        it("should handle line comments", () => {
+            const content = `// This is a greeting
+"greeting" = "Hello";`;
+            const result = parseStringsContent(content);
+            expect(result.comments.get("greeting")).toBe("This is a greeting");
+        });
+        it("should parse Unicode escape sequences", () => {
+            const content = `"char" = "caf\\U00E9";`;
+            const result = parseStringsContent(content);
+            expect(result.entries).toEqual([
+                { key: "char", value: "café" },
+            ]);
+        });
+    });
+    describe("escapeStringsValue", () => {
+        it("should escape quotes", () => {
+            expect(escapeStringsValue('Say "Hello"')).toBe('Say \\"Hello\\"');
+        });
+        it("should escape newlines and tabs", () => {
+            expect(escapeStringsValue("Line1\nLine2")).toBe("Line1\\nLine2");
+            expect(escapeStringsValue("Col1\tCol2")).toBe("Col1\\tCol2");
+        });
+        it("should escape backslashes", () => {
+            expect(escapeStringsValue("path\\to\\file")).toBe("path\\\\to\\\\file");
+        });
+    });
+    describe("reconstructStringsContent", () => {
+        it("should rebuild with proper formatting", () => {
+            const entries = [
+                { key: "greeting", value: "Hello" },
+                { key: "farewell", value: "Goodbye" },
+            ];
+            const comments = new Map();
+            const result = reconstructStringsContent(entries, comments, null);
+            expect(result).toBe('"greeting" = "Hello";\n"farewell" = "Goodbye";\n');
+        });
+        it("should preserve comments", () => {
+            const entries = [{ key: "greeting", value: "Hello" }];
+            const comments = new Map([["greeting", "User greeting"]]);
+            const result = reconstructStringsContent(entries, comments, null);
+            expect(result).toBe('/* User greeting */\n"greeting" = "Hello";\n');
+        });
+        it("should add header comment", () => {
+            const entries = [{ key: "key", value: "value" }];
+            const comments = new Map();
+            const result = reconstructStringsContent(entries, comments, "Header");
+            expect(result).toContain("/* Header */");
+        });
+        it("should escape special characters in output", () => {
+            const entries = [{ key: "msg", value: 'Say "Hi"\nOK' }];
+            const comments = new Map();
+            const result = reconstructStringsContent(entries, comments, null);
+            expect(result).toBe('"msg" = "Say \\"Hi\\"\\nOK";\n');
+        });
+    });
+    describe("mergeStringsContent", () => {
+        it("should merge new translations", () => {
+            const existing = '"greeting" = "Hallo";';
+            const newTranslations = [{ key: "farewell", value: "Auf Wiedersehen" }];
+            const sourceComments = new Map();
+            const sourceKeys = new Set(["greeting", "farewell"]);
+            const result = mergeStringsContent(existing, newTranslations, sourceComments, sourceKeys);
+            expect(result).toContain('"greeting" = "Hallo"');
+            expect(result).toContain('"farewell" = "Auf Wiedersehen"');
+        });
+        it("should preserve existing translations not updated", () => {
+            const existing = '"greeting" = "Hallo";\n"farewell" = "Tschüss";';
+            const newTranslations = [{ key: "greeting", value: "Guten Tag" }];
+            const sourceComments = new Map();
+            const sourceKeys = new Set(["greeting", "farewell"]);
+            const result = mergeStringsContent(existing, newTranslations, sourceComments, sourceKeys);
+            expect(result).toContain('"greeting" = "Guten Tag"');
+            expect(result).toContain('"farewell" = "Tschüss"');
+        });
+        it("should remove keys not in source", () => {
+            const existing = '"greeting" = "Hallo";\n"deleted" = "To be removed";';
+            const newTranslations = [];
+            const sourceComments = new Map();
+            const sourceKeys = new Set(["greeting"]);
+            const result = mergeStringsContent(existing, newTranslations, sourceComments, sourceKeys);
+            expect(result).toContain('"greeting" = "Hallo"');
+            expect(result).not.toContain("deleted");
+        });
+        it("should preserve comment associations from source", () => {
+            const existing = '"greeting" = "Hallo";';
+            const newTranslations = [];
+            const sourceComments = new Map([["greeting", "User greeting"]]);
+            const sourceKeys = new Set(["greeting"]);
+            const result = mergeStringsContent(existing, newTranslations, sourceComments, sourceKeys);
+            expect(result).toContain("/* User greeting */");
+        });
+    });
+});
+//# sourceMappingURL=strings-parser.test.js.map

package/dist/utils/strings-parser.test.js.map

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