gtx-cli 2.6.14 → 2.6.15

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # gtx-cli
 
+## 2.6.15
+
+### Patch Changes
+
+- [#999](https://github.com/generaltranslation/gt/pull/999) [`09f3e68`](https://github.com/generaltranslation/gt/commit/09f3e6829243decffa795251d46c9e6a0d1ed878) Thanks [@fernando-aviles](https://github.com/fernando-aviles)! - Allow `sharedStaticAssets` configuration to mirror shared asset structure
+
 ## 2.6.14
 
 ### Patch Changes

package/dist/cli/base.js

@@ -25,7 +25,7 @@ import { displayTranslateSummary } from '../console/displayTranslateSummary.js';
 import updateConfig from '../fs/config/updateConfig.js';
 import { createLoadTranslationsFile } from '../fs/createLoadTranslationsFile.js';
 import { saveLocalEdits } from '../api/saveLocalEdits.js';
-import processSharedStaticAssets from '../utils/sharedStaticAssets.js';
+import processSharedStaticAssets, { mirrorAssetsToLocales, } from '../utils/sharedStaticAssets.js';
 import { setupLocadex } from '../locadex/setupFlow.js';
 import { detectFramework } from '../setup/detectFramework.js';
 import { getFrameworkDisplayName, getReactFrameworkLibrary, } from '../setup/frameworkUtils.js';
@@ -131,6 +131,8 @@ export class BaseCLI {
         if (include.size > 0) {
             await postProcessTranslations(settings, include);
         }
+        // Mirror assets after translations are downloaded and locale dirs are populated
+        await mirrorAssetsToLocales(settings);
         clearDownloaded();
         displayTranslateSummary();
         clearWarnings();

package/dist/generated/version.d.ts

@@ -1 +1 @@
-export declare const PACKAGE_VERSION = "2.6.14";
+export declare const PACKAGE_VERSION = "2.6.15";

package/dist/generated/version.js

@@ -1,2 +1,2 @@
 // This file is auto-generated. Do not edit manually.
-export const PACKAGE_VERSION = '2.6.14';
+export const PACKAGE_VERSION = '2.6.15';

package/dist/types/index.d.ts

@@ -213,8 +213,9 @@ export type AdditionalOptions = {
 };
 export type SharedStaticAssetsConfig = {
     include: string | string[];
-    outDir: string;
+    outDir?: string;
     publicPath?: string;
+    mirrorToLocales?: boolean;
 };
 export type JsonSchema = {
     preset?: 'mintlify' | 'openapi';

package/dist/utils/addExplicitAnchorIds.js

@@ -113,8 +113,7 @@ export function extractHeadingInfo(mdxContent) {
         const ast = parseProcessor.parse(mdxContent);
         processedAst = parseProcessor.runSync(ast);
     }
-    catch (error) {
-        console.warn(`Failed to parse MDX content: ${error instanceof Error ? error.message : String(error)}`);
+    catch {
         // Fallback: line-by-line extraction skipping fenced code blocks
         return extractHeadingsWithFallback(mdxContent);
     }
@@ -220,8 +219,7 @@ function applyInlineIds(translatedContent, idMappings, escapeAnchors) {
         const ast = parseProcessor.parse(translatedContent);
         processedAst = parseProcessor.runSync(ast);
     }
-    catch (error) {
-        console.warn(`Failed to parse translated MDX content: ${error instanceof Error ? error.message : String(error)}`);
+    catch {
         return applyInlineIdsStringFallback(translatedContent, idMappings, escapeAnchors);
     }
     // Apply IDs to headings based on position
@@ -296,8 +294,7 @@ function applyInlineIds(translatedContent, idMappings, escapeAnchors) {
         }
         return content;
     }
-    catch (error) {
-        console.warn(`Failed to stringify translated MDX content: ${error instanceof Error ? error.message : String(error)}`);
+    catch {
         return translatedContent;
     }
 }

package/dist/utils/localizeStaticImports.js

@@ -291,9 +291,7 @@ function transformMdxImports(mdxContent, defaultLocale, targetLocale, hideDefaul
         const ast = parseProcessor.parse(mdxContent);
         processedAst = parseProcessor.runSync(ast);
     }
-    catch (error) {
-        console.warn(`Failed to parse MDX content: ${error instanceof Error ? error.message : String(error)}`);
-        console.warn('Falling back to string-based import localization.');
+    catch {
         return transformImportsStringFallback(mdxContent, defaultLocale, targetLocale, hideDefaultLocale, pattern, exclude, currentFilePath, options);
     }
     let content = mdxContent;

package/dist/utils/localizeStaticUrls.js

@@ -249,9 +249,7 @@ function transformMdxUrls(mdxContent, defaultLocale, targetLocale, hideDefaultLo
         const ast = parseProcessor.parse(mdxContent);
         processedAst = parseProcessor.runSync(ast);
     }
-    catch (error) {
-        console.warn(`Failed to parse MDX content: ${error instanceof Error ? error.message : String(error)}`);
-        console.warn('Returning original content unchanged due to parsing error.');
+    catch {
         return {
             content: mdxContent,
             hasChanges: false,

package/dist/utils/sharedStaticAssets.d.ts

@@ -1,2 +1,3 @@
 import type { Settings } from '../types/index.js';
+export declare function mirrorAssetsToLocales(settings: Settings): Promise<void>;
 export default function processSharedStaticAssets(settings: Settings): Promise<void>;

package/dist/utils/sharedStaticAssets.js

@@ -8,6 +8,8 @@ import remarkFrontmatter from 'remark-frontmatter';
 import remarkStringify from 'remark-stringify';
 import { visit } from 'unist-util-visit';
 import escapeHtmlInTextNodes from 'gt-remark';
+import { createFileMapping } from '../formats/files/fileMapping.js';
+import { TEMPLATE_FILE_NAME } from './constants.js';
 function derivePublicPath(outDir, provided) {
     if (provided)
         return provided;
@@ -199,26 +201,127 @@ function rewriteMdxContent(content, filePath, pathMap) {
         return { content, changed: false };
     }
 }
+function resolveAssetPaths(include, cwd) {
+    const assetPaths = new Set();
+    for (let pattern of include) {
+        if (pattern.startsWith('/'))
+            pattern = pattern.slice(1);
+        const matches = fg.sync(path.resolve(cwd, pattern), { absolute: true });
+        for (const m of matches)
+            assetPaths.add(path.normalize(m));
+    }
+    return assetPaths;
+}
+export async function mirrorAssetsToLocales(settings) {
+    const cfg = settings.sharedStaticAssets;
+    if (!cfg?.mirrorToLocales)
+        return;
+    if (!settings.files)
+        return;
+    const cwd = process.cwd();
+    const include = toArray(cfg.include);
+    if (include.length === 0)
+        return;
+    const assetPaths = resolveAssetPaths(include, cwd);
+    if (assetPaths.size === 0)
+        return;
+    const { resolvedPaths, placeholderPaths, transformPaths } = settings.files;
+    const targetLocales = settings.locales.filter((l) => l !== settings.defaultLocale);
+    if (targetLocales.length === 0)
+        return;
+    const fileMapping = createFileMapping(resolvedPaths, placeholderPaths, transformPaths, targetLocales, settings.defaultLocale);
+    for (const locale of targetLocales) {
+        const filesMap = fileMapping[locale];
+        if (!filesMap)
+            continue;
+        // Extract unique (sourceDir, targetDir) pairs from the file mapping
+        const dirPairs = new Map();
+        for (const [sourcePath, targetPath] of Object.entries(filesMap)) {
+            if (sourcePath === TEMPLATE_FILE_NAME)
+                continue;
+            const sourceDir = path.dirname(path.resolve(cwd, sourcePath));
+            const targetDir = path.dirname(path.resolve(cwd, targetPath));
+            if (sourceDir !== targetDir) {
+                dirPairs.set(sourceDir, targetDir);
+            }
+        }
+        if (dirPairs.size === 0)
+            continue;
+        // Derive ancestor directory pairs by walking up from each known pair.
+        // e.g. if docs/guide → ja/docs/guide, infer docs → ja/docs.
+        // Stop at cwd or when an existing pair conflicts.
+        const ancestorPairs = new Map();
+        for (const [sourceDir, targetDir] of dirPairs) {
+            let s = path.dirname(sourceDir);
+            let t = path.dirname(targetDir);
+            while (s.startsWith(cwd) && s !== cwd) {
+                const existing = dirPairs.get(s) ?? ancestorPairs.get(s);
+                if (existing !== undefined) {
+                    if (existing !== t)
+                        break; // conflict — different transforms
+                }
+                else {
+                    ancestorPairs.set(s, t);
+                }
+                s = path.dirname(s);
+                t = path.dirname(t);
+            }
+        }
+        for (const [s, t] of ancestorPairs) {
+            dirPairs.set(s, t);
+        }
+        // Sort source dirs by length descending so longest prefix matches first
+        const sortedPairs = [...dirPairs.entries()].sort((a, b) => b[0].length - a[0].length);
+        for (const assetAbs of assetPaths) {
+            // Find the directory pair whose sourceDir is the longest prefix of the asset
+            let bestSource;
+            let bestTarget;
+            for (const [sourceDir, targetDir] of sortedPairs) {
+                if (assetAbs.startsWith(sourceDir + path.sep) ||
+                    assetAbs.startsWith(sourceDir + '/')) {
+                    bestSource = sourceDir;
+                    bestTarget = targetDir;
+                    break;
+                }
+            }
+            if (!bestSource || !bestTarget)
+                continue;
+            const relFromSource = path.relative(bestSource, assetAbs);
+            const targetAsset = path.resolve(bestTarget, relFromSource);
+            // Skip if target already exists with same size
+            try {
+                const [srcStat, dstStat] = await Promise.all([
+                    fs.promises.stat(assetAbs),
+                    fs.promises.stat(targetAsset),
+                ]);
+                if (dstStat.isFile() && srcStat.size === dstStat.size)
+                    continue;
+            }
+            catch {
+                // target doesn't exist, proceed with copy
+            }
+            await ensureDir(path.dirname(targetAsset));
+            await fs.promises.copyFile(assetAbs, targetAsset);
+        }
+    }
+}
 export default async function processSharedStaticAssets(settings) {
     const cfg = settings.sharedStaticAssets;
     if (!cfg)
         return;
+    // mirrorToLocales is handled separately after translations are downloaded
+    if (cfg.mirrorToLocales)
+        return;
     const cwd = process.cwd();
     const include = toArray(cfg.include);
     if (include.length === 0)
         return;
     // Resolve assets
-    const assetPaths = new Set();
-    for (let pattern of include) {
-        // Treat leading '/' as repo-relative, not filesystem root
-        if (pattern.startsWith('/'))
-            pattern = pattern.slice(1);
-        const matches = fg.sync(path.resolve(cwd, pattern), { absolute: true });
-        for (const m of matches)
-            assetPaths.add(path.normalize(m));
-    }
+    const assetPaths = resolveAssetPaths(include, cwd);
     if (assetPaths.size === 0)
         return;
+    if (!cfg.outDir)
+        return;
     const outDirInput = cfg.outDir.startsWith('/')
         ? cfg.outDir.slice(1)
         : cfg.outDir;

package/package.json

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