i18ntk 3.0.0 → 3.1.0

package/settings/settings-cli.js

@@ -131,13 +131,14 @@ class SettingsCLI {
             { key: '1', label: t('settings.mainMenu.uiSettings'), description: t('settings.mainMenu.uiSettingsDesc') },
             { key: '2', label: t('settings.mainMenu.directorySettings'), description: t('settings.mainMenu.directorySettingsDesc') },
             { key: '3', label: t('settings.mainMenu.scriptDirectorySettings'), description: t('settings.mainMenu.scriptDirectorySettingsDesc') },
-            { key: '4', label: t('settings.mainMenu.processingSettings'), description: t('settings.mainMenu.processingSettingsDesc') },
-            { key: '5', label: t('settings.mainMenu.backupSettings'), description: t('settings.mainMenu.backupSettingsDesc') },
-            { key: '6', label: t('settings.mainMenu.securitySettings'), description: `${t('settings.mainMenu.securitySettingsDesc')} ${pinStatus}` },
-            { key: '7', label: t('settings.mainMenu.advancedSettings'), description: t('settings.mainMenu.advancedSettingsDesc') },
-            { key: '8', label: t('settings.mainMenu.viewAllSettings'), description: t('settings.mainMenu.viewAllSettingsDesc') },
-            { key: '9', label: t('settings.mainMenu.importExport'), description: t('settings.mainMenu.importExportDesc') },
-            { key: '0', label: t('settings.mainMenu.reportBug'), description: t('settings.mainMenu.reportBugDesc') },
+            { key: '4', label: t('settings.mainMenu.processingSettings'), description: t('settings.mainMenu.processingSettingsDesc') },
+            { key: '5', label: t('settings.mainMenu.backupSettings'), description: t('settings.mainMenu.backupSettingsDesc') },
+            { key: '6', label: t('settings.mainMenu.securitySettings'), description: `${t('settings.mainMenu.securitySettingsDesc')} ${pinStatus}` },
+            { key: '7', label: t('settings.mainMenu.advancedSettings'), description: t('settings.mainMenu.advancedSettingsDesc') },
+            { key: '8', label: t('settings.mainMenu.viewAllSettings'), description: t('settings.mainMenu.viewAllSettingsDesc') },
+            { key: '9', label: t('settings.mainMenu.importExport'), description: t('settings.mainMenu.importExportDesc') },
+            { key: 'a', label: 'Auto Translate Beta', description: 'Tune placeholder handling, concurrency, batching, and reports' },
+            { key: '0', label: t('settings.mainMenu.reportBug'), description: t('settings.mainMenu.reportBugDesc') },
             { key: 'x', label: 'Reset Script Directory Overrides', description: 'Clear script directory overrides and use defaults' },
             { key: 'r', label: t('settings.mainMenu.resetToDefaults'), description: t('settings.mainMenu.resetToDefaultsDesc') },
             { key: 'u', label: t('settings.mainMenu.updatePackage'), description: t('settings.mainMenu.updatePackageDesc') },
@@ -188,12 +189,15 @@ class SettingsCLI {
             case '8':
                 await this.showAllSettings();
                 break;
-            case '9':
-                await this.showImportExport();
-                break;
-            case '0':
-                await this.reportBug();
-                break;
+            case '9':
+                await this.showImportExport();
+                break;
+            case 'a':
+                await this.showAutoTranslateSettings();
+                break;
+            case '0':
+                await this.reportBug();
+                break;
             case 'x':
                 await this.resetScriptDirectories();
                 break;
@@ -302,7 +306,7 @@ class SettingsCLI {
     /**
      * Show processing settings menu
      */
-    async showProcessingSettings() {
+    async showProcessingSettings() {
         // Refresh language from settings to ensure consistency
         if (typeof uiI18n.refreshLanguageFromSettings === 'function') {
             uiI18n.refreshLanguageFromSettings();
@@ -318,8 +322,37 @@ class SettingsCLI {
             'advanced.sizingThreshold': t('settings.fields.sizingThreshold.label')
         };
 
-        await this.showSettingsCategory(processSettings);
-    }
+        await this.showSettingsCategory(processSettings);
+    }
+
+    async showAutoTranslateSettings() {
+        if (typeof uiI18n.refreshLanguageFromSettings === 'function') {
+            uiI18n.refreshLanguageFromSettings();
+        }
+
+        this.clearScreen();
+        this.showHeader();
+        console.log(`${colors.bright}Auto Translate Beta Settings${colors.reset}\n`);
+
+        const autoTranslateSettings = {
+            'autoTranslate.placeholderMode': 'Placeholder handling mode',
+            'autoTranslate.concurrency': 'Concurrent translation requests',
+            'autoTranslate.batchSize': 'Text segments per batch',
+            'autoTranslate.progressInterval': 'Progress update interval',
+            'autoTranslate.retryCount': 'Retry count',
+            'autoTranslate.retryDelay': 'Retry delay (ms)',
+            'autoTranslate.timeout': 'Request timeout (ms)',
+            'autoTranslate.dryRunFirst': 'Dry-run preview first',
+            'autoTranslate.reportStdout': 'Print report to terminal',
+            'autoTranslate.bom': 'Write UTF-8 BOM',
+            'autoTranslate.protectionEnabled': 'Protect brand terms, keys, values',
+            'autoTranslate.protectionFile': 'Protection JSON file',
+            'autoTranslate.promptProtectionSetup': 'Ask to create protection file',
+            'autoTranslate.promptProtectionUpdate': 'Ask to update protection rules'
+        };
+
+        await this.showSettingsCategory(autoTranslateSettings);
+    }
 
     /**
      * Show advanced settings menu
@@ -531,9 +564,16 @@ class SettingsCLI {
             'security.adminPinEnabled': ['true', 'false'],
             'security.pinProtection.enabled': ['true', 'false'],
             'advanced.backupBeforeChanges': ['true', 'false'],
-            'backup.enabled': ['true', 'false'],
-            'backup.singleFileMode': ['true', 'false']
-        };
+            'backup.enabled': ['true', 'false'],
+            'backup.singleFileMode': ['true', 'false'],
+            'autoTranslate.placeholderMode': ['preserve', 'skip', 'send'],
+            'autoTranslate.dryRunFirst': ['true', 'false'],
+            'autoTranslate.reportStdout': ['true', 'false'],
+            'autoTranslate.bom': ['true', 'false'],
+            'autoTranslate.protectionEnabled': ['true', 'false'],
+            'autoTranslate.promptProtectionSetup': ['true', 'false'],
+            'autoTranslate.promptProtectionUpdate': ['true', 'false']
+        };
         if (key === 'language') {
             return settingsManager.getAvailableLanguages().map(l => l.code);
         }
@@ -566,8 +606,14 @@ class SettingsCLI {
             'lockoutDuration': { min: 1, max: 60, type: 'int', unit: 'minutes' },
             'backupRetention': { min: 1, max: 30, type: 'int', unit: 'days' },
             'logRetention': { min: 1, max: 90, type: 'int', unit: 'days' },
-            'retentionDays': { min: 1, max: 365, type: 'int', unit: 'days' },
-            'maxBackups': { min: 1, max: 3, type: 'int' }
+            'retentionDays': { min: 1, max: 365, type: 'int', unit: 'days' },
+            'maxBackups': { min: 1, max: 3, type: 'int' },
+            'autoTranslate.concurrency': { min: 1, max: 25, type: 'int' },
+            'autoTranslate.batchSize': { min: 1, max: 10000, type: 'int' },
+            'autoTranslate.progressInterval': { min: 1, max: 10000, type: 'int' },
+            'autoTranslate.retryCount': { min: 0, max: 10, type: 'int' },
+            'autoTranslate.retryDelay': { min: 0, max: 30000, type: 'int', unit: 'ms' },
+            'autoTranslate.timeout': { min: 1000, max: 120000, type: 'int', unit: 'ms' }
         };
         
         for (const [field, rules] of Object.entries(validations)) {
@@ -827,10 +873,10 @@ class SettingsCLI {
         let finalValue = convertedValue;
         if (typeof finalValue === 'string') {
             const lowerKey = key.toLowerCase();
-            if (lowerKey.includes('dir') || lowerKey.includes('path') || lowerKey.includes('root')) {
-                finalValue = finalValue.replace(/^([/\\])/, './');
-                finalValue = configManager.toRelative(path.resolve(finalValue));
-            }
+            if (lowerKey.includes('dir') || lowerKey.includes('path') || lowerKey.includes('root') || key === 'autoTranslate.protectionFile') {
+                finalValue = finalValue.replace(/^([/\\])/, './');
+                finalValue = configManager.toRelative(path.resolve(finalValue));
+            }
         }
         this.setNestedValue(this.settings, key, finalValue);
         this.modified = true;
@@ -1934,9 +1980,9 @@ ${colors.dim}${t('settings.updatePackage.command')}: npm update i18ntk -g${color
             return `${colors.dim}(not set)${colors.reset}`;
         }
         const lowerKey = key.toLowerCase();
-        if (typeof value === 'string' && (lowerKey.includes('dir') || lowerKey.includes('path') || lowerKey.includes('root'))) {
-            return configManager.toRelative(path.resolve(value));
-        }
+        if (typeof value === 'string' && (lowerKey.includes('dir') || lowerKey.includes('path') || lowerKey.includes('root') || key === 'autoTranslate.protectionFile')) {
+            return configManager.toRelative(path.resolve(value));
+        }
         if (typeof value === 'boolean') {
             return value ? `${colors.green}enabled${colors.reset}` : `${colors.red}disabled${colors.reset}`;
         }
@@ -1960,7 +2006,7 @@ ${colors.dim}${t('settings.updatePackage.command')}: npm update i18ntk -g${color
             if (['false','no','n','0','off','disabled'].includes(lower)) return false;
 
             // Numbers for known numeric settings
-            const numericKeys = /(sessionTimeout|maxFailedAttempts|lockoutDuration|retentionDays|maxBackups|advanced\.|backup\.)/;
+            const numericKeys = /(sessionTimeout|maxFailedAttempts|lockoutDuration|retentionDays|maxBackups|advanced\.|backup\.|autoTranslate\.(concurrency|batchSize|progressInterval|retryCount|retryDelay|timeout))/;
             if (numericKeys.test(key)) {
                 const n = Number(raw);
                 if (!Number.isNaN(n)) return n;

package/settings/settings-manager.js

@@ -52,6 +52,22 @@ class SettingsManager {
                 "memoryOptimization": true,
                 "compression": true
             },
+            "autoTranslate": {
+                "placeholderMode": "preserve",
+                "concurrency": 6,
+                "batchSize": 100,
+                "progressInterval": 25,
+                "retryCount": 3,
+                "retryDelay": 1000,
+                "timeout": 15000,
+                "dryRunFirst": true,
+                "reportStdout": true,
+                "bom": false,
+                "protectionEnabled": true,
+                "protectionFile": "./i18ntk-auto-translate.json",
+                "promptProtectionSetup": true,
+                "promptProtectionUpdate": true
+            },
             "reports": {
                 "format": "json",
                 "includeSource": false,
@@ -368,6 +384,10 @@ class SettingsManager {
         if (loadedSettings.processing) {
             merged.processing = { ...this.defaultConfig.processing, ...loadedSettings.processing };
         }
+
+        if (loadedSettings.autoTranslate) {
+            merged.autoTranslate = { ...this.defaultConfig.autoTranslate, ...loadedSettings.autoTranslate };
+        }
         
         if (loadedSettings.advanced) {
             merged.advanced = { ...this.defaultConfig.advanced, ...loadedSettings.advanced };
@@ -875,6 +895,95 @@ class SettingsManager {
                         }
                     }
                 },
+                autoTranslate: {
+                    type: 'object',
+                    description: 'Auto Translate beta defaults',
+                    properties: {
+                        placeholderMode: {
+                            type: 'string',
+                            description: 'How placeholder-bearing strings are handled during auto translation',
+                            enum: ['preserve', 'skip', 'send'],
+                            default: 'preserve'
+                        },
+                        concurrency: {
+                            type: 'number',
+                            description: 'Maximum concurrent translation requests',
+                            minimum: 1,
+                            maximum: 25,
+                            default: 6
+                        },
+                        batchSize: {
+                            type: 'number',
+                            description: 'Number of text segments scheduled per translation batch',
+                            minimum: 1,
+                            maximum: 10000,
+                            default: 100
+                        },
+                        progressInterval: {
+                            type: 'number',
+                            description: 'Number of completed text segments between progress updates',
+                            minimum: 1,
+                            maximum: 10000,
+                            default: 25
+                        },
+                        retryCount: {
+                            type: 'number',
+                            description: 'Maximum retries per failed translation request',
+                            minimum: 0,
+                            maximum: 10,
+                            default: 3
+                        },
+                        retryDelay: {
+                            type: 'number',
+                            description: 'Base retry delay in milliseconds',
+                            minimum: 0,
+                            maximum: 30000,
+                            default: 1000
+                        },
+                        timeout: {
+                            type: 'number',
+                            description: 'HTTP request timeout in milliseconds',
+                            minimum: 1000,
+                            maximum: 120000,
+                            default: 15000
+                        },
+                        dryRunFirst: {
+                            type: 'boolean',
+                            description: 'Run a dry-run preview before interactive manager translation',
+                            default: true
+                        },
+                        reportStdout: {
+                            type: 'boolean',
+                            description: 'Print the post-translation report to stdout',
+                            default: true
+                        },
+                        bom: {
+                            type: 'boolean',
+                            description: 'Write translated JSON files with a UTF-8 BOM',
+                            default: false
+                        },
+                        protectionEnabled: {
+                            type: 'boolean',
+                            description: 'Enable user-editable protected terms, keys, values, and patterns',
+                            default: true
+                        },
+                        protectionFile: {
+                            type: 'string',
+                            description: 'Project JSON file containing Auto Translate protection rules',
+                            default: './i18ntk-auto-translate.json'
+                        },
+                        promptProtectionSetup: {
+                            type: 'boolean',
+                            description: 'Ask to create the protection file when Auto Translate first runs',
+                            default: true
+                        },
+                        promptProtectionUpdate: {
+                            type: 'boolean',
+                            description: 'Ask whether to update protection rules before manager translations',
+                            default: true
+                        }
+                    }
+                },
                 security: {
                     type: 'object',
                     properties: {
@@ -1003,4 +1112,3 @@ class SettingsManager {
 }
 
 module.exports = SettingsManager;
-

package/ui-locales/de.json

@@ -1,7 +1,7 @@
 {
   "meta": {
-    "version": "1.10.0",
-    "updated": "2025-08-16"
+    "version": "3.1.0",
+    "updated": "2026-05-07"
   },
   "common": {
     "welcome": "Willkommen",

package/ui-locales/en.json

@@ -1,7 +1,7 @@
 {
   "meta": {
-    "version": "1.10.3",
-    "updated": "2025-08-24"
+    "version": "3.1.0",
+    "updated": "2026-05-07"
   },
   "common": {
     "welcome": "Welcome",

package/ui-locales/es.json

@@ -1,7 +1,7 @@
 {
   "meta": {
-    "version": "1.10.0",
-    "updated": "2025-08-16"
+    "version": "3.1.0",
+    "updated": "2026-05-07"
   },
   "common": {
     "welcome": "Bienvenido",

package/ui-locales/fr.json

@@ -1,7 +1,7 @@
 {
   "meta": {
-    "version": "1.10.0",
-    "updated": "2025-08-16"
+    "version": "3.1.0",
+    "updated": "2026-05-07"
   },
   "common": {
     "welcome": "Bienvenue",

package/ui-locales/ja.json

@@ -1,7 +1,7 @@
 {
   "meta": {
-    "version": "1.10.0",
-    "updated": "2025-08-16"
+    "version": "3.1.0",
+    "updated": "2026-05-07"
   },
   "common": {
     "welcome": "ようこそ",

package/ui-locales/ru.json

@@ -1,7 +1,7 @@
 {
   "meta": {
-    "version": "1.10.0",
-    "updated": "2025-08-16"
+    "version": "3.1.0",
+    "updated": "2026-05-07"
   },
   "common": {
     "welcome": "Добро пожаловать",
@@ -984,7 +984,8 @@
       "translation_not_found": "Перевод для ключа не найден: {key}",
       "translation_key_not_string": "Значение ключа перевода не является строкой: {key}",
       "error_reading_locales_directory": "Ошибка чтения директории локалей: {errorMessage}"
-    }
+    },
+    "translateCommand": "translate - Автоперевод файлов локалей (Бета)"
   },
   "init": {
     "initializationTitle": "🚀 Набор инструментов i18n — Инициализация проекта",

package/ui-locales/zh.json

@@ -1,7 +1,7 @@
 {
   "meta": {
-    "version": "1.10.0",
-    "updated": "2025-08-16"
+    "version": "3.1.0",
+    "updated": "2026-05-07"
   },
   "common": {
     "welcome": "欢迎",

package/utils/config-manager.js

@@ -121,7 +121,7 @@ const DEFAULT_CONFIG = {
     "complete": null,
     "manage": null
   },
-  "processing": {
+  "processing": {
     "batchSize": 2000,
     "concurrency": 32,
     "maxFileSize": 524288,
@@ -150,9 +150,25 @@ const DEFAULT_CONFIG = {
     "streaming": true,
     "compression": "brotli",
     "parallelProcessing": true,
-    "minimalLogging": true
-  },
-  "reports": {
+    "minimalLogging": true
+  },
+  "autoTranslate": {
+    "placeholderMode": "preserve",
+    "concurrency": 6,
+    "batchSize": 100,
+    "progressInterval": 25,
+    "retryCount": 3,
+    "retryDelay": 1000,
+    "timeout": 15000,
+    "dryRunFirst": true,
+    "reportStdout": true,
+    "bom": false,
+    "protectionEnabled": true,
+    "protectionFile": "./i18ntk-auto-translate.json",
+    "promptProtectionSetup": true,
+    "promptProtectionUpdate": true
+  },
+  "reports": {
     "format": "json",
     "includeStats": true,
     "includeMissingKeys": true,

package/utils/security.js

@@ -687,12 +687,13 @@ static _logging = false;
       'projectRoot', 'sourceDir', 'i18nDir', 'outputDir', 'backupDir', 'tempDir', 'cacheDir', 'configDir',
       // Language settings
       'sourceLanguage', 'uiLanguage', 'language', 'defaultLanguages', 'supportedLanguages',
-      // Translation markers and content
-      'notTranslatedMarker', 'notTranslatedMarkers', 'translatedMarker', 'translatedMarkers',
+      // Translation markers and content
+      'notTranslatedMarker', 'notTranslatedMarkers', 'translatedMarker', 'translatedMarkers',
+      'allowedEnglishTerms', 'englishContentThresholdPercent',
       // File handling
       'supportedExtensions', 'excludeFiles', 'excludeDirs', 'includeFiles', 'includeDirs',
       // Operational settings
-      'strictMode', 'debug', 'displayPaths', 'version', 'scriptDirectories',
+      'strictMode', 'debug', 'displayPaths', 'version', 'scriptDirectories', 'autoTranslate',
       // Framework and processing
       'framework', 'processing', 'performance', 'advanced',
       // UI and theme settings

package/utils/translate/cli.js

@@ -6,18 +6,19 @@ const PLACEHOLDER_WARNING = [
   '  WARNING: DYNAMIC PLACEHOLDER TOKENS DETECTED',
   '============================================================',
   '',
-  '  Google Translate will attempt to translate the ENTIRE',
-  '  string value, including any placeholder tokens like:',
+  '  Auto Translate can preserve placeholders while translating',
+  '  only the text around tokens like:',
   '',
   '    {name}    {{count}}    %d    %s    :param    ${var}',
   '',
-  '  This WILL corrupt or alter your placeholders, which',
-  '  will break runtime substitution in your application.',
+  '  Sending placeholders to a translation provider can corrupt',
+  '  runtime substitution in your application.',
   '',
-  '  You have two choices for strings containing placeholders:',
+  '  You have three choices for strings containing placeholders:',
   '',
-  '    SKIP  - Copy verbatim (safe); manually translate later',
-  '    SEND  - Translate anyway (risky); may corrupt placeholders',
+  '    PRESERVE - Translate text segments and reinsert placeholders',
+  '    SKIP     - Copy verbatim; manually translate later',
+  '    SEND     - Translate anyway with masking',
   '',
   '============================================================',
 ].join('\n');
@@ -28,18 +29,20 @@ async function confirmGlobalChoice() {
   console.log('  What should we do with ALL strings that contain');
   console.log('  dynamic placeholder tokens?');
   console.log('');
-  console.log('  [s] SKIP all  - Copy verbatim, translate nothing with placeholders');
-  console.log('  [t] SEND all  - Translate everything, accept corruption risk');
-  console.log('  [i] ASK each  - Decide individually for each key');
+  console.log('  [p] PRESERVE all - Translate text around placeholders (recommended)');
+  console.log('  [s] SKIP all     - Copy verbatim, translate nothing with placeholders');
+  console.log('  [t] SEND all     - Translate everything with placeholder masking');
+  console.log('  [i] ASK each     - Decide individually for each key');
   console.log('');
 
   while (true) {
-    const answer = await ask('  Choice [s/t/i]: ');
+    const answer = await ask('  Choice [p/s/t/i]: ');
     const lower = answer.toLowerCase().trim();
+    if (lower === '' || lower === 'p' || lower === 'preserve') return { strategy: 'preserve', interactive: false };
     if (lower === 's' || lower === 'skip') return { strategy: 'skip', interactive: false };
     if (lower === 't' || lower === 'send') return { strategy: 'send', interactive: false };
-    if (lower === 'i' || lower === 'ask' || lower === 'interactive') return { strategy: 'skip', interactive: true };
-    console.log('  Please enter s, t, or i.');
+    if (lower === 'i' || lower === 'ask' || lower === 'interactive') return { strategy: 'preserve', interactive: true };
+    console.log('  Please enter p, s, t, or i.');
   }
 }
 
@@ -52,13 +55,14 @@ async function confirmPerKey(keyPath, value, placeholders) {
   console.log('');
 
   while (true) {
-    const answer = await ask('  [s]kip / [t]ranslate anyway / s[k]ip all remaining / [a]ll remaining? ');
+    const answer = await ask('  [p]reserve / [s]kip / [t]ranslate masked / s[k]ip all / [a]ll preserve? ');
     const lower = answer.toLowerCase().trim();
+    if (lower === '' || lower === 'p' || lower === 'preserve') return 'preserve';
     if (lower === 's' || lower === 'skip') return 'skip';
     if (lower === 't' || lower === 'translate') return 'send';
     if (lower === 'k' || lower === 'skipall') return 'skip-all';
-    if (lower === 'a' || lower === 'all') return 'send-all';
-    console.log('  Please enter s, t, k, or a.');
+    if (lower === 'a' || lower === 'all') return 'preserve-all';
+    console.log('  Please enter p, s, t, k, or a.');
   }
 }
 

package/utils/translate/placeholder.js

@@ -40,6 +40,7 @@ function detectPlaceholders(value, customPatterns) {
   const patterns = compilePatterns(customPatterns);
   const found = new Set();
   for (const pattern of patterns) {
+    pattern.lastIndex = 0;
     const matches = value.match(pattern);
     if (matches) {
       for (const m of matches) found.add(m);
@@ -52,11 +53,68 @@ function hasPlaceholders(value, customPatterns) {
   if (!value || typeof value !== 'string') return false;
   const patterns = compilePatterns(customPatterns);
   for (const pattern of patterns) {
+    pattern.lastIndex = 0;
     if (pattern.test(value)) return true;
   }
   return false;
 }
 
+function splitByPlaceholders(value, customPatterns) {
+  if (!value || typeof value !== 'string') {
+    return [{ type: 'text', value: value || '' }];
+  }
+
+  const patterns = compilePatterns(customPatterns);
+  const matches = [];
+
+  for (const pattern of patterns) {
+    pattern.lastIndex = 0;
+    let match;
+    while ((match = pattern.exec(value)) !== null) {
+      if (!match[0]) {
+        pattern.lastIndex++;
+        continue;
+      }
+      matches.push({
+        start: match.index,
+        end: match.index + match[0].length,
+        value: match[0],
+      });
+    }
+  }
+
+  if (matches.length === 0) {
+    return [{ type: 'text', value }];
+  }
+
+  matches.sort((a, b) => {
+    if (a.start !== b.start) return a.start - b.start;
+    return (b.end - b.start) - (a.end - a.start);
+  });
+
+  const accepted = [];
+  for (const match of matches) {
+    const overlaps = accepted.some((item) => match.start < item.end && match.end > item.start);
+    if (!overlaps) accepted.push(match);
+  }
+  accepted.sort((a, b) => a.start - b.start);
+
+  const segments = [];
+  let cursor = 0;
+  for (const match of accepted) {
+    if (match.start > cursor) {
+      segments.push({ type: 'text', value: value.slice(cursor, match.start) });
+    }
+    segments.push({ type: 'placeholder', value: match.value });
+    cursor = match.end;
+  }
+  if (cursor < value.length) {
+    segments.push({ type: 'text', value: value.slice(cursor) });
+  }
+
+  return segments;
+}
+
 function maskPlaceholders(value, customPatterns) {
   if (!value || typeof value !== 'string') return { masked: value, map: new Map() };
   const patterns = compilePatterns(customPatterns);
@@ -64,6 +122,7 @@ function maskPlaceholders(value, customPatterns) {
   let idx = 0;
   let masked = value;
   for (const pattern of patterns) {
+    pattern.lastIndex = 0;
     masked = masked.replace(pattern, (match) => {
       const ph = `\uE000${idx}\uE001`;
       map.set(ph, match);
@@ -88,6 +147,7 @@ module.exports = {
   compilePatterns,
   detectPlaceholders,
   hasPlaceholders,
+  splitByPlaceholders,
   maskPlaceholders,
   unmaskPlaceholders,
 };