Changelog

All notable changes to the i18n Mage VS Code extension will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.3.1] - 2026-03-03

Added

• Rewrite Preview: Added preview confirmation for entry value rewriting, allowing review of changes before application.
• Status Bar Entry Count: Bottom status bar now displays entry count for current file, clickable to trigger file translation browsing.
• Non-source Language Handling: Added specialized handling options for texts containing non-source languages during hard-coded extraction.

Improved

• Reference View Upgrade: Replaced peek popup with sidebar reference view for key reference browsing in hover panels, providing persistent reference exploration.
• Dictionary Module Enhancement: Added icons to sidebar dictionary module for distinguishing key prefixes from actual names; support for copying individual entry names.
• File Check Logic Optimization: Improved check triggering mechanism to avoid language file checks when modifying non-language files; fixed missing checks after Git operations.
• Language Selection Experience: Enhanced language selection dialog with standard language names as descriptions for better accuracy.
• Configuration Grouping: Merged skip injection toggle with injection statement settings in hard-coded extraction configuration group for clearer dependency relationships.
• Preview Interface Styling: Refined repair preview interface style, resolving inconsistent input width display issues.

Fixed

• Command Visibility: Refined command display logic for single-file hard-coded text extraction, showing in context menu only when files are processable.
• Cancel Operation Response: Resolved issue where cancel operation didn't properly terminate ongoing entry rewrite processes.
• AI Key Generation: Fixed abnormal behavior where key fallback strategy failed to use AI generation when extracting hard-coded texts containing non-source languages.

[1.3.0] - 2026-02-25

Added

• Hard-coded Text Extraction: Introduced hard-coded text extraction module for rapid internationalization of non-i18n projects and enhancement of existing i18n projects. Features nearly 20 configurable options, accessible via ctrl/cmd + alt + e shortcut or i18nMage.extractHardcodedTexts command.
• YAML Language File Support: Added comprehensive support for YAML format language files, expanding project compatibility.
• Cantonese Language Support: Added Cantonese as a translation language with improved language code alias mappings.
• Debug Mode: Introduced debug mode configuration that logs user operations and execution results in the extension output channel for troubleshooting.
• Pinyin Naming Style Configuration: When generating keys using Pinyin, now supports naming style configuration (e.g., PascalCase, camelCase) for flexible key customization.
• Nested Structure Sorting: Added key-based sorting support for nested language files to maintain structural consistency.
• Real-time Decoration Update: Exposed translationHints.realtimeVisibleRangeUpdate configuration to control immediate decoration updates during scrolling, balancing visual feedback with performance.
• Decoration Scope Configuration: Exposed translationHints.decorationScope to select decoration application to visible area or entire file, resolving sticky scroll display issues.
• OpenAI Proxy Support: Unified ChatGPT-related configurations under OpenAI naming, added proxy support, and corrected request endpoints for improved service stability.

Improved

• Repair Preview Interface Redesign: Completely redesigned repair preview interface with entry-centric information aggregation, supporting key editing, one-click collapse/expand, filtering, and selective language application for more intuitive operations.
• Multi-editor Decoration Sync: Translation decorations now apply simultaneously to multiple editor files in split view, not limited to the active editor.
• Enhanced Excel Functionality: Expanded import/export capabilities with version diff feature, supporting Git commit node selection for generating difference tables and re-importing modified content.
• Performance Optimization: Introduced caching strategy to optimize check logic, significantly improving scanning speed.
• Simplified Interface Operations: Merged import/export buttons in sidebar view into a single Excel button with selection dialog for cleaner workflow.
• Pre-filled Export Filename: Export dialogs now automatically pre-fill filenames when generating Excel files, reducing manual input.
• Configuration Cleanup: Removed analysis.languageFileParser configuration due to limited practical utility.
• Keyboard Shortcut Support: Repair preview interface now supports Escape key for quick closure.
• Configuration Naming Optimization: Moved file extension scanning configuration from general module to check rules module with updated naming.

Documentation

• Official Site Upgrade: Added English documentation support and enhanced Chinese documentation with comprehensive feature explanations.

[1.2.4] - 2026-02-10

Added

• Cross-project Entry Migration: Added copy-paste functionality for entry data, supporting seamless migration of individual or current page entries between projects via direct paste into dictionary modules.
• Smart Search Filtering: Enhanced search functionality with dictionary module filtering support for more precise search results.
• AI Translation Customization: New configuration allowing injection of custom domain terms or style instructions into AI translation workflows for specialized translation needs.

Improved

• Interface Operation Logic Restructuring: Optimized sidebar plugin view layout by placing read-only commands as inline buttons and write-related commands in right-click context menus, improving operational clarity.
• Distraction-free Copy Experience: Removed success notifications when copying entry names/values to reduce visual interruptions and maintain editing flow continuity.
• UI Element Display Fix: Fixed sorting button display issues to ensure proper interface element presentation.

[1.2.3] - 2026-02-02

Added

• Advanced Search Options: Added case-sensitive search support for translation entries, toggleable via Alt+C shortcut or interface button.
• Key Reference Tracking: Implemented complete reference tracking for entry keys, enabling view of all reference locations via right-click or Shift+F12 at usage points.

Improved

• Enhanced Hover Information Panel: Comprehensive upgrade to entry hover panels - source language texts now prioritized at top, independent rewrite buttons for each language text, and key reference count indicators with quick navigation in title area.
• Refined Rewrite Logic: Optimized entry rewriting behavior to execute even when rewritten text remains identical to original, ensuring complete semantic synchronization.

[1.2.2] - 2026-01-26

Added

• Quick Language Addition: Added "Add Language" button to sidebar "Sync" module, supporting one-click addition of new languages with automatic translation service population.
• Enhanced Excel Import Mode: Extended Excel import functionality with new language-based matching mode, intelligently synchronizing translations across languages based on existing texts.
• Search Enhancement: Search functionality now supports whole-word matching mode, toggleable via Alt+W shortcut or interface button.

Improved

• Smart Search Trigger: Optimized search triggering logic to automatically populate search box with selected text or translation texts at cursor position, improving search efficiency.
• File Detection Robustness: Enhanced type validation in large file detection methods to prevent exceptions when path parameters are empty.

[1.2.1] - 2026-01-17

Improved

• Enhanced Repair Progress Indication: Optimized progress notifications during repair operations, adding status information for English key name generation to improve operational awareness.

Fixed

• Multi-entry Repair Sequence: Resolved file write corruption caused by improper position ordering when repairing multiple undefined entries within a single file.
• Undefined Entry Reference Navigation: Fixed functionality defect preventing reference location viewing for undefined entries in sidebar usage panel.
• Existing Key Matching Repair: Solved repair operation failure for individual undefined entries matching existing texts when matchExistingKey configuration is enabled.
• Preview Interface Keyboard Interaction: Fixed keyboard event listening issue in newer VS Code versions, where Enter key couldn't apply modifications after repair preview interface loaded.
• Key Renaming Functionality: Resolved operation failure when renaming entry keys.

[1.2.0] - 2026-01-15

Added

• Cross-language Entry Search (Contributed by @Gur1a ): Added search functionality to sidebar plugin view, accessible via search button or Ctrl+Alt+S shortcut, supporting translation search across current file and global scope in all languages.
• Object Property Translation Support (Contributed by @Gur1a ): Introduced accessMode and translationObjectIdentifiers configurations to support translation access through object properties rather than translation functions.
• Large File User Guidance: Implemented large file detection with clear notifications when opening oversized files, helping users understand extension's handling strategy.

Improved

• Multi-mode Definition Navigation: Enhanced key definition navigation beyond F12 shortcut, now supporting Ctrl+click for more flexible operation.
• Smart Translation Completion: Improved key selection interface during missing translation completion by displaying corresponding translations for clearer decision-making.
• Dynamic Entry Display Fix: Corrected decoration and hover information display for dynamic entries containing dot notation keys, ensuring all dynamic entries properly show translations.

[1.1.8] - 2025-12-22

Improved

• Enhanced Repair Preview Interaction: Relocated function buttons to left side of repair preview interface to prevent result notifications from blocking operations; optimized auto-focus logic to ensure direct Enter key application.
• Smart Key Matching Selection: When existing key matching is enabled, added manual selection capability allowing users to specify target keys from multiple match results.
• Streamlined Repair Workflow: Optimized repair operation logic to skip redundant selection steps when no new entries need to be created.
• Precise Editing Prompts: Corrected prompt information in sidebar entry structure module's edit dialogs to accurately display currently edited entry names.

[1.1.7] - 2025-12-08

Added

• Smart Entry Rewriting: Introduced entry text rewriting functionality, automatically updating translations across languages using translation services when source language text is modified. Accessible via hover panels, sidebar context menus, or the rewriteEntry command.
• Key Refactoring: Added key renaming capability - press F2 at usage locations to rename keys, with automatic synchronization across language files and all reference points.

Improved

• Silent Check Execution: Check commands now run without automatically opening the extension sidebar view, preserving current editing context.
• Repair-Diagnostic Linkage: Linked quick fix actions for undefined entries with diagnostic functionality, synchronizing their enable/disable states for simplified configuration management.

Fixed

• Multi-language Write Integrity: Resolved synchronization issue where English language files were omitted when filling undefined entries with original text.

[1.1.6] - 2025-11-17

Added

• Flexible Language File Structure: Introduced languageStructure setting, supporting both nested and flat file organization based on project requirements.
• Smart Dot Notation Control: Added dot usage control in nested structures, enabling automatic conversion of "a.b" format keys to hierarchical objects { a: { b: "" } } when disabled.
• Auto Path Prefix Generation: keyPrefix configuration now includes auto-path option, generating prefixes from file paths and creating nested keys following directory structure.
• Prefix Exclusion List: New stopPrefixes configuration allows customizing lists of key prefixes to exclude from usage.

Improved

• Repair Operation Interaction Upgrade: Migrated in-file undefined entry repair operations from CodeLens to CodeAction format, resolving editor auto-focus issues and enhancing user experience.
• Dynamic Entry Display Precision: Corrected display positions for dynamically concatenated entry text decorations, ensuring accurate tooltip alignment.

Fixed

• Special Character Key Navigation: Resolved F12 navigation failure for keys containing non-special meaning dots, ensuring correct jumps to corresponding locations in source language files.
• Multi-level Path Prefix Parsing: Fixed key prefix reading errors when translation directories contain language files at different hierarchy levels.

[1.1.5] - 2025-11-11

Added

• Smart Key Value Navigation: Pressing F12 on translation keys now directly navigates to corresponding key locations in source language files for quick definition lookup.
• Enhanced Dynamic Entry Display: Improved dynamic concatenated entry presentation, showing all matched translations (separated by " | ") and supporting hover information for complete key overview.
• CodeLens Quick Actions: Added CodeLens buttons for undefined entries in current files, enabling one-click extraction as new entries or ignore operations.
• Quick Translation Preview: Introduced QuickSelect feature to browse all entry translations in current file, with direct navigation to usage locations (via right-click menu or Ctrl+Alt+T).
• Cross-platform Shortcut Support: Added Command key shortcuts for Mac users, enhancing cross-platform usability.

Improved

• Refined Variable Detection: Adjusted variable identification rules - all-uppercase letters no longer misidentified as variables, while underscore-connected words are correctly recognized.
• String Literal Visualization: With "Scan String Literals" enabled, the "Defined" section in sidebar's "Current File" panel now displays all potential entry information.

Fixed

• Extraction Scope Isolation: Resolved scope confusion where global missing translation operations incorrectly appeared during individual undefined text extraction.

[1.1.4] - 2025-10-31

Improved

• Smart Framework Detection: Added auto option as default for internationalization framework configuration, implementing more accurate automatic detection to simplify project setup.
• Vue-I18n Dynamic Syntax Support: Enhanced recognition of array-based dynamic concatenation usage in Vue-I18n, ensuring proper entry display in complex template syntax.

Fixed

• Inline Translation Color Updates: Resolved delayed visual feedback when manually changing translation text colors in light/dark themes.
• Precise Single File Extraction: Corrected scope determination issue where global entries were incorrectly included during single-file undefined entry extraction.
• Nested Object Structure Parsing: Fixed data construction errors when generating category trees for language files with nested object structures.

[1.1.3] - 2025-10-28

Added

• Flexible Inline Translation Display: Added configuration for inline translation decoration presentation, supporting parallel display of translated and original texts for enhanced code reading experience.
• Italic Decoration Style: Introduced option to display translation decorations in italic style for better visual distinction.
• Plain String Translation Support: Extended inline translation decoration functionality to support plain string texts.
• Smart Key Fallback Strategy: Added fallback mechanisms for key generation failures during undefined entry extraction, offering both traditional filename numbering and AI-powered intelligent generation options.

Improved

• Intelligent Namespace Handling: Enhanced namespace import format for react-i18next and i18next frameworks, avoiding unnecessary namespace prefixes for default namespace entries.
• Unified Configuration Field Names: Optimized configuration field names in write rules module by removing redundant prefixes for better consistency (e.g., generatedKeyStrategy → keyStrategy).

Fixed

• React Project Namespace Detection: Resolved incorrect namespace strategy determination during plugin initialization for projects using react-i18next or i18next.
• Repair Preview Data Sync: Corrected data synchronization issue where selected count in repair preview interfaces might not match actual selections.
• Multi-language File Write Completeness: Fixed integrity issue where some language files might be missed when applying repair results.

[1.1.2] - 2025-10-21

Added

• Expanded Translation Services: Added ChatGPT and Youdao Translate as new translation service providers.
• Enhanced Google Translate Integration: Added support for configuring official Google Translate API Key, enabling direct API calls when configured while maintaining free service as fallback.
• Flexible Indentation Support: Introduced tab indentation support for language file writing, accommodating diverse team formatting preferences.

Improved

• Default Key Prefix Strategy: Changed the default value for newly generated key prefixes from none to manual-selection for better key naming experience.
• Configuration Description Refinement: Corrected the background alpha configuration description from "transparency" to "opacity" to prevent user confusion.

Fixed

• Multi-language Text Display: Resolved an issue where the "Sync Info" panel incorrectly displayed reference language texts instead of corresponding language texts across all language sections.
• Plugin Initialization Refresh: Fixed delayed display of inline translation decorations and current language settings due to missing refresh after plugin initialization.
• Preview Data Consistency: Solved a synchronization issue where modified data in preview interfaces wasn't properly applied, with previous data being used instead.

[1.1.1] - 2025-10-13

Improved

• Enhanced Hover Tooltip Interaction: Upgraded entry hover tooltips with quick navigation to definition locations, one-click text copying, and instant translation for missing texts.

Fixed

• Hover Edit Functionality: Fixed an issue where the edit button in entry hover information panels was unresponsive.
• Repair Result Synchronization: Resolved a data sync issue where plugin interfaces continued to display repair results instead of original states after canceling repair applications.
• Variable Entry Filtering Logic: Corrected a bug where suspected variable entries still appeared in selection lists during global repairs when "Ignore Suspected Variables" was enabled.
• Panel Data Real-time Updates: Fixed delayed updates in the "Current File" module of the plugin panel under certain conditions.
• Auto-completion Trigger: Solved incorrect triggering behavior of key auto-completion in specific scenarios.
• Refined Repair Feedback: Improved success notification messages and progress bar display for clearer operation feedback.

[1.1.0] - 2025-10-09

Added

• Precision Repair Operations: Enhanced repair capabilities with granular control - now supports generating new keys for individual undefined entries, supplementing translations for specific missing languages, and completing translations for single missing items.
• Intelligent Code Completion: Implemented smart autocompletion for translation functions, displaying candidate entries when typing t( with support for key name, value, Chinese Pinyin, and initial letter matching.
• Flexible Key Generation: Introduced key name generation based on Pinyin or English translation, providing more naming flexibility.
• Configurable Translation Scope: Added options to control translation completion range when generating new keys, supporting either minimal language set or full language coverage.
• Smart Variable Detection: Added configuration to automatically identify and exclude variable texts from undefined entry extraction.

Improved

• Enhanced Language Validation: Expanded validateLanguageBeforeTranslate to cover both new key generation and missing translation completion. Enhanced validation failure handling with options to skip, keep original value, force translation, or switch translation sources.
• Key Length Calculation Logic: Optimized maxKeyLength to apply only to individual key names rather than full paths (e.g., only test is counted in common.test).
• Documentation System Upgrade: Migrated Chinese documentation to a new VitePress site, offering comprehensive guides and API documentation (new URL: https://baimohui.github.io/i18n-mage-docs/).

Fixed

• Status Bar Display Issue: Resolved incorrect language information display in status bar for non-internationalization projects.
• Special Character Handling: Fixed unexpected escaping of period symbols in key names when generating new entries in flat file structures.
• Sorting Function Failure: Solved the issue where sorting rules weren't properly applied after certain repair operations.

[1.0.7] - 2025-09-28

Added

• Status Bar Language Info: Added current display language and translation source language information to the status bar, with click-to-select functionality for quick language switching.

Changed

• Unified Language File Structure: Integrated file structures across languages, allowing selection of non-existent file locations for undefined entries (missing files will be created automatically during write operations).
• Enhanced Language File Parsing: Optimized data extraction logic with complete syntax analysis, precise target identification, and improved error handling mechanisms.
• Streamlined Tooltip Display: Removed full-language translation tooltips for "Normal" and "Redundant" entry categories in the synchronization panel, now only showing them for "Missing" and "Empty Value" categories for cleaner visualization.

Fixed

• Empty Object Selection: Resolved an issue where nested empty objects in language files couldn't be selected as target locations for undefined entries during manual selection.

[1.0.6] - 2025-09-19

Fixed

• Array Value Parsing: Resolved an issue where translation files containing array values caused entry parsing exceptions.
• Reference Language Sync: Fixed a bug where changing the reference language in configuration files wasn't automatically synchronized within the extension.
• Array Value Navigation: Corrected an issue where entries with array values couldn't properly navigate to their definition locations.
• Single File Cleanup: Solved a problem where the "Clear Unused Entries" function couldn't remove all entries within a single file.

[1.0.5] - 2025-09-17

Added

• Single File Operations: Added context menu options to copy translation entries and fix undefined entries directly from the right-click menu in open files.
• Namespace Configuration: Introduced a new namespace generation strategy with four options: 'auto' (auto-inference), 'full' (full path), 'file' (filename only), and 'none' (no namespace).
• Diagnostics Toggle: Added configuration option to enable or disable diagnostics as needed.
• Manual Prefix Selection: Enhanced key prefix generation with a "manual-selection" option that allows users to choose from existing prefixes when generating translation keys for undefined entries.

Changed

• Refined Inline Hint Colors: Updated default color scheme for translation inline hints with more professional, subtle tones that minimize visual disruption:
  • Light Theme: Font color #2E7D9A with background #9EC9D7 at 40% opacity
  • Dark Theme: Font color #4EC9B0 with background #264F48 at 60% opacity
• Enhanced DeepSeek Parsing: Further optimized text segmentation logic to prevent delimiter output when translating single text entries.

Fixed

• Chinese Language Detection: Resolved an issue where "zh" was incorrectly identified as Traditional Chinese instead of Simplified Chinese.
• Escape Character Handling: Added proper escape sequence processing for line breaks and special characters when editing entry values, copying entries, and displaying translation tooltips.

[1.0.4] - 2025-09-09

Added

• DeepL Translation Service: Added support for DeepL as a new translation service provider.
• Container Menu: Added a three-dot menu at the container top with buttons to view documentation, open extension settings, and provide feedback.
• Status Bar Toggle Indicator: The status bar now displays an enabled/disabled indicator when toggling inline hints via keyboard shortcut.

Changed

• Enhanced DeepSeek Parsing: Optimized the text segmentation logic for DeepSeek translation service to correctly handle and remove extra line breaks in its output.
• Translation Priority Update: Adjusted the default translation API priority, raising DeepSeek (due to improved parsing) and lowering Google Translate (which has no API key requirement).
• Magical Branding: Updated the fix button icon, extension description, and view names to better reflect the "magical" theme.
• Auto-Switch View: The Refresh command now automatically switches to the extension's view in the Activity Bar.

Fixed

• Diagnostics with Disabled Hints: Resolved an issue where disabling inline hints also incorrectly disabled entry diagnostics.
• Dynamic Decoration Cleanup: Fixed an issue where dynamic entry decorations persisted after disabling inline hints.
• Quote Writing Error: Corrected a bug that caused incorrect quotation marks to be written when fixing undefined entries.
• Key Case Sensitivity: Fixed a bug where using the filename to generate a key for long entries converted the filename to all lowercase.
• Activity Bar Visibility: Resolved an issue where the extension icon remained in the Activity Bar when opening a non-i18n project.
• Documentation and Text Optimization: Refined UI text and documentation for clarity and completeness.

[1.0.3] - 2025-09-01

Added

• Enhanced Tooltip Information: Added tooltips in the "Sync Info" module to display language directories, and in the "Undefined" usage section to indicate whether undefined entry correction is enabled, with additional validation status for sub-items.

Changed

• Key Prefix Default Change: Updated the default value for the "Key Prefix" configuration in "Write Rules" from auto-popular to none to prevent user confusion.
• Translation API Priority Adjustment: Modified the default "Translation API Priority" configuration to move Deepseek to the last position due to output instability.

Fixed

• Improved Activation Conditions: Expanded plugin activation conditions to include additional language and command triggers for better reliability.
• Command Categorization: Added plugin-specific categories to commands for easier identification in the command palette.
• Command Palette Argument Handling: Resolved errors when invoking commands without arguments from the command palette.
• Documentation and Text Optimization: Refined UI text and documentation for clarity and completeness.

[1.0.2] - 2025-08-28

Fixed

• Fix for Undefined Entry Repair Logic: Resolved an issue where the repair logic could not be properly enabled due to the undefined entry repair feature being turned off.

[1.0.1] - 2025-08-28

Fixed

• Language File Indentation Detection Fix: Corrected the method for detecting indentation levels in language files, resolving misidentification issues in flat files.

[1.0.0] - 2025-08-25

Added

• Initial release: The magical i18n assistant is here!
• Tree View Panel: A comprehensive overview of all translation keys, their status, and sync state.
• Inline Hints: Display translated text right next to the t() function in your code.
• Smart Fix for Undefined Keys: Automatically generates keys and translations for undefined text.
• One-Click Translation Completion: Integrates with Google, DeepSeek, Baidu, and Tencent Translation APIs to fill in missing translations.
• Excel Import & Export: Enables easy collaboration with translation teams via Excel files.
• Unused Key Detection: Analyzes your project to find and help remove unused keys.
• Deep Configuration: Over 50 options to customize the extension's behavior to fit any project.
• Built-in optimization for Chinese developers: Native Chinese UI and built-in access to domestic translation APIs.

Known Issues

• Please report any issues on our GitHub Issues page. Your feedback is valued!