inertia_i18n 0.6.2 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd6963fa4cee963f25abe89fd9b5d2c85fdd215818dc20758a58fe78bd1ef0fc
-  data.tar.gz: 570e11fd4df5a71af1885f576fd16bdd8bdd4a6dd63b96e70e26e341def65bee
+  metadata.gz: 4e612133c6b6af1e6269626c3af83a4c27c846b50f2b75f1a12d51559425a3d5
+  data.tar.gz: f2524dc747a6314a7a482566b086cc854b1a1276ae048b04cb8002946d5a4910
 SHA512:
-  metadata.gz: e03446783627997094d0e4c33b16b68719ee417167b76b2b370960354414c274c55ff366167499d4c4081c04ed49b9185e1937d93985f1fbe3f600949bc7d5fd
-  data.tar.gz: fcc6c743a74b8aef68f4c7a9cdf7d35a88492c543600ba89bc1ae68219a57ca42d6286441647f4d91ac0f9e563be8965746ddbfa7dcfb25539edc01a231a44ec
+  metadata.gz: e2675724ebf16a84ce0a13c3b7d09cc7d16b4c587f79c5ba05840100e796f16d86193e590011f08c6685d557926f63966191456c7bb72d4345397013d4fee80f
+  data.tar.gz: 166504db3b51629f77c9fb112c53f5ba87e661d1558f72beb22f2849996ded50dbee7c94a8879cfe07fd54590291df22ac97bd87e28a6a39c956b5e1e19a323a

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [0.7.0] - 2026-02-27
+
+### Added
+
+- **Dynamic Keys Configuration**: Added `dynamic_keys` configuration property to expand dynamic patterns into explicit static keys. This allows the scanner to check for missing variants of dynamic keys (e.g. `status.active`, `status.inactive`) and mark them as used. Supported in both Ruby initializer and YAML configuration formats.
+
 ## [0.6.2] - 2026-02-23
 
 ### Fixed

data/README.md

@@ -231,6 +231,38 @@ Handles:
 - Template literals: `t(\`user.\${type}.title\`)` (flagged for review)
 - Dynamic patterns: `t(keyVariable)` (flagged for review)
 
+### Dynamic Keys Configuration
+
+When you use template literals or dynamic variables for translations, the scanner might flag them as unused or missing. You can configure exact mappings for these dynamic keys using the `dynamic_keys` setting.
+
+```ruby
+# config/initializers/inertia_i18n.rb
+config.dynamic_keys = {
+  "status." => ["active", "inactive", "pending"]
+}
+```
+
+**Option B: YAML config**
+
+```yaml
+# config/inertia_i18n.yml
+dynamic_keys:
+  "status.":
+    - active
+    - inactive
+    - pending
+```
+
+Now, when the scanner sees `t(\`status.\${statusKey}\`)`, it will automatically expand it to `status.active`, `status.inactive`, and `status.pending`, ensuring they are checked for existence and marked as used.
+
+Alternatively, you can just ignore the prefix if the possible values are not known using `dynamic_patterns`:
+
+```ruby
+config.dynamic_patterns = {
+  "status." => "Dynamic status keys"
+}
+```
+
 ### Magic Comments
 
 Use magic comments to mark dynamic keys as used or suppress warnings. Both `inertia-i18n-use` and `i18n-tasks-use` are supported.
@@ -416,6 +448,12 @@ InertiaI18n.configure do |config|
     # "status." => "Dynamic status keys"
   }
 
+  # Dynamic keys exact mapping (prefix => array of possible values)
+  # These keys will be automatically expanded and checked for existence
+  config.dynamic_keys = {
+    # "status." => ["active", "inactive", "pending"]
+  }
+
   # Keys to ignore during unused/missing checks
   config.ignore_unused = []
   config.ignore_missing = []
@@ -467,6 +505,11 @@ translation_functions:
   - i18n.t
 # dynamic_patterns:
 #   "status.": Dynamic status keys
+dynamic_keys:
+  "status.":
+    - active
+    - inactive
+    - pending
 ignore_unused: []
 ignore_missing: []
 key_properties:

data/lib/generators/inertia_i18n/templates/inertia_i18n.rb.tt

@@ -34,6 +34,12 @@ InertiaI18n.configure do |config|
     # "status." => "Dynamic status keys"
   }
 
+  # Dynamic keys (prefix => array of possible values)
+  # These keys will be automatically expanded and checked for existence
+  config.dynamic_keys = {
+    # "status." => ["active", "inactive", "pending"]
+  }
+
   # Keys to ignore during unused check
   # "common" namespace is generated by inertia_i18n:install as sample data
   config.ignore_unused = ["common"]

data/lib/inertia_i18n/cli.rb

@@ -205,6 +205,12 @@ module InertiaI18n
             # "status." => "Dynamic status keys"
           }
 
+          # Dynamic keys (prefix => array of possible values)
+          # These keys will be automatically expanded and checked for existence
+          config.dynamic_keys = {
+            # "status." => ["active", "inactive", "pending"]
+          }
+
           # Keys to ignore during unused check
           config.ignore_unused = []
 
@@ -253,6 +259,14 @@ module InertiaI18n
         # dynamic_patterns:
         #   "status.": Dynamic status keys
 
+        # Dynamic keys (prefix => array of possible values)
+        # These keys will be automatically expanded and checked for existence
+        # dynamic_keys:
+        #   "status.":
+        #     - active
+        #     - inactive
+        #     - pending
+
         # Keys to ignore during unused check
         ignore_unused: []
 

data/lib/inertia_i18n/configuration.rb

@@ -35,6 +35,9 @@ module InertiaI18n
     # Dynamic key patterns (prefix => regex)
     attr_accessor :dynamic_patterns
 
+    # Dynamic keys exact mapping (prefix => array of possible values)
+    attr_accessor :dynamic_keys
+
     # Keys to ignore during unused check
     attr_accessor :ignore_unused
 
@@ -65,6 +68,7 @@ module InertiaI18n
       }
       @translation_functions = %w[t $t i18n.t]
       @dynamic_patterns = {}
+      @dynamic_keys = {}
       @ignore_unused = []
       @ignore_missing = []
       @key_properties = %w[titleKey labelKey messageKey descriptionKey placeholderKey key]
@@ -104,6 +108,7 @@ module InertiaI18n
 
       load_hash_attribute(:interpolation, data)
       self.dynamic_patterns = data["dynamic_patterns"] || {} if data.key?("dynamic_patterns")
+      self.dynamic_keys = data["dynamic_keys"] || {} if data.key?("dynamic_keys")
       load_sibling_detection(data) if data.key?("sibling_detection")
       load_missing_key_filters(data) if data.key?("missing_key_filters")
     end

data/lib/inertia_i18n/health_checker.rb

@@ -79,6 +79,7 @@ module InertiaI18n
 
       # Add configured dynamic patterns
       dynamic_prefixes.concat(@config.dynamic_patterns&.keys || [])
+      dynamic_prefixes.concat(@config.dynamic_keys&.keys || [])
 
       unused = available_keys - used_keys
 
@@ -102,11 +103,14 @@ module InertiaI18n
       # Filter out keys covered by ignore_unused config
       unused = filter_ignored_keys(unused, @config.ignore_unused)
 
-      unused.each do |key|
+      normalized_unused = normalize_keys_for_sync(unused)
+
+      normalized_unused.each do |key|
+        display_key = key.sub("_[plural]", " (plural forms)")
         @issues[:unused] << {
-          key: key,
+          key: display_key,
           severity: :warning,
-          message: "Key '#{key}' exists in #{primary_locale}.json but is not used in code"
+          message: "Key '#{display_key}' exists in #{primary_locale}.json but is not used in code"
         }
       end
     end
@@ -114,34 +118,53 @@ module InertiaI18n
     def check_locale_sync
       primary_locale = @config.primary_locale
       primary_keys = Set.new(LocaleLoader.extract_keys(@locales[primary_locale] || {}))
+      normalized_primary = normalize_keys_for_sync(primary_keys)
 
       @config.secondary_locales.each do |locale|
         locale_data = @locales[locale] || {}
         locale_keys = Set.new(LocaleLoader.extract_keys(locale_data))
+        normalized_locale = normalize_keys_for_sync(locale_keys)
 
-        missing_in_locale = primary_keys - locale_keys
-        extra_in_locale = locale_keys - primary_keys
+        missing_in_locale = normalized_primary - normalized_locale
+        extra_in_locale = normalized_locale - normalized_primary
 
-        missing_in_locale.each do |key|
+        missing_in_locale.each do |n_key|
+          display_key = n_key.sub("_[plural]", " (plural forms)")
           @issues[:unsync] << {
-            key: key,
+            key: display_key,
             locale: locale,
             severity: :error,
-            message: "Key '#{key}' exists in #{primary_locale}.json but missing from #{locale}.json"
+            message: "Key '#{display_key}' exists in #{primary_locale}.json but missing from #{locale}.json"
           }
         end
 
-        extra_in_locale.each do |key|
+        extra_in_locale.each do |n_key|
+          display_key = n_key.sub("_[plural]", " (plural forms)")
           @issues[:unsync] << {
-            key: key,
+            key: display_key,
             locale: locale,
             severity: :warning,
-            message: "Key '#{key}' exists in #{locale}.json but missing from #{primary_locale}.json"
+            message: "Key '#{display_key}' exists in #{locale}.json but missing from #{primary_locale}.json"
           }
         end
       end
     end
 
+    def normalize_keys_for_sync(keys)
+      plural_suffixes = %w[_zero _one _two _few _many _other]
+      
+      normalized = Set.new
+      keys.each do |key|
+        suffix = plural_suffixes.find { |s| key.end_with?(s) }
+        if suffix
+          normalized.add(key.chomp(suffix) + "_[plural]")
+        else
+          normalized.add(key)
+        end
+      end
+      normalized
+    end
+
     def filter_ignored_keys(keys, ignore_patterns)
       return keys if ignore_patterns.empty?
 

data/lib/inertia_i18n/parsers/javascript_parsing.rb

@@ -83,13 +83,15 @@ module InertiaI18n
           content.scan(/(?<!\w)#{escaped_func}\(\s*`([^`]*\$\{.+?)`/) do |match|
             template = match[0]
             prefix = template.split("${").first
-            patterns << {pattern: prefix, type: :template_literal, raw: template}
+            line = content[0..Regexp.last_match.begin(0)].count("\n") + 1
+            patterns << {pattern: prefix, type: :template_literal, raw: template, line: line}
           end
 
           # Matches t('prefix.' + var) or t("prefix." + var) - string concatenation
           content.scan(/(?<!\w)#{escaped_func}\(\s*(['"])([^'"]+\.)\1\s*\+/) do |match|
             prefix = match[1]
-            patterns << {pattern: prefix, type: :string_concat, raw: "#{prefix} + ..."}
+            line = content[0..Regexp.last_match.begin(0)].count("\n") + 1
+            patterns << {pattern: prefix, type: :string_concat, raw: "#{prefix} + ...", line: line}
           end
         end
 

data/lib/inertia_i18n/scan_results.rb

@@ -26,7 +26,22 @@ module InertiaI18n
         end
       end
 
-      @dynamic_patterns.concat(keys[:dynamic])
+      config = InertiaI18n.configuration
+      dynamic_keys_config = config.dynamic_keys || {}
+
+      keys[:dynamic].each do |dynamic|
+        pattern = dynamic[:pattern]
+        @dynamic_patterns << dynamic
+
+        if dynamic_keys_config.key?(pattern)
+          dynamic_keys_config[pattern].each do |value|
+            # Append value to pattern (e.g. "status." + "active" -> "status.active")
+            expanded_key = "#{pattern}#{value}"
+            @static_keys.add(expanded_key)
+            @occurrences[expanded_key] << {file: file, line: dynamic[:line]}
+          end
+        end
+      end
     end
 
     def used_keys

data/lib/inertia_i18n/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module InertiaI18n
-  VERSION = "0.6.2"
+  VERSION = "0.7.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: inertia_i18n
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.7.0
 platform: ruby
 authors:
 - Alexey Poimtsev
@@ -198,7 +198,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.7
 specification_version: 4
 summary: Translation management for Inertia.js applications
 test_files: []