gtx-cli 2.3.13 → 2.3.14

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # gtx-cli
 
+## 2.3.14
+
+### Patch Changes
+
+- [#739](https://github.com/generaltranslation/gt/pull/739) [`7afed0b`](https://github.com/generaltranslation/gt/commit/7afed0bda5be08d83bbe75cca9fb657ff5a50dae) Thanks [@fernando-aviles](https://github.com/fernando-aviles)! - Only post-process files downloaded by gtx-cli on current run
+
 ## 2.3.13
 
 ### Patch Changes

package/dist/api/downloadFileBatch.js

@@ -7,6 +7,7 @@ import { validateYamlSchema } from '../formats/yaml/utils.js';
 import { mergeJson } from '../formats/json/mergeJson.js';
 import mergeYaml from '../formats/yaml/mergeYaml.js';
 import { getDownloadedVersions, saveDownloadedVersions, } from '../fs/config/downloadedVersions.js';
+import { recordDownloaded } from '../state/recentDownloads.js';
 /**
  * Downloads multiple translation files in a single batch request
  * @param files - Array of files to download with their output paths
@@ -97,6 +98,8 @@ export async function downloadFileBatch(files, options, maxRetries = 3, retryDel
                     }
                     // Write the file to disk
                     await fs.promises.writeFile(outputPath, data);
+                    // Track as downloaded
+                    recordDownloaded(outputPath);
                     result.successful.push(translationId);
                     if (versionId) {
                         downloadedVersions.entries[downloadedKey] = {

package/dist/cli/base.js

@@ -17,6 +17,7 @@ import { upload } from '../formats/files/upload.js';
 import { attachTranslateFlags } from './flags.js';
 import { handleStage } from './commands/stage.js';
 import { handleDownload, handleTranslate, postProcessTranslations, } from './commands/translate.js';
+import { getDownloaded, clearDownloaded } from '../state/recentDownloads.js';
 import updateConfig from '../fs/config/updateConfig.js';
 import { createLoadTranslationsFile } from '../fs/createLoadTranslationsFile.js';
 export class BaseCLI {
@@ -86,7 +87,12 @@ export class BaseCLI {
         else {
             await handleDownload(initOptions, settings);
         }
-        await postProcessTranslations(settings);
+        // Only postprocess files downloaded in this run
+        const include = getDownloaded();
+        if (include.size > 0) {
+            await postProcessTranslations(settings, include);
+        }
+        clearDownloaded();
     }
     setupUploadCommand() {
         this.program

package/dist/cli/commands/translate.d.ts

@@ -3,4 +3,4 @@ import { TranslateFlags } from '../../types/index.js';
 import { Settings } from '../../types/index.js';
 export declare function handleTranslate(options: TranslateFlags, settings: Settings, filesTranslationResponse: SendFilesResult | undefined): Promise<void>;
 export declare function handleDownload(options: TranslateFlags, settings: Settings): Promise<void>;
-export declare function postProcessTranslations(settings: Settings): Promise<void>;
+export declare function postProcessTranslations(settings: Settings, includeFiles?: Set<string>): Promise<void>;

package/dist/cli/commands/translate.js

@@ -36,25 +36,25 @@ export async function handleDownload(options, settings) {
     await checkFileTranslations(stagedVersionData, settings.locales, options.timeout, (sourcePath, locale) => fileMapping[locale][sourcePath] ?? null, settings, false, // force is not applicable for downloading staged translations
     options.forceDownload);
 }
-export async function postProcessTranslations(settings) {
+export async function postProcessTranslations(settings, includeFiles) {
     // Localize static urls (/docs -> /[locale]/docs) and preserve anchor IDs for non-default locales
     // Default locale is processed earlier in the flow in base.ts
     if (settings.options?.experimentalLocalizeStaticUrls) {
         const nonDefaultLocales = settings.locales.filter((locale) => locale !== settings.defaultLocale);
         if (nonDefaultLocales.length > 0) {
-            await localizeStaticUrls(settings, nonDefaultLocales);
+            await localizeStaticUrls(settings, nonDefaultLocales, includeFiles);
         }
         // Add explicit anchor IDs to translated MDX/MD files to preserve navigation
         // Uses inline {#id} format by default, or div wrapping if experimentalAddHeaderAnchorIds is 'mintlify'
-        await processAnchorIds(settings);
+        await processAnchorIds(settings, includeFiles);
     }
     // Localize static imports (import Snippet from /snippets/file.mdx -> import Snippet from /snippets/[locale]/file.mdx)
     if (settings.options?.experimentalLocalizeStaticImports) {
-        await localizeStaticImports(settings);
+        await localizeStaticImports(settings, includeFiles);
     }
     // Flatten json files into a single file
     if (settings.options?.experimentalFlattenJsonFiles) {
-        await flattenJsonFiles(settings);
+        await flattenJsonFiles(settings, includeFiles);
     }
     // Copy files to the target locale
     if (settings.options?.copyFiles) {

package/dist/state/recentDownloads.d.ts

@@ -0,0 +1,3 @@
+export declare function recordDownloaded(filePath: string): void;
+export declare function getDownloaded(): Set<string>;
+export declare function clearDownloaded(): void;

package/dist/state/recentDownloads.js

@@ -0,0 +1,10 @@
+const recent = new Set();
+export function recordDownloaded(filePath) {
+    recent.add(filePath);
+}
+export function getDownloaded() {
+    return recent;
+}
+export function clearDownloaded() {
+    recent.clear();
+}

package/dist/utils/flattenJsonFiles.d.ts

@@ -1,2 +1,2 @@
 import { Settings } from '../types/index.js';
-export default function flattenJsonFiles(settings: Settings): Promise<void>;
+export default function flattenJsonFiles(settings: Settings, includeFiles?: Set<string>): Promise<void>;

package/dist/utils/flattenJsonFiles.js

@@ -1,6 +1,6 @@
 import { createFileMapping } from '../formats/files/fileMapping.js';
 import fs from 'node:fs';
-export default async function flattenJsonFiles(settings) {
+export default async function flattenJsonFiles(settings, includeFiles) {
     if (!settings.files ||
         (Object.keys(settings.files.placeholderPaths).length === 1 &&
             settings.files.placeholderPaths.gt)) {
@@ -9,7 +9,7 @@ export default async function flattenJsonFiles(settings) {
     const { resolvedPaths: sourceFiles } = settings.files;
     const fileMapping = createFileMapping(sourceFiles, settings.files.placeholderPaths, settings.files.transformPaths, settings.locales, settings.defaultLocale);
     await Promise.all(Object.values(fileMapping).map(async (filesMap) => {
-        const targetFiles = Object.values(filesMap).filter((path) => path.endsWith('.json'));
+        const targetFiles = Object.values(filesMap).filter((p) => p.endsWith('.json') && (!includeFiles || includeFiles.has(p)));
         await Promise.all(targetFiles.map(async (file) => {
             // Read each json file
             const json = JSON.parse(fs.readFileSync(file, 'utf8'));

package/dist/utils/localizeStaticImports.d.ts

@@ -12,4 +12,4 @@ import { Settings } from '../types/index.js';
  * - Support more file types
  * - Support more complex paths
  */
-export default function localizeStaticImports(settings: Settings): Promise<void>;
+export default function localizeStaticImports(settings: Settings, includeFiles?: Set<string>): Promise<void>;

package/dist/utils/localizeStaticImports.js

@@ -21,7 +21,7 @@ const { isMatch } = micromatch;
  * - Support more file types
  * - Support more complex paths
  */
-export default async function localizeStaticImports(settings) {
+export default async function localizeStaticImports(settings, includeFiles) {
     if (!settings.files ||
         (Object.keys(settings.files.placeholderPaths).length === 1 &&
             settings.files.placeholderPaths.gt)) {
@@ -33,7 +33,7 @@ export default async function localizeStaticImports(settings) {
     const processPromises = [];
     // First, process default locale files (from source files)
     // This is needed because they might not be in the fileMapping if they're not being translated
-    if (!fileMapping[settings.defaultLocale]) {
+    if (!fileMapping[settings.defaultLocale] && !includeFiles) {
         const defaultLocaleFiles = [];
         // Collect all .md and .mdx files from sourceFiles
         if (sourceFiles.md) {
@@ -62,7 +62,8 @@ export default async function localizeStaticImports(settings) {
     // Then process all other locales from fileMapping
     const mappingPromises = Object.entries(fileMapping).map(async ([locale, filesMap]) => {
         // Get all files that are md or mdx
-        const targetFiles = Object.values(filesMap).filter((path) => path.endsWith('.md') || path.endsWith('.mdx'));
+        const targetFiles = Object.values(filesMap).filter((p) => (p.endsWith('.md') || p.endsWith('.mdx')) &&
+            (!includeFiles || includeFiles.has(p)));
         // Replace the placeholder path with the target path
         await Promise.all(targetFiles.map(async (filePath) => {
             // Check if file exists before processing

package/dist/utils/localizeStaticUrls.d.ts

@@ -12,7 +12,7 @@ import { Settings } from '../types/index.js';
  * - Support more file types
  * - Support more complex paths
  */
-export default function localizeStaticUrls(settings: Settings, targetLocales?: string[]): Promise<void>;
+export default function localizeStaticUrls(settings: Settings, targetLocales?: string[], includeFiles?: Set<string>): Promise<void>;
 /**
  * Main URL transformation function that delegates to specific scenarios
  */

package/dist/utils/localizeStaticUrls.js

@@ -22,7 +22,7 @@ const { isMatch } = micromatch;
  * - Support more file types
  * - Support more complex paths
  */
-export default async function localizeStaticUrls(settings, targetLocales) {
+export default async function localizeStaticUrls(settings, targetLocales, includeFiles) {
     if (!settings.files ||
         (Object.keys(settings.files.placeholderPaths).length === 1 &&
             settings.files.placeholderPaths.gt)) {
@@ -39,7 +39,9 @@ export default async function localizeStaticUrls(settings, targetLocales) {
     // This is needed because they might not be in the fileMapping if they're not being translated
     // Only process default locale if it's in the target locales filter
     if (!fileMapping[settings.defaultLocale] &&
-        locales.includes(settings.defaultLocale)) {
+        locales.includes(settings.defaultLocale) &&
+        !includeFiles // when filtering, skip default-locale pass
+    ) {
         const defaultLocaleFiles = [];
         // Collect all .md and .mdx files from sourceFiles
         if (sourceFiles.md) {
@@ -72,7 +74,8 @@ export default async function localizeStaticUrls(settings, targetLocales) {
         .filter(([locale, filesMap]) => locales.includes(locale)) // Filter by target locales
         .map(async ([locale, filesMap]) => {
         // Get all files that are md or mdx
-        const targetFiles = Object.values(filesMap).filter((path) => path.endsWith('.md') || path.endsWith('.mdx'));
+        const targetFiles = Object.values(filesMap).filter((p) => (p.endsWith('.md') || p.endsWith('.mdx')) &&
+            (!includeFiles || includeFiles.has(p)));
         // Replace the placeholder path with the target path
         await Promise.all(targetFiles.map(async (filePath) => {
             // Check if file exists before processing

package/dist/utils/processAnchorIds.d.ts

@@ -3,4 +3,4 @@ import { Settings } from '../types/index.js';
  * Processes all translated MD/MDX files to add explicit anchor IDs
  * This preserves navigation links when headings are translated
  */
-export default function processAnchorIds(settings: Settings): Promise<void>;
+export default function processAnchorIds(settings: Settings, includeFiles?: Set<string>): Promise<void>;

package/dist/utils/processAnchorIds.js

@@ -6,7 +6,7 @@ import * as fs from 'fs';
  * Processes all translated MD/MDX files to add explicit anchor IDs
  * This preserves navigation links when headings are translated
  */
-export default async function processAnchorIds(settings) {
+export default async function processAnchorIds(settings, includeFiles) {
     if (!settings.files)
         return;
     const { resolvedPaths, placeholderPaths, transformPaths } = settings.files;
@@ -16,7 +16,9 @@ export default async function processAnchorIds(settings) {
         .filter(([locale, filesMap]) => locale !== settings.defaultLocale) // Skip default locale
         .map(async ([locale, filesMap]) => {
         // Get all translated files that are md or mdx
-        const translatedFiles = Object.values(filesMap).filter((path) => path && (path.endsWith('.md') || path.endsWith('.mdx')));
+        const translatedFiles = Object.values(filesMap).filter((p) => p &&
+            (p.endsWith('.md') || p.endsWith('.mdx')) &&
+            (!includeFiles || includeFiles.has(p)));
         for (const translatedPath of translatedFiles) {
             try {
                 // Check if translated file exists before processing

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gtx-cli",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "main": "dist/index.js",
   "bin": "dist/main.js",
   "files": [