hanami-view 3.0.0.rc1 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab1223361a1dd1e27cda821d93b04857383189680e9eb2936011ae18119a3b98
-  data.tar.gz: 10d4f6e9057266613cdd392a0daa16d4aa130cffdafda095e393fa1260a28e3e
+  metadata.gz: 3551aaf55b76ccc3396f09f954804be884cad50f774f8ae68b980799d9699de4
+  data.tar.gz: '08012b7065f9b8015cf2f274d595b7d6f6830c8071d23285ba268bc7ca7e99b7'
 SHA512:
-  metadata.gz: 2bb9ee14ae0cb4c446c80e24ee36a6f73a21baf95bc41face07aeb694014f74bed5e8ef1dfa8ec827de1f2a74acf3248cfdfd4c99ece34bcbb014c3a2f4bfddd
-  data.tar.gz: 33310b9d1de7704edcf2db34c401e310b18649a4d41f6bf8d5320c73842a46d545c9be9e43b9347634d2c9e635fc7d752f55b4630bd262091da43c1afffb4c29
+  metadata.gz: eb475608c10965166e12c6477793e6b47241f7888b4800f84b3e10075ae6f6a3d14494df18c607e0ce6f8514be450c201eaea5f4cb46203d6fea8af1e5073315
+  data.tar.gz: 11f2b19132241ce7ce76c928ef5be1f4a11dc849411b20d90197fa7c7168c3c2068da219d63150a6bac21d64244b6edd167eeced1442315eeaa7db8be07c335f

data/CHANGELOG.md

@@ -19,7 +19,34 @@ and this project adheres to [Break Versioning](https://www.taoensso.com/break-ve
 
 ### Security
 
-[Unreleased]: https://github.com/hanami/view/compare/v3.0.0.rc1...HEAD
+[Unreleased]: https://github.com/hanami/view/compare/v3.0.0...HEAD
+
+## [3.0.0] - 2026-06-30
+
+### Added
+
+- Track the currently-rendering template name. (@timriley in #277)
+
+    Expose this as `Hanami::View::Scope#_template_name` (with `template_name` as a convenience alias) and `Hanami::View::Context#current_template_name`.
+
+    The name is resolved path of the file actually being rendered, relative to its configured `paths` directory, with format/engine extensions stripped. For example, `render("form")` from inside `posts/show.html.erb` returns `"posts/_form"`; a layout at `layouts/app.html.erb` returns `"layouts/app"`.
+
+    The current template name can be used to enable such behaviors as lazy/relative key lookups for i18n view helpers. 
+
+### Changed
+
+- **BREAKING:** Default to undecorated exposures. (@timriley in #274)
+
+    Decorate your exposures with the new `.decorate` method, or the `decorate: true` option for `.expose`. Default back to decorated exposures via `config.decorate_exposures = true`. 
+- Cache the view's resolved configuration as a frozen `Data` snapshot (via dry-configurable's `#to_data`) at initialization, avoiding repeated config lookups on the rendering hot path for improved memory usage and speed. (@cllns in #276)
+- Require Ruby 3.3 or newer.
+
+### Fixed
+
+- Allow the gem to be eager loaded by Zeitwerk when the optional haml and slim gems are not installed. (@timriley in #279)
+- Use our own Haml template engine even when the haml gem is required before hanami-view. (@timriley in #279)
+
+[3.0.0]: https://github.com/hanami/view/compare/v2.3.1...v3.0.0
 
 ## [3.0.0.rc1] - 2026-06-16
 
@@ -27,9 +54,11 @@ and this project adheres to [Break Versioning](https://www.taoensso.com/break-ve
 
 - Track the currently-rendering template name. (@timriley in #277)
 
-    Expose the topmost entry as `Hanami::View::Rendering#current_template_name` and the full stack as `#current_template_names`. Entries are the resolved path of the file actually being rendered, relative to its configured `paths` directory, with format/engine extensions stripped. For example, `render("form")` from inside `posts/show.html.erb` reports `"posts/_form"`; a layout at `layouts/app.html.erb` reports `"layouts/app"`.
+    Expose this as `Hanami::View::Scope#_template_name` (with `template_name` as a convenience alias) and `Hanami::View::Context#current_template_name`.
+
+    The name is resolved path of the file actually being rendered, relative to its configured `paths` directory, with format/engine extensions stripped. For example, `render("form")` from inside `posts/show.html.erb` returns `"posts/_form"`; a layout at `layouts/app.html.erb` returns `"layouts/app"`.
 
-    Convenience accessors are available as `Hanami::View::Scope#_template_name` (with `template_name` as a convenience alias) and `Hanami::View::Context#current_template_name`. The current template name can be used to enable such behaviors as lazy/relative key lookups for i18n view helpers. 
+    The current template name can be used to enable such behaviors as lazy/relative key lookups for i18n view helpers. 
 
 ### Changed
 

data/lib/hanami/view/context.rb

@@ -47,7 +47,7 @@ module Hanami
       # @return [String, nil]
       #
       # @api public
-      # @since x.x.x
+      # @since 3.0.0
       def current_template_name
         _rendering.current_template_name
       end

data/lib/hanami/view/rendering.rb

@@ -37,9 +37,6 @@ module Hanami
       # no render is in progress.
       #
       # @return [String, nil]
-      #
-      # @api public
-      # @since x.x.x
       def current_template_name
         renderer.current_template_name
       end
@@ -48,9 +45,6 @@ module Hanami
       # rendered.
       #
       # @return [Array<String>]
-      #
-      # @api private
-      # @since x.x.x
       def current_template_names
         renderer.current_template_names
       end

data/lib/hanami/view/scope.rb

@@ -157,7 +157,7 @@ module Hanami
       #   @return [String, nil]
       #
       # @api public
-      # @since x.x.x
+      # @since 3.0.0
       def _template_name
         _rendering.current_template_name
       end

data/lib/hanami/view/tilt.rb

@@ -10,14 +10,24 @@ module Hanami
       # @api private
       # @since 2.1.0
       Mapping = ::Tilt.default_mapping.dup.tap { |mapping|
-        # If "slim" has been required before "hanami/view", unregister Slim's non-lazy registered
-        # template, so our own template adapter (using register_lazy below) can take precedence.
-        mapping.unregister "slim"
+        # Unregister any existing mappings for the extensions we provide our own engines for.
+        #
+        # Tilt preferences non-lazy registrations over lazy ones (see `Tilt::Mapping#lookup`). So if
+        # "haml" or "slim" has been required before this mapping is built (each of which registers
+        # its own non-lazy mapping with Tilt), our own lazy-registered adapters below would be
+        # shadowed and never picked up, and templates would render without our specific required
+        # behavior.
+        #
+        # Unregistering first ensures our engines are always used, regardless of load order.
+        mapping.unregister "erb", "rhtml", "haml", "slim"
 
         # Register our own ERB template.
         mapping.register_lazy "Hanami::View::ERB::Template", "hanami/view/erb/template", "erb", "rhtml"
 
-        # Register ERB templates for Haml and Slim that set the `use_html_safe: true` option.
+        # Register templates for Haml and Slim that set the `use_html_safe: true` option.
+        #
+        # We register these lazily so that the optional "haml" and "slim" gems only need to be
+        # installed when their templates are actually used.
         #
         # Our template namespaces below have the "Adapter" suffix to work around a bug in Tilt's
         # `Mapping#const_defined?`, which (if slim was already required) would receive

data/lib/hanami/view/version.rb

@@ -3,6 +3,6 @@
 module Hanami
   class View
     # @api public
-    VERSION = "3.0.0.rc1"
+    VERSION = "3.0.0"
   end
 end

data/lib/hanami/view.rb

@@ -30,7 +30,12 @@ module Hanami
         loader.ignore(
           "#{root}/hanami-view.rb",
           "#{root}/hanami/view/version.rb",
-          "#{root}/hanami/view/errors.rb"
+          "#{root}/hanami/view/errors.rb",
+          # These adapters require the optional "haml" and "slim" gems. They are loaded lazily by
+          # Tilt (see Hanami::View::Tilt) only when their respective template engines are used;
+          # ignore them here to allow eager loading without those gems installed.
+          "#{root}/hanami/view/tilt/haml_adapter.rb",
+          "#{root}/hanami/view/tilt/slim_adapter.rb"
         )
         loader.inflector = Zeitwerk::GemInflector.new("#{root}/hanami-view.rb")
         loader.inflector.inflect(
@@ -246,7 +251,7 @@ module Hanami
     #
     #   @param value [Boolean] whether to decorate exposures by default
     #   @api public
-    #   @since x.x.x
+    #   @since 3.0.0
     # @!scope class
     setting :decorate_exposures, default: false
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hanami-view
 version: !ruby/object:Gem::Version
-  version: 3.0.0.rc1
+  version: 3.0.0
 platform: ruby
 authors:
 - Hanakai team