ultra_settings 2.8.1 → 2.9.1

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

@@ -182,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
@@ -560,7 +560,7 @@ module UltraSettings
 
       sources = []
       sources << :env if field.env_var
-      sources << :settings if field.runtime_setting && UltraSettings.__runtime_settings__
+      sources << :settings if __runtime_setting_allowed?(field)
       sources << :yaml if field.yaml_key && self.class.configuration_file
       sources << :default unless field.default.nil?
       sources
@@ -592,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]
@@ -600,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
@@ -645,5 +646,14 @@ module UltraSettings
     def __yaml_config__
       @ultra_settings_yaml_config ||= self.class.load_yaml_config || {}
     end
+
+    def __runtime_setting_allowed?(field)
+      return false unless UltraSettings.__runtime_settings__
+      return false if field.static?
+      return false unless field.runtime_setting
+      return false if field.secret? && !UltraSettings.runtime_settings_secure?
+
+      true
+    end
   end
 end

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,22 +87,79 @@ module UltraSettings
       path.relative_path_from(root_path)
     end
 
-    def info_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"/>
-        </svg>
-      HTML
+    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 not_set_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"/>
-        </svg>
-      HTML
+    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)
@@ -118,77 +170,47 @@ module UltraSettings
       HTML
     end
 
-    def edit_icon(size = 16)
+    def pin_icon(size = 16)
       <<~HTML
         <svg width="#{size}" height="#{size}" fill="currentColor" viewBox="0 0 16 16">
-          <path d="M15.502 1.94a.5.5 0 0 1 0 .706L14.459 3.69l-2-2L13.502.646a.5.5 0 0 1 .707 0l1.293 1.293zm-1.75 2.456-2-2L4.939 9.21a.5.5 0 0 0-.121.196l-.805 2.414a.25.25 0 0 0 .316.316l2.414-.805a.5.5 0 0 0 .196-.12l6.813-6.814z"/>
-          <path fill-rule="evenodd" d="M1 13.5A1.5 1.5 0 0 0 2.5 15h11a1.5 1.5 0 0 0 1.5-1.5v-6a.5.5 0 0 0-1 0v6a.5.5 0 0 1-.5.5h-11a.5.5 0 0 1-.5-.5v-11a.5.5 0 0 1 .5-.5H9a.5.5 0 0 0 0-1H2.5A1.5 1.5 0 0 0 1 2.5z"/>
+          <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 eye_icon(size = 16)
+    def file_icon(size = 13)
       <<~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">
+          <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
 
-    def close_icon(size = 16)
+    def edit_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"/>
+          <path d="M15.502 1.94a.5.5 0 0 1 0 .706L14.459 3.69l-2-2L13.502.646a.5.5 0 0 1 .707 0l1.293 1.293zm-1.75 2.456-2-2L4.939 9.21a.5.5 0 0 0-.121.196l-.805 2.414a.25.25 0 0 0 .316.316l2.414-.805a.5.5 0 0 0 .196-.12l6.813-6.814z"/>
+          <path fill-rule="evenodd" d="M1 13.5A1.5 1.5 0 0 0 2.5 15h11a1.5 1.5 0 0 0 1.5-1.5v-6a.5.5 0 0 0-1 0v6a.5.5 0 0 1-.5.5h-11a.5.5 0 0 1-.5-.5v-11a.5.5 0 0 1 .5-.5H9a.5.5 0 0 0 0-1H2.5A1.5 1.5 0 0 0 1 2.5z"/>
         </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
-
-    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 override_indicator(overridden_by_source)
-      source_names = {
-        env: "environment variable",
-        settings: "runtime setting",
-        yaml: "configuration file",
-        default: "default value"
-      }
+    def close_icon(size = 16)
       <<~HTML
-        <span class="ultra-settings-source-override" title="Overridden by #{source_names[overridden_by_source]}">
-          #{warning_icon(14)}
-          <span class="ultra-settings-source-override-text">Overridden by #{source_names[overridden_by_source]}</span>
-        </span>
+        <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 warning_icon(size = 16)
       <<~HTML
-        <svg width="#{size}" height="#{size}" fill="currentColor" viewBox="0 0 16 16">
-          <path d="M8.982 1.566a1.13 1.13 0 0 0-1.96 0L.165 13.233c-.457.778.091 1.767.98 1.767h13.713c.889 0 1.438-.99.98-1.767zM8 5c.535 0 .954.462.9.995l-.35 3.507a.552.552 0 0 1-1.1 0L7.1 5.995A.905.905 0 0 1 8 5m.002 6a1 1 0 1 1 0 2 1 1 0 0 1 0-2"/>
+        <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

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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module UltraSettings
-  VERSION = File.read(File.join(__dir__, "..", "..", "VERSION")).strip
+  VERSION = File.read(File.expand_path("../../VERSION", __dir__)).strip.freeze
 end

data/lib/ultra_settings/web_view.rb

@@ -3,6 +3,8 @@
 module UltraSettings
   # Helper class for rendering the settings information in an HTML page.
   class WebView
+    include RenderHelper
+
     attr_reader :layout_css
 
     # Initialize a new WebView with the specified color scheme.
@@ -17,8 +19,13 @@ module UltraSettings
 
     # Render the complete settings page HTML.
     #
+    # @param request [Rack::Request, nil] The current Rack request for access control.
+    # @param locale [String] The locale code for translations.
     # @return [String] The rendered HTML page.
-    def render_settings
+    def render_settings(request = nil, locale: UltraSettings::MiniI18n::DEFAULT_LOCALE)
+      @request = request
+      @locale = locale
+      refresh_super_settings!
       @layout_template.result(binding)
     end
 
@@ -26,7 +33,25 @@ module UltraSettings
     #
     # @return [String] The HTML content for the settings.
     def content
-      UltraSettings::ApplicationView.new(color_scheme: @color_scheme).render
+      UltraSettings::ApplicationView.new(
+        color_scheme: @color_scheme,
+        locale: @locale || UltraSettings::MiniI18n::DEFAULT_LOCALE
+      ).render
+    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 || UltraSettings::MiniI18n::DEFAULT_LOCALE)
+    end
+
+    # Return the text direction (+"ltr"+ or +"rtl"+) for the current locale.
+    #
+    # @return [String]
+    def text_direction
+      UltraSettings::MiniI18n.text_direction(@locale || UltraSettings::MiniI18n::DEFAULT_LOCALE)
     end
 
     private
@@ -36,5 +61,11 @@ module UltraSettings
       css = ViewHelper.read_app_file("layout.css")
       "#{vars}\n#{css}"
     end
+
+    def refresh_super_settings!
+      return unless defined?(SuperSettings) && UltraSettings.__runtime_settings__ == SuperSettings
+
+      SuperSettings.refresh_settings
+    end
   end
 end