@localheroai/cli 0.0.5 → 0.0.7

package/{src → dist}/utils/translation-updater/index.js

@@ -2,35 +2,47 @@ import path from 'path';
 import { fileExists, ensureDirectoryExists } from './common.js';
 import { updateYamlFile, deleteKeysFromYamlFile } from './yaml-handler.js';
 import { updateJsonFile, deleteKeysFromJsonFile } from './json-handler.js';
-
-export async function updateTranslationFile(filePath, translations, languageCode = 'en') {
+/**
+ * Updates a translation file with new translations
+ *
+ * @param filePath Path to the file to update
+ * @param translations Dictionary of translations to add/update
+ * @param languageCode The language code (default: 'en')
+ * @param sourceFilePath Optional path to source file (needed for new files)
+ * @returns Information about the update operation
+ */
+export async function updateTranslationFile(filePath, translations, languageCode = 'en', sourceFilePath = null) {
     const fileExt = path.extname(filePath).slice(1).toLowerCase();
     const result = {
         updatedKeys: Object.keys(translations),
         created: false
     };
-
     await ensureDirectoryExists(filePath);
-
     if (fileExt === 'json') {
-        const jsonResult = await updateJsonFile(filePath, translations, languageCode);
+        const jsonResult = await updateJsonFile(filePath, translations, languageCode, sourceFilePath);
         return {
             updatedKeys: result.updatedKeys,
             created: jsonResult.created
         };
     }
-
     return updateYamlFile(filePath, translations, languageCode);
 }
-
+/**
+ * Deletes keys from a translation file
+ *
+ * @param filePath Path to the file to update
+ * @param keysToDelete Array of dot-notation keys to delete
+ * @param languageCode The language code (default: 'en')
+ * @returns Array of keys that were successfully deleted
+ */
 export async function deleteKeysFromTranslationFile(filePath, keysToDelete, languageCode = 'en') {
     const exists = await fileExists(filePath);
     if (!exists) {
         return [];
     }
-
     const fileExt = path.extname(filePath).slice(1).toLowerCase();
     return fileExt === 'json'
         ? deleteKeysFromJsonFile(filePath, keysToDelete, languageCode)
         : deleteKeysFromYamlFile(filePath, keysToDelete, languageCode);
-}
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/translation-updater/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/translation-updater/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAU3E;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAgB,EAChB,YAAqC,EACrC,eAAuB,IAAI,EAC3B,iBAAgC,IAAI;IAEpC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9D,MAAM,MAAM,GAAiB;QAC3B,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;QACtC,OAAO,EAAE,KAAK;KACf,CAAC;IAEF,MAAM,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAEtC,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;QAC9F,OAAO;YACL,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,OAAO,EAAE,UAAU,CAAC,OAAO;SAC5B,CAAC;IACJ,CAAC;IAED,OAAO,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,QAAgB,EAChB,YAAsB,EACtB,eAAuB,IAAI;IAE3B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9D,OAAO,OAAO,KAAK,MAAM;QACvB,CAAC,CAAC,sBAAsB,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC;QAC9D,CAAC,CAAC,sBAAsB,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;AACnE,CAAC"}

package/dist/utils/translation-updater/json-handler.d.ts

@@ -0,0 +1,5 @@
+export function updateJsonFile(filePath: any, translations: any, languageCode: any, sourceFilePath?: null): Promise<{
+    updatedKeys: string[];
+    created: boolean;
+}>;
+export function deleteKeysFromJsonFile(filePath: any, keysToDelete: any, languageCode: any): Promise<any[]>;

package/dist/utils/translation-updater/json-handler.js

@@ -0,0 +1,123 @@
+import { promises as fs } from 'fs';
+import { detectJsonFormat, preserveJsonStructure } from '../files.js';
+import { ensureDirectoryExists } from './common.js';
+async function detectSourceFileStructure(sourceFilePath) {
+    try {
+        const content = await fs.readFile(sourceFilePath, 'utf8');
+        const sourceContent = JSON.parse(content);
+        const hasLanguageWrapper = Object.entries(sourceContent).some(([key, value]) => {
+            // Check if any top-level key is a language code with an object value
+            return typeof value === 'object' && value !== null && /^[a-zA-Z]{2}(-[a-zA-Z]{2})?$/.test(key);
+        });
+        return hasLanguageWrapper;
+    }
+    catch (error) {
+        throw new Error(`Failed to read source file ${sourceFilePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export async function updateJsonFile(filePath, translations, languageCode, sourceFilePath = null) {
+    try {
+        let existingContent = {};
+        let jsonFormat = 'nested';
+        let hasLanguageWrapper = false;
+        const result = {
+            updatedKeys: Object.keys(translations),
+            created: false
+        };
+        try {
+            const content = await fs.readFile(filePath, 'utf8');
+            existingContent = JSON.parse(content);
+            if (existingContent[languageCode] && typeof existingContent[languageCode] === 'object') {
+                hasLanguageWrapper = true;
+                jsonFormat = detectJsonFormat(existingContent[languageCode]);
+            }
+            else {
+                jsonFormat = detectJsonFormat(existingContent);
+            }
+        }
+        catch {
+            if (!sourceFilePath) {
+                throw new Error('Source file is required for creating new JSON translation files');
+            }
+            console.warn(`Creating new JSON file: ${filePath}`);
+            result.created = true;
+            await ensureDirectoryExists(filePath);
+            // Use source file structure
+            hasLanguageWrapper = await detectSourceFileStructure(sourceFilePath);
+        }
+        let updatedContent;
+        if (result.created) {
+            updatedContent = hasLanguageWrapper ?
+                { [languageCode]: preserveJsonStructure({}, translations, jsonFormat) } :
+                preserveJsonStructure({}, translations, jsonFormat);
+        }
+        else if (hasLanguageWrapper) {
+            existingContent[languageCode] = existingContent[languageCode] || {};
+            updatedContent = JSON.parse(JSON.stringify(existingContent));
+            const mergedContent = preserveJsonStructure(existingContent[languageCode], translations, jsonFormat);
+            updatedContent[languageCode] = mergedContent;
+        }
+        else {
+            const existingCopy = JSON.parse(JSON.stringify(existingContent));
+            updatedContent = preserveJsonStructure(existingCopy, translations, jsonFormat);
+        }
+        await fs.writeFile(filePath, JSON.stringify(updatedContent, null, 2));
+        return result;
+    }
+    catch (error) {
+        throw new Error(`Failed to update JSON file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export async function deleteKeysFromJsonFile(filePath, keysToDelete, languageCode) {
+    try {
+        const content = await fs.readFile(filePath, 'utf8');
+        let jsonContent = JSON.parse(content);
+        let hasLanguageWrapper = false;
+        let rootContent = jsonContent;
+        if (jsonContent[languageCode] && typeof jsonContent[languageCode] === 'object') {
+            hasLanguageWrapper = true;
+            rootContent = jsonContent[languageCode];
+        }
+        const deletedKeys = [];
+        for (const keyPath of keysToDelete) {
+            const keys = keyPath.split('.');
+            const lastIndex = keys.length - 1;
+            let current = rootContent;
+            let parent = null;
+            let keyInParent = '';
+            let found = true;
+            for (let i = 0; i < lastIndex; i++) {
+                const key = keys[i];
+                if (!current[key] || typeof current[key] !== 'object') {
+                    found = false;
+                    break;
+                }
+                parent = current;
+                keyInParent = key;
+                current = current[key];
+            }
+            if (found) {
+                const lastKey = keys[lastIndex];
+                if (current[lastKey] !== undefined) {
+                    delete current[lastKey];
+                    deletedKeys.push(keyPath);
+                    if (parent && Object.keys(current).length === 0) {
+                        delete parent[keyInParent];
+                    }
+                }
+            }
+        }
+        if (hasLanguageWrapper) {
+            jsonContent[languageCode] = rootContent;
+        }
+        else {
+            jsonContent = rootContent;
+        }
+        await fs.writeFile(filePath, JSON.stringify(jsonContent, null, 2));
+        return deletedKeys;
+    }
+    catch (error) {
+        throw new Error(`Failed to delete keys from JSON file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=json-handler.js.map

package/dist/utils/translation-updater/json-handler.js.map

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

package/dist/utils/translation-updater/yaml-handler.d.ts

@@ -0,0 +1,5 @@
+export function updateYamlFile(filePath: any, translations: any, languageCode: any): Promise<{
+    updatedKeys: string[];
+    created: boolean;
+}>;
+export function deleteKeysFromYamlFile(filePath: any, keysToDelete: any, languageCode: any): Promise<any[]>;

package/dist/utils/translation-updater/yaml-handler.js

@@ -0,0 +1,193 @@
+import { promises as fs } from 'fs';
+import yaml from 'yaml';
+import { SPECIAL_CHARS_REGEX, INTERPOLATION, fileExists, tryParseJsonArray } from './common.js';
+const NEEDS_QUOTES_REGEX = /[:,%{}[\]|><!&*?-]/;
+const LINE_WIDTH = 80;
+function detectYamlOptions(content) {
+    const lines = content
+        .split('\n')
+        .filter(line => line.trim())
+        .slice(0, 10);
+    const options = {
+        indent: 2,
+        indentSeq: true
+    };
+    const indentMatch = lines.find(line => /^\s+\S/.test(line))?.match(/^(\s+)\S/);
+    if (indentMatch) {
+        options.indent = indentMatch[1].length;
+        if (indentMatch[1].includes('\t')) {
+            options.indent = 2;
+        }
+    }
+    const seqMatch = lines.find(line => /^\s*-\s+\S/.test(line));
+    if (seqMatch) {
+        options.indentSeq = /^\s+-\s+/.test(seqMatch);
+    }
+    return options;
+}
+function needsQuotes(str) {
+    if (typeof str !== 'string')
+        return false;
+    return (SPECIAL_CHARS_REGEX.test(str) ||
+        str.includes(INTERPOLATION) ||
+        NEEDS_QUOTES_REGEX.test(str) ||
+        (str.includes(' ') && /[:"']/g.test(str)));
+}
+function shouldForceQuotes(str) {
+    if (typeof str !== 'string')
+        return false;
+    // Special case: strings containing quotes but no interpolation
+    // don't need outer quotes
+    if (str.includes('"') && !str.includes(INTERPOLATION)) {
+        return false;
+    }
+    return needsQuotes(str);
+}
+function processArrayItems(array, yamlDoc) {
+    return array.map(item => {
+        const itemNode = yamlDoc.createNode(item);
+        if (shouldForceQuotes(item)) {
+            itemNode.type = 'QUOTE_DOUBLE';
+        }
+        return itemNode;
+    });
+}
+async function createYamlDocument(filePath) {
+    const exists = await fileExists(filePath);
+    if (!exists) {
+        console.warn(`Creating new file: ${filePath}`);
+        const doc = new yaml.Document();
+        doc.contents = doc.createNode({});
+        return { doc, created: true, options: { indent: 2, indentSeq: true, lineWidth: LINE_WIDTH } };
+    }
+    const content = await fs.readFile(filePath, 'utf8');
+    const options = detectYamlOptions(content);
+    const doc = yaml.parseDocument(content);
+    // @ts-ignore - lineWidth exists on options
+    doc.options.lineWidth = LINE_WIDTH;
+    return {
+        doc,
+        created: false,
+        options
+    };
+}
+async function updateYamlTranslations(yamlDoc, translations, languageCode) {
+    if (!yamlDoc.contents) {
+        yamlDoc.contents = yamlDoc.createNode({});
+    }
+    const rootNode = yamlDoc.contents;
+    if (!yaml.isMap(rootNode)) {
+        throw new Error('Invalid YAML structure: root node must be a mapping');
+    }
+    let langNode = rootNode.get(languageCode);
+    if (!langNode || !yaml.isMap(langNode)) {
+        langNode = yamlDoc.createNode({});
+        rootNode.set(languageCode, langNode);
+    }
+    for (const [keyPath, newValue] of Object.entries(translations)) {
+        const keys = keyPath.split('.');
+        let current = langNode;
+        for (let i = 0; i < keys.length - 1; i++) {
+            const key = keys[i];
+            if (!current.has(key)) {
+                current.set(key, yamlDoc.createNode({}));
+            }
+            const nextNode = current.get(key);
+            if (!yaml.isMap(nextNode)) {
+                // If the existing node is not a mapping, replace it with an empty mapping
+                const newNode = yamlDoc.createNode({});
+                current.set(key, newNode);
+                current = newNode;
+            }
+            else {
+                current = nextNode;
+            }
+        }
+        const lastKey = keys[keys.length - 1];
+        if (Array.isArray(newValue)) {
+            const arrayNode = new yaml.YAMLSeq();
+            processArrayItems(newValue, yamlDoc).forEach(item => arrayNode.add(item));
+            current.set(lastKey, arrayNode);
+            continue;
+        }
+        const array = tryParseJsonArray(newValue);
+        if (array) {
+            const arrayNode = new yaml.YAMLSeq();
+            processArrayItems(array, yamlDoc).forEach(item => arrayNode.add(item));
+            current.set(lastKey, arrayNode);
+            continue;
+        }
+        if (typeof newValue === 'string' && newValue.includes('\n')) {
+            const scalar = new yaml.Scalar(newValue);
+            scalar.type = 'BLOCK_LITERAL';
+            current.set(lastKey, scalar);
+            continue;
+        }
+        const node = yamlDoc.createNode(newValue);
+        if (needsQuotes(newValue)) {
+            node.type = 'QUOTE_DOUBLE';
+        }
+        current.set(lastKey, node);
+    }
+}
+export async function updateYamlFile(filePath, translations, languageCode) {
+    const { doc: yamlDoc, created, options } = await createYamlDocument(filePath);
+    await updateYamlTranslations(yamlDoc, translations, languageCode);
+    // @ts-ignore - yaml options exist at runtime
+    yamlDoc.options.indent = options.indent;
+    // @ts-ignore - yaml options exist at runtime
+    yamlDoc.options.indentSeq = options.indentSeq;
+    // @ts-ignore - yaml options exist at runtime
+    yamlDoc.options.lineWidth = LINE_WIDTH;
+    await fs.writeFile(filePath, yamlDoc.toString());
+    return {
+        updatedKeys: Object.keys(translations),
+        created
+    };
+}
+export async function deleteKeysFromYamlFile(filePath, keysToDelete, languageCode) {
+    try {
+        const content = await fs.readFile(filePath, 'utf8');
+        const yamlDoc = yaml.parseDocument(content);
+        const contents = yamlDoc.contents;
+        if (!contents || !contents.has(languageCode)) {
+            return [];
+        }
+        const langNode = contents.get(languageCode);
+        const deletedKeys = [];
+        for (const keyPath of keysToDelete) {
+            const keys = keyPath.split('.');
+            const lastIndex = keys.length - 1;
+            let current = langNode;
+            let parent = null;
+            let keyInParent = '';
+            let found = true;
+            for (let i = 0; i < lastIndex; i++) {
+                const key = keys[i];
+                if (!current.has(key)) {
+                    found = false;
+                    break;
+                }
+                parent = current;
+                keyInParent = key;
+                current = current.get(key);
+            }
+            if (found) {
+                const lastKey = keys[lastIndex];
+                if (current.has(lastKey)) {
+                    current.delete(lastKey);
+                    deletedKeys.push(keyPath);
+                    if (parent && current.items.length === 0) {
+                        parent.delete(keyInParent);
+                    }
+                }
+            }
+        }
+        await fs.writeFile(filePath, yamlDoc.toString());
+        return deletedKeys;
+    }
+    catch (error) {
+        throw new Error(`Failed to delete keys from YAML file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=yaml-handler.js.map

package/dist/utils/translation-updater/yaml-handler.js.map

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

package/dist/utils/translation-utils.d.ts

@@ -0,0 +1,30 @@
+export function findMissingTranslations(sourceKeys: any, targetKeys: any): {
+    missingKeys: {};
+    skippedKeys: {};
+};
+export function batchKeysWithMissing(sourceFiles: any, missingByLocale: any, batchSize?: number): {
+    batches: {
+        sourceFilePath: string;
+        sourceFile: {
+            path: any;
+            format: any;
+            content: string;
+        };
+        localeEntries: any;
+        locales: any[];
+    }[];
+    errors: {
+        type: string;
+        message: string;
+        path: string;
+    }[];
+};
+export function findTargetFile(targetFiles: any, targetLocale: any, sourceFile: any, sourceLocale: any): any;
+export function generateTargetPath(sourceFile: any, targetLocale: any, sourceLocale: any): string;
+export function processTargetContent(targetContent: any, targetLocale: any): {};
+export function processLocaleTranslations(sourceKeys: any, targetLocale: any, targetFiles: any, sourceFile: any, sourceLocale: any): {
+    targetPath: string;
+    missingKeys: {};
+    skippedKeys: {};
+    targetFile: any;
+};