Merge branch 'master' into update-generator-for-v15

Author: justin808

CHANGELOG.md

@@ -23,6 +23,31 @@ After a release, please make sure to run `bundle exec rake update_changelog`. Th
 
 Changes since the last non-beta release.
 
+### [16.0.0] - 2025-09-16
+
+See [Release Notes](docs/release-notes/16.0.0.md) for full details.
+
+#### Enhanced
+
+- Improved error messages in install generator with clearer troubleshooting steps
+- Enhanced package manager detection with multi-strategy validation
+- Ensured that the RSC payload is injected after the component's HTML markup to improve the performance of the RSC payload injection. [PR 1738](https://github.com/shakacode/react_on_rails/pull/1738) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
+- Improved RSC rendering flow by eliminating double rendering of server components and reducing the number of HTTP requests.
+- Updated communication protocol between Node Renderer and Rails to version 2.0.0 which supports the ability to upload multiple bundles at once.
+- Added `RSCRoute` component to enable seamless server-side rendering of React Server Components. This component automatically handles RSC payload injection and hydration, allowing server components to be rendered directly within client components while maintaining optimal performance. [PR 1696](https://github.com/shakacode/react_on_rails/pull/1696) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
+- The global context is now accessed using `globalThis`. [PR 1727](https://github.com/shakacode/react_on_rails/pull/1727) by [alexeyr-ci2](https://github.com/alexeyr-ci2).
+- Generated client packs now import from `react-on-rails/client` instead of `react-on-rails`. [PR 1706](https://github.com/shakacode/react_on_rails/pull/1706) by [alexeyr-ci](https://github.com/alexeyr-ci).
+  - The "optimization opportunity" message when importing the server-side `react-on-rails` instead of `react-on-rails/client` in browsers is now a warning for two reasons:
+    - Make it more prominent
+    - Include a stack trace when clicked
+
+#### Added
+
+- Configuration option `generated_component_packs_loading_strategy` to control how generated component packs are loaded. It supports `sync`, `async`, and `defer` strategies. [PR 1712](https://github.com/shakacode/react_on_rails/pull/1712) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
+- Support for returning React component from async render-function. [PR 1720](https://github.com/shakacode/react_on_rails/pull/1720) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
+- React Server Components Support (Pro Feature) [PR 1644](https://github.com/shakacode/react_on_rails/pull/1644) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
+- Improved component and store hydration performance [PR 1656](https://github.com/shakacode/react_on_rails/pull/1656) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
+
 #### Removed (Breaking Changes)
 
 - **Webpacker support completely removed**. Shakapacker 8.2+ is now required.
@@ -44,18 +69,6 @@ Changes since the last non-beta release.
   - Generator uses `Thor::Error` exceptions instead of `exit(1)` for better error handling
   - Migration: Ensure you have a JavaScript package manager installed before running the generator
 
-#### Enhanced
-
-- Simplified CI matrix configuration with clear dependency level naming (`minimum`/`latest` instead of `oldest`/`newest`)
-- Improved error messages in install generator with clearer troubleshooting steps
-- Enhanced package manager detection with multi-strategy validation
-
-### [15.0.0] - 2025-08-28
-
-See [Release Notes](docs/release-notes/15.0.0.md) for full details.
-
-### Removed (Breaking Changes)
-
 - Deprecated `defer_generated_component_packs` configuration option. You should use `generated_component_packs_loading_strategy` instead.
   - Migration:
     - `defer_generated_component_packs: true` → `generated_component_packs_loading_strategy: :defer`
@@ -67,35 +80,25 @@ See [Release Notes](docs/release-notes/15.0.0.md) for full details.
   - For TypeScript errors, upgrade to TypeScript 5.8+ and set `module` to `nodenext`.
 - `ReactOnRails.reactOnRailsPageLoaded` is now an async function. Migration:
   - Add `await` when calling this function: `await ReactOnRails.reactOnRailsPageLoaded()`.
-- `force_load` configuration now defaults to `true`. Migration:
-  - Set `force_load: false` in your config if you want the previous behavior.
-
-For detailed migration instructions, see the [15.0.0 Release Notes](docs/release-notes/15.0.0.md).
+- **RENAMED**: `force_load` configuration renamed to `immediate_hydration` for better API clarity.
+  - `immediate_hydration` now defaults to `false` and requires React on Rails Pro license.
+  - Migration:
+    - `config.force_load = true` → `config.immediate_hydration = true`
+    - `react_component(force_load: true)` → `react_component(immediate_hydration: true)`
+    - `redux_store(force_load: true)` → `redux_store(immediate_hydration: true)`
+For detailed migration instructions, see the [16.0.0 Release Notes](docs/release-notes/16.0.0.md).
 
 #### Fixed
 
 - Enable support for ReactRefreshWebpackPlugin v0.6.0 by adding conditional logic regarding configuration. [PR 1748](https://github.com/shakacode/react_on_rails/pull/1748) by [judahmeek](https://github.com/judahmeek).
 - Replace RenderOptions.renderRequestId and use local trackers instead. This change should only be relevant to ReactOnRails Pro users. [PR 1745](https://github.com/shakacode/react_on_rails/pull/1745) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
 - Fixed invalid warnings about non-exact versions when using a pre-release version of React on Rails, as well as missing warnings when using different pre-release versions of the gem and the Node package. [PR 1742](https://github.com/shakacode/react_on_rails/pull/1742) by [alexeyr-ci2](https://github.com/alexeyr-ci2).
 
-#### Improved
-
-- Ensured that the RSC payload is injected after the component's HTML markup to improve the performance of the RSC payload injection. [PR 1738](https://github.com/shakacode/react_on_rails/pull/1738) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
-- Improved RSC rendering flow by eliminating double rendering of server components and reducing the number of HTTP requests.
-- Updated communication protocol between Node Renderer and Rails to version 2.0.0 which supports the ability to upload multiple bundles at once.
-- Added `RSCRoute` component to enable seamless server-side rendering of React Server Components. This component automatically handles RSC payload injection and hydration, allowing server components to be rendered directly within client components while maintaining optimal performance. [PR 1696](https://github.com/shakacode/react_on_rails/pull/1696) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
-- The global context is now accessed using `globalThis`. [PR 1727](https://github.com/shakacode/react_on_rails/pull/1727) by [alexeyr-ci2](https://github.com/alexeyr-ci2).
-- Generated client packs now import from `react-on-rails/client` instead of `react-on-rails`. [PR 1706](https://github.com/shakacode/react_on_rails/pull/1706) by [alexeyr-ci](https://github.com/alexeyr-ci).
-  - The "optimization opportunity" message when importing the server-side `react-on-rails` instead of `react-on-rails/client` in browsers is now a warning for two reasons:
-    - Make it more prominent
-    - Include a stack trace when clicked
+### [15.0.0] - 2025-08-28 - RETRACTED
 
-#### Added
+**⚠️ This version has been retracted due to API design issues. Please upgrade directly to v16.0.0.**
 
-- Configuration option `generated_component_packs_loading_strategy` to control how generated component packs are loaded. It supports `sync`, `async`, and `defer` strategies. [PR 1712](https://github.com/shakacode/react_on_rails/pull/1712) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
-- Support for returning React component from async render-function. [PR 1720](https://github.com/shakacode/react_on_rails/pull/1720) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
-- React Server Components Support (Pro Feature) [PR 1644](https://github.com/shakacode/react_on_rails/pull/1644) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
-- Improved component and store hydration performance [PR 1656](https://github.com/shakacode/react_on_rails/pull/1656) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
+The `force_load` feature was incorrectly available without a Pro license and has been renamed to `immediate_hydration` for better clarity. All features from v15 are available in v16 with the corrected API.
 
 ### [14.2.0] - 2025-03-03
 
@@ -1593,8 +1596,8 @@ such as:
 
 - Fix several generator-related issues.
 
-[Unreleased]: https://github.com/shakacode/react_on_rails/compare/15.0.0...master
-[15.0.0]: https://github.com/shakacode/react_on_rails/compare/14.2.0...15.0.0
+[Unreleased]: https://github.com/shakacode/react_on_rails/compare/16.0.0...master
+[16.0.0]: https://github.com/shakacode/react_on_rails/compare/14.2.0...16.0.0
 [14.2.0]: https://github.com/shakacode/react_on_rails/compare/14.1.1...14.2.0
 [14.1.1]: https://github.com/shakacode/react_on_rails/compare/14.1.0...14.1.1
 [14.1.0]: https://github.com/shakacode/react_on_rails/compare/14.0.5...14.1.0

CLAUDE.md

@@ -15,6 +15,9 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
   - All linters: `rake lint` (runs ESLint and RuboCop)
   - ESLint only: `yarn run lint` or `rake lint:eslint`
   - RuboCop only: `rake lint:rubocop`
+- **Code Formatting**:
+  - Format code with Prettier: `yarn start format`
+  - Check formatting without fixing: `yarn start format.listDifferent`
 - **Build**: `yarn run build` (compiles TypeScript to JavaScript in node_package/lib)
 - **Type checking**: `yarn run type-check`
 

CONTRIBUTING.md

@@ -180,6 +180,42 @@ cd react_on_rails/
 yarn run check
 ```
 
+## Development Commands
+
+### Code Formatting
+
+To format JavaScript/TypeScript files with Prettier:
+
+```sh
+yarn start format
+```
+
+To check formatting without fixing:
+
+```sh
+yarn start format.listDifferent
+```
+
+### Linting
+
+Run all linters (ESLint and RuboCop):
+
+```sh
+rake lint
+```
+
+Run only RuboCop:
+
+```sh
+rake lint:rubocop
+```
+
+Run only ESLint:
+
+```sh
+yarn run lint
+```
+
 ### Starting the Dummy App
 
 To run the dummy app, it's **CRITICAL** to not just run `rails s`. You have to run `foreman start` with one of the Procfiles. If you don't do this, then `webpack` will not generate a new bundle, and you will be seriously confused when you change JavaScript and the app does not change. If you change the Webpack configs, then you need to restart Foreman. If you change the JS code for react-on-rails, you need to run `yarn run build` in the project root.

docs/guides/configuration.md

@@ -223,13 +223,14 @@ ReactOnRails.configure do |config|
   # DEPRECATED: Use `generated_component_packs_loading_strategy` instead.
   # Migration: `defer_generated_component_packs: true` → `generated_component_packs_loading_strategy: :defer`
   # Migration: `defer_generated_component_packs: false` → `generated_component_packs_loading_strategy: :sync`
-  # See [15.0.0 Release Notes](docs/release-notes/15.0.0.md) for more details.
+  # See [16.0.0 Release Notes](docs/release-notes/16.0.0.md) for more details.
   # config.defer_generated_component_packs = false
 
-  # Default is true
-  # When true, components hydrate immediately as soon as their server-rendered HTML reaches the client,
-  # without waiting for the full page load. This improves time-to-interactive performance.
-  config.force_load = true
+  # Default is false
+  # React on Rails Pro (licensed) feature: When true, components hydrate immediately as soon as
+  # their server-rendered HTML reaches the client, without waiting for the full page load.
+  # This improves time-to-interactive performance.
+  config.immediate_hydration = false
 
   ################################################################################
   # I18N OPTIONS

docs/guides/streaming-server-rendering.md

@@ -6,7 +6,7 @@ React on Rails Pro supports streaming server rendering using React 18's latest A
 
 - React on Rails Pro subscription
 - React 19
-- React on Rails v15.0.0-alpha.0 or higher
+- React on Rails v16.0.0 or higher
 - React on Rails Pro v4.0.0.rc.5 or higher
 
 ## Benefits of Streaming Server Rendering

docs/rails/turbolinks.md

@@ -103,7 +103,7 @@ document.addEventListener('turbolinks:load', function () {
 React on Rails 15 fixes both issues, so if you still have the listener it can be removed (and should be as `reactOnRailsPageLoaded()` is now async).
 
 > [!WARNING]
-> Do not use `force_load: false` with Turbolinks if you have async scripts.
+> Do not use `immediate_hydration: false` (React on Rails Pro licensed feature) with Turbolinks if you have async scripts.
 
 ## Troubleshooting