Add changelog and readme for :context support

Author: fnordfish

CHANGELOG.md

@@ -9,6 +9,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 ### Added
 
 - Support for Phlex 2.0 Component context. (`HelloWorld.new.call(context: {some: :data})`).
+    + Like layout options, the `:context` plugin option can be used to set a default context.
+    The value will be`dup`ed on first use.
+    + `#phlex_context` method to access the context.
+    + `#set_phlex_context` method to set the context.
 - `:delegate_on` plugin option to specify the object to delegate methods to.
   Defaults to `::Phlex::SGML` but its advised to set it to your own subclass of `::Phlex::SGML`.
 - `:delegate_name` plugin option to specify name of the method that delegates to the Roda app.
@@ -17,6 +21,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 ### Changed
 
 - Update to phlex 2.0.
+- `#phlex_layout`, `#phlex_layout_opts`, `#phlex_layout_handler` no longer accept a value to set their value.
+  Use their corresponding `#set_*` methods instead.
 
 ### Deprecated
 
@@ -28,6 +34,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 
 ### Fixed
 
+- Mutating the layout options hash no longer affects subsequent requests.
+  The value passed as `:layout_opts` plugin config is now `dup`ed on first use.
+  Note, that mutating nested objects will still affect the original hash.
+
 ### Security
 
 ## [0.2.0] - 2024-12-13

README.md

@@ -37,6 +37,9 @@ gem install roda-phlex
   layout options, and the object to be rendered. By default, it runs
   `layout.new(obj, **layout_opts)`, which instantiates the layout class with the
   provided view object and options as keyword arguments.
+* `:context` (`Hash`): The context that is passed to the rendering call. (default: `{}`)
+  To avoid external changes effecting subsequent requests, you should `.freeze` this
+  and all nested objects.
 * `:delegate`: Define if or which methods should be delegated to the Roda app:
     + `true` (default): Create a single `app` method that delegates to the Roda app.
     + `false`: Do not create any delegate methods.

lib/roda/plugins/phlex.rb

@@ -17,6 +17,7 @@ module RodaPlugins
     #   layout options, and the object to be rendered. By default, it uses the
     #   `DEFAULT_LAYOUT_HANDLER`, which instantiates the layout class with the
     #   provided object and options as keyword arguments.
+    # - `:context` (+Hash+): The context that is passed to the rendering call. (default: `{}`)
     # - `:delegate`: Define if or which methods should be delegated to the Roda app:
     #     + `true` (default): Create a single `app` method that delegates to the Roda app.
     #     + `false`: Do not create any delegate methods.