@el-j/google-sheet-translations 2.1.4 → 2.2.0-beta.1

package/README.md

@@ -245,18 +245,19 @@ When enabled, the auto-translation feature automatically adds Google Translate f
 
 The formula follows this format:
 ```
-=GOOGLETRANSLATE(INDIRECT(sourceColumn&ROW());$sourceColumn$1;targetColumn$1)
+=GOOGLETRANSLATE(INDIRECT(srcCol&ROW()); langCodeFormula($srcCol$1); langCodeFormula(tgtCol$1))
 ```
 
-For example, if you add a new key with an English translation in column B but no German translation in column C, the system will automatically add:
+The `langCodeFormula` dynamically extracts the GOOGLETRANSLATE-compatible language code from the header cell — stripping region qualifiers (e.g. `"tr-TR"` → `"tr"`) while preserving Chinese variants (`zh-TW` / `zh-CN`).  All formula separators are automatically matched to the spreadsheet's locale.
+
+For example, if you add a new key with an English translation in column B but no Turkish translation (header `tr-TR`) in column C, the system will automatically add:
 ```
-=GOOGLETRANSLATE(INDIRECT("B"&ROW());$B$1;C$1)
+=GOOGLETRANSLATE(INDIRECT("B"&ROW());IF(LOWER(LEFT($B$1;3))="zh-";LOWER($B$1);LOWER(IFERROR(LEFT($B$1;FIND("-";$B$1)-1);$B$1)));IF(LOWER(LEFT(C$1;3))="zh-";LOWER(C$1);LOWER(IFERROR(LEFT(C$1;FIND("-";C$1)-1);C$1))))
 ```
 
 Where:
 - `INDIRECT("B"&ROW())` dynamically references the source text cell in the same row
-- `$B$1` references the header cell containing the source language code
-- `C$1` references the header cell containing the target language code
+- Each `IF(…)` wrapper extracts the language code from the header cell (`$B$1` / `C$1`), producing `"en"` and `"tr"` respectively at evaluation time
 
 [View the complete Auto-Translation Guide](docs/auto-translation-guide.md) for more details and best practices.
 

package/dist/action-entrypoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-entrypoint.d.ts","sourceRoot":"","sources":["../src/action-entrypoint.ts"],"names":[],"mappings":"AAKA,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA+DzC"}
+{"version":3,"file":"action-entrypoint.d.ts","sourceRoot":"","sources":["../src/action-entrypoint.ts"],"names":[],"mappings":"AAMA,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA2FzC"}

package/dist/esm/index.js

@@ -169,6 +169,14 @@ function filterValidLocales(headerRow, keyColumn) {
 function getLanguagePrefix(locale) {
   return locale.toLowerCase().split(/[-_]/)[0];
 }
+var GOOGLE_TRANSLATE_CODES_REQUIRING_REGION = /* @__PURE__ */ new Set(["zh-tw", "zh-cn"]);
+function getGoogleTranslateCode(locale) {
+  const normalized = locale.toLowerCase().trim().replace("_", "-");
+  if (GOOGLE_TRANSLATE_CODES_REQUIRING_REGION.has(normalized)) {
+    return normalized;
+  }
+  return normalized.split(/[-_]/)[0];
+}
 var LANGUAGE_TO_COUNTRY_MAP = {
   "en": "en-GB",
   "de": "de-DE",
@@ -531,12 +539,23 @@ function columnIndexToLetter(index) {
   } while (i >= 0);
   return result;
 }
-function langCodeFormula(cellRef) {
-  return `LOWER(IFERROR(LEFT(${cellRef},FIND("-",${cellRef})-1),${cellRef}))`;
+function getFormulaSeparator(doc) {
+  try {
+    const locale = doc._rawProperties?.locale || "";
+    if (/^(en|ja|ko|zh|th|id|ms)/i.test(locale)) return ",";
+  } catch {
+  }
+  return ";";
+}
+function langCodeFormula(cellRef, sep) {
+  const prefix = `LOWER(IFERROR(LEFT(${cellRef}${sep}FIND("-"${sep}${cellRef})-1)${sep}${cellRef}))`;
+  const full = `LOWER(${cellRef})`;
+  return `IF(LOWER(LEFT(${cellRef}${sep}3))="zh-"${sep}${full}${sep}${prefix})`;
 }
 async function updateSpreadsheetWithLocalChanges(doc, changes, waitSeconds, autoTranslate = false, localeMapping = {}, override = false) {
   console.log("Updating spreadsheet with local changes...");
   const baseDelayMs = waitSeconds * 1e3;
+  const sep = getFormulaSeparator(doc);
   for (const sheetTitle of new Set(
     Object.values(changes).flatMap((locale) => Object.keys(locale))
   )) {
@@ -680,7 +699,7 @@ async function updateSpreadsheetWithLocalChanges(doc, changes, waitSeconds, auto
                     const targetColumnLetter = columnIndexToLetter(targetHeaderIndex);
                     row.set(
                       exactTargetHeader,
-                      `=GOOGLETRANSLATE(INDIRECT("${sourceColumnLetter}"&ROW());${langCodeFormula(`$${sourceColumnLetter}$1`)};${langCodeFormula(`${targetColumnLetter}$1`)})`
+                      `=GOOGLETRANSLATE(INDIRECT("${sourceColumnLetter}"&ROW())${sep}${langCodeFormula(`$${sourceColumnLetter}$1`, sep)}${sep}${langCodeFormula(`${targetColumnLetter}$1`, sep)})`
                     );
                   }
                 }
@@ -729,7 +748,7 @@ async function updateSpreadsheetWithLocalChanges(doc, changes, waitSeconds, auto
                 }
                 const sourceColumnLetter = columnIndexToLetter(sourceHeaderIndex);
                 const targetColumnLetter = columnIndexToLetter(targetHeaderIndex);
-                rowData[exactHeaderName] = `=GOOGLETRANSLATE(INDIRECT("${sourceColumnLetter}"&ROW());${langCodeFormula(`$${sourceColumnLetter}$1`)};${langCodeFormula(`${targetColumnLetter}$1`)})`;
+                rowData[exactHeaderName] = `=GOOGLETRANSLATE(INDIRECT("${sourceColumnLetter}"&ROW())${sep}${langCodeFormula(`$${sourceColumnLetter}$1`, sep)}${sep}${langCodeFormula(`${targetColumnLetter}$1`, sep)})`;
               }
             }
           }
@@ -985,8 +1004,18 @@ function colLetter(index) {
   } while (i >= 0);
   return result;
 }
-function langCodeFormula2(cellRef) {
-  return `LOWER(IFERROR(LEFT(${cellRef},FIND("-",${cellRef})-1),${cellRef}))`;
+function getFormulaSeparator2(doc) {
+  try {
+    const locale = doc._rawProperties?.locale || "";
+    if (/^(en|ja|ko|zh|th|id|ms)/i.test(locale)) return ",";
+  } catch {
+  }
+  return ";";
+}
+function langCodeFormula2(cellRef, sep) {
+  const prefix = `LOWER(IFERROR(LEFT(${cellRef}${sep}FIND("-"${sep}${cellRef})-1)${sep}${cellRef}))`;
+  const full = `LOWER(${cellRef})`;
+  return `IF(LOWER(LEFT(${cellRef}${sep}3))="zh-"${sep}${full}${sep}${prefix})`;
 }
 var DEFAULT_TARGET_LOCALES = ["de", "fr", "es", "it", "pt", "ja", "zh"];
 var STARTER_KEYS = {
@@ -1068,11 +1097,12 @@ async function createSpreadsheet(authClient, options = {}) {
       "setHeaderRow"
     );
     const sourceColLetter = colLetter(1);
+    const sep = getFormulaSeparator2(doc);
     const rows = Object.entries(seedKeys).map(([key, sourceValue]) => {
       const row = { key, [sourceLocale]: sourceValue };
       targetLocales.forEach((locale, idx) => {
         const targetColLetter = colLetter(2 + idx);
-        row[locale] = `=GOOGLETRANSLATE(INDIRECT("${sourceColLetter}"&ROW());${langCodeFormula2(`$${sourceColLetter}$1`)};${langCodeFormula2(`${targetColLetter}$1`)})`;
+        row[locale] = `=GOOGLETRANSLATE(INDIRECT("${sourceColLetter}"&ROW())${sep}${langCodeFormula2(`$${sourceColLetter}$1`, sep)}${sep}${langCodeFormula2(`${targetColLetter}$1`, sep)})`;
       });
       return row;
     });
@@ -1287,6 +1317,367 @@ function mergeSheets(translations, locale, sheetNames) {
   return merged;
 }
 
+// src/utils/multiSpreadsheetMerger.ts
+function mergeMultipleTranslationData(results, mergeStrategy = "later-wins") {
+  const merged = {};
+  for (const result of results) {
+    for (const [locale, sheets] of Object.entries(result)) {
+      if (!merged[locale]) {
+        merged[locale] = {};
+      }
+      for (const [sheet, keys] of Object.entries(sheets)) {
+        if (!merged[locale][sheet]) {
+          merged[locale][sheet] = {};
+        }
+        for (const [key, value] of Object.entries(keys)) {
+          if (mergeStrategy === "first-wins" && key in merged[locale][sheet]) {
+            continue;
+          }
+          merged[locale][sheet][key] = value;
+        }
+      }
+    }
+  }
+  return merged;
+}
+
+// src/getMultipleSpreadSheetsData.ts
+async function getMultipleSpreadSheetsData(docTitles, options = {}) {
+  const { spreadsheetIds, mergeStrategy = "later-wins", ...baseOptions } = options;
+  if (!spreadsheetIds || spreadsheetIds.length === 0) {
+    return getSpreadSheetData(docTitles, baseOptions);
+  }
+  console.log(`[getMultipleSpreadSheetsData] Fetching ${spreadsheetIds.length} spreadsheets...`);
+  const results = [];
+  for (let i = 0; i < spreadsheetIds.length; i++) {
+    const id = spreadsheetIds[i];
+    console.log(`[getMultipleSpreadSheetsData] (${i + 1}/${spreadsheetIds.length}) "${id}"...`);
+    const result = await getSpreadSheetData(docTitles, { ...baseOptions, spreadsheetId: id });
+    results.push(result);
+  }
+  return mergeMultipleTranslationData(results, mergeStrategy);
+}
+
+// src/utils/driveFolderScanner.ts
+import { GoogleAuth } from "google-auth-library";
+var SPREADSHEET_MIME = "application/vnd.google-apps.spreadsheet";
+var FOLDER_MIME = "application/vnd.google-apps.folder";
+var DRIVE_FILES_URL = "https://www.googleapis.com/drive/v3/files";
+async function getAccessToken(credentials) {
+  const clientEmail = credentials?.GOOGLE_CLIENT_EMAIL ?? process.env.GOOGLE_CLIENT_EMAIL;
+  const privateKey = credentials?.GOOGLE_PRIVATE_KEY ?? process.env.GOOGLE_PRIVATE_KEY;
+  if (!clientEmail || !privateKey) {
+    throw new Error(
+      "Google Drive credentials required: GOOGLE_CLIENT_EMAIL and GOOGLE_PRIVATE_KEY"
+    );
+  }
+  const normalizedKey = privateKey.replace(/\\n/g, "\n");
+  const auth = new GoogleAuth({
+    credentials: { client_email: clientEmail, private_key: normalizedKey },
+    scopes: ["https://www.googleapis.com/auth/drive.readonly"]
+  });
+  const client = await auth.getClient();
+  const tokenResponse = await client.getAccessToken();
+  return tokenResponse.token;
+}
+async function listFilesInFolder(folderId, mimeType, token) {
+  const results = [];
+  let pageToken;
+  do {
+    const query = `'${folderId}' in parents and mimeType = '${mimeType}' and trashed = false`;
+    const params = new URLSearchParams({
+      q: query,
+      fields: "nextPageToken,files(id,name,mimeType,modifiedTime,parents)",
+      pageSize: "1000"
+    });
+    if (pageToken) params.set("pageToken", pageToken);
+    const response = await fetch(`${DRIVE_FILES_URL}?${params.toString()}`, {
+      headers: { Authorization: `Bearer ${token}` }
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(
+        `Drive API error ${response.status}: ${text}`
+      );
+    }
+    const data = await response.json();
+    results.push(...data.files);
+    pageToken = data.nextPageToken;
+  } while (pageToken);
+  return results;
+}
+async function scanFolder(folderId, folderPath, token, recursive, nameFilter, seen = /* @__PURE__ */ new Set()) {
+  console.log(`[driveFolderScanner] Scanning folder: ${folderId} (path: "${folderPath}")`);
+  const spreadsheets = await listFilesInFolder(folderId, SPREADSHEET_MIME, token);
+  const results = [];
+  for (const file of spreadsheets) {
+    if (seen.has(file.id)) continue;
+    seen.add(file.id);
+    if (nameFilter && !nameFilter.test(file.name)) continue;
+    results.push({
+      id: file.id,
+      name: file.name,
+      folderPath,
+      mimeType: file.mimeType,
+      modifiedTime: file.modifiedTime
+    });
+  }
+  if (recursive) {
+    const subfolders = await listFilesInFolder(folderId, FOLDER_MIME, token);
+    for (const folder of subfolders) {
+      const subPath = folderPath ? `${folderPath}/${folder.name}` : folder.name;
+      const subResults = await scanFolder(
+        folder.id,
+        subPath,
+        token,
+        recursive,
+        nameFilter,
+        seen
+      );
+      results.push(...subResults);
+    }
+  }
+  return results;
+}
+async function scanDriveFolderForSpreadsheets(options) {
+  const { folderId, recursive = true, nameFilter, credentials } = options;
+  const token = await getAccessToken(credentials);
+  return scanFolder(folderId, "", token, recursive, nameFilter);
+}
+
+// src/utils/driveImageSync.ts
+import { createWriteStream, mkdirSync, existsSync, readdirSync, unlinkSync, statSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { pipeline } from "node:stream/promises";
+import { Readable } from "node:stream";
+import { GoogleAuth as GoogleAuth2 } from "google-auth-library";
+var DEFAULT_IMAGE_MIME_TYPES = [
+  "image/jpeg",
+  "image/jpg",
+  "image/png",
+  "image/webp",
+  "image/avif",
+  "image/gif",
+  "image/svg+xml",
+  "image/tiff",
+  "image/bmp",
+  "image/ico",
+  "image/x-icon"
+];
+var FOLDER_MIME2 = "application/vnd.google-apps.folder";
+var DRIVE_FILES_URL2 = "https://www.googleapis.com/drive/v3/files";
+async function getAccessToken2(credentials) {
+  const clientEmail = credentials?.GOOGLE_CLIENT_EMAIL ?? process.env.GOOGLE_CLIENT_EMAIL;
+  const privateKey = credentials?.GOOGLE_PRIVATE_KEY ?? process.env.GOOGLE_PRIVATE_KEY;
+  if (!clientEmail || !privateKey) {
+    throw new Error(
+      "Google Drive credentials required: GOOGLE_CLIENT_EMAIL and GOOGLE_PRIVATE_KEY"
+    );
+  }
+  const normalizedKey = privateKey.replace(/\\n/g, "\n");
+  const auth = new GoogleAuth2({
+    credentials: { client_email: clientEmail, private_key: normalizedKey },
+    scopes: ["https://www.googleapis.com/auth/drive.readonly"]
+  });
+  const client = await auth.getClient();
+  const tokenResponse = await client.getAccessToken();
+  return tokenResponse.token;
+}
+async function listFilesInFolder2(folderId, token, mimeTypeFilter) {
+  const results = [];
+  let pageToken;
+  do {
+    const mimeClause = mimeTypeFilter ? ` and mimeType = '${mimeTypeFilter}'` : "";
+    const query = `'${folderId}' in parents${mimeClause} and trashed = false`;
+    const params = new URLSearchParams({
+      q: query,
+      fields: "nextPageToken,files(id,name,mimeType,parents)",
+      pageSize: "1000"
+    });
+    if (pageToken) params.set("pageToken", pageToken);
+    const response = await fetch(`${DRIVE_FILES_URL2}?${params.toString()}`, {
+      headers: { Authorization: `Bearer ${token}` }
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Drive API error ${response.status}: ${text}`);
+    }
+    const data = await response.json();
+    results.push(...data.files);
+    pageToken = data.nextPageToken;
+  } while (pageToken);
+  return results;
+}
+async function collectFiles(folderId, folderRelPath, outputPath, token, allowedMimeTypes, recursive, folderPattern) {
+  console.log(`[driveImageSync] Scanning folder: ${folderId} (path: "${folderRelPath}")`);
+  const allItems = await listFilesInFolder2(folderId, token);
+  const entries = [];
+  for (const item of allItems) {
+    if (item.mimeType === FOLDER_MIME2) {
+      if (!recursive) continue;
+      const subRelPath = folderRelPath ? `${folderRelPath}/${item.name}` : item.name;
+      if (folderPattern && !folderPattern.test(subRelPath)) continue;
+      const subEntries = await collectFiles(
+        item.id,
+        subRelPath,
+        outputPath,
+        token,
+        allowedMimeTypes,
+        recursive,
+        folderPattern
+      );
+      entries.push(...subEntries);
+    } else if (allowedMimeTypes.includes(item.mimeType)) {
+      const localPath = folderRelPath ? join(outputPath, folderRelPath, item.name) : join(outputPath, item.name);
+      entries.push({ id: item.id, name: item.name, localPath, mimeType: item.mimeType });
+    }
+  }
+  return entries;
+}
+async function downloadFile(fileId, localPath, token) {
+  const url = `${DRIVE_FILES_URL2}/${fileId}?alt=media`;
+  const response = await fetch(url, { headers: { Authorization: `Bearer ${token}` } });
+  if (!response.ok) {
+    throw new Error(`Failed to download ${fileId}: ${response.status}`);
+  }
+  mkdirSync(dirname(localPath), { recursive: true });
+  const dest = createWriteStream(localPath);
+  await pipeline(Readable.fromWeb(response.body), dest);
+}
+function collectLocalFiles(dir, base) {
+  const results = [];
+  if (!existsSync(dir)) return results;
+  for (const entry of readdirSync(dir)) {
+    const fullPath = join(dir, entry);
+    const stat = statSync(fullPath);
+    if (stat.isDirectory()) {
+      results.push(...collectLocalFiles(fullPath, base));
+    } else {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+async function runConcurrent(tasks, concurrency) {
+  const results = [];
+  for (let i = 0; i < tasks.length; i += concurrency) {
+    const batch = tasks.slice(i, i + concurrency).map((t) => t());
+    results.push(...await Promise.all(batch));
+  }
+  return results;
+}
+async function syncDriveImages(options) {
+  const {
+    folderId,
+    outputPath,
+    mimeTypes = DEFAULT_IMAGE_MIME_TYPES,
+    recursive = true,
+    folderPattern,
+    credentials,
+    cleanSync = false,
+    concurrency = 3
+  } = options;
+  const token = await getAccessToken2(credentials);
+  mkdirSync(outputPath, { recursive: true });
+  const entries = await collectFiles(
+    folderId,
+    "",
+    outputPath,
+    token,
+    mimeTypes,
+    recursive,
+    folderPattern
+  );
+  const downloaded = [];
+  const skipped = [];
+  const errors = [];
+  const tasks = entries.map((entry) => async () => {
+    if (existsSync(entry.localPath)) {
+      console.log(`[driveImageSync] Skipping (exists): ${entry.localPath}`);
+      skipped.push(entry.localPath);
+      return;
+    }
+    console.log(`[driveImageSync] Downloading: ${entry.localPath}`);
+    try {
+      await downloadFile(entry.id, entry.localPath, token);
+      downloaded.push(entry.localPath);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`[driveImageSync] Error downloading ${entry.localPath}: ${msg}`);
+      errors.push(entry.localPath);
+    }
+  });
+  await runConcurrent(tasks, concurrency);
+  const deleted = [];
+  if (cleanSync) {
+    const driveLocalPaths = new Set(entries.map((e) => e.localPath));
+    const localFiles = collectLocalFiles(outputPath, outputPath);
+    for (const localFile of localFiles) {
+      if (!driveLocalPaths.has(localFile)) {
+        console.log(`[driveImageSync] Deleting (not in Drive): ${localFile}`);
+        unlinkSync(localFile);
+        deleted.push(localFile);
+      }
+    }
+  }
+  console.log(
+    `[driveImageSync] Synced ${downloaded.length} files, skipped ${skipped.length}, deleted ${deleted.length}, errors ${errors.length}`
+  );
+  return { downloaded, skipped, deleted, errors };
+}
+
+// src/utils/getDriveTranslations.ts
+async function manageDriveTranslations(options) {
+  const {
+    driveFolderId,
+    scanForSpreadsheets = true,
+    spreadsheetIds: explicitIds = [],
+    spreadsheetNameFilter,
+    syncImages = false,
+    imageOutputPath,
+    imageSyncOptions,
+    translationOptions = {},
+    docTitles
+  } = options;
+  if (syncImages && !imageOutputPath) {
+    throw new Error(
+      "[manageDriveTranslations] imageOutputPath is required when syncImages is true"
+    );
+  }
+  const discoveredIds = [];
+  const discoveredNames = /* @__PURE__ */ new Map();
+  if (driveFolderId && scanForSpreadsheets) {
+    const scanOptions = { folderId: driveFolderId };
+    const discovered = await scanDriveFolderForSpreadsheets(scanOptions);
+    console.log(
+      `[manageDriveTranslations] Found ${discovered.length} spreadsheet(s) in Drive folder`
+    );
+    for (const file of discovered) {
+      discoveredIds.push(file.id);
+      discoveredNames.set(file.id, file.name);
+    }
+  }
+  const allIds = [.../* @__PURE__ */ new Set([...discoveredIds, ...explicitIds])];
+  const filteredIds = spreadsheetNameFilter ? allIds.filter((id) => {
+    const name = discoveredNames.get(id);
+    if (!name) return true;
+    return spreadsheetNameFilter.test(name);
+  }) : allIds;
+  const translations = await getMultipleSpreadSheetsData(docTitles, {
+    ...translationOptions,
+    spreadsheetIds: filteredIds.length > 0 ? filteredIds : void 0
+  });
+  let imageSync;
+  if (syncImages && driveFolderId && imageOutputPath) {
+    imageSync = await syncDriveImages({
+      ...imageSyncOptions,
+      folderId: driveFolderId,
+      outputPath: imageOutputPath
+    });
+  }
+  return { translations, spreadsheetIds: filteredIds, imageSync };
+}
+
 // src/index.ts
 var index_default = getSpreadSheetData;
 export {
@@ -1299,19 +1690,25 @@ export {
   index_default as default,
   filterValidLocales,
   findLocalChanges,
+  getGoogleTranslateCode,
   getLanguagePrefix,
   getLocaleDisplayName,
+  getMultipleSpreadSheetsData,
   getNormalizedLocaleForHeader,
   getOriginalHeaderForLocale,
   getSpreadSheetData,
   getTranslationSummary,
   handleBidirectionalSync,
   isValidLocale,
+  manageDriveTranslations,
+  mergeMultipleTranslationData,
   mergeSheets,
   normalizeLocaleCode,
   processRawRows,
   readPublicSheet,
   resolveLocaleWithFallback,
+  scanDriveFolderForSpreadsheets,
+  syncDriveImages,
   updateSpreadsheetWithLocalChanges,
   validateCredentials,
   validateEnv,

package/dist/getMultipleSpreadSheetsData.d.ts

@@ -0,0 +1,19 @@
+import type { TranslationData } from './types';
+import type { SpreadsheetOptions } from './utils/configurationHandler';
+export interface MultiSpreadsheetOptions extends SpreadsheetOptions {
+    /** Array of spreadsheet IDs to fetch from. Overrides spreadsheetId if provided. */
+    spreadsheetIds?: string[];
+    /**
+     * How to merge same-locale same-sheet keys from different spreadsheets.
+     * 'later-wins': keys from later spreadsheets override earlier (default)
+     * 'first-wins': keep first occurrence of each key
+     */
+    mergeStrategy?: 'later-wins' | 'first-wins';
+}
+/**
+ * Fetches translations from multiple Google Spreadsheets and merges them.
+ * When spreadsheetIds is not provided, falls back to options.spreadsheetId
+ * or GOOGLE_SPREADSHEET_ID env var (same as getSpreadSheetData).
+ */
+export declare function getMultipleSpreadSheetsData(docTitles?: string[], options?: MultiSpreadsheetOptions): Promise<TranslationData>;
+//# sourceMappingURL=getMultipleSpreadSheetsData.d.ts.map

package/dist/getMultipleSpreadSheetsData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMultipleSpreadSheetsData.d.ts","sourceRoot":"","sources":["../src/getMultipleSpreadSheetsData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAIvE,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IAClE,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAChD,SAAS,CAAC,EAAE,MAAM,EAAE,EACpB,OAAO,GAAE,uBAA4B,GACnC,OAAO,CAAC,eAAe,CAAC,CAmB1B"}

package/dist/index.d.ts

@@ -16,7 +16,7 @@ export { readPublicSheet } from './utils/publicSheetReader';
 export { createSpreadsheet } from './utils/spreadsheetCreator';
 export { validateCredentials } from './utils/validateEnv';
 export { isValidLocale, filterValidLocales } from './utils/localeFilter';
-export { getLanguagePrefix, normalizeLocaleCode, createLocaleMapping, getOriginalHeaderForLocale, getNormalizedLocaleForHeader, resolveLocaleWithFallback, } from './utils/localeNormalizer';
+export { getLanguagePrefix, getGoogleTranslateCode, normalizeLocaleCode, createLocaleMapping, getOriginalHeaderForLocale, getNormalizedLocaleForHeader, resolveLocaleWithFallback, } from './utils/localeNormalizer';
 export { processRawRows } from './utils/sheetProcessor';
 export type { SheetProcessingResult } from './utils/sheetProcessor';
 export { getTranslationSummary, getLocaleDisplayName, mergeSheets } from './utils/translationHelpers';
@@ -25,6 +25,15 @@ export { writeTranslationFiles, writeLocalesFile, writeLanguageDataFile } from '
 export { handleBidirectionalSync } from './utils/syncManager';
 export type { SyncResult } from './utils/syncManager';
 export type { TranslationData, TranslationValue, SheetRow, GoogleEnvVars, } from './types';
+export { getMultipleSpreadSheetsData } from './getMultipleSpreadSheetsData';
+export type { MultiSpreadsheetOptions } from './getMultipleSpreadSheetsData';
+export { mergeMultipleTranslationData } from './utils/multiSpreadsheetMerger';
+export { scanDriveFolderForSpreadsheets } from './utils/driveFolderScanner';
+export type { DriveSpreadsheetFile, ScanDriveFolderOptions } from './utils/driveFolderScanner';
+export { syncDriveImages } from './utils/driveImageSync';
+export type { DriveImageSyncOptions, DriveImageSyncResult } from './utils/driveImageSync';
+export { manageDriveTranslations } from './utils/getDriveTranslations';
+export type { GoogleDriveManagerOptions, GoogleDriveManagerResult } from './utils/getDriveTranslations';
 import { getSpreadSheetData } from './getSpreadSheetData';
 export default getSpreadSheetData;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGhF,YAAY,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAC;AAG/E,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGzE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAGpE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACtG,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAGnF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGpG,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGhF,YAAY,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAC;AAG/E,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGzE,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAGpE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACtG,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAGnF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGpG,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,YAAY,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAG9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAC5E,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAG/F,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAGxG,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,eAAe,kBAAkB,CAAC"}