added docs

Author: 23tux

docs/CHANGELOG.md

@@ -10,8 +10,9 @@ nav_order: 6
 
 ## main
 
-* Allow I18n calls in render?
-* Split render lifecycle into separate methods, to be able to test component methods that rely on `t(...)` directly
+* Allow I18n calls in render?.
+* Split render lifecycle into separate methods, to be able to test component methods that rely on `t(...)` directly.
+* Added `setup_render` test helper to allow testing of component methods that rely on `t(...)` without rendering the component.
 
     *23tux*
 

docs/api.md

@@ -301,6 +301,23 @@ render_inline(MyComponent.new)
 assert_text("Hello, World!")
 ```
 
+### `#setup_render(component)` → [ViewComponent::Base]
+
+Triggers the render setup of a component without actually rendering it.
+The method is also called internally by `#render_in` when a component is rendered.
+Useful for testing methods of components that need access to the view context or the `@virtual_path` variable like I18n's `t(...)` helper.
+
+```ruby
+class MyComponent < ViewComponent::Base
+  def message
+    t("hello.world")
+  end
+end
+
+component = setup_render(MyComponent.new)
+assert_equal(component.message, "Hello, World!")
+```
+
 ### `#render_preview(name, from: __vc_test_helpers_preview_class, params: {})` → [Nokogiri::HTML5]
 
 Render a preview inline. Internally sets `page` to be a `Capybara::Node::Simple`,