i18n-js 3.3.0 → 3.9.2

data/app/assets/javascripts/i18n/shims.js

@@ -33,7 +33,7 @@ if (!Array.prototype.indexOf) {
 }
 
 // Production steps of ECMA-262, Edition 5, 15.4.4.18
-// Reference: http://es5.github.com/#x15.4.4.18
+// Reference: https://es5.github.com/#x15.4.4.18
 // https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/Array/forEach
 if ( !Array.prototype.forEach ) {
 
@@ -53,7 +53,7 @@ if ( !Array.prototype.forEach ) {
     var len = O.length >>> 0; // Hack to convert O.length to a UInt32
 
     // 4. If IsCallable(callback) is false, throw a TypeError exception.
-    // See: http://es5.github.com/#x9.11
+    // See: https://es5.github.com/#x9.11
     if ( {}.toString.call(callback) !== "[object Function]" ) {
       throw new TypeError( callback + " is not a function" );
     }
@@ -139,7 +139,7 @@ if (!Array.prototype.map) {
     var len = O.length >>> 0;
 
     // 4. If IsCallable(callback) is false, throw a TypeError exception.
-    // See: http://es5.github.com/#x9.11
+    // See: https://es5.github.com/#x9.11
     if (typeof callback !== 'function') {
       throw new TypeError(callback + ' is not a function');
     }
@@ -206,3 +206,35 @@ if (!Array.prototype.map) {
     return A;
   };
 }
+
+// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_objects/Function/bind
+if (!Function.prototype.bind) (function(){
+  var ArrayPrototypeSlice = Array.prototype.slice;
+  Function.prototype.bind = function(otherThis) {
+    if (typeof this !== 'function') {
+      // closest thing possible to the ECMAScript 5
+      // internal IsCallable function
+      throw new TypeError('Function.prototype.bind - what is trying to be bound is not callable');
+    }
+
+    var baseArgs= ArrayPrototypeSlice .call(arguments, 1),
+        baseArgsLength = baseArgs.length,
+        fToBind = this,
+        fNOP    = function() {},
+        fBound  = function() {
+          baseArgs.length = baseArgsLength; // reset to default base arguments
+          baseArgs.push.apply(baseArgs, arguments);
+          return fToBind.apply(
+                 fNOP.prototype.isPrototypeOf(this) ? this : otherThis, baseArgs
+          );
+        };
+
+    if (this.prototype) {
+      // Function.prototype doesn't have a prototype property
+      fNOP.prototype = this.prototype; 
+    }
+    fBound.prototype = new fNOP();
+
+    return fBound;
+  };
+})();

data/app/assets/javascripts/i18n.js

@@ -269,23 +269,23 @@
     }
 
     // Locale code format 1:
-    // According to RFC4646 (http://www.ietf.org/rfc/rfc4646.txt)
+    // According to RFC4646 (https://www.ietf.org/rfc/rfc4646.txt)
     // language codes for Traditional Chinese should be `zh-Hant`
     //
     // But due to backward compatibility
     // We use older version of IETF language tag
-    // @see http://www.w3.org/TR/html401/struct/dirlang.html
-    // @see http://en.wikipedia.org/wiki/IETF_language_tag
+    // @see https://www.w3.org/TR/html401/struct/dirlang.html
+    // @see https://en.wikipedia.org/wiki/IETF_language_tag
     //
     // Format: `language-code = primary-code ( "-" subcode )*`
     //
     // primary-code uses ISO639-1
-    // @see http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
-    // @see http://www.iso.org/iso/home/standards/language_codes.htm
+    // @see https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
+    // @see https://www.iso.org/iso/home/standards/language_codes.htm
     //
     // subcode uses ISO 3166-1 alpha-2
-    // @see http://en.wikipedia.org/wiki/ISO_3166
-    // @see http://www.iso.org/iso/country_codes.htm
+    // @see https://en.wikipedia.org/wiki/ISO_3166
+    // @see https://www.iso.org/iso/country_codes.htm
     //
     // @note
     //   subcode can be in upper case or lower case
@@ -402,7 +402,7 @@
 
     while (locales.length) {
       locale = locales.shift();
-      scopes = fullScope.split(this.defaultSeparator);
+      scopes = fullScope.split(options.separator || this.defaultSeparator);
       translations = this.translations[locale];
 
       if (!translations) {
@@ -433,7 +433,7 @@
       , pluralizerKey
       , message;
 
-    if (isObject(translations)) {
+    if (translations && isObject(translations)) {
       while (pluralizerKeys.length) {
         pluralizerKey = pluralizerKeys.shift();
         if (isSet(translations[pluralizerKey])) {
@@ -459,7 +459,7 @@
 
     while (locales.length) {
       locale = locales.shift();
-      scopes = scope.split(this.defaultSeparator);
+      scopes = scope.split(options.separator || this.defaultSeparator);
       translations = this.translations[locale];
 
       if (!translations) {
@@ -679,13 +679,13 @@
       var s = scope.split('.').slice(-1)[0];
       //replace underscore with space && camelcase with space and lowercase letter
       return (this.missingTranslationPrefix.length > 0 ? this.missingTranslationPrefix : '') +
-          s.replace('_',' ').replace(/([a-z])([A-Z])/g,
+          s.replace(/_/g,' ').replace(/([a-z])([A-Z])/g,
           function(match, p1, p2) {return p1 + ' ' + p2.toLowerCase()} );
     }
 
     var localeForTranslation = (options != null && options.locale != null) ? options.locale : this.currentLocale();
     var fullScope           = this.getFullScope(scope, options);
-    var fullScopeWithLocale = [localeForTranslation, fullScope].join(this.defaultSeparator);
+    var fullScopeWithLocale = [localeForTranslation, fullScope].join(options.separator || this.defaultSeparator);
 
     return '[missing "' + fullScopeWithLocale + '" translation]';
   };
@@ -779,8 +779,8 @@
   I18n.toCurrency = function(number, options) {
     options = this.prepareOptions(
         options
-      , this.lookup("number.currency.format")
-      , this.lookup("number.format")
+      , this.lookup("number.currency.format", options)
+      , this.lookup("number.format", options)
       , CURRENCY_FORMAT
     );
 
@@ -799,17 +799,17 @@
 
     switch (scope) {
       case "currency":
-        return this.toCurrency(value);
+        return this.toCurrency(value, options);
       case "number":
-        scope = this.lookup("number.format");
+        scope = this.lookup("number.format", options);
         return this.toNumber(value, scope);
       case "percentage":
-        return this.toPercentage(value);
+        return this.toPercentage(value, options);
       default:
         var localizedValue;
 
         if (scope.match(/^(date|time)/)) {
-          localizedValue = this.toTime(scope, value);
+          localizedValue = this.toTime(scope, value, options);
         } else {
           localizedValue = value.toString();
         }
@@ -897,7 +897,7 @@
   //     %d     - Day of the month (01..31)
   //     %-d    - Day of the month (1..31)
   //     %H     - Hour of the day, 24-hour clock (00..23)
-  //     %-H    - Hour of the day, 24-hour clock (0..23)
+  //     %-H/%k - Hour of the day, 24-hour clock (0..23)
   //     %I     - Hour of the day, 12-hour clock (01..12)
   //     %-I/%l - Hour of the day, 12-hour clock (1..12)
   //     %m     - Month of the year (01..12)
@@ -914,8 +914,8 @@
   //     %Y     - Year with century
   //     %z/%Z  - Timezone offset (+0545)
   //
-  I18n.strftime = function(date, format) {
-    var options = this.lookup("date")
+  I18n.strftime = function(date, format, options) {
+    var options = this.lookup("date", options)
       , meridianOptions = I18n.meridian()
     ;
 
@@ -961,6 +961,7 @@
     format = format.replace("%-d", day);
     format = format.replace("%H", padding(hour));
     format = format.replace("%-H", hour);
+    format = format.replace("%k", hour);
     format = format.replace("%I", padding(hour12));
     format = format.replace("%-I", hour12);
     format = format.replace("%l", hour12);
@@ -983,9 +984,9 @@
   };
 
   // Convert the given dateString into a formatted date.
-  I18n.toTime = function(scope, dateString) {
+  I18n.toTime = function(scope, dateString, options) {
     var date = this.parseDate(dateString)
-      , format = this.lookup(scope)
+      , format = this.lookup(scope, options)
     ;
 
     // A date input of `null` or `undefined` will be returned as-is
@@ -1002,15 +1003,15 @@
       return date_string;
     }
 
-    return this.strftime(date, format);
+    return this.strftime(date, format, options);
   };
 
   // Convert a number into a formatted percentage value.
   I18n.toPercentage = function(number, options) {
     options = this.prepareOptions(
         options
-      , this.lookup("number.percentage.format")
-      , this.lookup("number.format")
+      , this.lookup("number.percentage.format", options)
+      , this.lookup("number.format", options)
       , PERCENTAGE_FORMAT
     );
 
@@ -1024,6 +1025,7 @@
       , iterations = 0
       , unit
       , precision
+      , fullScope
     ;
 
     while (size >= kb && iterations < 4) {
@@ -1032,10 +1034,12 @@
     }
 
     if (iterations === 0) {
-      unit = this.t("number.human.storage_units.units.byte", {count: size});
+      fullScope = this.getFullScope("number.human.storage_units.units.byte", options);
+      unit = this.t(fullScope, {count: size});
       precision = 0;
     } else {
-      unit = this.t("number.human.storage_units.units." + SIZE_UNITS[iterations]);
+      fullScope = this.getFullScope("number.human.storage_units.units." + SIZE_UNITS[iterations], options);
+      unit = this.t(fullScope);
       precision = (size - Math.floor(size) === 0) ? 0 : 1;
     }
 
@@ -1052,7 +1056,7 @@
 
     // Deal with the scope as an array.
     if (isArray(scope)) {
-      scope = scope.join(this.defaultSeparator);
+      scope = scope.join(options.separator || this.defaultSeparator);
     }
 
     // Deal with the scope option provided through the second argument.
@@ -1060,7 +1064,7 @@
     //    I18n.t('hello', {scope: 'greetings'});
     //
     if (options.scope) {
-      scope = [options.scope, scope].join(this.defaultSeparator);
+      scope = [options.scope, scope].join(options.separator || this.defaultSeparator);
     }
 
     return scope;
@@ -1083,9 +1087,9 @@
   };
 
   // Set aliases, so we can save some typing.
-  I18n.t = I18n.translate;
-  I18n.l = I18n.localize;
-  I18n.p = I18n.pluralize;
+  I18n.t = I18n.translate.bind(I18n);
+  I18n.l = I18n.localize.bind(I18n);
+  I18n.p = I18n.pluralize.bind(I18n);
 
   return I18n;
 }));

data/gemfiles/i18n_1_10.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "i18n", "~> 1.10.0"
+
+gemspec path: "../"

data/gemfiles/i18n_1_7.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "i18n", "~> 1.7.0"
+
+gemspec path: "../"

data/gemfiles/i18n_1_8.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "i18n", "~> 1.8.0"
+
+gemspec path: "../"

data/gemfiles/i18n_1_9.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "i18n", "~> 1.9.0"
+
+gemspec path: "../"

data/i18n-js.gemspec

@@ -8,7 +8,7 @@ Gem::Specification.new do |s|
   s.platform    = Gem::Platform::RUBY
   s.authors     = ["Nando Vieira"]
   s.email       = ["fnando.vieira@gmail.com"]
-  s.homepage    = "http://rubygems.org/gems/i18n-js"
+  s.homepage    = "https://rubygems.org/gems/i18n-js"
   s.summary     = "It's a small library to provide the Rails I18n translations on the Javascript."
   s.description = s.summary
   s.license       = "MIT"
@@ -20,7 +20,7 @@ Gem::Specification.new do |s|
 
   s.add_dependency "i18n", ">= 0.6.6"
 
-  s.add_development_dependency "appraisal", "~> 2.0"
+  s.add_development_dependency "appraisal", "~> 2.3"
   s.add_development_dependency "rspec", "~> 3.0"
   s.add_development_dependency "rake", "~> 12.0"
   s.add_development_dependency "gem-release", ">= 0.7"

data/lib/i18n/js/dependencies.rb

@@ -18,7 +18,7 @@ module I18n
         # Call this in an initializer
         def using_asset_pipeline?
           assets_pipeline_available =
-            (rails3? || rails4? || rails5? || rails6?) &&
+            (rails3? || rails4? || rails5? || rails6? || rails7?) &&
             Rails.respond_to?(:application) &&
             Rails.application.config.respond_to?(:assets)
           rails3_assets_enabled =
@@ -26,7 +26,7 @@ module I18n
             assets_pipeline_available &&
             Rails.application.config.assets.enabled != false
 
-          assets_pipeline_available && (rails4? || rails5? || rails6? || rails3_assets_enabled)
+          assets_pipeline_available && (rails4? || rails5? || rails6? || rails7? || rails3_assets_enabled)
         end
 
         private
@@ -46,6 +46,10 @@ module I18n
         def rails6?
           rails? && Rails.version.to_i == 6
         end
+        
+        def rails7?
+          rails? && Rails.version.to_i == 7
+        end
 
         def safe_gem_check(*args)
           if Gem::Specification.respond_to?(:find_by_name)

data/lib/i18n/js/engine.rb

@@ -21,7 +21,7 @@ module I18n
       # https://github.com/rails/sprockets-rails/blob/master/lib/sprockets/railtie.rb
       #
       # Finisher hook is the place which should be used as border.
-      # http://guides.rubyonrails.org/configuring.html#initializers
+      # https://guides.rubyonrails.org/configuring.html#initializers
       #
       # For detail see Pull Request:
       # https://github.com/fnando/i18n-js/pull/371

data/lib/i18n/js/formatters/base.rb

@@ -2,10 +2,12 @@ module I18n
   module JS
     module Formatters
       class Base
-        def initialize(js_extend: false, namespace: nil, pretty_print: false)
+        def initialize(js_extend: false, namespace: nil, pretty_print: false, prefix: nil, suffix: nil)
           @js_extend    = js_extend
           @namespace    = namespace
           @pretty_print = pretty_print
+          @prefix = prefix
+          @suffix = suffix
         end
 
         protected

data/lib/i18n/js/formatters/js.rb

@@ -4,25 +4,33 @@ module I18n
   module JS
     module Formatters
       class JS < Base
+        JSON_ESCAPE_MAP = {
+          "'" => "\\'",
+          "\\" => "\\\\"
+        }.freeze
+        private_constant :JSON_ESCAPE_MAP
+
         def format(translations)
           contents = header
           translations.each do |locale, translations_for_locale|
             contents << line(locale, format_json(translations_for_locale))
           end
-          contents
+          contents << (@suffix || '')
         end
 
         protected
 
         def header
-          %(#{@namespace}.translations || (#{@namespace}.translations = {});\n)
+          text = @prefix || ''
+          text + %(#{@namespace}.translations || (#{@namespace}.translations = {});\n)
         end
 
         def line(locale, translations)
+          json_literal = @pretty_print ? translations : %(JSON.parse('#{translations.gsub(/#{Regexp.union(JSON_ESCAPE_MAP.keys)}/){|match| JSON_ESCAPE_MAP.fetch(match) }}'))
           if @js_extend
-            %(#{@namespace}.translations["#{locale}"] = I18n.extend((#{@namespace}.translations["#{locale}"] || {}), #{translations});\n)
+            %(#{@namespace}.translations["#{locale}"] = I18n.extend((#{@namespace}.translations["#{locale}"] || {}), #{json_literal});\n)
           else
-            %(#{@namespace}.translations["#{locale}"] = #{translations};\n)
+            %(#{@namespace}.translations["#{locale}"] = #{json_literal};\n)
           end
         end
       end

data/lib/i18n/js/middleware.rb

@@ -45,7 +45,7 @@ module I18n
 
       def save_cache(new_cache)
         # path could be a symbolic link
-        FileUtils.mkdir_p(cache_dir) unless File.exists?(cache_dir)
+        FileUtils.mkdir_p(cache_dir) unless File.exist?(cache_dir)
         File.open(cache_path, "w+") do |file|
           file << new_cache.to_yaml
         end

data/lib/i18n/js/private/config_store.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "singleton"
+
+module I18n
+  module JS
+    # @api private
+    module Private
+      # Caching implementation for I18n::JS.config
+      #
+      # @api private
+      class ConfigStore
+        include Singleton
+
+        def fetch
+          return @config if @config
+
+          yield.tap do |obj|
+            raise ArgumentError, "unexpected falsy object from block" unless obj
+
+            @config = obj
+          end
+        end
+
+        def flush_cache
+          @config = nil
+        end
+      end
+    end
+  end
+end

data/lib/i18n/js/segment.rb

@@ -7,7 +7,7 @@ module I18n
 
     # Class which enscapulates a translations hash and outputs a single JSON translation file
     class Segment
-      OPTIONS = [:namespace, :pretty_print, :js_extend, :sort_translation_keys, :json_only].freeze
+      OPTIONS = [:namespace, :pretty_print, :js_extend, :prefix, :suffix, :sort_translation_keys, :json_only].freeze
       LOCALE_INTERPOLATOR = /%\{locale\}/
 
       attr_reader *([:file, :translations] | OPTIONS)
@@ -24,6 +24,8 @@ module I18n
         @namespace    = options[:namespace] || 'I18n'
         @pretty_print = !!options[:pretty_print]
         @js_extend    = options.key?(:js_extend) ? !!options[:js_extend] : true
+        @prefix       = options.key?(:prefix) ? options[:prefix] : nil
+        @suffix       = options.key?(:suffix) ? options[:suffix] : nil
         @sort_translation_keys = options.key?(:sort_translation_keys) ? !!options[:sort_translation_keys] : true
         @json_only = options.key?(:json_only) ? !!options[:json_only] : false
       end
@@ -31,7 +33,7 @@ module I18n
       # Saves JSON file containing translations
       def save!
         if @file =~ LOCALE_INTERPOLATOR
-          I18n.available_locales.each do |locale|
+          I18n::JS.js_available_locales.each do |locale|
             write_file(file_for_locale(locale), @translations.slice(locale))
           end
         else
@@ -48,6 +50,7 @@ module I18n
       def write_file(_file = @file, _translations = @translations)
         FileUtils.mkdir_p File.dirname(_file)
         _translations = Utils.deep_key_sort(_translations) if @sort_translation_keys
+        _translations = Utils.deep_remove_procs(_translations)
         contents = formatter.format(_translations)
 
         return if File.exist?(_file) && File.read(_file) == contents
@@ -68,7 +71,10 @@ module I18n
       def formatter_options
         { js_extend: @js_extend,
           namespace: @namespace,
-          pretty_print: @pretty_print }
+          pretty_print: @pretty_print,
+          prefix: @prefix,
+          suffix: @suffix
+        }
       end
     end
   end

data/lib/i18n/js/utils.rb

@@ -3,20 +3,25 @@ module I18n
     module Utils
       PLURAL_KEYS = %i[zero one two few many other].freeze
 
-      # Based on deep_merge by Stefan Rusterholz, see <http://www.ruby-forum.com/topic/142809>.
+      # Based on deep_merge by Stefan Rusterholz, see <https://www.ruby-forum.com/topic/142809>.
       # This method is used to handle I18n fallbacks. Given two equivalent path nodes in two locale trees:
       # 1. If the node in the current locale appears to be an I18n pluralization (:one, :other, etc.),
-      #    use the node as-is without merging. This prevents mixing locales with different pluralization schemes.
-      # 2. Else if both nodes are Hashes, combine (merge) the key-value pairs of the two nodes into one, 
+      #    use the node, but merge in any missing/non-nil keys from the fallback (default) locale.
+      # 2. Else if both nodes are Hashes, combine (merge) the key-value pairs of the two nodes into one,
       #    prioritizing the current locale.
       # 3. Else if either node is nil, use the other node.
+      PLURAL_MERGER = proc do |_key, v1, v2|
+        v1 || v2
+      end
       MERGER = proc do |_key, v1, v2|
-        if Hash === v2 && (v2.keys - PLURAL_KEYS).empty?
-          v2
-        elsif Hash === v1 && Hash === v2
-          v1.merge(v2, &MERGER)
+        if Hash === v1 && Hash === v2
+          if (v2.keys - PLURAL_KEYS).empty?
+            slice(v2.merge(v1, &PLURAL_MERGER), v2.keys)
+          else
+            v1.merge(v2, &MERGER)
+          end
         else
-          v2.nil? ? v1 : v2
+          v2 || v1
         end
       end
 
@@ -24,6 +29,14 @@ module I18n
         v.kind_of?(Hash) ? (v.delete_if(&HASH_NIL_VALUE_CLEANER_PROC); false) : v.nil?
       end
 
+      def self.slice(hash, keys)
+        if hash.respond_to?(:slice) # ruby 2.5 onwards
+          hash.slice(*keys)
+        else
+          hash.select {|key, _| keys.include?(key)}
+        end
+      end
+
       def self.strip_keys_with_nil_values(hash)
         hash.dup.delete_if(&HASH_NIL_VALUE_CLEANER_PROC)
       end
@@ -60,6 +73,19 @@ module I18n
           seed[key] = value.is_a?(Hash) ? deep_key_sort(value) : value
         end
       end
+
+      def self.deep_remove_procs(hash)
+        # procs exist in `i18n.plural.rule` as pluralizer
+        # But having it in translation causes the exported JS/JSON changes every time
+        # https://github.com/ruby-i18n/i18n/blob/v1.8.7/lib/i18n/backend/pluralization.rb#L51
+        hash.keys.
+          each_with_object({}) do |key, seed|
+          value = hash[key]
+          next if value.is_a?(Proc)
+
+          seed[key] = value.is_a?(Hash) ? deep_remove_procs(value) : value
+        end
+      end
     end
   end
 end

data/lib/i18n/js/version.rb

@@ -2,6 +2,6 @@
 
 module I18n
   module JS
-    VERSION = "3.3.0"
+    VERSION = "3.9.2"
   end
 end

data/lib/i18n/js.rb

@@ -4,6 +4,7 @@ require "i18n"
 
 require "i18n/js/utils"
 require "i18n/js/private/hash_with_symbol_keys"
+require "i18n/js/private/config_store"
 
 module I18n
   module JS
@@ -26,6 +27,8 @@ module I18n
 
     def self.config_file_path=(new_path)
       @config_file_path = new_path
+      # new config file path = need to re-read config from new file
+      Private::ConfigStore.instance.flush_cache
     end
 
     # Allow using a different backend than the one globally configured
@@ -78,7 +81,7 @@ module I18n
 
     # deep_merge! given result with result for fallback locale
     def self.merge_with_fallbacks!(result)
-      I18n.available_locales.each do |locale|
+      js_available_locales.each do |locale|
         fallback_locales = FallbackLocales.new(fallbacks, locale)
         fallback_locales.each do |fallback_locale|
           # `result[fallback_locale]` could be missing
@@ -108,14 +111,16 @@ module I18n
     # Load configuration file for partial exporting and
     # custom output directory
     def self.config
-      if config_file_exists?
-        erb_result_from_yaml_file = ERB.new(File.read(config_file_path)).result
-        Private::HashWithSymbolKeys.new(
-          (::YAML.load(erb_result_from_yaml_file) || {})
-        )
-      else
-        Private::HashWithSymbolKeys.new({})
-      end.freeze
+      Private::ConfigStore.instance.fetch do
+        if config_file_exists?
+          erb_result_from_yaml_file = ERB.new(File.read(config_file_path)).result
+          Private::HashWithSymbolKeys.new(
+            (::YAML.load(erb_result_from_yaml_file) || {})
+          )
+        else
+          Private::HashWithSymbolKeys.new({})
+        end.freeze
+      end
     end
 
     # @api private
@@ -178,7 +183,7 @@ module I18n
         #
         # So the input is wrapped by our class for better `#slice`
         Private::HashWithSymbolKeys.new(translations).
-          slice(*::I18n.available_locales).
+          slice(*::I18n::JS.js_available_locales).
           to_h
       end
     end
@@ -208,6 +213,16 @@ module I18n
       end
     end
 
+    # Get all available locales.
+    #
+    # @return [Array<Symbol>] the locales.
+    def self.js_available_locales
+      config.fetch(:js_available_locales) do
+        # default value
+        I18n.available_locales
+      end.map(&:to_sym)
+    end
+
     def self.sort_translation_keys?
       @sort_translation_keys ||= (config[:sort_translation_keys]) if config.key?(:sort_translation_keys)
       @sort_translation_keys = true if @sort_translation_keys.nil?