Filament Localization Laravel Package

Fixed

• Table actions on resources — Resources now detect and localize Filament table actions beyond generic Action::make(), including EditAction::make(), DeleteAction::make(), CreateAction::make(), BulkAction, RestoreAction, ForceDeleteAction, and other common action types. Unnamed ::make() calls (Filament v5 style) are supported.
• Table filters on resources — Filter label detection now uses the correct component class (SelectFilter, TernaryFilter, TrashedFilter, etc.) instead of a generic Filter::make() pattern, so filters with existing labels are handled correctly and missing labels are added reliably.
• Separate table schema files — Actions and filters defined in dedicated table schema classes (e.g. UserTable::configure()) are now analyzed, translated, and modified alongside columns.

Enhanced

• Widget localization — Widget analyzer and modifier now detect and localize widget headings ($heading property, getHeading()), stat descriptions, and additional widget text via ->heading(), ->title(), and related helpers.

Added

• Resource localization — Infolist body scanning, navigation group keys (UnitEnum|string), and getNavigationGroup() wrapping.
• Relation manager localization — Table empty state, KeyValue labels, action modal copy, CreateAction::make() without name, and literal ->label() handling.
• Page titles — Inject getTitle() with __() when still using the Filament base implementation.
• Discovery — Namespaced RelationManager::class resolution in filament:localize.
• Tests — Coverage for ResourceAnalyzer and RelationManagerAnalyzer.

Added

• Laravel 13 — Composer allows laravel/framework: ^12.0|^13.0.

Changed

• PHP — Requirement restored to ^8.3 (from ^8.2 in v2.0.1) to align with Laravel 13's minimum PHP version.
• CI — GitHub Actions matrix tests Laravel 12 and 13 with Orchestra Testbench 10 and 11.
• Dev dependencies — Pest 4.x, Testbench ^10.0|^11.0.

Compatibility

• Supported: PHP ^8.3–^8.5, Laravel ^12.0 | ^13.0, Filament ^5.0, Livewire ^4.0.
• Note: Laravel 12 on PHP 8.2 is not supported in v2.1.x; use v2.0.1 if you need PHP 8.2 on Laravel 12 only.

Changed

• PHP support — Composer requirement relaxed from ^8.3|^8.4|^8.5 to ^8.2 so the package can be used on PHP 8.2, 8.3, 8.4, and 8.5 (e.g. servers on 8.4 until 8.5 is available).

Added

• PHP 8.5 — Composer allows PHP ^8.3|^8.4|^8.5. v2.x supports PHP 8.3, 8.4, and 8.5 only.
• Filament 5 & Livewire 4 — Full compatibility with Filament v5.x (Livewire v4.x, Tailwind v4.x). All analyzers and modifiers work with Filament 5's structure (Forms, Tables, Infolists, Actions, Schemas).
• README — Version support table; "Supported" and "Deprecated" lines aligned with filament-team-guard style.

Changed (Breaking)

• Filament — Requirement ^4.0 → ^5.0. v2.x is Filament 5 only; use v1.x for Filament 4.
• PHP — Requirement ^8.2|^8.3|^8.4 → ^8.3|^8.4|^8.5. PHP 8.2 is no longer supported in v2.x.
• CI — GitHub Actions test matrix updated to PHP 8.3, 8.4, and 8.5 (8.2 removed).

Compatibility

• Supported: PHP ^8.3–^8.5, Laravel ^12.0, Filament ^5.0, Livewire ^4.0.
• Deprecated (use v1.x): PHP <8.3, Filament v4, Livewire v3.

Major Features

• 🤖 DeepL API Integration (NEW): Full translation service with intelligent detection of untranslated content

  • Complete DeepLTranslationService implementation for automated translations
  • New filament:translate-deepl command for translating existing translation files
  • Smart detection of missing translations and identical content
  • Support for 40+ languages with automatic language detection
  • Batch processing with usage monitoring
  • Configurable skip terms for acronyms and technical terms (API, URL, SMS, etc.)
  • Force mode to overwrite existing translations
  • Context-aware processing with formatting preservation

• 📊 Widget Localization Support (NEW): Complete widget detection and localization

  • New WidgetAnalyzer for detecting Filament widget classes
  • New WidgetModifier for automatic widget localization
  • Automatic scanning of Filament widgets
  • Translation key generation for widget labels and properties
  • Added processWidget() method to LocalizationService

• 🔗 RelationManager Localization (NEW): Full support for Filament relation managers

  • New RelationManagerAnalyzer for detecting relation manager classes
  • New RelationManagerModifier for automatic relation manager localization
  • Added processRelationManager() method to LocalizationService
  • Support for all relation manager components and actions

• 📄 Page Localization Support (NEW): Complete page detection and localization

  • New PageAnalyzer for detecting Filament page classes
  • New PageModifier for automatic page localization
  • Added processPage() method to LocalizationService
  • Support for static properties and methods in pages
  • Better handling of dashboard pages and custom pages

Enhancements

• 🎨 Laravel Pint Integration (NEW): Added Laravel Pint for consistent code styling

  • New PintService for automatic code formatting
  • Integration with LocalizeFilamentCommand to format code after localization
  • Updated Pint version to ^1.25 in composer.json
  • GitHub Actions workflow updates for code style checks
  • Improved code quality and consistency

• 💰 Funding Configuration (NEW): Added GitHub Sponsors funding support

  • New .github/FUNDING.yml file
  • Improved package ownership and maintainer information

• 🎯 Enhanced Resource Analyzer: Significant improvements to ResourceAnalyzer

  • Enhanced class checking and detection
  • Better resource identification
  • Improved analysis capabilities

• 🔧 Enhanced Resource Modifier: Major improvements to ResourceModifier

  • Better compatibility and handling
  • Improved modification logic
  • Enhanced translation key generation

• 📝 Enhanced Translation File Generator: Improvements to TranslationFileGenerator

  • Better file structure generation
  • Improved key organization
  • Enhanced locale handling

• 🧪 Enhanced Testing: Expanded test coverage

  • New tests for DeepL integration (DeepLIntegrationTest)
  • New Widget analyzer tests (Unit/PageAnalyzerTest - actually for widgets)
  • New RelationManager analyzer tests (Unit/RelationManagerAnalyzerTest)
  • New Pint service tests (Unit/PintServiceTest)
  • New LocalizeFilamentCommand tests (Feature/LocalizeFilamentCommandTest)
  • New Resource modifier tests (Feature/ResourceModifierTest)
  • New Git service tests (Unit/GitServiceTest)
  • Improved ServiceProvider tests

• ⚙️ Configuration Improvements: Enhanced configuration options

  • DeepL API configuration with batch size settings
  • Skip identical terms configuration
  • Improved default settings
  • New config options for DeepL integration

• 📚 Documentation Updates: Comprehensive documentation improvements

  • New TESTING.md file
  • DeepL integration guide in README
  • Widget localization examples
  • RelationManager localization examples
  • Enhanced README with new features
  • New .env.example file

Bug Fixes

• 🔧 Fixed backslash handling in translation keys
• 🐛 Improved error handling in DeepL translation service
• ⚡ Enhanced resource modifier for better compatibility
• 🔧 Fixed various code style issues across multiple files

Developer Experience

• 🛠️ Removed test-package.sh from repository (contains personal information)
• 📝 Improved code formatting across all files with Laravel Pint
• 🔄 Better git integration and commit messages
• 🗑️ Removed CheckDependenciesCommand (no longer needed)

Enhancements

• 🔧 Enhanced Composer Package Handling: Improved package metadata and dependencies

  • Updated composer.json with better package information
  • Enhanced package handling for Packagist features

• 🎨 Code Style Workflows: Added GitHub Actions workflows for code style

  • New code-style.yml workflow for automated style checking
  • New fix-php-code-style-issues.yml workflow for automatic fixes
  • Improved code consistency across the package

• 📦 New Command: Added CheckDependenciesCommand

  • Dependency checking functionality
  • Better error handling for missing dependencies

• 📸 Documentation Improvements: Enhanced README and package documentation

  • Updated README with additional information
  • Moved photos to dedicated photos folder for better organization
  • Improved package summary documentation

• 🔄 CI/CD Improvements: Consolidated and improved GitHub Actions workflows

  • Consolidated workflows into single CI/CD pipeline
  • Fixed GitHub Actions conditional syntax
  • Removed publish.yml workflow
  • Restored proven working workflow structure

• 🎯 Resource Analyzer Enhancements: Improved resource detection and analysis

  • Enhanced ResourceAnalyzer with better class checking
  • Improved ResourceModifier for better compatibility
  • Better translation file generation

• 📝 Code Quality: Multiple code style fixes

  • Fixed PHP code style issues across multiple files
  • Improved code formatting consistency
  • Enhanced LocalizationService and LocalizeFilamentCommand

Bug Fixes

• 🔧 Fixed styling issues across multiple files
• ⚡ Improved command handling and error messages

Initial Release

• 🎉 First stable release
• ✨ Automatic scanning and localization of Filament resources
• 🌍 Multi-locale support (generate translations for multiple locales)
• 📦 Support for all Filament v4 components (40+ component types)
• 🎯 Panel-based, nested, and flat translation structures
• 📊 Comprehensive statistics tracking
• 🔄 Git integration for easy reverting
• 🧪 Full test coverage with Pest
• 📚 Complete documentation (README, Installation Guide, Quick Start, Package Summary)
• ⚙️ Configurable label generation strategies
• 🔒 Safety features (git status check, backup creation, dry-run mode)
• 🚀 Laravel 12 and Filament 4 support
• 💻 PHP 8.2, 8.3, and 8.4 compatibility

Supported Components

• Forms: TextInput, Select, Checkbox, Toggle, Radio, Textarea, RichEditor, MarkdownEditor, DatePicker, DateTimePicker, TimePicker, ColorPicker, FileUpload, Repeater, Builder, KeyValue, TagsInput, Hidden
• Tables: TextColumn, IconColumn, ImageColumn, ColorColumn, BadgeColumn, BooleanColumn, SelectColumn, CheckboxColumn, ToggleColumn
• Infolists: TextEntry, IconEntry, ImageEntry, ColorEntry, BadgeEntry, BooleanEntry
• Actions: Action, BulkAction, HeaderAction, CreateAction, EditAction, DeleteAction, ViewAction
• Filters: SelectFilter, TernaryFilter, DateFilter
• Sections: Section, Fieldset, Card, Grid, Tabs, Wizard, Split

Author

• Momin Al Zaraa
• Email: [email protected]
• Website: https://mominpert.com
• GitHub: https://github.com/MominAlZaraa

Bug Fixes

• 🐛 Fixed issue where Pages weren't properly localized without using the --force flag
• 🔧 Improved Page detection with more robust class checking
• ✨ Always add title and navigation_label translations for Page classes
• ⚡️ Fixed LocalizationService to properly process all Page classes