arb_excel_converter_tool 1.1.1

A complete CLI tool to export Flutter ARB files to Excel for translators and import them back into your project.

Changelog

All notable changes to this project will be documented in this file.

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

🚀 Fixed

1.1.1 - 2025-12-25

• Fixed: subcommand help flag support for export and import.
• Improved: Error handling for invalid command-line arguments.

1.1.0 - 2025-12-25

🚀 Added

• Two-Way Sync: Introduced the import command. You can now convert Excel (.xlsx) files back into Flutter .arb files, completing the localization workflow.
• Smart Defaults: Both commands now look for standard Flutter paths by default (lib/l10n/app_en.arb), allowing for zero-config usage.
• New Primary CLI: Added arb_tool as the main global command with a revamped help menu and usage examples.
• Pretty-Print JSON: Imported ARB files are automatically formatted with a 2-space indent to match Flutter's localization standards.

🛠 Fixed & Improved

• Enhanced Help Menu: Added a rich in-terminal help experience with emojis, box-drawing characters, and contextual examples for sub-commands.
• Excel 4.x Migration: Rewrote row handling using TextCellValue to ensure compatibility with the latest excel package standards.
• Metadata Persistence: Improved the logic for handling @description tags during both export and import cycles.
• Robust Parsing: Added defensive checks to skip empty rows and handle missing keys gracefully during the import process.

---

1.0.2 - 2025-12-16

• Fix: Resolved "Unsupported operation: Cannot remove from an unmodifiable list" crash during Excel sheet creation.
• Stability: Improved Excel saving logic for better compatibility across different OS environments.

1.0.1 - 2025-12-16

• Feature: Added a default input path (lib/l10n/app_en.arb) for easier use.
• Feature: Added a --help (-h) flag for in-terminal instructions.
• Fix: Removed the "mandatory input" requirement that caused crashes.
• Improvement: Added descriptive error messages for missing files.
• Docs: Updated README with usage examples and an arguments table.

1.0.0 - 2025-12-15

Added

• Initial public release of the ARB to Excel Converter Tool.
• Added core functionality to read .arb files and extract keys, values, and descriptions.
• Implemented command-line arguments for specifying input (-i) and output (-o) files.
• Created arb_export executable to simplify running the tool globally.