@el-j/google-sheet-translations 1.0.0

package/dist/utils/dataConverter/convertFromDataJsonFormat.d.ts

@@ -0,0 +1,8 @@
+import type { TranslationData } from "../../types";
+/**
+ * Converts languageData.json format back to the translation object structure
+ * @param dataJson - Data in the languageData.json format
+ * @returns Converted data in the TranslationData format
+ */
+export declare function convertFromDataJsonFormat(dataJson: Record<string, unknown>[]): TranslationData;
+//# sourceMappingURL=convertFromDataJsonFormat.d.ts.map

package/dist/utils/dataConverter/convertFromDataJsonFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertFromDataJsonFormat.d.ts","sourceRoot":"","sources":["../../../src/utils/dataConverter/convertFromDataJsonFormat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,aAAa,CAAC;AAYrE;;;;GAIG;AACH,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACjC,eAAe,CAqCjB"}

package/dist/utils/dataConverter/convertFromDataJsonFormat.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertFromDataJsonFormat = convertFromDataJsonFormat;
+/**
+ * Type-guard: checks that a value has the shape of sheet data
+ * (an object mapping locale → translation record)
+ */
+function isSheetData(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+/**
+ * Converts languageData.json format back to the translation object structure
+ * @param dataJson - Data in the languageData.json format
+ * @returns Converted data in the TranslationData format
+ */
+function convertFromDataJsonFormat(dataJson) {
+    const result = {};
+    for (const projectData of dataJson) {
+        for (const sheetTitle of Object.keys(projectData)) {
+            const raw = projectData[sheetTitle];
+            if (!isSheetData(raw)) {
+                console.warn(`Skipping malformed entry for sheet "${sheetTitle}"`);
+                continue;
+            }
+            for (const locale of Object.keys(raw)) {
+                // Initialize locale if it doesn't exist
+                if (!result[locale]) {
+                    result[locale] = {};
+                }
+                // Initialize sheet if it doesn't exist
+                if (!result[locale][sheetTitle]) {
+                    result[locale][sheetTitle] = {};
+                }
+                const localeData = raw[locale];
+                if (typeof localeData !== 'object' || localeData === null) {
+                    continue;
+                }
+                // Add all translations
+                for (const key of Object.keys(localeData)) {
+                    result[locale][sheetTitle][key] = localeData[key];
+                }
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=convertFromDataJsonFormat.js.map

package/dist/utils/dataConverter/convertFromDataJsonFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertFromDataJsonFormat.js","sourceRoot":"","sources":["../../../src/utils/dataConverter/convertFromDataJsonFormat.ts"],"names":[],"mappings":";;AAiBA,8DAuCC;AAtDD;;;GAGG;AACH,SAAS,WAAW,CACnB,CAAU;IAEV,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,SAAgB,yBAAyB,CACxC,QAAmC;IAEnC,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,WAAW,IAAI,QAAQ,EAAE,CAAC;QACpC,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACnD,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;YAEpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,uCAAuC,UAAU,GAAG,CAAC,CAAC;gBACnE,SAAS;YACV,CAAC;YAED,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvC,wCAAwC;gBACxC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;gBACrB,CAAC;gBAED,uCAAuC;gBACvC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;oBACjC,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;gBACjC,CAAC;gBAED,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC/B,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;oBAC3D,SAAS;gBACV,CAAC;gBAED,uBAAuB;gBACvB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;gBACnD,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/utils/dataConverter/convertToDataJsonFormat.d.ts

@@ -0,0 +1,10 @@
+import type { TranslationData } from "../../types";
+/**
+ * Converts the translation object to the expected languageData.json format
+ * @param translationObj - The translation object with locale->sheet->key->value structure
+ * @param locales - Array of locale identifiers
+ * @returns Converted data in the format expected for languageData.json
+ */
+export declare function convertToDataJsonFormat(translationObj: TranslationData, locales: string[]): Record<string, unknown>[];
+export default convertToDataJsonFormat;
+//# sourceMappingURL=convertToDataJsonFormat.d.ts.map

package/dist/utils/dataConverter/convertToDataJsonFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertToDataJsonFormat.d.ts","sourceRoot":"","sources":["../../../src/utils/dataConverter/convertToDataJsonFormat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,aAAa,CAAC;AAErE;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACtC,cAAc,EAAE,eAAe,EAC/B,OAAO,EAAE,MAAM,EAAE,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAuD3B;AAED,eAAe,uBAAuB,CAAC"}

package/dist/utils/dataConverter/convertToDataJsonFormat.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertToDataJsonFormat = convertToDataJsonFormat;
+/**
+ * Converts the translation object to the expected languageData.json format
+ * @param translationObj - The translation object with locale->sheet->key->value structure
+ * @param locales - Array of locale identifiers
+ * @returns Converted data in the format expected for languageData.json
+ */
+function convertToDataJsonFormat(translationObj, locales) {
+    const result = [];
+    console.log("Converting translation object to languageData.json format...");
+    // Get all sheet names from all locales to make sure we don't miss any
+    const allSheets = new Set();
+    for (const locale of Object.keys(translationObj)) {
+        if (translationObj[locale]) {
+            for (const sheet of Object.keys(translationObj[locale])) {
+                allSheets.add(sheet);
+            }
+        }
+    }
+    console.log(`Found ${allSheets.size} sheets across all locales`);
+    // Process each sheet
+    for (const sheetTitle of allSheets) {
+        // Create a new project object with the sheet title as the main key
+        const projectData = {};
+        projectData[sheetTitle] = {};
+        // For each locale, add all key-value pairs
+        for (const locale of locales) {
+            if (translationObj?.[locale]?.[sheetTitle]) { // Use original locale case for lookup
+                // Create the locale object
+                projectData[sheetTitle][locale] = {};
+                // Add all translations for this locale
+                const translations = translationObj[locale][sheetTitle];
+                for (const key of Object.keys(translations)) {
+                    projectData[sheetTitle][locale][key] = translations[key];
+                }
+                // Log how many translations we found for debugging
+                console.log(`Found ${Object.keys(translations).length} keys for locale ${locale} in sheet ${sheetTitle}`);
+            }
+        }
+        // Only add non-empty projects
+        if (Object.keys(projectData[sheetTitle]).length > 0) {
+            result.push(projectData);
+        }
+    }
+    console.log(`Created ${result.length} sheet entries for languageData.json`);
+    return result;
+}
+exports.default = convertToDataJsonFormat;
+//# sourceMappingURL=convertToDataJsonFormat.js.map

package/dist/utils/dataConverter/convertToDataJsonFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertToDataJsonFormat.js","sourceRoot":"","sources":["../../../src/utils/dataConverter/convertToDataJsonFormat.ts"],"names":[],"mappings":";;AAQA,0DA0DC;AAhED;;;;;GAKG;AACH,SAAgB,uBAAuB,CACtC,cAA+B,EAC/B,OAAiB;IAEjB,MAAM,MAAM,GAA8B,EAAE,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;IAE5E,sEAAsE;IACtE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QAClD,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBACzD,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,SAAS,SAAS,CAAC,IAAI,4BAA4B,CAAC,CAAC;IAEjE,qBAAqB;IACrB,KAAK,MAAM,UAAU,IAAI,SAAS,EAAE,CAAC;QACpC,mEAAmE;QACnE,MAAM,WAAW,GAGb,EAAE,CAAC;QACP,WAAW,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;QAE7B,2CAA2C;QAC3C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC9B,IAAI,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,sCAAsC;gBAEnF,2BAA2B;gBAC3B,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;gBAErC,uCAAuC;gBACvC,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;gBACxD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC7C,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;gBAC1D,CAAC;gBAED,mDAAmD;gBACnD,OAAO,CAAC,GAAG,CACV,SACC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAC3B,oBAAoB,MAAM,aAAa,UAAU,EAAE,CACnD,CAAC;YACH,CAAC;QACF,CAAC;QAED,8BAA8B;QAC9B,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1B,CAAC;IACF,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,MAAM,sCAAsC,CAAC,CAAC;IAC5E,OAAO,MAAM,CAAC;AACf,CAAC;AAED,kBAAe,uBAAuB,CAAC"}

package/dist/utils/dataConverter/findLocalChanges.d.ts

@@ -0,0 +1,9 @@
+import type { TranslationData } from "../../types";
+/**
+ * Compares local languageData.json with spreadsheet data to find new keys
+ * @param localData - Data from local languageData.json file
+ * @param spreadsheetData - Data fetched from the spreadsheet
+ * @returns Object with new keys that are in localData but not in spreadsheetData
+ */
+export declare function findLocalChanges(localData: TranslationData, spreadsheetData: TranslationData): TranslationData;
+//# sourceMappingURL=findLocalChanges.d.ts.map

package/dist/utils/dataConverter/findLocalChanges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findLocalChanges.d.ts","sourceRoot":"","sources":["../../../src/utils/dataConverter/findLocalChanges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;GAKG;AAEH,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,eAAe,EAC1B,eAAe,EAAE,eAAe,GAC9B,eAAe,CA6BjB"}

package/dist/utils/dataConverter/findLocalChanges.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findLocalChanges = findLocalChanges;
+/**
+ * Compares local languageData.json with spreadsheet data to find new keys
+ * @param localData - Data from local languageData.json file
+ * @param spreadsheetData - Data fetched from the spreadsheet
+ * @returns Object with new keys that are in localData but not in spreadsheetData
+ */
+function findLocalChanges(localData, spreadsheetData) {
+    const changes = {};
+    // Check each locale in local data
+    for (const locale of Object.keys(localData)) {
+        if (!localData[locale])
+            continue;
+        // Check each sheet in local data
+        for (const sheet of Object.keys(localData[locale])) {
+            if (!localData[locale][sheet])
+                continue;
+            // Check each key in local data
+            for (const key of Object.keys(localData[locale][sheet])) {
+                // If the spreadsheet doesn't have this locale, sheet, or key, it's a new key
+                const isNewKey = !spreadsheetData[locale] ||
+                    !spreadsheetData[locale][sheet] ||
+                    !spreadsheetData[locale][sheet][key];
+                // If it's a new key, add it to changes
+                if (isNewKey) {
+                    if (!changes[locale])
+                        changes[locale] = {};
+                    if (!changes[locale][sheet])
+                        changes[locale][sheet] = {};
+                    changes[locale][sheet][key] = localData[locale][sheet][key];
+                }
+            }
+        }
+    }
+    return changes;
+}
+//# sourceMappingURL=findLocalChanges.js.map

package/dist/utils/dataConverter/findLocalChanges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findLocalChanges.js","sourceRoot":"","sources":["../../../src/utils/dataConverter/findLocalChanges.ts"],"names":[],"mappings":";;AASA,4CAgCC;AAvCD;;;;;GAKG;AAEH,SAAgB,gBAAgB,CAC/B,SAA0B,EAC1B,eAAgC;IAEhC,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,kCAAkC;IAClC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YAAE,SAAS;QAEjC,iCAAiC;QACjC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC;gBAAE,SAAS;YAExC,+BAA+B;YAC/B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACzD,6EAA6E;gBAC7E,MAAM,QAAQ,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC;oBACxC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC;oBAC/B,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;gBAEtC,uCAAuC;gBACvC,IAAI,QAAQ,EAAE,CAAC;oBACd,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;wBAAE,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;oBAC3C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC;wBAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;oBACzD,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;gBAC7D,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC"}

package/dist/utils/fileWriter.d.ts

@@ -0,0 +1,23 @@
+import type { TranslationData } from "../types";
+/**
+ * Writes locale files to the translations directory
+ * @param translations Translation data organized by locale
+ * @param locales Array of locale identifiers
+ * @param translationsOutputDir Directory to write translation files to
+ */
+export declare function writeTranslationFiles(translations: TranslationData, locales: string[], translationsOutputDir: string): void;
+/**
+ * Writes the locales.ts file containing the array of available locales and header mapping
+ * @param locales Array of normalized locale identifiers (filtered to only include valid locales)
+ * @param localeMapping Mapping from normalized locales to original spreadsheet headers
+ * @param localesOutputPath Path to write the locales.ts file
+ */
+export declare function writeLocalesFile(locales: string[], localeMapping: Record<string, string>, localesOutputPath: string): void;
+/**
+ * Writes the languageData.json file containing all translation data
+ * @param translations Translation data organized by locale
+ * @param locales Array of locale identifiers
+ * @param dataJsonPath Path to write the languageData.json file
+ */
+export declare function writeLanguageDataFile(translations: TranslationData, locales: string[], dataJsonPath: string): void;
+//# sourceMappingURL=fileWriter.d.ts.map

package/dist/utils/fileWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileWriter.d.ts","sourceRoot":"","sources":["../../src/utils/fileWriter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGhD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACpC,YAAY,EAAE,eAAe,EAC7B,OAAO,EAAE,MAAM,EAAE,EACjB,qBAAqB,EAAE,MAAM,GAC3B,IAAI,CAqCN;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EAAE,EACjB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACrC,iBAAiB,EAAE,MAAM,GACvB,IAAI,CAqCN;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACpC,YAAY,EAAE,eAAe,EAC7B,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,MAAM,GAClB,IAAI,CAwBN"}

package/dist/utils/fileWriter.js

@@ -0,0 +1,119 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeTranslationFiles = writeTranslationFiles;
+exports.writeLocalesFile = writeLocalesFile;
+exports.writeLanguageDataFile = writeLanguageDataFile;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const convertToDataJsonFormat_1 = require("./dataConverter/convertToDataJsonFormat");
+/**
+ * Writes locale files to the translations directory
+ * @param translations Translation data organized by locale
+ * @param locales Array of locale identifiers
+ * @param translationsOutputDir Directory to write translation files to
+ */
+function writeTranslationFiles(translations, locales, translationsOutputDir) {
+    // Make sure the translations directory exists
+    if (!node_fs_1.default.existsSync(translationsOutputDir)) {
+        try {
+            node_fs_1.default.mkdirSync(translationsOutputDir, { recursive: true });
+        }
+        catch (err) {
+            throw new Error(`Failed to create translations directory "${translationsOutputDir}"`, { cause: err });
+        }
+    }
+    // Write files for all locales
+    for (const locale of locales) {
+        if (!translations[locale] || Object.keys(translations[locale]).length === 0) {
+            console.warn(`No translations found for locale "${locale}"`);
+            continue;
+        }
+        // Sanitize locale to prevent path traversal attacks
+        const safeName = locale.toLowerCase().replace(/[^a-z0-9_-]/g, '_');
+        if (safeName !== locale.toLowerCase()) {
+            console.warn(`Locale "${locale}" contained unsafe characters; sanitised to "${safeName}"`);
+        }
+        try {
+            node_fs_1.default.writeFileSync(node_path_1.default.join(translationsOutputDir, `${safeName}.json`), JSON.stringify(translations[locale], null, 2), "utf8");
+            console.log(`Successfully wrote translations for ${locale}`);
+        }
+        catch (err) {
+            console.error(`Failed to write translation file for locale "${locale}" at "${node_path_1.default.join(translationsOutputDir, `${safeName}.json`)}":`, err);
+        }
+    }
+}
+/**
+ * Writes the locales.ts file containing the array of available locales and header mapping
+ * @param locales Array of normalized locale identifiers (filtered to only include valid locales)
+ * @param localeMapping Mapping from normalized locales to original spreadsheet headers
+ * @param localesOutputPath Path to write the locales.ts file
+ */
+function writeLocalesFile(locales, localeMapping, localesOutputPath) {
+    // Create locales.ts file directory if it doesn't exist
+    const localesOutputDir = node_path_1.default.dirname(localesOutputPath);
+    if (!node_fs_1.default.existsSync(localesOutputDir)) {
+        try {
+            node_fs_1.default.mkdirSync(localesOutputDir, { recursive: true });
+        }
+        catch (err) {
+            throw new Error(`Failed to create directory "${localesOutputDir}"`, { cause: err });
+        }
+    }
+    const validLocales = locales.filter(locale => locale && locale.trim().length > 0);
+    // Create the content with both locales and header mapping
+    const content = `/**
+ * This file is auto-generated from the Google Spreadsheet package.
+ * It contains the list of available locales and their mappings to original spreadsheet headers.
+ * Do not edit this file manually, it will be overwritten by the package.
+ */
+
+ export const locales = ${JSON.stringify(validLocales)};
+
+/**
+ * Mapping from normalized locale codes to original spreadsheet headers
+ * Used for syncing changes back to the spreadsheet
+ */
+export const localeHeaderMapping = ${JSON.stringify(localeMapping, null, 2)};
+
+export default locales;
+`;
+    try {
+        node_fs_1.default.writeFileSync(localesOutputPath, content, "utf8");
+    }
+    catch (err) {
+        throw new Error(`Failed to write locales file at "${localesOutputPath}"`, { cause: err });
+    }
+    console.log(`Successfully wrote locales file with ${validLocales.length} locales:`, validLocales);
+    console.log('Header mapping includes:', Object.keys(localeMapping).length, 'mappings');
+}
+/**
+ * Writes the languageData.json file containing all translation data
+ * @param translations Translation data organized by locale
+ * @param locales Array of locale identifiers
+ * @param dataJsonPath Path to write the languageData.json file
+ */
+function writeLanguageDataFile(translations, locales, dataJsonPath) {
+    // Create languageData.json directory if it doesn't exist
+    const dataJsonDir = node_path_1.default.dirname(dataJsonPath);
+    if (!node_fs_1.default.existsSync(dataJsonDir)) {
+        try {
+            node_fs_1.default.mkdirSync(dataJsonDir, { recursive: true });
+        }
+        catch (err) {
+            throw new Error(`Failed to create directory "${dataJsonDir}"`, { cause: err });
+        }
+    }
+    // Convert the object format to the array format expected in languageData.json
+    const dataJsonContent = (0, convertToDataJsonFormat_1.convertToDataJsonFormat)(translations, locales);
+    try {
+        node_fs_1.default.writeFileSync(dataJsonPath, JSON.stringify(dataJsonContent, null, 2), "utf8");
+    }
+    catch (err) {
+        throw new Error(`Failed to write language data file at "${dataJsonPath}"`, { cause: err });
+    }
+    console.log("Successfully updated languageData.json with fresh spreadsheet data");
+}
+//# sourceMappingURL=fileWriter.js.map

package/dist/utils/fileWriter.js.map

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

package/dist/utils/getFileLastModified.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Gets the last modified time of a file
+ * @param filePath - Path to the file
+ * @returns The last modified time as a Date object, or null if file doesn't exist
+ */
+export declare function getFileLastModified(filePath: string): Date | null;
+//# sourceMappingURL=getFileLastModified.d.ts.map

package/dist/utils/getFileLastModified.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFileLastModified.d.ts","sourceRoot":"","sources":["../../src/utils/getFileLastModified.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAQjE"}

package/dist/utils/getFileLastModified.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFileLastModified = getFileLastModified;
+const node_fs_1 = __importDefault(require("node:fs"));
+/**
+ * Gets the last modified time of a file
+ * @param filePath - Path to the file
+ * @returns The last modified time as a Date object, or null if file doesn't exist
+ */
+function getFileLastModified(filePath) {
+    try {
+        const stats = node_fs_1.default.statSync(filePath);
+        return stats.mtime;
+    }
+    catch (error) {
+        console.warn(`Could not read file stats for "${filePath}":`, error);
+        return null;
+    }
+}
+//# sourceMappingURL=getFileLastModified.js.map

package/dist/utils/getFileLastModified.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFileLastModified.js","sourceRoot":"","sources":["../../src/utils/getFileLastModified.ts"],"names":[],"mappings":";;;;;AAOA,kDAQC;AAfD,sDAAyB;AAEzB;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,QAAgB;IACnD,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,iBAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,KAAK,CAAC,KAAK,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,kCAAkC,QAAQ,IAAI,EAAE,KAAK,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC"}

package/dist/utils/isDataJsonNewer.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Checks if languageData.json has been modified more recently than the translation files
+ * @param dataJsonPath - Path to languageData.json
+ * @param translationsOutputDir - Directory containing translation files
+ * @returns True if languageData.json is newer than the translation files
+ */
+export declare function isDataJsonNewer(dataJsonPath: string, translationsOutputDir: string): boolean;
+//# sourceMappingURL=isDataJsonNewer.d.ts.map

package/dist/utils/isDataJsonNewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isDataJsonNewer.d.ts","sourceRoot":"","sources":["../../src/utils/isDataJsonNewer.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,GAAG,OAAO,CA2B5F"}

package/dist/utils/isDataJsonNewer.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDataJsonNewer = isDataJsonNewer;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const getFileLastModified_1 = require("./getFileLastModified");
+/**
+ * Checks if languageData.json has been modified more recently than the translation files
+ * @param dataJsonPath - Path to languageData.json
+ * @param translationsOutputDir - Directory containing translation files
+ * @returns True if languageData.json is newer than the translation files
+ */
+function isDataJsonNewer(dataJsonPath, translationsOutputDir) {
+    const dataJsonMtime = (0, getFileLastModified_1.getFileLastModified)(dataJsonPath);
+    if (!dataJsonMtime)
+        return false;
+    // Get the most recent translation file modification time
+    try {
+        const files = node_fs_1.default.readdirSync(translationsOutputDir)
+            .filter(file => file.endsWith('.json'))
+            .map(file => node_path_1.default.join(translationsOutputDir, file));
+        if (files.length === 0)
+            return true;
+        const mostRecentTranslationMtime = files
+            .map(file => (0, getFileLastModified_1.getFileLastModified)(file))
+            .filter((d) => d !== null)
+            .reduce((max, d) => (max === null || d > max ? d : max), null);
+        if (!mostRecentTranslationMtime)
+            return true;
+        return dataJsonMtime > mostRecentTranslationMtime;
+    }
+    catch (error) {
+        console.warn("Error comparing file modification times:", error);
+        return false;
+    }
+}
+//# sourceMappingURL=isDataJsonNewer.js.map

package/dist/utils/isDataJsonNewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isDataJsonNewer.js","sourceRoot":"","sources":["../../src/utils/isDataJsonNewer.ts"],"names":[],"mappings":";;;;;AAUA,0CA2BC;AArCD,sDAAyB;AACzB,0DAA6B;AAC7B,+DAA4D;AAE5D;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,YAAoB,EAAE,qBAA6B;IAClF,MAAM,aAAa,GAAG,IAAA,yCAAmB,EAAC,YAAY,CAAC,CAAC;IAExD,IAAI,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IAEjC,yDAAyD;IACzD,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,iBAAE,CAAC,WAAW,CAAC,qBAAqB,CAAC;aACjD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;aACtC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,mBAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC,CAAC;QAEtD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEpC,MAAM,0BAA0B,GAAG,KAAK;aACtC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAA,yCAAmB,EAAC,IAAI,CAAC,CAAC;aACtC,MAAM,CAAC,CAAC,CAAC,EAAa,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;aACpC,MAAM,CACN,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAC/C,IAAI,CACJ,CAAC;QAEH,IAAI,CAAC,0BAA0B;YAAE,OAAO,IAAI,CAAC;QAC7C,OAAO,aAAa,GAAG,0BAA0B,CAAC;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;QAChE,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC"}

package/dist/utils/localeFilter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Locale validation utilities
+ */
+/**
+ * Determines if a string represents a valid locale identifier
+ * @param value The string to test
+ * @returns true if the string appears to be a locale identifier
+ */
+export declare function isValidLocale(value: string): boolean;
+/**
+ * Filters header row to only include valid locale columns, excluding the key column
+ * @param headerRow Array of column names from the sheet header
+ * @param keyColumn The name of the key column to exclude
+ * @returns Array of valid locale identifiers
+ */
+export declare function filterValidLocales(headerRow: string[], keyColumn: string): string[];
+//# sourceMappingURL=localeFilter.d.ts.map

package/dist/utils/localeFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localeFilter.d.ts","sourceRoot":"","sources":["../../src/utils/localeFilter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAcpD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAKnF"}

package/dist/utils/localeFilter.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Locale validation utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidLocale = isValidLocale;
+exports.filterValidLocales = filterValidLocales;
+const COMMON_LOCALE_PATTERNS = [
+    /^[a-z]{2}$/, // en, de, fr
+    /^[a-z]{2}-[a-z]{2}$/, // en-us, de-de
+    /^[a-z]{2}_[a-z]{2}$/, // en_us, de_de
+    /^[a-z]{2}-[a-z]{2}-[a-z]+$/, // en-us-traditional
+];
+const NON_LOCALE_KEYWORDS = [
+    'key', 'keys', 'id', 'identifier', 'name', 'title', 'label',
+    'description', 'comment', 'note', 'context', 'category', 'type',
+    'status', 'updated', 'created', 'modified', 'version', 'source',
+    'i18n', 'translation', 'namespace', 'section'
+];
+/**
+ * Determines if a string represents a valid locale identifier
+ * @param value The string to test
+ * @returns true if the string appears to be a locale identifier
+ */
+function isValidLocale(value) {
+    if (!value || typeof value !== 'string') {
+        return false;
+    }
+    const normalized = value.toLowerCase().trim();
+    // Check if it's a common non-locale keyword
+    if (NON_LOCALE_KEYWORDS.includes(normalized)) {
+        return false;
+    }
+    // Check if it matches common locale patterns (only accept lowercase patterns)
+    return COMMON_LOCALE_PATTERNS.some(pattern => pattern.test(normalized));
+}
+/**
+ * Filters header row to only include valid locale columns, excluding the key column
+ * @param headerRow Array of column names from the sheet header
+ * @param keyColumn The name of the key column to exclude
+ * @returns Array of valid locale identifiers
+ */
+function filterValidLocales(headerRow, keyColumn) {
+    return headerRow
+        .filter(column => column.toLowerCase() !== keyColumn.toLowerCase())
+        .filter(column => isValidLocale(column)) // Use original case for validation
+        .map(locale => locale.toLowerCase()); // Then normalize to lowercase
+}
+//# sourceMappingURL=localeFilter.js.map

package/dist/utils/localeFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localeFilter.js","sourceRoot":"","sources":["../../src/utils/localeFilter.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAqBH,sCAcC;AAQD,gDAKC;AA9CD,MAAM,sBAAsB,GAAG;IAC9B,YAAY,EAAqB,aAAa;IAC9C,qBAAqB,EAAW,eAAe;IAC/C,qBAAqB,EAAW,eAAe;IAC/C,4BAA4B,EAAI,oBAAoB;CACpD,CAAC;AAEF,MAAM,mBAAmB,GAAG;IAC3B,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAC3D,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM;IAC/D,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ;IAC/D,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS;CAC7C,CAAC;AAEF;;;;GAIG;AACH,SAAgB,aAAa,CAAC,KAAa;IAC1C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAE9C,4CAA4C;IAC5C,IAAI,mBAAmB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACd,CAAC;IAED,8EAA8E;IAC9E,OAAO,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,SAAmB,EAAE,SAAiB;IACxE,OAAO,SAAS;SACd,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC;SAClE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,mCAAmC;SAC3E,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,8BAA8B;AACtE,CAAC"}

package/dist/utils/localeNormalizer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Locale normalization utilities for converting simple language codes to full locale codes
+ * and maintaining mappings between normalized codes and original spreadsheet headers
+ */
+/**
+ * Normalizes a language code to include country code if missing
+ * @param locale The original locale code from spreadsheet header
+ * @returns Normalized locale with country code
+ */
+export declare function normalizeLocaleCode(locale: string): string;
+/**
+ * Creates a mapping between normalized locale codes and their original spreadsheet headers
+ * @param originalHeaders Array of original header names from spreadsheet
+ * @param keyColumn The key column name to exclude
+ * @returns Object with normalized locales and header mapping
+ */
+export declare function createLocaleMapping(originalHeaders: string[], keyColumn: string): {
+    normalizedLocales: string[];
+    localeMapping: Record<string, string>;
+    originalMapping: Record<string, string>;
+};
+/**
+ * Finds the original header name for a given normalized locale
+ * @param normalizedLocale The normalized locale code (e.g., 'pl-PL')
+ * @param localeMapping Mapping from normalized locales to original headers
+ * @returns Original header name or undefined if not found
+ */
+export declare function getOriginalHeaderForLocale(normalizedLocale: string, localeMapping: Record<string, string>): string | undefined;
+/**
+ * Finds the normalized locale for a given original header
+ * @public
+ * @param originalHeader The original header name (e.g., 'pl')
+ * @param originalMapping Mapping from original headers to normalized locales
+ * @returns Normalized locale code or undefined if not found
+ */
+export declare function getNormalizedLocaleForHeader(originalHeader: string, originalMapping: Record<string, string>): string | undefined;
+//# sourceMappingURL=localeNormalizer.d.ts.map

package/dist/utils/localeNormalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localeNormalizer.d.ts","sourceRoot":"","sources":["../../src/utils/localeNormalizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4CH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA0B1D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAClC,eAAe,EAAE,MAAM,EAAE,EACzB,SAAS,EAAE,MAAM,GACf;IACF,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC,CA+BA;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACzC,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,MAAM,GAAG,SAAS,CAkBpB;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC3C,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,MAAM,GAAG,SAAS,CAEpB"}