@digitaldefiance/express-suite-starter 2.1.44 → 2.1.46

package/dist/src/generate-monorepo.js

@@ -57,22 +57,44 @@ const nodeSetup_1 = require("../scripts/nodeSetup");
 const licensePrompt_1 = require("../scripts/licensePrompt");
 const addScriptsToPackageJson_1 = require("../scripts/addScriptsToPackageJson");
 const templateUtils_1 = require("../scripts/templateUtils");
+const i18n_1 = require("./i18n");
+const i18n_lib_1 = require("@digitaldefiance/i18n-lib");
+const i18n_lib_2 = require("@digitaldefiance/i18n-lib");
 async function main() {
     (0, albatross_1.printBanner)();
     (0, nodeSetup_1.checkAndUseNode)();
     // Disable Yarn build scripts globally to avoid native module issues
     process.env.YARN_ENABLE_SCRIPTS = 'false';
+    // Language selection
+    const selectedLanguage = await (0, select_1.default)({
+        message: 'Select language / Seleccionar idioma / Choisir la langue / Sprache wählen / 选择语言 / 言語を選択 / Виберіть мову:',
+        choices: [
+            { name: 'English (US)', value: i18n_lib_2.LanguageCodes.EN_US },
+            { name: 'English (UK)', value: i18n_lib_2.LanguageCodes.EN_GB },
+            { name: 'Español', value: i18n_lib_2.LanguageCodes.ES },
+            { name: 'Français', value: i18n_lib_2.LanguageCodes.FR },
+            { name: 'Deutsch', value: i18n_lib_2.LanguageCodes.DE },
+            { name: '中文', value: i18n_lib_2.LanguageCodes.ZH_CN },
+            { name: '日本語', value: i18n_lib_2.LanguageCodes.JA },
+            { name: 'Українська', value: i18n_lib_2.LanguageCodes.UK },
+        ],
+        default: i18n_lib_2.LanguageCodes.EN_US,
+    });
+    // Set the language for the i18n engine
+    const i18nEngine = (0, i18n_1.getStarterI18nEngine)();
+    i18nEngine.setLanguage(selectedLanguage);
+    (0, albatross_1.printIntro)();
     // System check
-    logger_1.Logger.header('System Check');
+    logger_1.Logger.header((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SYSTEM_CHECK_HEADER));
     const systemCheck = system_check_1.SystemCheck.check();
     system_check_1.SystemCheck.printReport(systemCheck);
     if (!systemCheck.passed) {
         const proceed = await (0, confirm_1.default)({
-            message: 'Continue anyway? (Installation may fail)',
+            message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SYSTEM_CHECK_CONTINUE_ANYWAY),
             default: false,
         });
         if (!proceed) {
-            logger_1.Logger.info('Cancelled. Please install required tools and try again.');
+            logger_1.Logger.info((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.CLI_CANCELLED));
             process.exit(0);
         }
     }
@@ -80,49 +102,49 @@ async function main() {
     const presetPath = path.resolve(__dirname, '../../config/presets/standard.json');
     const preset = JSON.parse(fs.readFileSync(presetPath, 'utf-8'));
     // Prompt for workspace configuration
-    logger_1.Logger.header('Workspace Configuration');
+    logger_1.Logger.header((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SECTION_WORKSPACE_CONFIG));
     const workspaceName = await (0, input_1.default)({
-        message: 'Enter the workspace name:',
+        message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_WORKSPACE_NAME),
         default: 'example-project',
-        validate: (val) => config_schema_1.ConfigValidator.validateWorkspaceName(val) || 'Invalid workspace name (letters, numbers, dashes only)',
+        validate: (val) => config_schema_1.ConfigValidator.validateWorkspaceName(val) || (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.VALIDATION_INVALID_WORKSPACE_NAME),
     });
     const projectPrefix = await (0, input_1.default)({
-        message: 'Enter the project prefix:',
+        message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_PROJECT_PREFIX),
         default: workspaceName,
-        validate: (val) => config_schema_1.ConfigValidator.validatePrefix(val) || 'Invalid prefix (lowercase letters, numbers, dashes only)',
+        validate: (val) => config_schema_1.ConfigValidator.validatePrefix(val) || (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.VALIDATION_INVALID_PREFIX),
     });
     const namespaceRoot = await (0, input_1.default)({
-        message: 'Enter the npm namespace:',
+        message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_NPM_NAMESPACE),
         default: `@${projectPrefix}`,
-        validate: (val) => config_schema_1.ConfigValidator.validateNamespace(val) || 'Invalid namespace (must start with @)',
+        validate: (val) => config_schema_1.ConfigValidator.validateNamespace(val) || (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.VALIDATION_INVALID_NAMESPACE),
     });
     const parentDir = path.resolve(await (0, input_1.default)({
-        message: 'Enter the parent directory:',
+        message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_PARENT_DIRECTORY),
         default: process.cwd(),
     }));
     const gitRepo = await (0, input_1.default)({
-        message: 'Enter the git repository URL (optional):',
-        validate: (val) => config_schema_1.ConfigValidator.validateGitRepo(val) || 'Invalid git repository URL',
+        message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_GIT_REPO),
+        validate: (val) => config_schema_1.ConfigValidator.validateGitRepo(val) || (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.VALIDATION_INVALID_GIT_REPO),
     });
     const hostname = await (0, input_1.default)({
-        message: 'Enter the hostname for development (e.g., example-project.local):',
+        message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_HOSTNAME),
         default: `${workspaceName}.local`,
-        validate: (val) => /^[a-z0-9-]+(\.[a-z0-9-]+)*$/.test(val) || 'Invalid hostname format',
+        validate: (val) => /^[a-z0-9-]+(\.[a-z0-9-]+)*$/.test(val) || (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.VALIDATION_INVALID_HOSTNAME),
     });
     const dryRun = await (0, confirm_1.default)({
-        message: 'Run in dry-run mode (preview without creating files)?',
+        message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_DRY_RUN),
         default: false,
     });
-    logger_1.Logger.section('Optional Projects');
+    logger_1.Logger.section((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SECTION_OPTIONAL_PROJECTS));
     const includeE2e = await (0, confirm_1.default)({
-        message: 'Include E2E tests?',
+        message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_INCLUDE_E2E),
         default: true,
     });
-    logger_1.Logger.section('Package Groups');
+    logger_1.Logger.section((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SECTION_PACKAGE_GROUPS));
     const packageGroupsPath = path.resolve(__dirname, '../../config/package-groups.json');
     const packageGroups = JSON.parse(fs.readFileSync(packageGroupsPath, 'utf-8')).groups;
     const selectedGroups = await (0, checkbox_1.default)({
-        message: 'Select optional package groups:',
+        message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_SELECT_PACKAGE_GROUPS),
         choices: packageGroups
             .filter((g) => !g.enabled)
             .map((g) => ({
@@ -132,70 +154,70 @@ async function main() {
         })),
     });
     const enableDocGeneration = await (0, confirm_1.default)({
-        message: 'Generate documentation (README, ARCHITECTURE, API docs)?',
+        message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_ENABLE_DOC_GENERATION),
         default: true,
     });
-    logger_1.Logger.section('DevContainer Configuration');
+    logger_1.Logger.section((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SECTION_DEVCONTAINER_CONFIG));
     const setupDevcontainer = await (0, confirm_1.default)({
-        message: 'Set up DevContainer configuration?',
+        message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_SETUP_DEVCONTAINER),
         default: true,
     });
     let devcontainerChoice = 'none';
     let mongoPassword = '';
     if (setupDevcontainer) {
         devcontainerChoice = await (0, select_1.default)({
-            message: 'DevContainer configuration:',
+            message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_DEVCONTAINER_CONFIG),
             choices: [
-                { name: 'Simple (Node.js only)', value: 'simple' },
-                { name: 'With MongoDB', value: 'mongodb' },
-                { name: 'With MongoDB Replica Set', value: 'mongodb-replicaset' },
+                { name: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.DEVCONTAINER_SIMPLE), value: 'simple' },
+                { name: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.DEVCONTAINER_MONGODB), value: 'mongodb' },
+                { name: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.DEVCONTAINER_MONGODB_REPLICASET), value: 'mongodb-replicaset' },
             ],
             default: 'mongodb-replicaset',
         });
         if (devcontainerChoice === 'mongodb' || devcontainerChoice === 'mongodb-replicaset') {
             mongoPassword = await (0, input_1.default)({
-                message: 'Enter MongoDB root password:',
-                validate: (val) => val.length > 0 || 'Password required',
+                message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_MONGO_PASSWORD),
+                validate: (val) => val.length > 0 || (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.VALIDATION_PASSWORD_REQUIRED),
             });
         }
     }
-    logger_1.Logger.section('Database Configuration');
+    logger_1.Logger.section((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SECTION_DATABASE_CONFIG));
     const useInMemoryDb = await (0, confirm_1.default)({
-        message: 'Use in-memory database for development?',
+        message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_USE_IN_MEMORY_DB),
         default: false,
     });
     let devDatabaseName = '';
     if (useInMemoryDb) {
         devDatabaseName = await (0, input_1.default)({
-            message: 'Enter the in-memory database name:',
+            message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_DEV_DATABASE_NAME),
             default: 'test',
-            validate: (val) => val.length > 0 || 'Database name cannot be empty',
+            validate: (val) => val.length > 0 || (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.VALIDATION_DATABASE_NAME_REQUIRED),
         });
     }
-    logger_1.Logger.section('Security Configuration');
+    logger_1.Logger.section((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SECTION_SECURITY_CONFIG));
     const crypto = await Promise.resolve().then(() => __importStar(require('crypto')));
     const HEX_64_REGEX = /^[0-9a-f]{64}$/i;
     const promptOrGenerateSecret = async (name) => {
         const generate = await (0, confirm_1.default)({
-            message: `Generate ${name}?`,
+            message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_GENERATE_SECRET, { name }),
             default: true,
         });
         if (generate) {
             const secret = crypto.randomBytes(32).toString('hex');
-            logger_1.Logger.info(`Generated ${name}`);
+            logger_1.Logger.info((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.ENV_GENERATED_SECRET, { name }));
             return secret;
         }
         else {
             return await (0, input_1.default)({
-                message: `Enter ${name} (64-character hex string):`,
-                validate: (val) => HEX_64_REGEX.test(val) || 'Must be 64-character hex string',
+                message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_ENTER_SECRET, { name }),
+                validate: (val) => HEX_64_REGEX.test(val) || (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.VALIDATION_MUST_BE_HEX_64),
             });
         }
     };
     const jwtSecret = await promptOrGenerateSecret('JWT_SECRET');
     const mnemonicEncryptionKey = await promptOrGenerateSecret('MNEMONIC_ENCRYPTION_KEY');
     const mnemonicHmacSecret = await promptOrGenerateSecret('MNEMONIC_HMAC_SECRET');
-    logger_1.Logger.section('Express Suite Packages');
+    logger_1.Logger.section((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SECTION_EXPRESS_SUITE_PACKAGES));
     const monorepoPath = path.join(parentDir, workspaceName);
     // Build project configurations
     const projects = project_config_builder_1.ProjectConfigBuilder.build(projectPrefix, namespaceRoot, {
@@ -237,6 +259,7 @@ async function main() {
         config,
         state: new Map(stateEntries),
         checkpointPath: path.join(parentDir, `.${workspaceName}.checkpoint`),
+        dryRun,
     };
     // Merge selected package groups
     const additionalPackages = [];
@@ -260,56 +283,56 @@ async function main() {
         ? new (await Promise.resolve().then(() => __importStar(require('./core/dry-run-executor')))).DryRunExecutor()
         : new step_executor_1.StepExecutor();
     if (dryRun) {
-        logger_1.Logger.warning('DRY RUN MODE - No files will be created');
+        logger_1.Logger.warning((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.GENERATION_DRY_RUN_MODE));
     }
     executor.addStep({
         name: 'checkTargetDir',
-        description: 'Checking target directory',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_CHECK_TARGET_DIR),
         execute: () => {
             if (fs.existsSync(monorepoPath) && fs.readdirSync(monorepoPath).length > 0) {
-                throw new Error(`Directory ${logger_1.Logger.path(monorepoPath)} already exists and is not empty`);
+                throw new i18n_lib_1.TranslatableGenericError(i18n_1.StarterComponentId, i18n_1.StarterStringKey.ERROR_DIRECTORY_NOT_EMPTY, { path: monorepoPath });
             }
         },
     });
     executor.addStep({
         name: 'createMonorepo',
-        description: 'Creating Nx monorepo',
-        execute: () => {
-            (0, shell_utils_1.runCommand)(`npx create-nx-workspace@latest "${workspaceName}" --package-manager=yarn --preset=apps --ci=${config.nx?.ciProvider}`, { cwd: parentDir });
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_CREATE_MONOREPO),
+        execute: (context) => {
+            (0, shell_utils_1.runCommand)(`npx create-nx-workspace@latest "${workspaceName}" --package-manager=yarn --preset=apps --ci=${config.nx?.ciProvider}`, { cwd: parentDir, dryRun: context.dryRun });
         },
     });
     executor.addStep({
         name: 'setupGitOrigin',
-        description: 'Setting up git remote',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_SETUP_GIT_ORIGIN),
         skip: () => !gitRepo,
         execute: () => {
-            (0, shell_utils_1.runCommand)(`git remote add origin ${gitRepo}`, { cwd: monorepoPath });
+            (0, shell_utils_1.runCommand)(`git remote add origin ${gitRepo}`, { cwd: monorepoPath, dryRun: context.dryRun });
         },
     });
     executor.addStep({
         name: 'yarnBerrySetup',
-        description: 'Configuring Yarn Berry',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_YARN_BERRY_SETUP),
         execute: () => {
-            (0, shell_utils_1.runCommand)('yarn set version berry', { cwd: monorepoPath });
-            (0, shell_utils_1.runCommand)('yarn config set nodeLinker node-modules', { cwd: monorepoPath });
-            (0, shell_utils_1.runCommand)('yarn', { cwd: monorepoPath });
+            (0, shell_utils_1.runCommand)('yarn set version berry', { cwd: monorepoPath, dryRun: context.dryRun });
+            (0, shell_utils_1.runCommand)('yarn config set nodeLinker node-modules', { cwd: monorepoPath, dryRun: context.dryRun });
+            (0, shell_utils_1.runCommand)('yarn', { cwd: monorepoPath, dryRun: context.dryRun });
         },
     });
     executor.addStep({
         name: 'addNxPlugins',
-        description: 'Installing Nx plugins',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_ADD_NX_PLUGINS),
         execute: () => {
             try {
-                (0, shell_utils_1.runCommand)('yarn add -D @nx/react @nx/node', { cwd: monorepoPath });
+                (0, shell_utils_1.runCommand)('yarn add -D @nx/react @nx/node', { cwd: monorepoPath, dryRun: context.dryRun });
             }
             catch (error) {
                 if (error.status === 1) {
-                    logger_1.Logger.error('\nPackage installation failed.');
-                    logger_1.Logger.section('If you see "exit code 127" above, install build tools:');
-                    logger_1.Logger.dim('  Ubuntu/Debian: sudo apt-get install build-essential python3');
-                    logger_1.Logger.dim('  Fedora/RHEL:   sudo dnf install gcc-c++ make python3');
-                    logger_1.Logger.dim('  macOS:         xcode-select --install');
-                    logger_1.Logger.section('\nThen retry or skip: yarn start --start-at=addYarnPackages');
+                    logger_1.Logger.error('\n' + (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PACKAGE_INSTALLATION_FAILED));
+                    logger_1.Logger.section((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PACKAGE_INSTALL_BUILD_TOOLS));
+                    logger_1.Logger.dim('  ' + (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SYSTEM_CHECK_UBUNTU_DEBIAN));
+                    logger_1.Logger.dim('  ' + (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SYSTEM_CHECK_FEDORA_RHEL));
+                    logger_1.Logger.dim('  ' + (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SYSTEM_CHECK_MACOS));
+                    logger_1.Logger.section('\n' + (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PACKAGE_RETRY_OR_SKIP));
                 }
                 throw error;
             }
@@ -317,44 +340,44 @@ async function main() {
     });
     executor.addStep({
         name: 'addYarnPackages',
-        description: 'Installing dependencies',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_ADD_YARN_PACKAGES),
         execute: () => {
             const devPkgs = config.packages?.dev || [];
             const prodPkgs = config.packages?.prod || [];
             if (devPkgs.length > 0) {
-                (0, shell_utils_1.runCommand)(`yarn add -D ${devPkgs.join(' ')}`, { cwd: monorepoPath });
+                (0, shell_utils_1.runCommand)(`yarn add -D ${devPkgs.join(' ')}`, { cwd: monorepoPath, dryRun: context.dryRun });
             }
             if (prodPkgs.length > 0) {
-                (0, shell_utils_1.runCommand)(`yarn add ${prodPkgs.join(' ')}`, { cwd: monorepoPath });
+                (0, shell_utils_1.runCommand)(`yarn add ${prodPkgs.join(' ')}`, { cwd: monorepoPath, dryRun: context.dryRun });
             }
         },
     });
     executor.addStep({
         name: 'generateProjects',
-        description: 'Generating project structure',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_GENERATE_PROJECTS),
         execute: () => {
             projects.forEach(project => {
                 if (!project.enabled)
                     return;
-                logger_1.Logger.info(`Generating ${project.type}: ${project.name}`);
+                logger_1.Logger.info((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROJECT_GENERATING, { type: project.type, name: project.name }));
                 switch (project.type) {
                     case 'react':
-                        project_generator_1.ProjectGenerator.generateReact(project, monorepoPath, config.nx);
+                        project_generator_1.ProjectGenerator.generateReact(project, monorepoPath, config.nx, context.dryRun);
                         break;
                     case 'react-lib':
-                        project_generator_1.ProjectGenerator.generateReactLib(project, monorepoPath, config.nx);
+                        project_generator_1.ProjectGenerator.generateReactLib(project, monorepoPath, config.nx, context.dryRun);
                         break;
                     case 'api':
-                        project_generator_1.ProjectGenerator.generateApi(project, monorepoPath, config.nx);
+                        project_generator_1.ProjectGenerator.generateApi(project, monorepoPath, config.nx, context.dryRun);
                         break;
                     case 'api-lib':
-                        project_generator_1.ProjectGenerator.generateApiLib(project, monorepoPath, config.nx);
+                        project_generator_1.ProjectGenerator.generateApiLib(project, monorepoPath, config.nx, context.dryRun);
                         break;
                     case 'lib':
-                        project_generator_1.ProjectGenerator.generateLib(project, monorepoPath, config.nx);
+                        project_generator_1.ProjectGenerator.generateLib(project, monorepoPath, config.nx, context.dryRun);
                         break;
                     case 'inituserdb':
-                        project_generator_1.ProjectGenerator.generateInitUserDb(project, monorepoPath);
+                        project_generator_1.ProjectGenerator.generateInitUserDb(project, monorepoPath, context.dryRun);
                         break;
                 }
             });
@@ -389,7 +412,7 @@ async function main() {
                         }
                     }
                     fs.writeFileSync(projectJsonPath, JSON.stringify(projectJson, null, 2) + '\n');
-                    logger_1.Logger.info(`Added copy-env and post-build targets to ${apiProject.name}/project.json`);
+                    logger_1.Logger.info((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROJECT_ADDED_TARGETS, { name: apiProject.name }));
                 }
             }
             if (initUserDbProject) {
@@ -424,30 +447,30 @@ async function main() {
                         }
                     }
                     fs.writeFileSync(projectJsonPath, JSON.stringify(projectJson, null, 2) + '\n');
-                    logger_1.Logger.info(`Added copy-env and post-build targets to ${initUserDbProject.name}/project.json`);
+                    logger_1.Logger.info((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROJECT_ADDED_TARGETS, { name: initUserDbProject.name }));
                 }
             }
         },
     });
     executor.addStep({
         name: 'installReactComponents',
-        description: 'Installing React components package',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_INSTALL_REACT_COMPONENTS),
         execute: () => {
             const reactLibProject = projects.find(p => p.type === 'react-lib' && p.enabled);
             if (reactLibProject) {
-                logger_1.Logger.info(`Installing @digitaldefiance/express-suite-react-components in ${reactLibProject.name}`);
+                logger_1.Logger.info((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROJECT_INSTALLING_PACKAGE, { package: '@digitaldefiance/express-suite-react-components', project: reactLibProject.name }));
                 const projectPackageJsonPath = path.join(monorepoPath, reactLibProject.name, 'package.json');
                 const projectPackageJson = JSON.parse(fs.readFileSync(projectPackageJsonPath, 'utf-8'));
                 projectPackageJson.dependencies = projectPackageJson.dependencies || {};
                 projectPackageJson.dependencies['@digitaldefiance/express-suite-react-components'] = 'latest';
                 fs.writeFileSync(projectPackageJsonPath, JSON.stringify(projectPackageJson, null, 2) + '\n');
-                (0, shell_utils_1.runCommand)('yarn install', { cwd: monorepoPath });
+                (0, shell_utils_1.runCommand)('yarn install', { cwd: monorepoPath, dryRun: context.dryRun });
             }
         },
     });
     executor.addStep({
         name: 'renderTemplates',
-        description: 'Rendering configuration templates',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_RENDER_TEMPLATES),
         execute: () => {
             const variables = {
                 WORKSPACE_NAME: workspaceName,
@@ -464,12 +487,12 @@ async function main() {
                 const key = project.type === 'lib' ? 'LIB_NAME' : `${project.type.toUpperCase().replace(/-/g, '_')}_NAME`;
                 variables[key] = project.name;
             });
-            (0, template_renderer_1.renderTemplates)(context.state.get('templatesDir'), monorepoPath, variables, config.templates?.engine);
+            (0, template_renderer_1.renderTemplates)(context.state.get('templatesDir'), monorepoPath, variables, config.templates?.engine, context.dryRun);
         },
     });
     executor.addStep({
         name: 'copyScaffolding',
-        description: 'Copying scaffolding files',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_COPY_SCAFFOLDING),
         execute: () => {
             const scaffoldingDir = context.state.get('scaffoldingDir');
             // Template variables for scaffolding
@@ -483,35 +506,35 @@ async function main() {
             // Copy root scaffolding
             const rootSrc = path.join(scaffoldingDir, 'root');
             if (fs.existsSync(rootSrc)) {
-                (0, template_renderer_1.copyDir)(rootSrc, monorepoPath, scaffoldingVars);
+                (0, template_renderer_1.copyDir)(rootSrc, monorepoPath, scaffoldingVars, 'mustache', context.dryRun);
             }
             // Copy devcontainer configuration
             if (devcontainerChoice !== 'none') {
                 const devcontainerSrc = path.join(scaffoldingDir, `devcontainer-${devcontainerChoice}`);
                 if (fs.existsSync(devcontainerSrc)) {
                     logger_1.Logger.info(`Copying devcontainer configuration: ${devcontainerChoice}`);
-                    (0, template_renderer_1.copyDir)(devcontainerSrc, monorepoPath, scaffoldingVars);
+                    (0, template_renderer_1.copyDir)(devcontainerSrc, monorepoPath, scaffoldingVars, 'mustache', context.dryRun);
                 }
             }
             // Copy project-specific scaffolding
             projects.forEach(project => {
                 const projectSrc = path.join(scaffoldingDir, project.type);
                 if (fs.existsSync(projectSrc)) {
-                    (0, template_renderer_1.copyDir)(projectSrc, path.join(monorepoPath, project.name), scaffoldingVars);
+                    (0, template_renderer_1.copyDir)(projectSrc, path.join(monorepoPath, project.name), scaffoldingVars, 'mustache', context.dryRun);
                 }
             });
         },
     });
     executor.addStep({
         name: 'generateLicense',
-        description: 'Generating LICENSE file',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_GENERATE_LICENSE),
         execute: async () => {
             await (0, licensePrompt_1.promptAndGenerateLicense)(monorepoPath);
         },
     });
     executor.addStep({
         name: 'addScripts',
-        description: 'Adding package.json scripts',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_ADD_SCRIPTS),
         execute: () => {
             const packageJsonPath = path.join(monorepoPath, 'package.json');
             const scriptContext = {
@@ -553,7 +576,7 @@ async function main() {
     });
     executor.addStep({
         name: 'generateDocumentation',
-        description: 'Generating documentation',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_GENERATE_DOCUMENTATION),
         skip: () => !enableDocGeneration || dryRun,
         execute: async () => {
             const { DocGenerator } = await Promise.resolve().then(() => __importStar(require('./utils/doc-generator')));
@@ -562,13 +585,13 @@ async function main() {
     });
     executor.addStep({
         name: 'setupEnvironment',
-        description: 'Setting up environment files',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_SETUP_ENVIRONMENT),
         execute: () => {
             const apiProject = projects.find(p => p.type === 'api');
             const initUserDbProject = projects.find(p => p.type === 'inituserdb');
-            // Build MONGO_URI with optional password
+            // Build MONGO_URI with optional password (URL-encode password for special characters)
             const buildMongoUri = (dbName) => {
-                const auth = mongoPassword ? `root:${mongoPassword}@` : '';
+                const auth = mongoPassword ? `root:${encodeURIComponent(mongoPassword)}@` : '';
                 const params = devcontainerChoice === 'mongodb-replicaset'
                     ? '?replicaSet=rs0&directConnection=true'
                     : '?directConnection=true';
@@ -596,6 +619,13 @@ async function main() {
                         const mongoUri = buildMongoUri(workspaceName);
                         envContent = envContent.replace(/MONGO_URI=.*/g, `MONGO_URI=${mongoUri}`);
                     }
+                    // Enable transactions for replica set
+                    if (devcontainerChoice === 'mongodb-replicaset') {
+                        envContent = envContent.replace(/MONGO_USE_TRANSACTIONS=.*/g, 'MONGO_USE_TRANSACTIONS=true');
+                    }
+                    else {
+                        envContent = envContent.replace(/MONGO_USE_TRANSACTIONS=.*/g, 'MONGO_USE_TRANSACTIONS=false');
+                    }
                     fs.writeFileSync(envPath, envContent);
                     logger_1.Logger.info(`Created ${apiProject.name}/.env with secrets`);
                 }
@@ -611,58 +641,85 @@ async function main() {
             }
             // Setup devcontainer .env if devcontainer with MongoDB
             if (devcontainerChoice === 'mongodb' || devcontainerChoice === 'mongodb-replicaset') {
+                const devcontainerEnvExamplePath = path.join(monorepoPath, '.devcontainer', '.env.example');
                 const devcontainerEnvPath = path.join(monorepoPath, '.devcontainer', '.env');
-                const mongoUri = buildMongoUri(workspaceName);
-                const envContent = `MONGO_PASSWORD=${mongoPassword}\nMONGO_URI=${mongoUri}\n`;
-                fs.writeFileSync(devcontainerEnvPath, envContent);
-                logger_1.Logger.info('Created .devcontainer/.env with MongoDB configuration');
+                if (fs.existsSync(devcontainerEnvExamplePath)) {
+                    let envContent = fs.readFileSync(devcontainerEnvExamplePath, 'utf-8');
+                    const mongoUri = buildMongoUri(workspaceName);
+                    // Replace MongoDB configuration
+                    envContent = envContent.replace(/MONGO_INITDB_ROOT_PASSWORD=.*/g, `MONGO_INITDB_ROOT_PASSWORD=${mongoPassword}`);
+                    envContent = envContent.replace(/MONGO_INITDB_DATABASE=.*/g, `MONGO_INITDB_DATABASE=${workspaceName}`);
+                    envContent = envContent.replace(/COMPOSE_PROJECT_NAME=.*/g, `COMPOSE_PROJECT_NAME=${workspaceName}_devcontainer`);
+                    // Add MONGO_PASSWORD and MONGO_URI if not present
+                    if (!envContent.includes('MONGO_PASSWORD=')) {
+                        envContent += `\nMONGO_PASSWORD=${mongoPassword}\n`;
+                    }
+                    else {
+                        envContent = envContent.replace(/MONGO_PASSWORD=.*/g, `MONGO_PASSWORD=${mongoPassword}`);
+                    }
+                    if (!envContent.includes('MONGO_URI=')) {
+                        envContent += `MONGO_URI=${mongoUri}\n`;
+                    }
+                    else {
+                        envContent = envContent.replace(/MONGO_URI=.*/g, `MONGO_URI=${mongoUri}`);
+                    }
+                    fs.writeFileSync(devcontainerEnvPath, envContent);
+                    logger_1.Logger.info((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.ENV_CREATED_DEVCONTAINER_FROM_EXAMPLE));
+                }
+                else {
+                    // Fallback to minimal .env if .env.example doesn't exist
+                    const mongoUri = buildMongoUri(workspaceName);
+                    const envContent = `MONGO_PASSWORD=${mongoPassword}\nMONGO_URI=${mongoUri}\n`;
+                    fs.writeFileSync(devcontainerEnvPath, envContent);
+                    logger_1.Logger.warning((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.ENV_CREATED_DEVCONTAINER_MINIMAL));
+                }
             }
         },
     });
     executor.addStep({
         name: 'rebuildNativeModules',
-        description: 'Building native modules',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_REBUILD_NATIVE_MODULES),
         execute: () => {
-            logger_1.Logger.info('Re-enabling build scripts and building native modules...');
-            (0, shell_utils_1.runCommand)('yarn config set enableScripts true', { cwd: monorepoPath });
-            (0, shell_utils_1.runCommand)('yarn rebuild', { cwd: monorepoPath });
+            logger_1.Logger.info((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.COMMAND_REBUILDING_NATIVE));
+            (0, shell_utils_1.runCommand)('yarn config set enableScripts true', { cwd: monorepoPath, dryRun: context.dryRun });
+            (0, shell_utils_1.runCommand)('yarn rebuild', { cwd: monorepoPath, dryRun: context.dryRun });
         },
     });
     executor.addStep({
         name: 'validateGeneration',
-        description: 'Validating generated project',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_VALIDATE_GENERATION),
         skip: () => dryRun,
         execute: async () => {
             const { PostGenerationValidator } = await Promise.resolve().then(() => __importStar(require('./core/validators/post-generation-validator')));
             const report = await PostGenerationValidator.validate(context);
             PostGenerationValidator.printReport(report);
             if (!report.passed) {
-                logger_1.Logger.warning('Validation found errors, but continuing...');
+                logger_1.Logger.warning((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.WARNING_VALIDATION_ERRORS));
             }
         },
     });
     executor.addStep({
         name: 'initialCommit',
-        description: 'Creating initial commit',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_INITIAL_COMMIT),
         execute: async () => {
             // Ensure git is initialized
             if (!fs.existsSync(path.join(monorepoPath, '.git'))) {
-                (0, shell_utils_1.runCommand)('git init', { cwd: monorepoPath });
+                (0, shell_utils_1.runCommand)('git init', { cwd: monorepoPath, dryRun: context.dryRun });
             }
             const doCommit = await (0, confirm_1.default)({
-                message: 'Create initial git commit?',
+                message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_CREATE_INITIAL_COMMIT),
                 default: true,
             });
             if (doCommit) {
-                (0, shell_utils_1.runCommand)('git add -A', { cwd: monorepoPath });
-                (0, shell_utils_1.runCommand)('git commit -m "Initial commit"', { cwd: monorepoPath });
+                (0, shell_utils_1.runCommand)('git add -A', { cwd: monorepoPath, dryRun: context.dryRun });
+                (0, shell_utils_1.runCommand)('git commit -m "Initial commit"', { cwd: monorepoPath, dryRun: context.dryRun });
                 if (gitRepo) {
                     const doPush = await (0, confirm_1.default)({
-                        message: 'Push to remote repository?',
+                        message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_PUSH_TO_REMOTE),
                         default: true,
                     });
                     if (doPush) {
-                        (0, shell_utils_1.runCommand)('git push --set-upstream origin main', { cwd: monorepoPath });
+                        (0, shell_utils_1.runCommand)('git push --set-upstream origin main', { cwd: monorepoPath, dryRun: context.dryRun });
                     }
                 }
             }
@@ -670,19 +727,19 @@ async function main() {
     });
     executor.addStep({
         name: 'installPlaywright',
-        description: 'Installing Playwright browsers',
+        description: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.STEP_INSTALL_PLAYWRIGHT),
         skip: () => !includeE2e,
         execute: async () => {
             const installPlaywright = await (0, confirm_1.default)({
-                message: 'Install Playwright browsers? (Required for E2E tests)',
+                message: (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.PROMPT_INSTALL_PLAYWRIGHT),
                 default: true,
             });
             if (installPlaywright) {
-                logger_1.Logger.info('Installing Playwright browsers (this may take a few minutes)...');
-                (0, shell_utils_1.runCommand)('yarn playwright install --with-deps', { cwd: monorepoPath });
+                logger_1.Logger.info((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.COMMAND_INSTALLING_PLAYWRIGHT_BROWSERS));
+                (0, shell_utils_1.runCommand)('yarn playwright install --with-deps', { cwd: monorepoPath, dryRun: context.dryRun });
             }
             else {
-                logger_1.Logger.warning('Skipped. Run manually later: yarn playwright install --with-deps');
+                logger_1.Logger.warning((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.COMMAND_SKIPPED_PLAYWRIGHT));
             }
         },
     });
@@ -690,26 +747,26 @@ async function main() {
     try {
         await executor.execute(context);
         if (dryRun) {
-            logger_1.Logger.warning('Dry-run complete. Re-run without dry-run to generate.');
+            logger_1.Logger.warning((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.WARNING_DRY_RUN_RERUN));
             process.exit(0);
         }
-        logger_1.Logger.header('Generation Complete!');
-        logger_1.Logger.success(`Monorepo created at: ${logger_1.Logger.path(monorepoPath)}`);
+        logger_1.Logger.header((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SUCCESS_GENERATION_COMPLETE));
+        logger_1.Logger.success((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SUCCESS_MONOREPO_CREATED, { path: logger_1.Logger.path(monorepoPath) }));
         const apiProject = projects.find(p => p.type === 'api');
         if (apiProject) {
-            logger_1.Logger.warning(`\nIMPORTANT: Update ${apiProject.name}/.env with your configuration`);
+            logger_1.Logger.warning(`\n` + (0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.WARNING_UPDATE_ENV_FILE, { name: apiProject.name }));
         }
         if (devcontainerChoice === 'mongodb' || devcontainerChoice === 'mongodb-replicaset') {
-            logger_1.Logger.warning(`IMPORTANT: Update .devcontainer/.env with your MongoDB configuration`);
+            logger_1.Logger.warning((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.WARNING_UPDATE_DEVCONTAINER_ENV));
         }
-        logger_1.Logger.section('Next steps:');
+        logger_1.Logger.section((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SECTION_NEXT_STEPS));
         logger_1.Logger.dim(`  cd ${workspaceName}`);
         if (apiProject) {
-            logger_1.Logger.dim(`  # Update ${apiProject.name}/.env with your settings`);
+            logger_1.Logger.dim(`  ${(0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SECTION_NEXT_STEPS_UPDATE_ENV, { name: apiProject.name })}`);
         }
         logger_1.Logger.dim(`  yarn build:dev`);
         logger_1.Logger.dim(`  yarn serve:dev`);
-        logger_1.Logger.section('Generated projects:');
+        logger_1.Logger.section((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.SECTION_GENERATED_PROJECTS));
         projects.forEach(p => {
             if (p.enabled) {
                 logger_1.Logger.dim(`  ${p.type.padEnd(12)} ${p.name}`);
@@ -717,14 +774,14 @@ async function main() {
         });
     }
     catch (error) {
-        logger_1.Logger.error('Generation failed');
+        logger_1.Logger.error((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.GENERATION_FAILED));
         console.error(error);
         process.exit(1);
     }
 }
 if (require.main === module) {
     main().catch((err) => {
-        logger_1.Logger.error('Fatal error');
+        logger_1.Logger.error((0, i18n_1.getStarterTranslation)(i18n_1.StarterStringKey.ERROR_FATAL));
         console.error(err);
         process.exit(1);
     });