hanami 3.0.0.rc1 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0629b02399ba598bc3d4cbcd3c421b6312e06bee5f6e1f41a5608b2cac18ec0
-  data.tar.gz: fde643ae7b04a53c3047ff88f27856177bc16905e1bbe65ee577142ae1cdb35f
+  metadata.gz: 53f2d51070211158a50d0adfd0e4326c2647cd8dfb81135d74b5c09449213b24
+  data.tar.gz: f8c19c0c73096809f15176ed90c358be89dfda92adb8c418e1863c902b7835dc
 SHA512:
-  metadata.gz: 1a27833e74d730e9ba84222cf739a6e503d5ae733846ba0abf0ecc21d527fbb3e0f416902f37d82064d773b18456fe803f85fd7085a5367ba9a6744efaac49be
-  data.tar.gz: ac8e58a76c42b02a967c2d2c86769b019dc5f4321408d877250c446ddb851c4199a781e7594e4c0bca54f3211bcdd86093af6a5393127e380cc59227aa7af883
+  metadata.gz: a0b02ef4b8832c4de4d7ba33077ccde81a5412a1483e942fcf3ac8d179c6b5a4dc1ad23c2c597ef50cfb77f84034c6045679051c7c70e7bcc0c9ccd43f7414f0
+  data.tar.gz: 82fe7c7f69fc77c9a4cce6017a3b3e3dea90e3eb55aabc58205532c77711caab93cf2bc1824177a1d1840d5d723da12c7337a7a158390043fad9d7e5f88c7ea3

data/CHANGELOG.md

@@ -37,7 +37,55 @@ A complete Hanami app is composed of multiple gems. For a complete overview of c
 
 ### Security
 
-[unreleased]: https://github.com/hanami/hanami/compare/v3.0.0.rc1...HEAD
+[unreleased]: https://github.com/hanami/hanami/compare/v3.0.0...HEAD
+
+## [3.0.0] - 2026-06-30
+
+### Added
+
+- Integrate hanami-mailer gem when bundled. (@timriley in #1597, #1600, #1606, #1609)
+
+    Load templates from `templates/mailers/`. Register a `"mailers.delivery_method"`, which is either an SMTP mailer when `SMTP_ADDRESS`, `SMTP_PORT`, `SMTP_USERNAME`, `SMTP_PASSWORD`, `SMTP_AUTHENTICATION` env vars are present. These can also be prefixed with a slice name. Register a test delivery always in the test env, and also in other envs when the env vars are absent.
+- Integrate i18n gem when bundled. (@timriley in #1562, #1589, #1590, #1591, #1592, #1593)
+
+    Register an `"i18n"` component in each slice, which may be configured via `config.i18n` or a dedicated `:i18n` provider. Load translations from `config/i18n/` within each slice. Load shared translations from `config/i18n/shared/` at the app-level only. Bundle default English translations for `#localize`. Make helpers available in views and actions, which also prefix relative keys (with a leading ".") with their own dot-delimited template or action names.
+- Wrap the configured app logger with `Hanami::UniversalLogger`, to provide a consistent logging interface regardless of the underlying logger. The app can now be depended upon to support (1) structured logging via keyword args passed to log methods, and (2) tagged logging via `#tagged`. (@timriley in #1567, #1568, #1608)
+- Allow the built-in logger to be further configured in a `config/providers/logger.rb` provider file, useful for calling arbitrary methods on the logger, like adding backends. (@timriley in #1608)
+
+    ```ruby
+    Hanami.app.configure_provider :logger do
+      before :start do
+        logger.add_backend(
+          stream: Hanami.app.root.join("log", "payments.log"),
+          log_if: -> entry { entry.tag?(:payments) }
+        )
+      end
+    end
+    ```
+- Support `HANAMI_LOG_LEVEL` env var to set the log level (e.g. `HANAMI_LOG_LEVEL=warn bundle exec hanami server`). Takes precedence over `config.logger.level` set in `config/app.rb`. (@cllns in #1580)
+- Add `config.db.log_level` setting, for changing the log level for SQL logs. (@katafrakt in #1587)
+- New setting `:default_template_engine` that sets which template engine should be used by default when doing `hanami generate`. (@katafrakt in #1564)
+- Add `Hanami::Settings::CompositeStore`, which can be used to chain setting lookups from multiple stores. (@aaronmallen in #1572)
+- Add `Hanami::Slice.with_slices`, returning the slice and all its nested slices. (@timriley in #1604)
+
+### Changed
+
+- Default to memoizing all components, except in test env. Opt out for some or all components via `config.no_memoize`. (@timriley in #1573, #1599)
+- Colorize logs by default in development env. (@timriley in #1566)
+- Emit structured log entries for SQL queries, formatted consistently with request logs. (@timriley in #1569)
+- Syntax highlight SQL in logs when the rouge gem is bundled. (@timriley in #1570, #1607)
+- Colorize web request logs. (@timriley in #1571)
+- Change default log level for SQL (and other database) statements from `:info` to `:debug`. (@katafrakt in #1595)
+- Raise a helpful error message when the `Slice.call` Rack entrypoint is called and no routes are available. (@sandbergja in #1586)
+- Apply extensions to hanami-action gem rather than hanami-controller (which is now retired). (@cllns in #1582)
+- Redesign the new app welcome screen to match our new Hanakai visuals. (@makenosound in #1598)
+- Require Ruby 3.3 or newer.
+
+### Removed
+
+- Remove default body parsing middleware. This functionality has moved into Hanami Action. (@timriley in #1575)
+
+[3.0.0]: https://github.com/hanami/hanami/compare/v2.3.2...v3.0.0
 
 ## [3.0.0.rc1] - 2026-06-16
 
@@ -46,7 +94,7 @@ A complete Hanami app is composed of multiple gems. For a complete overview of c
 - Integrate hanami-mailer gem when bundled. (@timriley in #1597, #1600)
 
     Load templates from `templates/mailers/`. Register a `"mailers.delivery_method"`, which is either an SMTP mailer when `SMTP_ADDRESS`, `SMTP_PORT`, `SMTP_USERNAME`, `SMTP_PASSWORD`, `SMTP_AUTHENTICATION` env vars are present. These can also be prefixed with a slice name. Register a test delivery always in the test env, and also in other envs when the env vars are absent.
-- Integrate i18n gem when bundled. (@timriley in #1562, #1589, #1590, #1591, #1592)
+- Integrate i18n gem when bundled. (@timriley in #1562, #1589, #1590, #1591, #1592, #1593)
 
     Register an `"i18n"` component in each slice, which may be configured via `config.i18n` or a dedicated `:i18n` provider. Load translations from `config/i18n/` within each slice. Load shared translations from `config/i18n/shared/` at the app-level only. Bundle default English translations for `#localize`. Make helpers available in views and actions, which also prefix relative keys (with a leading ".") with their own dot-delimited template or action names.
 - Wrap the configured app logger with `Hanami::UniversalLogger`, to provide a consistent logging interface regardless of the underlying logger. The app can now be depended upon to support (1) structured logging via keyword args passed to log methods, and (2) tagged logging via `#tagged`. (@timriley in #1567, #1568)

data/hanami.gemspec

@@ -38,7 +38,7 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency "dry-system", "~> 1.1"
   spec.add_runtime_dependency "dry-logger", "~> 1.2", "< 2"
   spec.add_runtime_dependency "hanami-cli", ">= 2.3.1"
-  spec.add_runtime_dependency "hanami-utils", ">= 2.3.0"
+  spec.add_runtime_dependency "hanami-utils", "~> 3.0.0"
   spec.add_runtime_dependency "json", ">= 2.7.2"
   spec.add_runtime_dependency "zeitwerk", "~> 2.6"
   spec.add_runtime_dependency "rack-session"

data/lib/hanami/app.rb

@@ -151,12 +151,22 @@ module Hanami
         require_relative "providers/inflector"
         register_provider(:inflector, source: Hanami::Providers::Inflector)
 
-        # Allow logger to be replaced by users with a manual provider, for advanced cases
+        # Allow the logger to be replaced by users with a manual provider, for advanced cases.
+        #
+        # Require the logger provider source up front, to make `configure_provider(:logger)`
+        # possible.
+        require_relative "providers/logger"
         unless container.providers[:logger]
-          require_relative "providers/logger"
           register_provider(:logger, source: Hanami::Providers::Logger)
         end
 
+        # Ensure the logger is wrapped by `Hanami::UniversalLogger`, even if manually registered in a
+        # user-defined provider, guaranteeing Hanami's structured and tagged logging interface across
+        # the framework.
+        container.providers[:logger].source.after(:start) do
+          container.decorate(:logger) { |logger| Hanami::UniversalLogger[logger] }
+        end
+
         if Hanami.bundled?("rack")
           require_relative "providers/rack"
           register_provider(:rack, source: Hanami::Providers::Rack, namespace: true)

data/lib/hanami/config/i18n.rb

@@ -8,7 +8,7 @@ module Hanami
     # Hanami I18n config
     #
     # @api public
-    # @since x.x.x
+    # @since 3.0.0
     class I18n
       include Dry::Configurable
 
@@ -23,7 +23,7 @@ module Hanami
       #     config.i18n.default_locale = :fr
       #
       #   @api public
-      #   @since x.x.x
+      #   @since 3.0.0
       setting :default_locale, default: Providers::I18n::DEFAULT_LOCALE
 
       # @!attribute [rw] available_locales
@@ -41,7 +41,7 @@ module Hanami
       #     config.i18n.available_locales = [:en, :fr, :de]
       #
       #   @api public
-      #   @since x.x.x
+      #   @since 3.0.0
       setting :available_locales, default: Providers::I18n::DEFAULT_AVAILABLE_LOCALES
 
       # @!attribute [rw] load_path
@@ -65,7 +65,7 @@ module Hanami
       #     config.i18n.load_path = ["translations/**/*.yml"]
       #
       #   @api public
-      #   @since x.x.x
+      #   @since 3.0.0
       setting :load_path, default: Providers::I18n::DEFAULT_LOAD_PATH
 
       # @!attribute [rw] shared_load_path
@@ -91,7 +91,7 @@ module Hanami
       #     config.i18n.shared_load_path += ["vendor/translations/**/*.yml"]
       #
       #   @api public
-      #   @since x.x.x
+      #   @since 3.0.0
       setting :shared_load_path, default: Providers::I18n::DEFAULT_SHARED_LOAD_PATH
 
       # @!attribute [rw] fallbacks
@@ -117,7 +117,7 @@ module Hanami
       #     config.i18n.fallbacks = [:en]
       #
       #   @api public
-      #   @since x.x.x
+      #   @since 3.0.0
       setting :fallbacks
 
       private

data/lib/hanami/extensions/action/i18n_helper.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Hanami
+  module Extensions
+    module Action
+      # Action translation and localization helpers.
+      #
+      # These helpers are automatically available on `Hanami::Action` when the `i18n` gem is
+      # bundled.
+      #
+      # When relative translation keys (with a leading dot) are given, they are expanded against a
+      # the action's name. For example, `t(".not_found")` within `Main::Actions::Posts::Show`
+      # becomes `"posts.show.not_found"`.
+      #
+      # @example Basic translation in an action
+      #   module Main
+      #     module Actions
+      #       module Posts
+      #         class Create < Main::Action
+      #           def handle(req, res)
+      #             res.flash[:notice] = t("messages.post_created")
+      #             res.redirect_to routes.path(:posts)
+      #           end
+      #         end
+      #       end
+      #     end
+      #   end
+      #
+      # @example Relative key lookup
+      #   # In Main::Actions::Posts::Show, this looks up "posts.show.not_found"
+      #   t(".not_found")
+      #
+      # @see Hanami::Helpers::I18nHelper::Methods
+      #
+      # @api public
+      # @since 3.0.0
+      module I18nHelper
+        include Hanami::Helpers::I18nHelper::Methods
+
+        private
+
+        def _i18n
+          i18n
+        end
+
+        def _resolve_i18n_key(key)
+          return key unless key.to_s.start_with?(".")
+
+          key_base = self.class.config.i18n_key_base
+
+          unless key_base
+            raise(
+              ::I18n::ArgumentError,
+              "Cannot use relative translation key #{key.inspect} outside of a slice-configured action. " \
+              "Use an absolute key (without a leading dot) instead."
+            )
+          end
+
+          "#{key_base}#{key}"
+        end
+      end
+    end
+  end
+end

data/lib/hanami/extensions/action/name_inferrer.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Hanami
+  module Extensions
+    module Action
+      # Infers an action's name (e.g. `posts.show`) from its class name relative to its slice
+      # namespace.
+      #
+      # @api private
+      class NameInferrer
+        class << self
+          # @example
+          #   NameInferrer.call(action_class_name: "Main::Actions::Posts::Show", slice: Main::Slice)
+          #   # => "posts.show"
+          #
+          # @param action_class_name [String, nil] the action class name
+          # @param slice [Hanami::Slice] the slice the action belongs to
+          #
+          # @return [String, nil] the inferred name, or nil if `action_class_name` is nil
+          def call(action_class_name:, slice:)
+            return nil unless action_class_name
+
+            slice
+              .inflector
+              .underscore(action_class_name)
+              .sub(%r{^#{slice.slice_name.path}#{PATH_DELIMITER}}, "")
+              .sub(%r{^#{slice.config.actions.name_inference_base}#{PATH_DELIMITER}}, "")
+              .gsub("/", CONTAINER_KEY_DELIMITER)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/hanami/extensions/action/slice_configured_action.rb

@@ -3,11 +3,12 @@
 module Hanami
   module Extensions
     module Action
+      require_relative "name_inferrer"
+
       # Provides slice-specific configuration and behavior for any action class defined
       # within a slice's module namespace.
       #
       # @api private
-      # @since 2.0.0
       class SliceConfiguredAction < Module
         attr_reader :slice
 
@@ -18,7 +19,9 @@ module Hanami
 
         def extended(action_class)
           configure_action(action_class)
+          configure_action_i18n(action_class)
           extend_behavior(action_class)
+          define_inherited
           define_new
         end
 
@@ -34,6 +37,7 @@ module Hanami
           view_context_class = method(:view_context_class)
           resolve_routes = method(:resolve_routes)
           resolve_rack_monitor = method(:resolve_rack_monitor)
+          resolve_i18n = method(:resolve_i18n)
 
           define_method(:new) do |**kwargs|
             super(
@@ -41,11 +45,24 @@ module Hanami
               view_context_class: kwargs.fetch(:view_context_class) { view_context_class.() },
               routes: kwargs.fetch(:routes) { resolve_routes.() },
               rack_monitor: kwargs.fetch(:rack_monitor) { resolve_rack_monitor.() },
+              i18n: kwargs.fetch(:i18n) { resolve_i18n.() },
               **kwargs,
             )
           end
         end
 
+        # Defines an `inherited` hook on this module so each subclass of the slice-configured
+        # action gets its own `config.i18n_key_base`, inferred from its class name. Mirrors the
+        # approach used by `SliceConfiguredView` for `config.template`.
+        def define_inherited
+          configure_action_i18n = method(:configure_action_i18n)
+
+          define_method(:inherited) do |subclass|
+            super(subclass)
+            configure_action_i18n.call(subclass)
+          end
+        end
+
         def configure_action(action_class)
           action_class.settings.each do |setting|
             # Configure the action from config on the slice, _unless it has already been configured
@@ -98,6 +115,14 @@ module Hanami
           end
         end
 
+        def configure_action_i18n(action_class)
+          return unless action_class.config.respond_to?(:i18n_key_base=)
+
+          action_class.config.i18n_key_base = NameInferrer.call(
+            action_class_name: action_class.name, slice:
+          )
+        end
+
         def extend_behavior(action_class)
           if actions_config.sessions.enabled?
             require "hanami/action/session"
@@ -152,6 +177,10 @@ module Hanami
           slice.app["rack.monitor"] if slice.app.key?("rack.monitor")
         end
 
+        def resolve_i18n
+          slice["i18n"] if slice.key?("i18n")
+        end
+
         def actions_config
           slice.config.actions
         end

data/lib/hanami/extensions/action.rb

@@ -43,8 +43,7 @@ module Hanami
         # @api private
         attr_reader :view_context_class
 
-        # Returns the app or slice's {Hanami::Slice::RoutesHelper RoutesHelper} for use within
-        # action instance methods.
+        # Returns the slice's {Hanami::Slice::RoutesHelper RoutesHelper}.
         #
         # @return [Hanami::Slice::RoutesHelper]
         #
@@ -52,8 +51,7 @@ module Hanami
         # @since 2.0.0
         attr_reader :routes
 
-        # Returns the app or slice's `Dry::Monitor::Rack::Middleware` for use within
-        # action instance methods.
+        # Returns the slice's `Dry::Monitor::Rack::Middleware`.
         #
         # @return [Dry::Monitor::Rack::Middleware]
         #
@@ -61,6 +59,14 @@ module Hanami
         # @since 2.0.0
         attr_reader :rack_monitor
 
+        # Returns the slice's i18n backend.
+        #
+        # @return [Hanami::Providers::I18n::Backend]
+        #
+        # @api public
+        # @since x.x.x
+        attr_reader :i18n
+
         # @overload def initialize(routes: nil, **kwargs)
         #   Returns a new `Hanami::Action` with app components injected as dependencies.
         #
@@ -71,11 +77,12 @@ module Hanami
         #
         #   @api public
         #   @since 2.0.0
-        def initialize(view: nil, view_context_class: nil, rack_monitor: nil, routes: nil, **kwargs)
+        def initialize(view: nil, view_context_class: nil, rack_monitor: nil, routes: nil, i18n: nil, **kwargs)
           @view = view
           @view_context_class = view_context_class
           @routes = routes
           @rack_monitor = rack_monitor
+          @i18n = i18n
 
           super(**kwargs)
         end
@@ -132,3 +139,9 @@ module Hanami
 end
 
 Hanami::Action.include(Hanami::Extensions::Action)
+
+if Hanami.bundled?("i18n")
+  require_relative "action/i18n_helper"
+  Hanami::Action.setting(:i18n_key_base)
+  Hanami::Action.include(Hanami::Extensions::Action::I18nHelper)
+end

data/lib/hanami/extensions/mailer/slice_configured_mailer.rb

@@ -25,6 +25,7 @@ module Hanami
         def extended(mailer_class)
           configure_mailer(mailer_class)
           define_new
+          define_inherited
         end
 
         def inspect
@@ -44,6 +45,19 @@ module Hanami
           end
         end
 
+        # Reconfigures the template name for each subclass.
+        def define_inherited
+          template_name = method(:template_name)
+
+          define_method(:inherited) do |subclass|
+            super(subclass)
+
+            if (template = template_name.(subclass))
+              subclass.config.template = template
+            end
+          end
+        end
+
         def resolve_delivery_method
           slice["mailers.delivery_method"] if slice.key?("mailers.delivery_method")
         end

data/lib/hanami/extensions/view/context.rb

@@ -203,7 +203,7 @@ module Hanami
             # @raise [Hanami::ComponentLoadError] if the i18n gem is not bundled
             #
             # @api public
-            # @since x.x.x
+            # @since 3.0.0
             def i18n
               unless @i18n
                 raise Hanami::ComponentLoadError, "the i18n gem is required to access translations"

data/lib/hanami/helpers/i18n_helper.rb

@@ -1,140 +1,226 @@
 # frozen_string_literal: true
 
-require "hanami/view"
+require "cgi/escape"
 
 module Hanami
   module Helpers
-    # Helper methods for translating and localizing content using the slice's i18n backend.
+    # View-layer translation and localization helpers.
     #
-    # These helpers will be automatically available in your view templates, part classes, and scope
-    # classes when the `i18n` gem is bundled.
+    # These helpers are automatically available in your view templates, part classes, and scope
+    # classes when the `i18n` gem is bundled. They provide `translate`/`t`, `translate!`/`t!`, and
+    # `localize`/`l`, sourcing the i18n backend from the view context and expanding relative
+    # (leading-dot) translation keys against the currently-rendering template name.
+    #
+    # The shared `translate`/`localize` logic lives in {Methods}, which is also included by the
+    # action-layer i18n helper ({Hanami::Extensions::Action::I18nHelper}). This module supplies
+    # the two view-specific concrete implementations of {Methods}'s abstract hooks: {#_i18n}
+    # returns the i18n backend from the view context, and {#_resolve_i18n_key} expands relative
+    # keys against the template name.
+    #
+    # @example Basic translation
+    #   <%= translate("messages.welcome") %>
+    #   # => "Welcome"
+    #
+    # @example HTML-safe translation
+    #   # en.yml
+    #   #   greeting_html: "Hello, <strong>%{name}</strong>!"
+    #   <%= translate("greeting_html", name: "<script>") %>
+    #   # => "Hello, <strong>&lt;script&gt;</strong>!" (marked HTML-safe)
+    #
+    # @example Missing translation
+    #   <%= translate("missing.key") %>
+    #   # => '<span class="translation_missing" title="...">missing.key</span>'
+    #
+    # @example Relative key lookup
+    #   # In app/templates/users/index.html.erb:
+    #   <%= translate(".title") %>
+    #   # Looks up "users.index.title"
+    #
+    #   # In app/templates/users/_form.html.erb (a partial):
+    #   <%= translate(".label") %>
+    #   # Looks up "users._form.label"
     #
     # @api public
-    # @since x.x.x
+    # @since 3.0.0
     module I18nHelper
-      # Matches keys whose final segment is `html` or whose final segment ends in `_html`. These
-      # translated values are treated as HTML-safe and any string interpolation values are
-      # HTML-escaped before substitution.
-      #
-      # @api private
-      HTML_SAFE_TRANSLATION_KEY = /(\b|_)html\z/
-
-      # Translates the given key using the slice's i18n backend.
-      #
-      # When the key's final segment is `html` or ends in `_html`, the result is marked HTML-safe
-      # and any string interpolation values are HTML-escaped first.
+      # Shared `translate` / `localize` (and shorthand) helper methods used by both view-layer
+      # consumers and action-layer consumers.
       #
-      # When a translation is missing and neither `:default` nor `:raise` was supplied, returns a
-      # `<span class="translation_missing">` element containing the missing key, useful for
-      # spotting missing translations during development.
+      # **This module is abstract.** Including modules must override two private hooks:
       #
-      # When the key begins with a `.`, it is treated as relative to the currently-rendering
-      # template and expanded against its name (slashes become dots; partial basenames keep
-      # their leading underscore). For example, `translate(".title")` inside
-      # `users/index.html.erb` resolves to `users.index.title`, and `translate(".label")`
-      # inside `users/_form.html.erb` resolves to `users._form.label`. Raises
-      # `I18n::ArgumentError` if called outside a template render.
-      #
-      # @param key [String, Symbol] the translation key to look up
-      # @param options [Hash] translation options forwarded to the backend (`:locale`, `:scope`,
-      #   `:default`, `:count`, `:raise`, etc.), plus any interpolation values
-      #
-      # @return [String, Hanami::View::HTML::SafeString] the translated string
-      #
-      # @example Basic translation
-      #   <%= translate("messages.welcome") %>
-      #   # => "Welcome"
-      #
-      # @example HTML-safe translation
-      #   # en.yml
-      #   #   greeting_html: "Hello, <strong>%{name}</strong>!"
-      #   <%= translate("greeting_html", name: "<script>") %>
-      #   # => "Hello, <strong>&lt;script&gt;</strong>!" (marked HTML-safe)
-      #
-      # @example Missing translation
-      #   <%= translate("missing.key") %>
-      #   # => '<span class="translation_missing" title="...">missing.key</span>'
-      #
-      # @example Relative key lookup
-      #   # In app/templates/users/index.html.erb:
-      #   <%= translate(".title") %>
-      #   # Looks up "users.index.title"
-      #
-      #   # In app/templates/users/_form.html.erb (a partial):
-      #   <%= translate(".label") %>
-      #   # Looks up "users._form.label"
+      # - {#_i18n} — returns the i18n backend to delegate to.
+      # - {#_resolve_i18n_key} — expands relative (leading-dot) keys against the consumer's
+      #   context, and is a no-op for absolute keys.
       #
       # @api public
-      # @since x.x.x
-      def translate(key, **options)
-        key = _resolve_i18n_key(key)
+      # @since 3.0.0
+      module Methods
+        # Matches keys whose final segment is `html` or whose final segment ends in `_html`. These
+        # translated values are treated as HTML-safe and any string interpolation values are
+        # HTML-escaped before substitution.
+        #
+        # @api private
+        HTML_SAFE_TRANSLATION_KEY = /(\b|_)html\z/
+
+        # Translates the given key using the slice's i18n backend.
+        #
+        # When the key's final segment is `html` or ends in `_html`, the result is marked HTML-safe
+        # and any string interpolation values are HTML-escaped first.
+        #
+        # When a translation is missing and neither `:default` nor `:raise` was supplied, returns a
+        # `<span class="translation_missing">` element containing the missing key, useful for
+        # spotting missing translations during development.
+        #
+        # When the key begins with a `.`, it is treated as relative to the consumer's context and
+        # expanded by {#_resolve_i18n_key}.
+        #
+        # @param key [String, Symbol] the translation key to look up
+        # @param options [Hash] translation options forwarded to the backend (`:locale`, `:scope`,
+        #   `:default`, `:count`, `:raise`, etc.), plus any interpolation values
+        #
+        # @return [String] the translated string (marked HTML-safe when hanami-view is bundled and
+        #   the key ends in `_html` or `html`)
+        #
+        # @api public
+        # @since 3.0.0
+        def translate(key, **options)
+          key = _resolve_i18n_key(key)
+
+          html_safe = _html_safe_translation_key?(key)
+
+          options = _escape_translation_options(options) if html_safe
+
+          result =
+            if options.key?(:default) || options[:raise]
+              _i18n.translate(key, **options)
+            else
+              begin
+                _i18n.translate(key, **options, raise: true)
+              rescue ::I18n::MissingTranslationData => exception
+                return _missing_translation_markup(key, exception)
+              end
+            end
 
-        html_safe = _html_safe_translation_key?(key)
+          html_safe ? _i18n_mark_html_safe(result.to_s) : result
+        end
 
-        options = _escape_translation_options(options) if html_safe
+        # @api public
+        # @since 3.0.0
+        alias_method :t, :translate
+
+        # Translates the given key, raising an exception if the translation is missing.
+        #
+        # @param (see #translate)
+        #
+        # @return [String] the translated string (marked HTML-safe when hanami-view is bundled and
+        #   the key ends in `_html` or `html`)
+        #
+        # @raise [I18n::MissingTranslationData] if the translation is missing
+        #
+        # @api public
+        # @since 3.0.0
+        def translate!(key, **options)
+          translate(key, **options, raise: true)
+        end
 
-        result =
-          if options.key?(:default) || options[:raise]
-            _context.i18n.translate(key, **options)
-          else
-            begin
-              _context.i18n.translate(key, **options, raise: true)
-            rescue ::I18n::MissingTranslationData => exception
-              return _missing_translation_markup(key, exception)
-            end
-          end
+        # @api public
+        # @since 3.0.0
+        alias_method :t!, :translate!
+
+        # Localizes the given object (e.g. a date, time, or number) using the slice's i18n backend.
+        #
+        # @param object [Date, Time, DateTime, Numeric] the object to localize
+        # @param options [Hash] localization options forwarded to the backend (`:locale`, `:format`,
+        #   etc.)
+        #
+        # @return [String] the localized string
+        #
+        # @api public
+        # @since 3.0.0
+        def localize(object, **options)
+          _i18n.localize(object, **options)
+        end
 
-        html_safe ? result.to_s.html_safe : result
-      end
+        # @api public
+        # @since 3.0.0
+        alias_method :l, :localize
 
-      # @api public
-      # @since x.x.x
-      alias_method :t, :translate
+        private
 
-      # Translates the given key, raising an exception if the translation is missing.
-      #
-      # @param (see #translate)
-      #
-      # @return [String, Hanami::View::HTML::SafeString] the translated string
-      #
-      # @raise [I18n::MissingTranslationData] if the translation is missing
-      #
-      # @example
-      #   <%= translate!("messages.welcome") %>
-      #
-      # @api public
-      # @since x.x.x
-      def translate!(key, **options)
-        translate(key, **options, raise: true)
-      end
+        # Returns the i18n backend the helper methods delegate to.
+        #
+        # Including modules must override this method to return an I18n backend instance.
+        #
+        # @return [Hanami::Providers::I18n::Backend]
+        def _i18n
+          raise NoMethodError, "#{self.class} must implement #_i18n to return an i18n backend"
+        end
 
-      # @api public
-      # @since x.x.x
-      alias_method :t!, :translate!
+        # Resolves the given key, returning it unchanged by default.
+        #
+        # Override this hook to expand relative (leading-dot) keys against a context.
+        #
+        # @param key [String, Symbol]
+        #
+        # @return [String, Symbol] the resolved key
+        def _resolve_i18n_key(key)
+          key
+        end
 
-      # Localizes the given object (e.g. a date, time, or number) using the slice's i18n backend.
-      #
-      # @param object [Date, Time, DateTime, Numeric] the object to localize
-      # @param options [Hash] localization options forwarded to the backend (`:locale`, `:format`,
-      #   etc.)
-      #
-      # @return [String] the localized string
-      #
-      # @example
-      #   <%= localize(Date.today, format: :long) %>
-      #
-      # @api public
-      # @since x.x.x
-      def localize(object, **options)
-        _context.i18n.localize(object, **options)
+        def _html_safe_translation_key?(key)
+          HTML_SAFE_TRANSLATION_KEY.match?(key.to_s)
+        end
+
+        def _escape_translation_options(options)
+          options.each_with_object({}) do |(key, value), result|
+            result[key] =
+              if ::I18n::RESERVED_KEYS.include?(key) || !value.is_a?(String) || _i18n_html_safe?(value)
+                value
+              else
+                _i18n_html_escape(value)
+              end
+          end
+        end
+
+        def _missing_translation_markup(key, error)
+          title = _i18n_html_escape(error.message)
+          body = _i18n_html_escape(key.to_s)
+          _i18n_mark_html_safe(%(<span class="translation_missing" title="#{title}">#{body}</span>))
+        end
+
+        # Escapes `value` for HTML. Prefers `Hanami::View::Helpers::EscapeHelper#escape_html` when
+        # Hanami View's EscapeHelper is included, falling back to stdlib `CGI.escapeHTML` so the
+        # helper works in API-only apps that don't bundle hanami-view.
+        def _i18n_html_escape(value)
+          if respond_to?(:escape_html)
+            escape_html(value)
+          else
+            CGI.escapeHTML(value.to_s)
+          end
+        end
+
+        # Marks the given string as HTML-safe when Hanami View is loaded, otherwise returns the
+        # string unchanged.
+        #
+        # The HTML-safe marker is only meaningful to Hanami View's template rendering, so there's
+        # nothing to do in its absence.
+        def _i18n_mark_html_safe(str)
+          str.respond_to?(:html_safe) ? str.html_safe : str
+        end
+
+        def _i18n_html_safe?(value)
+          value.respond_to?(:html_safe?) && value.html_safe?
+        end
       end
 
-      # @api public
-      # @since x.x.x
-      alias_method :l, :localize
+      include Methods
 
       private
 
+      def _i18n
+        _context.i18n
+      end
+
       def _resolve_i18n_key(key)
         return key unless key.to_s.start_with?(".")
 
@@ -150,27 +236,6 @@ module Hanami
 
         "#{template_name.tr("/", ".")}#{key}"
       end
-
-      def _html_safe_translation_key?(key)
-        HTML_SAFE_TRANSLATION_KEY.match?(key.to_s)
-      end
-
-      def _escape_translation_options(options)
-        options.each_with_object({}) do |(key, value), result|
-          result[key] =
-            if ::I18n::RESERVED_KEYS.include?(key) || !value.is_a?(String) || value.html_safe?
-              value
-            else
-              escape_html(value)
-            end
-        end
-      end
-
-      def _missing_translation_markup(key, error)
-        title = escape_html(error.message)
-        body = escape_html(key.to_s)
-        %(<span class="translation_missing" title="#{title}">#{body}</span>).html_safe
-      end
     end
   end
 end

data/lib/hanami/logger/sql_formatter.rb

@@ -26,9 +26,9 @@ module Hanami
     # highlighted using Rouge's SQL lexer. This is a soft dependency; if Rouge is not installed,
     # queries output as plain, unhighlighted text.
     #
-    # The Rouge theme defaults to Gruvbox and can be customized by setting the `HANAMI_SQL_THEME`
-    # environment variable to any Rouge theme name (e.g. "github.dark", "monokai", "gruvbox.light").
-    # See `Rouge::Theme.registry` for available themes.
+    # The Rouge theme defaults to "pastie" and can be customized by setting the
+    # `HANAMI_LOG_SYNTAX_THEME` environment variable to any Rouge theme name. See
+    # `Rouge::Theme.registry` for available themes.
     #
     # @see Hanami::Logger::SQLLogger
     #
@@ -67,8 +67,8 @@ module Hanami
           return nil
         end
 
-        theme_name = ENV.fetch("HANAMI_SQL_THEME", "gruvbox")
-        theme_class = Rouge::Theme.find(theme_name) || Rouge::Themes::Gruvbox
+        theme_name = ENV.fetch("HANAMI_LOG_SYNTAX_THEME", "pastie")
+        theme_class = Rouge::Theme.find(theme_name) || Rouge::Themes::Pastie
         formatter = Rouge::Formatters::Terminal256.new(theme_class.new)
 
         lexer = Rouge::Lexers::SQL.new

data/lib/hanami/providers/i18n/backend.rb

@@ -10,7 +10,7 @@ module Hanami
       # this wrapper maintains per-instance state for true isolation between slices.
       #
       # @api public
-      # @since x.x.x
+      # @since 3.0.0
       class Backend
         attr_reader :backend
 
@@ -19,7 +19,7 @@ module Hanami
         # @return [Symbol] the default locale
         #
         # @api public
-        # @since x.x.x
+        # @since 3.0.0
         attr_reader :default_locale
 
         # Creates a new Backend instance.
@@ -31,7 +31,7 @@ module Hanami
         # @param fallbacks [I18n::Locale::Fallbacks, nil] fallbacks configuration for missing translations
         #
         # @api private
-        # @since x.x.x
+        # @since 3.0.0
         def initialize(backend, locale: nil, default_locale: :en, available_locales: [], fallbacks: nil)
           @backend = backend
           @default_locale = default_locale.to_sym
@@ -69,7 +69,7 @@ module Hanami
         #   translate("hello", locale: :fr) # => "Bonjour"
         #
         # @api public
-        # @since x.x.x
+        # @since 3.0.0
         def translate(key, **options)
           locale = options[:locale] || self.locale
 
@@ -105,7 +105,7 @@ module Hanami
         # rubocop:enable Metrics/PerceivedComplexity
 
         # @api public
-        # @since x.x.x
+        # @since 3.0.0
         alias_method :t, :translate
 
         # Translates the given key, raising an exception if translation is missing.
@@ -118,15 +118,19 @@ module Hanami
         # @raise [I18n::MissingTranslationData] if translation is missing
         #
         # @example
-        #   t!("hello") # => "Hello"
-        #   t!("missing.key") # raises I18n::MissingTranslationData
+        #   translate!("hello") # => "Hello"
+        #   translate!("missing.key") # raises I18n::MissingTranslationData
         #
         # @api public
-        # @since x.x.x
-        def t!(key, **options)
+        # @since 3.0.0
+        def translate!(key, **options)
           translate(key, **options.merge(raise: true))
         end
 
+        # @api public
+        # @since 3.0.0
+        alias_method :t!, :translate!
+
         # Localizes the given date or time.
         #
         # Resolves symbol formats through this instance's translations (e.g. `:short` becomes
@@ -147,7 +151,7 @@ module Hanami
         #   localize(Date.today, locale: :fr, format: :long) # => "19 janvier 2026"
         #
         # @api public
-        # @since x.x.x
+        # @since 3.0.0
         def localize(object, locale: nil, format: :default, **options)
           locale ||= self.locale
 
@@ -172,7 +176,7 @@ module Hanami
         end
 
         # @api public
-        # @since x.x.x
+        # @since 3.0.0
         alias_method :l, :localize
 
         # Returns true if a translation exists for the given key.
@@ -188,7 +192,7 @@ module Hanami
         #   exists?("missing.key") # => false
         #
         # @api public
-        # @since x.x.x
+        # @since 3.0.0
         def exists?(key, locale: nil, **options)
           locale ||= self.locale
           @backend.exists?(locale, key, options)
@@ -207,7 +211,7 @@ module Hanami
         #   transliterate("Ærøskøbing") # => "AEroskobing"
         #
         # @api public
-        # @since x.x.x
+        # @since 3.0.0
         def transliterate(key, locale: nil, replacement: nil, **options)
           locale ||= self.locale
           @backend.transliterate(locale, key, replacement)
@@ -219,7 +223,7 @@ module Hanami
         # Otherwise, returns all locales detected from loaded translation files.
         #
         # @api public
-        # @since x.x.x
+        # @since 3.0.0
         def available_locales
           if @available_locales.any?
             @available_locales
@@ -233,7 +237,7 @@ module Hanami
         # @return [void]
         #
         # @api public
-        # @since x.x.x
+        # @since 3.0.0
         def reload!
           @backend.reload!
         end
@@ -243,7 +247,7 @@ module Hanami
         # @return [void]
         #
         # @api public
-        # @since x.x.x
+        # @since 3.0.0
         def eager_load!
           @backend.eager_load! if @backend.respond_to?(:eager_load!)
         end
@@ -261,7 +265,7 @@ module Hanami
         #   locale # => :fr
         #
         # @api public
-        # @since x.x.x
+        # @since 3.0.0
         def locale
           Thread.current[@storage_key] || default_locale
         end
@@ -281,7 +285,7 @@ module Hanami
         #   self.locale = nil # resets to default_locale
         #
         # @api public
-        # @since x.x.x
+        # @since 3.0.0
         def locale=(value)
           Thread.current[@storage_key] = value&.to_sym
         end
@@ -312,7 +316,7 @@ module Hanami
         #   end
         #
         # @api public
-        # @since x.x.x
+        # @since 3.0.0
         def with_locale(tmp_locale)
           previous_locale = Thread.current[@storage_key]
           Thread.current[@storage_key] = tmp_locale&.to_sym

data/lib/hanami/providers/logger.rb

@@ -12,8 +12,30 @@ module Hanami
     class Logger < Hanami::Provider::Source
       # @api private
       def start
-        register :logger, Hanami.app.config.logger_instance
+        register :logger, logger
+      end
+
+      # Returns the logger instance that will be registered as the slice's `"logger"` component.
+      #
+      # This is memoized, so lifecycle callbacks added when extending the provider via
+      # {Hanami::Slice::ClassMethods#configure_provider} (such as a `before :start` or `after :start`
+      # hook) can access and customize the very same logger that `start` registers — for example, to
+      # add a logging backend.
+      #
+      # @return [Dry::Logger::Dispatcher] the default logger, or the logger instance configured via
+      #   {Hanami::Config#logger=}
+      #
+      # @api public
+      # @since 3.0.0
+      def logger
+        @logger ||= Hanami.app.config.logger_instance
       end
     end
+
+    Dry::System.register_provider_source(
+      :logger,
+      source: Logger,
+      group: :hanami
+    )
   end
 end

data/lib/hanami/settings/composite_store.rb

@@ -17,7 +17,7 @@ module Hanami
     #   )
     #
     # @api public
-    # @since x.x.x
+    # @since 3.0.0
     class CompositeStore
       # @api private
       Undefined = Dry::Core::Constants::Undefined
@@ -36,7 +36,7 @@ module Hanami
       # @raise [KeyError] if no store has the key and no default is given
       #
       # @api public
-      # @since x.x.x
+      # @since 3.0.0
       def fetch(name, *args, &block)
         @stores.each do |store|
           value = store.fetch(name, Undefined)

data/lib/hanami/slice.rb

@@ -394,6 +394,26 @@ module Hanami
         @slices ||= SliceRegistrar.new(self)
       end
 
+      # Returns an array of this slice and all of its nested slices.
+      #
+      # The nested slices are returned first (with their more specific namespaces ahead of their
+      # parents'), and this slice is returned last. This ordering means a class can be matched to
+      # its most specific slice by detecting the first slice whose namespace it belongs to. It is
+      # useful when you need to operate across every container, such as in test support code.
+      #
+      # @example
+      #   Hanami.app.with_slices # => [Main::Nested::Slice, Main::Slice, Admin::Slice, MyApp::App]
+      #
+      # @return [Array<Hanami::Slice>] this slice and all of its (nested) slices, this slice last
+      #
+      # @see #slices
+      #
+      # @api public
+      # @since 3.0.0
+      def with_slices
+        slices.with_nested + [self]
+      end
+
       # @overload register_slice(name, &block)
       #   Registers a nested slice with the given name.
       #
@@ -1009,7 +1029,7 @@ module Hanami
           require_relative "providers/mailers"
 
           # Only register the provider if the user hasn't provided their own.
-          unless container.providers[:mailers]
+          if register_mailers_provider? && !container.providers[:mailers]
             register_provider(:mailers, namespace: true, source: Providers::Mailers)
           end
         end
@@ -1172,6 +1192,17 @@ module Hanami
         !config.shared_app_component_keys.include?("i18n")
       end
 
+      # Ensures a mailers provider is available in every slice.
+      #
+      # For the app, this will always be a standalone provider. For slices, this will be a
+      # standalone provider unless the slice is configured to share the app's
+      # "mailers.delivery_method" component.
+      def register_mailers_provider?
+        return true if self == app
+
+        !config.shared_app_component_keys.include?("mailers.delivery_method")
+      end
+
       def register_db_provider?
         concrete_db_provider? ||
           db_config_dir? ||

data/lib/hanami/slice_configurable.rb

@@ -57,9 +57,7 @@ module Hanami
       def slice_for(klass)
         return unless klass.name
 
-        slices = Hanami.app.slices.with_nested + [Hanami.app]
-
-        slices.detect { |slice| klass.name.start_with?("#{slice.namespace}#{MODULE_DELIMITER}") }
+        Hanami.app.with_slices.detect { |slice| klass.name.start_with?("#{slice.namespace}#{MODULE_DELIMITER}") }
       end
     end
 

data/lib/hanami/universal_logger.rb

@@ -23,7 +23,7 @@ module Hanami
   # This adapter is used for all loggers configured in Hanami apps.
   #
   # @api public
-  # @since x.x.x
+  # @since 3.0.0
   class UniversalLogger
     class << self
       # Wrap a logger if needed, or return it as-is if fully compatible.
@@ -59,7 +59,7 @@ module Hanami
     end
 
     # @api public
-    # @since x.x.x
+    # @since 3.0.0
     attr_reader :logger
 
     # @api private
@@ -82,7 +82,7 @@ module Hanami
     #   @return [void]
     #
     #   @api public
-    #   @since x.x.x
+    #   @since 3.0.0
 
     # @!method info(message = nil, **payload, &blk)
     #   Logs an info message.
@@ -92,7 +92,7 @@ module Hanami
     #   @yieldreturn [Hash] additional payload data to merge
     #   @return [void]
     #   @api public
-    #   @since x.x.x
+    #   @since 3.0.0
 
     # @!method warn(message = nil, **payload, &blk)
     #   Logs a warning message.
@@ -103,7 +103,7 @@ module Hanami
     #   @return [void]
     #
     #   @api public
-    #   @since x.x.x
+    #   @since 3.0.0
 
     # @!method error(message = nil, **payload, &blk)
     #   Logs an error message.
@@ -114,7 +114,7 @@ module Hanami
     #   @return [void]
     #
     #   @api public
-    #   @since x.x.x
+    #   @since 3.0.0
 
     # @!method fatal(message = nil, **payload, &blk)
     #   Logs a fatal message.
@@ -125,7 +125,7 @@ module Hanami
     #   @return [void]
     #
     #   @api public
-    #   @since x.x.x
+    #   @since 3.0.0
 
     # @!method unknown(message = nil, **payload, &blk)
     #   Logs a message with unknown severity.
@@ -136,7 +136,7 @@ module Hanami
     #   @return [void]
     #
     #   @api public
-    #   @since x.x.x
+    #   @since 3.0.0
 
     LOG_LEVEL_METHODS.each do |level|
       define_method(level) do |message = nil, **payload, &blk|
@@ -145,7 +145,7 @@ module Hanami
     end
 
     # @api public
-    # @since x.x.x
+    # @since 3.0.0
     def add(severity, message = nil, progname = nil, &blk)
       # Convert severity to a level symbol if it's an integer (the standard Logger uses integers).
       level = _severity_to_level(severity)
@@ -157,11 +157,11 @@ module Hanami
     end
 
     # @api public
-    # @since x.x.x
+    # @since 3.0.0
     alias_method :log, :add
 
     # @api public
-    # @since x.x.x
+    # @since 3.0.0
     def tagged(*tags)
       previous_tags = _current_tags
       self._current_tags = tags

data/lib/hanami/version.rb

@@ -7,7 +7,7 @@ module Hanami
   # @api private
   module Version
     # @api public
-    VERSION = "3.0.0.rc1"
+    VERSION = "3.0.0"
 
     # @since 0.9.0
     # @api private

data/lib/hanami/web/rack_logger.rb

@@ -59,7 +59,7 @@ module Hanami
       # @api private
       # @since 2.0.0
       def initialize(logger, env: :development)
-        @logger = Hanami::UniversalLogger[logger]
+        @logger = logger
         extend(Development) if %i[development test].include?(env)
       end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hanami
 version: !ruby/object:Gem::Version
-  version: 3.0.0.rc1
+  version: 3.0.0
 platform: ruby
 authors:
 - Hanakai team
@@ -173,16 +173,16 @@ dependencies:
   name: hanami-utils
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.3.0
+        version: 3.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.3.0
+        version: 3.0.0
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
@@ -302,6 +302,8 @@ files:
 - lib/hanami/errors.rb
 - lib/hanami/extensions.rb
 - lib/hanami/extensions/action.rb
+- lib/hanami/extensions/action/i18n_helper.rb
+- lib/hanami/extensions/action/name_inferrer.rb
 - lib/hanami/extensions/action/slice_configured_action.rb
 - lib/hanami/extensions/db/repo.rb
 - lib/hanami/extensions/mailer.rb