Extract Grape::Util::Translation for shared I18n logic

[ericproulx]

Summary

Isolates all I18n logic into a single Grape::Util::Translation module, eliminating duplicated locale-fallback code and direct I18n calls scattered across exceptions and validators.

Changes

Grape::Util::Translation (new module)

• #translate wraps I18n.translate with a MISSING sentinel to reliably detect absent keys (vs. blank translations)
• Automatically falls back to :en when the current locale has no translation, unless enforce_available_locales: true and :en is not in the available locales list
• Extra keyword args (**) are forwarded verbatim to I18n as interpolation variables

Consumers

• Exceptions::Base — includes Translation; removes local translate, fallback_message, and related constants; Hash message branch uses pattern matching (=>) to destructure { key:, **opts }
• Exceptions::Validation — attr_accessor → attr_reader for params and message_key; params always normalized to Array; Hash message support ({ key:, **opts }) for message_key extraction and translation
• Exceptions::ValidationErrors — removes ERRORS_FORMAT_KEY / DEFAULT_ERRORS_FORMAT; delegates to translate
• Validators::Base — includes Translation; custom validators inherit translate automatically
• LengthValidator / SameAsValidator — replaced format I18n.t(...) with translate

Spec — I18n isolation

• translation_spec: new spec for Grape::Util::Translation directly, including I18n::ReservedInterpolationKey propagation
• coerce_validator_spec: replaced I18n.load_path << mutation with store_translations; uses I18n.with_locale at call sites; no global locale mutation
• base_i18n_spec: new spec verifying request-time locale is used regardless of the locale active at definition time
• base_spec: all I18n state changes (available_locales, enforce_available_locales) are self-contained via around + ensure
• validation_spec: expanded with Hash message (interpolation), Proc message, and String message cases
• Deleted zh-CN.yml: translations stored inline via store_translations

Test plan

• bundle exec rspec
• bundle exec rspec --seed 16961 (order-sensitive check)

🤖 Generated with Claude Code

[github-actions]

Danger Report

No issues found.

View run