ultra_settings 2.8.0 → 2.9.0

data/lib/ultra_settings/audit_data_sources.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module UltraSettings
+  class AuditDataSources
+    class << self
+      # Find environment variables that are set but have the same value as their default.
+      # These environment variables could potentially be removed since they're not changing behavior.
+      #
+      # @return [Array<Array<(String, Object)>>] An array of tuples containing environment variable names and their default values
+      def unnecessary_env_vars
+        env_vars_at_default = []
+        each_configuration do |config|
+          each_field_using_source(config, :env) do |field|
+            value = config[field.name]
+            default_value = default_config_value(config, field)
+            env_vars_at_default << [field.env_var, default_value] if default_value == value
+          end
+        end
+        env_vars_at_default
+      end
+
+      # Find runtime settings that are set but have the same value as their default.
+      # These runtime settings could potentially be removed since they're not changing behavior.
+      #
+      # @return [Array<Array<(String, Object)>>] An array of tuples containing runtime setting names and their default values
+      def unnecessary_runtime_settings
+        unnecessary_runtime_settings = []
+        each_configuration do |config|
+          each_field_using_source(config, :settings) do |field|
+            value = config[field.name]
+            default_value = default_config_value(config, field)
+            unnecessary_runtime_settings << [field.runtime_setting, default_value] if default_value == value
+          end
+        end
+        unnecessary_runtime_settings
+      end
+
+      # Find environment variables that could be moved to runtime settings.
+      # These are non-default environment variable values where a runtime setting is also available.
+      #
+      # @return [Array<Array<(String, String, Object)>>] An array of tuples containing environment variable name, runtime setting name, and current value
+      def env_vars_can_be_runtime_setting
+        env_vars_can_be_runtime = []
+        each_configuration do |config|
+          each_field_using_source(config, :env) do |field|
+            value = config[field.name]
+            default_value = default_config_value(config, field)
+            next unless field.runtime_setting && value != default_value
+
+            env_vars_can_be_runtime << [field.env_var, field.runtime_setting, value]
+          end
+        end
+        env_vars_can_be_runtime
+      end
+
+      # Find environment variables being used that don't have default values defined.
+      # These configurations require an environment variable to be set.
+      #
+      # @return [Array<Array<(String, Symbol, String, Object)>>] An array of tuples containing class name, field name, environment variable name, and current value
+      def env_vars_without_default
+        no_default_env_var_fields = []
+        each_configuration do |config|
+          each_field_using_source(config, :env) do |field|
+            value = default_config_value(config, field)
+            if value.nil?
+              no_default_env_var_fields << [config.class.name, field.name, field.env_var, config[field.name]]
+            end
+          end
+        end
+        no_default_env_var_fields
+      end
+
+      private
+
+      def each_configuration(&_block)
+        UltraSettings::Configuration.descendant_configurations.each do |config_class|
+          config = config_class.instance
+          yield config
+        end
+      end
+
+      def each_field_using_source(config, source, &_block)
+        config.class.fields.each do |field|
+          next if field.secret?
+          next unless config.__source__(field.name) == source
+
+          yield field
+        end
+      end
+
+      def default_config_value(config, field)
+        yaml_value = config.__value_from_source__(field.name, :yaml)
+        default_value = config.__value_from_source__(field.name, :default)
+        yaml_value || default_value
+      end
+    end
+  end
+end

data/lib/ultra_settings/coerce.rb

@@ -39,12 +39,6 @@ module UltraSettings
           array(value).map(&:to_s)
         when :symbol
           value.to_s.to_sym
-        when :rollout
-          if numeric?(value)
-            value.to_f
-          else
-            boolean(value)
-          end
         else
           value.to_s
         end

data/lib/ultra_settings/config_helper.rb

@@ -15,13 +15,13 @@ module UltraSettings
     #
     # @param config_class [Class] The configuration class to use.
     # @return [void]
-    def configuration_class(config_class)
-      define_singleton_method :config do
+    def configuration_class(config_class, config_alias: :config)
+      define_singleton_method config_alias do
         config_class.instance
       end
 
-      define_method :config do
-        self.class.config
+      define_method config_alias do
+        self.class.send(config_alias)
       end
     end
   end

data/lib/ultra_settings/configuration.rb

@@ -10,6 +10,7 @@ module UltraSettings
     @env_var_prefix = nil
     @runtime_setting_prefix = nil
     @description = nil
+    @descendants = []
 
     class << self
       # Set a description for the configuration. This is optional. It will be displayed
@@ -84,7 +85,8 @@ module UltraSettings
           secret: secret
         )
 
-        class_eval <<~RUBY, __FILE__, __LINE__ + 1 # rubocop:disable Security/Eval
+        caller_location = caller_locations(1, 1).first
+        class_eval <<~RUBY, caller_location.path, caller_location.lineno # rubocop:disable Security/Eval, Style/EvalWithLocation
           def #{name}
             __get_value__(#{name.inspect})
           end
@@ -110,7 +112,7 @@ module UltraSettings
         name = name.to_s
         return true if defined_fields.include?(name)
 
-        if superclass <= Configuration
+        if superclass < Configuration
           superclass.include_field?(name)
         else
           false
@@ -180,7 +182,7 @@ module UltraSettings
 
           @configuration_file = default_configuration_file
         end
-        return nil? unless @configuration_file
+        return nil unless @configuration_file
 
         path = @configuration_file
         if path.relative? && yaml_config_path
@@ -369,12 +371,30 @@ module UltraSettings
         YamlConfig.new(configuration_file, yaml_config_env).to_h
       end
 
+      # Get all descendant configuration classes (subclasses and their subclasses, recursively).
+      #
+      # @return [Array<Class>] All classes that inherit from this class.
+      def descendant_configurations
+        @descendants ||= []
+        @descendants.flat_map { |subclass| [subclass] + subclass.descendant_configurations }
+      end
+
       private
 
+      # Hook called when this class is inherited. Tracks all descendant classes.
+      #
+      # @param subclass [Class] The subclass that is inheriting from this class.
+      # @return [void]
+      def inherited(subclass)
+        super
+        @descendants ||= []
+        @descendants << subclass
+      end
+
       def defined_fields
         unless defined?(@defined_fields)
           fields = {}
-          if superclass <= Configuration
+          if superclass < Configuration
             fields = superclass.send(:defined_fields).dup
           end
           @defined_fields = fields
@@ -540,7 +560,7 @@ module UltraSettings
 
       sources = []
       sources << :env if field.env_var
-      sources << :settings if field.runtime_setting && UltraSettings.__runtime_settings__
+      sources << :settings if !field.static? && field.runtime_setting && UltraSettings.__runtime_settings__
       sources << :yaml if field.yaml_key && self.class.configuration_file
       sources << :default unless field.default.nil?
       sources
@@ -572,7 +592,8 @@ module UltraSettings
       field = self.class.send(:defined_fields)[name]
       return nil unless field
 
-      use_override = @ultra_settings_override_values[Thread.current.object_id]&.include?(name)
+      override_values = @ultra_settings_mutex.synchronize { @ultra_settings_override_values[Thread.current.object_id] }
+      use_override = override_values&.include?(name)
 
       if field.static? && !use_override && @ultra_settings_memoized_values.include?(name)
         return @ultra_settings_memoized_values[name]
@@ -580,7 +601,7 @@ module UltraSettings
 
       value = nil
       if use_override
-        value = field.coerce(@ultra_settings_override_values[Thread.current.object_id][name])
+        value = field.coerce(override_values[name])
       else
         env = ENV if field.env_var
         settings = UltraSettings.__runtime_settings__ if field.runtime_setting

data/lib/ultra_settings/configuration_view.rb

@@ -16,16 +16,18 @@ module UltraSettings
     # Initialize the configuration view with a configuration instance.
     #
     # @param configuration [UltraSettings::Configuration] The configuration instance to display.
-    def initialize(configuration)
+    # @param locale [String] The locale code for translations.
+    def initialize(configuration, locale: UltraSettings::MiniI18n::DEFAULT_LOCALE)
       @configuration = configuration
+      @locale = locale
     end
 
     # Render the HTML for the configuration view.
     #
-    # @param table_class [String] CSS class for the table element (maintained for backwards compatibility).
+    # @param table_class [String] @deprecated CSS class for the table element (maintained for backwards compatibility).
     # @return [String] The rendered HTML.
     def render(table_class: "")
-      configuration = @configuration
+      configuration = @configuration # used by ERB template via binding
       html = ViewHelper.erb_template("configuration.html.erb").result(binding)
       html = html.html_safe if html.respond_to?(:html_safe)
       html
@@ -40,6 +42,25 @@ module UltraSettings
 
     private
 
+    # Map an UltraSettings field type to a SuperSettings value type.
+    #
+    # @param type [Symbol] The UltraSettings field type.
+    # @return [String] The corresponding SuperSettings value type.
+    def super_settings_value_type(type)
+      case type.to_sym
+      when :symbol then "string"
+      else type.to_s
+      end
+    end
+
+    # Look up a translation key for the current locale.
+    #
+    # @param key [String] dotted translation key
+    # @return [String]
+    def t(key)
+      UltraSettings::MiniI18n.t(key, locale: @locale)
+    end
+
     def display_value(value)
       case value
       when Time
@@ -49,35 +70,9 @@ module UltraSettings
       end
     end
 
-    def show_defined_value(label, value, secret)
-      val = nil
-      icon = nil
-      css_class = nil
-
-      if value.nil?
-        val = "Not set"
-        icon = not_set_icon
-        css_class = "ultra-settings-icon-not-set"
-      elsif secret
-        val = secret_value(value)
-        icon = lock_icon
-        css_class = "ultra-settings-icon-secret"
-      else
-        val = display_value(value)
-        icon = eye_icon
-        css_class = "ultra-settings-icon-info"
-      end
-
-      <<~HTML
-        <dfn class="#{css_class}" title="#{html_escape(val)}" onclick="#{html_escape(open_dialog_script)}" data-label="#{html_escape(label)}">
-          #{icon}
-        </dfn>
-      HTML
-    end
-
     def secret_value(value)
       if value.nil?
-        "nil"
+        t("field.nil")
       else
         "••••••••••••••••"
       end
@@ -92,28 +87,102 @@ module UltraSettings
       path.relative_path_from(root_path)
     end
 
-    def info_icon(size = 16)
+    def source_chip_label(source)
+      case source
+      when :env then t("source.env")
+      when :settings then t("source.setting")
+      when :yaml then t("source.yaml")
+      when :default then t("source.default")
+      else source.to_s.upcase
+      end
+    end
+
+    def source_chip_class(source)
+      case source
+      when :env then "ultra-settings-chip-env"
+      when :settings then "ultra-settings-chip-setting"
+      when :yaml then "ultra-settings-chip-yaml"
+      when :default then "ultra-settings-chip-default"
+      else "ultra-settings-chip-default"
+      end
+    end
+
+    def source_key_name(field, source)
+      case source
+      when :env then field.env_var
+      when :settings then field.runtime_setting
+      when :yaml then field.yaml_key
+      when :default then nil
+      end
+    end
+
+    def open_panel_script
+      <<~JAVASCRIPT.gsub(/\s+/, " ").tr('"', "'")
+        var el = this;
+        var panel = document.getElementById('ultra-settings-detail-panel');
+        if (panel) {
+          var name = el.dataset.name || '';
+          var value = el.dataset.value || '';
+          var type = el.dataset.type || '';
+          var isSecret = el.dataset.secret || 'false';
+          document.getElementById('ultra-settings-dp-title').textContent = name;
+          document.getElementById('ultra-settings-dp-value').textContent = isSecret === 'true' ? window.__ultraSettingsI18n['detail.secret_value'] : value;
+          document.getElementById('ultra-settings-dp-meta').innerHTML = window.__ultraSettingsI18n['detail.type_label'] + ' <span>' + type.toUpperCase() + '</span>' + (isSecret === 'true' ? ' \u00B7 <span style=color:var(--badge-secret-text)>' + window.__ultraSettingsI18n['detail.secret_badge'] + '</span>' : '');
+          document.getElementById('ultra-settings-panel-bg').classList.add('open');
+          panel.classList.add('open');
+        } else {
+          var block = el.closest('.ultra-settings-block');
+          if (block) {
+            var dialog = block.querySelector('.ultra-settings-dialog');
+            if (dialog) {
+              var title = dialog.querySelector('.ultra-settings-dialog-title');
+              var val = dialog.querySelector('.ultra-settings-dialog-value');
+              if (title) title.textContent = el.dataset.name || '';
+              if (val) val.textContent = el.dataset.value || '';
+              dialog.showModal();
+            }
+          }
+        }
+      JAVASCRIPT
+    end
+
+    def source_priority
+      [:env, :settings, :yaml, :default]
+    end
+
+    def source_overridden_by(current_source, active_source)
+      return nil if current_source == active_source
+
+      current_index = source_priority.index(current_source)
+      active_index = source_priority.index(active_source)
+
+      return nil if current_index.nil? || active_index.nil?
+      return nil if current_index < active_index
+
+      active_source
+    end
+
+    def lock_icon(size = 16)
       <<~HTML
         <svg width="#{size}" height="#{size}" fill="currentColor" viewBox="0 0 16 16">
-          <path d="M8 15A7 7 0 1 1 8 1a7 7 0 0 1 0 14m0 1A8 8 0 1 0 8 0a8 8 0 0 0 0 16"/>
-          <path d="m8.93 6.588-2.29.287-.082.38.45.083c.294.07.352.176.288.469l-.738 3.468c-.194.897.105 1.319.808 1.319.545 0 1.178-.252 1.465-.598l.088-.416c-.2.176-.492.246-.686.246-.275 0-.375-.193-.304-.533zM9 4.5a1 1 0 1 1-2 0 1 1 0 0 1 2 0"/>
+          <path fill-rule="evenodd" d="M8 0a4 4 0 0 1 4 4v2.05a2.5 2.5 0 0 1 2 2.45v5a2.5 2.5 0 0 1-2.5 2.5h-7A2.5 2.5 0 0 1 2 13.5v-5a2.5 2.5 0 0 1 2-2.45V4a4 4 0 0 1 4-4m0 1a3 3 0 0 0-3 3v2h6V4a3 3 0 0 0-3-3"/>
         </svg>
       HTML
     end
 
-    def not_set_icon(size = 16)
+    def pin_icon(size = 16)
       <<~HTML
         <svg width="#{size}" height="#{size}" fill="currentColor" viewBox="0 0 16 16">
-          <path d="M8 15A7 7 0 1 1 8 1a7 7 0 0 1 0 14m0 1A8 8 0 1 0 8 0a8 8 0 0 0 0 16"/>
-          <path d="M11.354 4.646a.5.5 0 0 0-.708 0l-6 6a.5.5 0 0 0 .708.708l6-6a.5.5 0 0 0 0-.708"/>
+          <path d="M4.146.146A.5.5 0 0 1 4.5 0h7a.5.5 0 0 1 .5.5c0 .68-.342 1.174-.646 1.479-.126.125-.25.224-.354.298v4.431l.078.048c.203.127.476.314.751.555C12.36 7.775 13 8.527 13 9.5a.5.5 0 0 1-.5.5h-4v4.5a.5.5 0 0 1-1 0V10h-4A.5.5 0 0 1 3 9.5c0-.973.64-1.725 1.17-2.189A6 6 0 0 1 5 6.708V2.277a3 3 0 0 1-.354-.298C4.342 1.674 4 1.179 4 .5a.5.5 0 0 1 .146-.354"/>
         </svg>
       HTML
     end
 
-    def lock_icon(size = 16)
+    def file_icon(size = 13)
       <<~HTML
-        <svg width="#{size}" height="#{size}" fill="currentColor" viewBox="0 0 16 16">
-          <path fill-rule="evenodd" d="M8 0a4 4 0 0 1 4 4v2.05a2.5 2.5 0 0 1 2 2.45v5a2.5 2.5 0 0 1-2.5 2.5h-7A2.5 2.5 0 0 1 2 13.5v-5a2.5 2.5 0 0 1 2-2.45V4a4 4 0 0 1 4-4m0 1a3 3 0 0 0-3 3v2h6V4a3 3 0 0 0-3-3"/>
+        <svg width="#{size}" height="#{size}" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+          <path d="M13 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V9z"/>
+          <polyline points="13 2 13 9 20 9"/>
         </svg>
       HTML
     end
@@ -127,31 +196,23 @@ module UltraSettings
       HTML
     end
 
-    def eye_icon(size = 16)
+    def close_icon(size = 16)
       <<~HTML
-        <svg width="#{size}" height="#{size}" fill="currentColor" viewBox="0 0 16 16">
-          <path d="M16 8s-3-5.5-8-5.5S0 8 0 8s3 5.5 8 5.5S16 8 16 8M1.173 8a13 13 0 0 1 1.66-2.043C4.12 4.668 5.88 3.5 8 3.5s3.879 1.168 5.168 2.457A13 13 0 0 1 14.828 8q-.086.13-.195.288c-.335.48-.83 1.12-1.465 1.755C11.879 11.332 10.119 12.5 8 12.5s-3.879-1.168-5.168-2.457A13 13 0 0 1 1.172 8z"/>
-          <path d="M8 5.5a2.5 2.5 0 1 0 0 5 2.5 2.5 0 0 0 0-5M4.5 8a3.5 3.5 0 1 1 7 0 3.5 3.5 0 0 1-7 0"/>
+        <svg width="#{size}" height="#{size}" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round">
+          <line x1="18" y1="6" x2="6" y2="18"/>
+          <line x1="6" y1="6" x2="18" y2="18"/>
         </svg>
       HTML
     end
 
-    def close_icon(size = 16)
+    def warning_icon(size = 16)
       <<~HTML
-        <svg width="#{size}" height="#{size}" fill="currentColor" viewBox="0 0 16 16">
-          <path d="M8 15A7 7 0 1 1 8 1a7 7 0 0 1 0 14m0 1A8 8 0 1 0 8 0a8 8 0 0 0 0 16"/>
-          <path d="M4.646 4.646a.5.5 0 0 1 .708 0L8 7.293l2.646-2.647a.5.5 0 0 1 .708.708L8.707 8l2.647 2.646a.5.5 0 0 1-.708.708L8 8.707l-2.646 2.647a.5.5 0 0 1-.708-.708L7.293 8 4.646 5.354a.5.5 0 0 1 0-.708"/>
+        <svg width="#{size}" height="#{size}" viewBox="0 0 24 24" fill="none" stroke="currentColor" xmlns="http://www.w3.org/2000/svg">
+          <path d="M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z" stroke-width="2" stroke-linejoin="round"/>
+          <line x1="12" y1="10" x2="12" y2="14" stroke-width="2.5" stroke-linecap="round"/>
+          <circle cx="12" cy="17" r="1" fill="currentColor"/>
         </svg>
       HTML
     end
-
-    def open_dialog_script
-      <<~JAVASCRIPT.gsub(/\s+/, " ").tr('"', "'")
-        this.closest('.ultra-settings-configuration').querySelector('.ultra-settings-dialog-title').textContent = this.dataset.label;
-        this.closest('.ultra-settings-configuration').querySelector('.ultra-settings-dialog-value').textContent = this.title;
-        this.closest('.ultra-settings-configuration').querySelector('.ultra-settings-dialog').showModal();
-        this.closest('.ultra-settings-configuration').querySelector('.ultra-settings-dialog-close').blur();
-      JAVASCRIPT
-    end
   end
 end

data/lib/ultra_settings/mini_i18n.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+require "json"
+
+module UltraSettings
+  # Internationalization support for the web UI. Translations are stored as
+  # JSON files in +app/locales/+ with one file per locale (e.g. +en.json+).
+  #
+  # Ruby templates use `#t` to look up a dotted key. JavaScript receives the
+  # full translation hash inlined via a +<script>+ tag so that the same JSON
+  # file drives both server-side and client-side strings.
+  module MiniI18n
+    DEFAULT_LOCALE = "en"
+
+    @cache = {}
+    @mutex = Mutex.new
+
+    class << self
+      # Return the list of available locale codes derived from the JSON files
+      # present in +app/locales/+.
+      #
+      # @return [Array<String>] locale codes, e.g. +["en"]+
+      def available_locales
+        load_all_locales.keys.sort
+      end
+
+      # Look up a translation by dotted key for the given locale.
+      # Falls back to the default locale when the key is missing, and
+      # ultimately returns the key itself if no translation is found.
+      #
+      # @param key [String] dotted translation key, e.g. +"page.title"+
+      # @param locale [String] the locale code (default: +DEFAULT_LOCALE+)
+      # @return [String] the translated string
+      def t(key, locale: DEFAULT_LOCALE)
+        translations = translations_for(locale)
+        translations[key] || translations_for(DEFAULT_LOCALE)[key] || key
+      end
+
+      # Return the full translation hash for a locale. Used to inline
+      # translations into the HTML page for JavaScript consumption.
+      #
+      # @param locale [String] the locale code
+      # @return [Hash<String, String>] all key/value translations
+      def translations_for(locale)
+        load_all_locales[normalize_locale(locale)] || load_all_locales[DEFAULT_LOCALE] || {}
+      end
+
+      # Return the text direction for the given locale. Reads the +"dir"+ key
+      # from the locale's translations hash, falling back to +"ltr"+ when not set.
+      #
+      # @param locale [String] the locale code
+      # @return [String] +"ltr"+ or +"rtl"+
+      def text_direction(locale = DEFAULT_LOCALE)
+        dir = translations_for(locale)["dir"]
+        (dir == "rtl") ? "rtl" : "ltr"
+      end
+
+      # Clear the translation cache. Called automatically in development mode.
+      #
+      # @return [void]
+      def clear_cache!
+        @mutex.synchronize { @cache = {} }
+      end
+
+      private
+
+      # Normalize a locale string to just the language subtag if the full
+      # tag is not available (e.g. "en-US" → "en").
+      def normalize_locale(locale)
+        locale = locale.to_s.strip.tr("_", "-").downcase
+        return locale if @cache.key?(locale)
+
+        # Try the language subtag (e.g. "en-us" → "en")
+        lang = locale.split("-").first
+        lang if @cache.key?(lang)
+      end
+
+      # Load every JSON file from the locales directory, keyed by filename
+      # stem (e.g. "en").
+      def load_all_locales
+        if development_mode?
+          @mutex.synchronize { @cache = {} }
+        end
+
+        return @cache unless @cache.empty?
+
+        @mutex.synchronize do
+          return @cache unless @cache.empty?
+
+          Dir.glob(File.join(locales_dir, "*.json")).each do |path|
+            code = File.basename(path, ".json").downcase
+            @cache[code] = JSON.parse(File.read(path))
+          rescue JSON::ParserError
+            # Skip malformed locale files
+          end
+        end
+
+        @cache
+      end
+
+      def locales_dir
+        File.expand_path(File.join("..", "..", "app", "locales"), __dir__)
+      end
+
+      def development_mode?
+        ENV.fetch("RACK_ENV", "development") == "development"
+      end
+    end
+  end
+end

data/lib/ultra_settings/rack_app.rb

@@ -18,7 +18,9 @@ module UltraSettings
     # @param env [Hash] The Rack environment.
     # @return [Array] A Rack response array [status, headers, body].
     def call(env)
-      [200, {"content-type" => "text/html; charset=utf8"}, [webview.render_settings]]
+      request = Rack::Request.new(env)
+      locale = resolve_locale(request)
+      [200, {"content-type" => "text/html; charset=utf8"}, [webview.render_settings(request, locale: locale)]]
     end
 
     private
@@ -29,5 +31,53 @@ module UltraSettings
       end
       @webview ||= WebView.new(color_scheme: @color_scheme)
     end
+
+    # Determine the locale for a request. Precedence:
+    # 1. ?lang= query parameter
+    # 2. ultra_settings_locale cookie (set by the language picker)
+    # 3. Accept-Language header
+    # 4. Default locale
+    def resolve_locale(request)
+      available = UltraSettings::MiniI18n.available_locales
+
+      # 1. Explicit query parameter
+      lang = request.params["lang"] if request.respond_to?(:params)
+      return lang if lang && available.include?(lang)
+
+      # 2. Cookie
+      cookie = request.cookies["ultra_settings_locale"] if request.respond_to?(:cookies)
+      return cookie if cookie && available.include?(cookie)
+
+      # 3. Accept-Language header
+      accept = request.env["HTTP_ACCEPT_LANGUAGE"] if request.respond_to?(:env)
+      locale_from_accept_language(accept.to_s, available) || UltraSettings::MiniI18n::DEFAULT_LOCALE
+    end
+
+    # Parse the Accept-Language header and return the best matching locale.
+    def locale_from_accept_language(header, available)
+      return nil if header.nil? || header.empty?
+
+      # Parse tags with optional quality values, e.g. "en-US,en;q=0.9,fr;q=0.8"
+      tags = header.split(",").map { |entry|
+        parts = entry.strip.split(";")
+        tag = parts[0].to_s.strip.downcase.tr("_", "-")
+        q = 1.0
+        parts[1..-1].each do |p|
+          if p.strip.start_with?("q=")
+            q = p.strip.sub("q=", "").to_f
+          end
+        end
+        [tag, q]
+      }.sort_by { |_, q| -q }
+
+      tags.each do |tag, _|
+        return tag if available.include?(tag)
+        # Try language subtag
+        lang = tag.split("-").first
+        return lang if available.include?(lang)
+      end
+
+      nil
+    end
   end
 end

data/lib/ultra_settings/railtie.rb

@@ -23,6 +23,8 @@ module UltraSettings
 
         app_config_dir = Rails.root.join(directory)
         app_config_dir.glob("**/*_configuration.rb").each do |file_path|
+          next unless file_path.file? && file_path.readable?
+
           relative_path = file_path.relative_path_from(app_config_dir).to_s
           class_name = relative_path.chomp(".rb").classify
           unless UltraSettings.added?(class_name)
@@ -32,5 +34,11 @@ module UltraSettings
         end
       end
     end
+
+    rake_tasks do
+      Dir.glob(File.expand_path("tasks/*.rake", __dir__)).each do |rake_file|
+        load rake_file
+      end
+    end
   end
 end