@digitaldefiance/express-suite-starter 4.24.0 → 4.25.0

package/dist/src/i18n/translations-all.d.ts

@@ -8,190 +8,7 @@ import { jaTranslations } from './strings/ja';
 import { ukTranslations } from './strings/uk';
 export declare const allTranslations: {
     'en-US': Record<import("./starter-string-key").StarterStringKey, string>;
-    'en-GB': {
-        starter_title: string;
-        starter_subtitle: string;
-        starter_description: string;
-        cli_banner: string;
-        cli_fatalError: string;
-        cli_cancelled: string;
-        cli_installRequiredTools: string;
-        systemCheck_header: string;
-        systemCheck_passed: string;
-        systemCheck_continueAnyway: string;
-        systemCheck_missingTools: string;
-        systemCheck_optionalTools: string;
-        systemCheck_installInstructions: string;
-        systemCheck_ubuntuDebian: string;
-        systemCheck_fedoraRhel: string;
-        systemCheck_macos: string;
-        systemCheck_windows: string;
-        prompt_workspaceName: string;
-        prompt_projectPrefix: string;
-        prompt_npmNamespace: string;
-        prompt_parentDirectory: string;
-        prompt_gitRepo: string;
-        prompt_hostname: string;
-        prompt_dryRun: string;
-        prompt_includeE2e: string;
-        prompt_selectPackageGroups: string;
-        prompt_enableDocGeneration: string;
-        prompt_setupDevcontainer: string;
-        prompt_devcontainerConfig: string;
-        prompt_mongoPassword: string;
-        prompt_useInMemoryDb: string;
-        prompt_devDatabaseName: string;
-        prompt_generateSecret: string;
-        prompt_enterSecret: string;
-        prompt_createInitialCommit: string;
-        prompt_pushToRemote: string;
-        prompt_installPlaywright: string;
-        prompt_siteTitle: string;
-        prompt_siteDescription: string;
-        prompt_siteTagline: string;
-        validation_invalidWorkspaceName: string;
-        validation_invalidPrefix: string;
-        validation_invalidNamespace: string;
-        validation_invalidGitRepo: string;
-        validation_invalidHostname: string;
-        validation_passwordRequired: string;
-        validation_databaseNameRequired: string;
-        validation_mustBeHex64: string;
-        validation_packageJsonNotFound: string;
-        validation_packageJsonInvalid: string;
-        validation_packageJsonMissingName: string;
-        validation_packageJsonMissingVersion: string;
-        validation_packageJsonNoScripts: string;
-        validation_reactVersionMismatch: string;
-        validation_reactDomRequired: string;
-        validation_gitignoreNotFound: string;
-        validation_readmeNotFound: string;
-        validation_licenseNotFound: string;
-        validation_passed: string;
-        validation_passedWithWarnings: string;
-        validation_failed: string;
-        validation_reportHeader: string;
-        validation_errors: string;
-        validation_warnings: string;
-        validation_info: string;
-        validation_fix: string;
-        step_checkTargetDir: string;
-        step_createMonorepo: string;
-        step_updateTsConfigBase: string;
-        step_setupGitOrigin: string;
-        step_yarnBerrySetup: string;
-        step_addPackageResolutions: string;
-        step_addNxPlugins: string;
-        step_addYarnPackages: string;
-        step_generateProjects: string;
-        step_installReactComponents: string;
-        step_renderTemplates: string;
-        step_copyScaffolding: string;
-        step_generateLicense: string;
-        step_addScripts: string;
-        step_generateDocumentation: string;
-        step_setupEnvironment: string;
-        step_rebuildNativeModules: string;
-        step_validateGeneration: string;
-        step_initialCommit: string;
-        step_installPlaywright: string;
-        step_skipping: string;
-        step_completed: string;
-        step_failed: string;
-        generation_starting: string;
-        generation_complete: string;
-        generation_failed: string;
-        generation_dryRunMode: string;
-        generation_dryRunComplete: string;
-        generation_rollback: string;
-        generation_rollbackFailed: string;
-        project_generating: string;
-        project_addedTargets: string;
-        project_installingPackage: string;
-        project_copyingDevcontainer: string;
-        tsconfig_baseUpdated: string;
-        package_resolutionsAdded: string;
-        env_createdWithSecrets: string;
-        env_createdFromApi: string;
-        env_createdDevcontainer: string;
-        env_createdDevcontainerFromExample: string;
-        env_createdDevcontainerMinimal: string;
-        env_generatedSecret: string;
-        doc_generatedReadme: string;
-        doc_generatedArchitecture: string;
-        doc_generatedApi: string;
-        template_rendered: string;
-        template_copied: string;
-        package_installationFailed: string;
-        package_installBuildTools: string;
-        package_retryOrSkip: string;
-        package_resolvingVersion: string;
-        package_failedResolveLatest: string;
-        package_failedResolveStable: string;
-        plugin_registering: string;
-        plugin_hookFailed: string;
-        dryRun_header: string;
-        dryRun_summary: string;
-        dryRun_filesToCreate: string;
-        dryRun_filesToModify: string;
-        dryRun_filesToDelete: string;
-        dryRun_commandsToRun: string;
-        dryRun_encounteredError: string;
-        dryRun_actions: string;
-        diff_changesSummary: string;
-        diff_filesAdded: string;
-        diff_filesModified: string;
-        diff_filesDeleted: string;
-        diff_truncated: string;
-        diff_before: string;
-        diff_after: string;
-        command_failed: string;
-        command_rebuildingNative: string;
-        command_installingPlaywrightBrowsers: string;
-        command_skippedPlaywright: string;
-        success_generationComplete: string;
-        success_monorepoCreated: string;
-        success_validationNoIssues: string;
-        warning_directoryExists: string;
-        warning_updateEnvFile: string;
-        warning_updateDevcontainerEnv: string;
-        warning_validationErrors: string;
-        warning_dryRunRerun: string;
-        notice_siteTitleTaglineDescriptions: string;
-        error_directoryNotEmpty: string;
-        error_invalidStartStep: string;
-        error_fatal: string;
-        section_workspaceConfig: string;
-        section_optionalProjects: string;
-        section_packageGroups: string;
-        section_devcontainerConfig: string;
-        section_databaseConfig: string;
-        section_securityConfig: string;
-        section_expressSuitePackages: string;
-        section_nextSteps: string;
-        section_nextStepsUpdateEnv: string;
-        section_nextStepsInitDb: string;
-        section_nextStepsCopyCredentials: string;
-        section_nextStepsMemoryDbInfo: string;
-        section_generatedProjects: string;
-        section_issues: string;
-        section_runningValidation: string;
-        devcontainer_simple: string;
-        devcontainer_mongodb: string;
-        devcontainer_mongodbReplicaset: string;
-        prompt_stackType: string;
-        stack_mern: string;
-        stack_brightstack: string;
-        prompt_blockstorePath: string;
-        prompt_memberPoolName: string;
-        validation_invalidBlockstorePath: string;
-        section_stackSelection: string;
-        section_brightstackStorage: string;
-        devcontainer_simpleBrightstack: string;
-        validation_stackMismatch: string;
-        validation_missingBrightstackEnv: string;
-        validation_crossStackImport: string;
-    };
+    'en-GB': Record<import("./starter-string-key").StarterStringKey, string>;
     es: Record<import("./starter-string-key").StarterStringKey, string>;
     fr: Record<import("./starter-string-key").StarterStringKey, string>;
     de: Record<import("./starter-string-key").StarterStringKey, string>;

package/dist/src/i18n/translations-all.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translations-all.d.ts","sourceRoot":"","sources":["../../../src/i18n/translations-all.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAS3B,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"translations-all.d.ts","sourceRoot":"","sources":["../../../src/i18n/translations-all.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,eAAO,MAAM,eAAe;;;;;;;;;CAS3B,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC"}

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

@@ -0,0 +1,99 @@
+/**
+ * Translation service for auto-translating site strings during scaffolding.
+ *
+ * Provider chain (user always chooses):
+ * 1. Google Translate (free, no API key)
+ * 2. AWS Translate (auto-detect or prompt for credentials, may incur charges)
+ * 3. Skip: user's original input in all languages, with TODO comments in generated code
+ *
+ * The user is ALWAYS asked before using any paid service.
+ */
+/** Result of translating a single string */
+export interface TranslationResult {
+    text: string;
+    wasTranslated: boolean;
+}
+/** Per-language site string translations */
+export interface SiteStringsTranslations {
+    siteTitle: Record<string, TranslationResult>;
+    siteDescription: Record<string, TranslationResult>;
+    siteTagline: Record<string, TranslationResult>;
+    /** Languages where translation failed */
+    failedLanguages: string[];
+    /** Provider that succeeded, or 'none' */
+    providerUsed: string;
+}
+/** Provider interface for translation backends */
+export interface TranslationProvider {
+    readonly name: string;
+    readonly displayName: string;
+    readonly isPaid: boolean;
+    /** Check if this provider is available (e.g. credentials exist) */
+    isAvailable(): Promise<boolean>;
+    translate(text: string, fromLang: string, toLang: string): Promise<TranslationResult>;
+}
+/**
+ * Get the API language code for an i18n language code.
+ */
+export declare function getApiLanguageCode(i18nCode: string): string;
+/**
+ * Check if two i18n language codes are in the same language family
+ * (e.g. en-US and en-GB are both English).
+ */
+export declare function isSameFamily(langA: string, langB: string): boolean;
+export declare const ALL_TARGET_LANGUAGES: string[];
+/**
+ * Uses the undocumented Google Translate web API.
+ * No API key required. Suitable for translating a handful of short strings.
+ * May break if Google changes their endpoint.
+ */
+export declare class GoogleTranslateProvider implements TranslationProvider {
+    readonly name = "google-free";
+    readonly displayName = "Google Translate (free, no API key)";
+    readonly isPaid = false;
+    isAvailable(): Promise<boolean>;
+    translate(text: string, fromLang: string, toLang: string): Promise<TranslationResult>;
+}
+/**
+ * Uses AWS Translate via @aws-sdk/client-translate.
+ * Dynamically imports the SDK so it's not a hard dependency.
+ * Checks for existing AWS credentials before attempting.
+ */
+export declare class AwsTranslateProvider implements TranslationProvider {
+    readonly name = "aws-translate";
+    readonly displayName = "AWS Translate (may incur charges)";
+    readonly isPaid = true;
+    private region;
+    private accessKeyId?;
+    private secretAccessKey?;
+    constructor(options?: {
+        region?: string;
+        accessKeyId?: string;
+        secretAccessKey?: string;
+    });
+    isAvailable(): Promise<boolean>;
+    translate(text: string, fromLang: string, toLang: string): Promise<TranslationResult>;
+}
+/**
+ * Translate site strings to all target languages using the given provider.
+ * For same-family languages (e.g. en-US → en-GB), copies verbatim.
+ * On per-language failure, marks that language as failed and uses fallback.
+ */
+export declare function translateSiteStrings(provider: TranslationProvider, sourceLang: string, siteTitle: string, siteDescription: string, siteTagline: string): Promise<SiteStringsTranslations>;
+/**
+ * Build fallback translations (no translation attempted).
+ * Same-family languages get verbatim copy, others get the original text
+ * and are marked in failedLanguages for TODO comment generation.
+ */
+export declare function buildFallbackTranslations(sourceLang: string, siteTitle: string, siteDescription: string, siteTagline: string): SiteStringsTranslations;
+/**
+ * Convert SiteStringsTranslations into a flat Record<string, string>
+ * suitable for mustache template variables.
+ *
+ * Produces keys like: siteTitleEnUs, siteDescriptionFr, siteTaglineJa, etc.
+ *
+ * @param translations - The translation results
+ * @param escapeForTs - Function to escape strings for TypeScript string literals
+ */
+export declare function translationsToMustacheVars(translations: SiteStringsTranslations, escapeForTs: (s: string) => string): Record<string, string | boolean>;
+//# sourceMappingURL=translation-service.d.ts.map

package/dist/src/utils/translation-service.d.ts.map

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

package/dist/src/utils/translation-service.js

@@ -0,0 +1,387 @@
+"use strict";
+/**
+ * Translation service for auto-translating site strings during scaffolding.
+ *
+ * Provider chain (user always chooses):
+ * 1. Google Translate (free, no API key)
+ * 2. AWS Translate (auto-detect or prompt for credentials, may incur charges)
+ * 3. Skip: user's original input in all languages, with TODO comments in generated code
+ *
+ * The user is ALWAYS asked before using any paid service.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AwsTranslateProvider = exports.GoogleTranslateProvider = exports.ALL_TARGET_LANGUAGES = void 0;
+exports.getApiLanguageCode = getApiLanguageCode;
+exports.isSameFamily = isSameFamily;
+exports.translateSiteStrings = translateSiteStrings;
+exports.buildFallbackTranslations = buildFallbackTranslations;
+exports.translationsToMustacheVars = translationsToMustacheVars;
+const i18n_lib_1 = require("@digitaldefiance/i18n-lib");
+const https = __importStar(require("https"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+// ─── Language mapping ────────────────────────────────────────────────
+/** Map i18n-lib codes to BCP-47 codes used by translation APIs */
+const LANGUAGE_API_MAP = {
+    [i18n_lib_1.LanguageCodes.EN_US]: 'en',
+    [i18n_lib_1.LanguageCodes.EN_GB]: 'en',
+    [i18n_lib_1.LanguageCodes.FR]: 'fr',
+    [i18n_lib_1.LanguageCodes.ES]: 'es',
+    [i18n_lib_1.LanguageCodes.DE]: 'de',
+    [i18n_lib_1.LanguageCodes.ZH_CN]: 'zh-CN',
+    [i18n_lib_1.LanguageCodes.JA]: 'ja',
+    [i18n_lib_1.LanguageCodes.UK]: 'uk',
+};
+/**
+ * Get the API language code for an i18n language code.
+ */
+function getApiLanguageCode(i18nCode) {
+    return LANGUAGE_API_MAP[i18nCode] ?? i18nCode;
+}
+/**
+ * Check if two i18n language codes are in the same language family
+ * (e.g. en-US and en-GB are both English).
+ */
+function isSameFamily(langA, langB) {
+    const apiA = getApiLanguageCode(langA);
+    const apiB = getApiLanguageCode(langB);
+    return apiA === apiB;
+}
+// ─── All supported target languages ─────────────────────────────────
+exports.ALL_TARGET_LANGUAGES = [
+    i18n_lib_1.LanguageCodes.EN_US,
+    i18n_lib_1.LanguageCodes.EN_GB,
+    i18n_lib_1.LanguageCodes.FR,
+    i18n_lib_1.LanguageCodes.ES,
+    i18n_lib_1.LanguageCodes.DE,
+    i18n_lib_1.LanguageCodes.ZH_CN,
+    i18n_lib_1.LanguageCodes.JA,
+    i18n_lib_1.LanguageCodes.UK,
+];
+// ─── Google Translate Provider (free, no API key) ────────────────────
+/**
+ * Uses the undocumented Google Translate web API.
+ * No API key required. Suitable for translating a handful of short strings.
+ * May break if Google changes their endpoint.
+ */
+class GoogleTranslateProvider {
+    name = 'google-free';
+    displayName = 'Google Translate (free, no API key)';
+    isPaid = false;
+    async isAvailable() {
+        return true; // Always available to try
+    }
+    async translate(text, fromLang, toLang) {
+        if (!text.trim()) {
+            return { text, wasTranslated: false };
+        }
+        const encodedText = encodeURIComponent(text);
+        const url = `https://translate.googleapis.com/translate_a/single` +
+            `?client=gtx&sl=${fromLang}&tl=${toLang}&dt=t&q=${encodedText}`;
+        return new Promise((resolve, reject) => {
+            const req = https.get(url, { timeout: 10000 }, (res) => {
+                let data = '';
+                res.on('data', (chunk) => {
+                    data += chunk.toString();
+                });
+                res.on('end', () => {
+                    try {
+                        if (res.statusCode !== 200) {
+                            reject(new Error(`Google Translate returned status ${res.statusCode}`));
+                            return;
+                        }
+                        const parsed = JSON.parse(data);
+                        // Response format: [[["translated text","original text",null,null,10]],null,"en",...]
+                        const translated = parsed?.[0]
+                            ?.map((segment) => segment[0])
+                            .join('');
+                        if (translated) {
+                            resolve({ text: translated, wasTranslated: true });
+                        }
+                        else {
+                            reject(new Error('Empty translation response'));
+                        }
+                    }
+                    catch (err) {
+                        reject(new Error(`Failed to parse Google Translate response: ${err instanceof Error ? err.message : String(err)}`));
+                    }
+                });
+            });
+            req.on('error', reject);
+            req.on('timeout', () => {
+                req.destroy();
+                reject(new Error('Google Translate request timed out'));
+            });
+        });
+    }
+}
+exports.GoogleTranslateProvider = GoogleTranslateProvider;
+// ─── AWS Translate Provider ──────────────────────────────────────────
+/**
+ * Uses AWS Translate via @aws-sdk/client-translate.
+ * Dynamically imports the SDK so it's not a hard dependency.
+ * Checks for existing AWS credentials before attempting.
+ */
+class AwsTranslateProvider {
+    name = 'aws-translate';
+    displayName = 'AWS Translate (may incur charges)';
+    isPaid = true;
+    region;
+    accessKeyId;
+    secretAccessKey;
+    constructor(options) {
+        this.region = options?.region ?? process.env.AWS_REGION ?? 'us-east-1';
+        this.accessKeyId = options?.accessKeyId;
+        this.secretAccessKey = options?.secretAccessKey;
+    }
+    async isAvailable() {
+        // Check if credentials are available via env vars or explicit config
+        if (this.accessKeyId && this.secretAccessKey) {
+            return true;
+        }
+        if (process.env.AWS_ACCESS_KEY_ID && process.env.AWS_SECRET_ACCESS_KEY) {
+            return true;
+        }
+        // Check for ~/.aws/credentials file
+        const credPath = path.join(process.env.HOME ?? process.env.USERPROFILE ?? '', '.aws', 'credentials');
+        try {
+            await fs.promises.access(credPath, fs.constants.R_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async translate(text, fromLang, toLang) {
+        if (!text.trim()) {
+            return { text, wasTranslated: false };
+        }
+        // Map some BCP-47 codes to AWS Translate codes
+        const awsLangMap = {
+            'zh-CN': 'zh',
+        };
+        const awsFrom = awsLangMap[fromLang] ?? fromLang;
+        const awsTo = awsLangMap[toLang] ?? toLang;
+        try {
+            // Dynamic require — not a hard dependency.
+            // Jest needs @aws-sdk in transformIgnorePatterns to avoid VM issues.
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { TranslateClient, TranslateTextCommand } = require('@aws-sdk/client-translate');
+            const clientConfig = { region: this.region };
+            if (this.accessKeyId && this.secretAccessKey) {
+                clientConfig.credentials = {
+                    accessKeyId: this.accessKeyId,
+                    secretAccessKey: this.secretAccessKey,
+                };
+            }
+            const client = new TranslateClient(clientConfig);
+            const command = new TranslateTextCommand({
+                Text: text,
+                SourceLanguageCode: awsFrom,
+                TargetLanguageCode: awsTo,
+            });
+            const response = await client.send(command);
+            if (response.TranslatedText) {
+                return { text: response.TranslatedText, wasTranslated: true };
+            }
+            return { text, wasTranslated: false };
+        }
+        catch (err) {
+            throw new Error(`AWS Translate failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+exports.AwsTranslateProvider = AwsTranslateProvider;
+// ─── Translation orchestrator ────────────────────────────────────────
+/**
+ * Translate site strings to all target languages using the given provider.
+ * For same-family languages (e.g. en-US → en-GB), copies verbatim.
+ * On per-language failure, marks that language as failed and uses fallback.
+ */
+async function translateSiteStrings(provider, sourceLang, siteTitle, siteDescription, siteTagline) {
+    const sourceApiLang = getApiLanguageCode(sourceLang);
+    const failedLanguages = [];
+    const result = {
+        siteTitle: {},
+        siteDescription: {},
+        siteTagline: {},
+        failedLanguages,
+        providerUsed: provider.name,
+    };
+    for (const targetLang of exports.ALL_TARGET_LANGUAGES) {
+        // Source language: use the user's input directly
+        if (targetLang === sourceLang) {
+            result.siteTitle[targetLang] = { text: siteTitle, wasTranslated: false };
+            result.siteDescription[targetLang] = {
+                text: siteDescription,
+                wasTranslated: false,
+            };
+            result.siteTagline[targetLang] = {
+                text: siteTagline,
+                wasTranslated: false,
+            };
+            continue;
+        }
+        // Same family (e.g. en-US and en-GB): copy verbatim
+        if (isSameFamily(sourceLang, targetLang)) {
+            result.siteTitle[targetLang] = { text: siteTitle, wasTranslated: false };
+            result.siteDescription[targetLang] = {
+                text: siteDescription,
+                wasTranslated: false,
+            };
+            result.siteTagline[targetLang] = {
+                text: siteTagline,
+                wasTranslated: false,
+            };
+            continue;
+        }
+        // Translate each string individually
+        const targetApiLang = getApiLanguageCode(targetLang);
+        try {
+            const [titleResult, descResult, taglineResult] = await Promise.all([
+                provider.translate(siteTitle, sourceApiLang, targetApiLang),
+                provider.translate(siteDescription, sourceApiLang, targetApiLang),
+                provider.translate(siteTagline, sourceApiLang, targetApiLang),
+            ]);
+            result.siteTitle[targetLang] = titleResult;
+            result.siteDescription[targetLang] = descResult;
+            result.siteTagline[targetLang] = taglineResult;
+        }
+        catch {
+            // Translation failed for this language — use original text as fallback
+            failedLanguages.push(targetLang);
+            result.siteTitle[targetLang] = {
+                text: siteTitle,
+                wasTranslated: false,
+            };
+            result.siteDescription[targetLang] = {
+                text: siteDescription,
+                wasTranslated: false,
+            };
+            result.siteTagline[targetLang] = {
+                text: siteTagline,
+                wasTranslated: false,
+            };
+        }
+    }
+    return result;
+}
+/**
+ * Build fallback translations (no translation attempted).
+ * Same-family languages get verbatim copy, others get the original text
+ * and are marked in failedLanguages for TODO comment generation.
+ */
+function buildFallbackTranslations(sourceLang, siteTitle, siteDescription, siteTagline) {
+    const result = {
+        siteTitle: {},
+        siteDescription: {},
+        siteTagline: {},
+        failedLanguages: [],
+        providerUsed: 'none',
+    };
+    for (const targetLang of exports.ALL_TARGET_LANGUAGES) {
+        if (targetLang === sourceLang || isSameFamily(sourceLang, targetLang)) {
+            result.siteTitle[targetLang] = { text: siteTitle, wasTranslated: false };
+            result.siteDescription[targetLang] = {
+                text: siteDescription,
+                wasTranslated: false,
+            };
+            result.siteTagline[targetLang] = {
+                text: siteTagline,
+                wasTranslated: false,
+            };
+        }
+        else {
+            result.failedLanguages.push(targetLang);
+            result.siteTitle[targetLang] = {
+                text: siteTitle,
+                wasTranslated: false,
+            };
+            result.siteDescription[targetLang] = {
+                text: siteDescription,
+                wasTranslated: false,
+            };
+            result.siteTagline[targetLang] = {
+                text: siteTagline,
+                wasTranslated: false,
+            };
+        }
+    }
+    return result;
+}
+// ─── Mustache variable helpers ───────────────────────────────────────
+/**
+ * Map from i18n language code to the suffix used in mustache variable names.
+ * e.g. LanguageCodes.EN_US → 'EnUs', LanguageCodes.ZH_CN → 'ZhCn'
+ */
+const LANG_SUFFIX_MAP = {
+    [i18n_lib_1.LanguageCodes.EN_US]: 'EnUs',
+    [i18n_lib_1.LanguageCodes.EN_GB]: 'EnGb',
+    [i18n_lib_1.LanguageCodes.FR]: 'Fr',
+    [i18n_lib_1.LanguageCodes.ES]: 'Es',
+    [i18n_lib_1.LanguageCodes.DE]: 'De',
+    [i18n_lib_1.LanguageCodes.ZH_CN]: 'ZhCn',
+    [i18n_lib_1.LanguageCodes.JA]: 'Ja',
+    [i18n_lib_1.LanguageCodes.UK]: 'Uk',
+};
+/**
+ * Convert SiteStringsTranslations into a flat Record<string, string>
+ * suitable for mustache template variables.
+ *
+ * Produces keys like: siteTitleEnUs, siteDescriptionFr, siteTaglineJa, etc.
+ *
+ * @param translations - The translation results
+ * @param escapeForTs - Function to escape strings for TypeScript string literals
+ */
+function translationsToMustacheVars(translations, escapeForTs) {
+    const vars = {};
+    for (const lang of exports.ALL_TARGET_LANGUAGES) {
+        const suffix = LANG_SUFFIX_MAP[lang];
+        if (!suffix)
+            continue;
+        const titleResult = translations.siteTitle[lang];
+        const descResult = translations.siteDescription[lang];
+        const taglineResult = translations.siteTagline[lang];
+        vars[`siteTitle${suffix}`] = escapeForTs(titleResult?.text ?? '');
+        vars[`siteDescription${suffix}`] = escapeForTs(descResult?.text ?? '');
+        vars[`siteTagline${suffix}`] = escapeForTs(taglineResult?.text ?? '');
+        // True if this language needs manual translation (failed or skipped)
+        const needsIt = translations.failedLanguages.includes(lang);
+        vars[`needsTranslation${suffix}`] = needsIt;
+    }
+    return vars;
+}
+//# sourceMappingURL=translation-service.js.map