Changes due to review

Author: bopm

README.md

@@ -7,31 +7,31 @@
 <!-- toc -->
 
 - [Installation](#installation)
-  * [Choosing a specific version of `tailwindcss`](#choosing-a-specific-version-of-tailwindcss)
-  * [Using a local installation of `tailwindcss`](#using-a-local-installation-of-tailwindcss)
+  - [Choosing a specific version of `tailwindcss`](#choosing-a-specific-version-of-tailwindcss)
+  - [Using a local installation of `tailwindcss`](#using-a-local-installation-of-tailwindcss)
 - [Upgrading your application from Tailwind v3 to v4](#upgrading-your-application-from-tailwind-v3-to-v4)
-  * [You don't _have_ to upgrade](#you-dont-_have_-to-upgrade)
-  * [Upgrade steps](#upgrade-steps)
-  * [Troubleshooting a v4 upgrade](#troubleshooting-a-v4-upgrade)
-  * [Updating CSS class names for v4](#updating-css-class-names-for-v4)
+  - [You don't _have_ to upgrade](#you-dont-_have_-to-upgrade)
+  - [Upgrade steps](#upgrade-steps)
+  - [Troubleshooting a v4 upgrade](#troubleshooting-a-v4-upgrade)
+  - [Updating CSS class names for v4](#updating-css-class-names-for-v4)
 - [Developing with Tailwindcss](#developing-with-tailwindcss)
-  * [Configuration and commands](#configuration-and-commands)
-  * [Building for production](#building-for-production)
-  * [Building for testing](#building-for-testing)
-  * [Building unminified assets](#building-unminified-assets)
-  * [Live rebuild](#live-rebuild)
-  * [Using Tailwind plugins](#using-tailwind-plugins)
-  * [Using with PostCSS](#using-with-postcss)
-  * [Custom inputs or outputs](#custom-inputs-or-outputs)
-  * [Rails Engines support (Experimental)](#rails-engines-support-experimental)
+  - [Configuration and commands](#configuration-and-commands)
+  - [Building for production](#building-for-production)
+  - [Building for testing](#building-for-testing)
+  - [Building unminified assets](#building-unminified-assets)
+  - [Live rebuild](#live-rebuild)
+  - [Using Tailwind plugins](#using-tailwind-plugins)
+  - [Using with PostCSS](#using-with-postcss)
+  - [Custom inputs or outputs](#custom-inputs-or-outputs)
+  - [Rails Engines support (Experimental)](#rails-engines-support-experimental)
 - [Troubleshooting](#troubleshooting)
-  * [The `watch` command is hanging](#the-watch-command-is-hanging)
-  * [Lost keystrokes or hanging when using terminal-based debugging tools (e.g. IRB, Pry, `ruby/debug`...etc.) with the Puma plugin](#lost-keystrokes-or-hanging-when-using-terminal-based-debugging-tools-eg-irb-pry-rubydebugetc-with-the-puma-plugin)
-  * [Running in a docker container exits prematurely](#running-in-a-docker-container-exits-prematurely)
-  * [Conflict with sassc-rails](#conflict-with-sassc-rails)
-  * [Class names must be spelled out](#class-names-must-be-spelled-out)
-  * [`ERROR: Cannot find the tailwindcss executable` for supported platform](#error-cannot-find-the-tailwindcss-executable-for-supported-platform)
-  * [Using asset-pipeline assets](#using-asset-pipeline-assets)
+  - [The `watch` command is hanging](#the-watch-command-is-hanging)
+  - [Lost keystrokes or hanging when using terminal-based debugging tools (e.g. IRB, Pry, `ruby/debug`...etc.) with the Puma plugin](#lost-keystrokes-or-hanging-when-using-terminal-based-debugging-tools-eg-irb-pry-rubydebugetc-with-the-puma-plugin)
+  - [Running in a docker container exits prematurely](#running-in-a-docker-container-exits-prematurely)
+  - [Conflict with sassc-rails](#conflict-with-sassc-rails)
+  - [Class names must be spelled out](#class-names-must-be-spelled-out)
+  - [`ERROR: Cannot find the tailwindcss executable` for supported platform](#error-cannot-find-the-tailwindcss-executable-for-supported-platform)
+  - [Using asset-pipeline assets](#using-asset-pipeline-assets)
 - [License](#license)
 
 <!-- tocstop -->
@@ -99,7 +99,7 @@ gem "tailwindcss-ruby", "~> 3.4" # only necessary with tailwindcss-rails <= 3.3.
 First, update to `tailwindcss-rails` v4.0.0 or higher. This will also ensure you're transitively depending on `tailwindcss-ruby` v4.
 
 ```ruby
-# Gemfile 
+# Gemfile
 gem "tailwindcss-rails", "~> 4.0" # which transitively pins tailwindcss-ruby to v4
 ```
 
@@ -392,7 +392,7 @@ If you need to use a custom input or output file, you can run `bundle exec tailw
 
 _This feature is experimental and may change in the future. If you have feedback, please join the [discussion](https://github.com/rails/tailwindcss-rails/discussions/355)._
 
-If you have Rails Engines in your application that use Tailwind CSS and provide an `app/assets/tailwind/<engine_name>/engine.css` file, entry point files will be created for each of them in `app/assets/builds/tailwind/<engine_name>.css` on the first build/watch invocation so they can be included in your host application's Tailwind CSS by adding `@import "../builds/tailwind/<engine_name>"` to your `app/assets/tailwind/application.css` file.
+If you have Rails Engines in your application that use Tailwind CSS and provide an `app/assets/tailwind/<engine_name>/engine.css` file, entry point files will be created for each of them in `app/assets/builds/tailwind/<engine_name>.css` on the first build/watch invocation or manual call for `rails tailwindcss:engines` so they can be included in your host application's Tailwind CSS by adding `@import "../builds/tailwind/<engine_name>"` to your `app/assets/tailwind/application.css` file.
 
 > [!IMPORTANT]
 > You must `@import` the engine CSS files in your `app/assets/tailwind/application.css` for the engine to be included in the build. By default, no engine CSS files are imported, and you must opt-in to using the file in your build.

lib/tasks/build.rake

@@ -4,7 +4,7 @@ namespace :tailwindcss do
     debug = args.extras.include?("debug")
     verbose = args.extras.include?("verbose")
 
-    Tailwindcss::Engines.bundle
+
     command = Tailwindcss::Commands.compile_command(debug: debug)
     env = Tailwindcss::Commands.command_env(verbose: verbose)
     puts "Running: #{Shellwords.join(command)}" if verbose
@@ -19,7 +19,6 @@ namespace :tailwindcss do
     always = args.extras.include?("always")
     verbose = args.extras.include?("verbose")
 
-    Tailwindcss::Engines.bundle
     command = Tailwindcss::Commands.watch_command(always: always, debug: debug, poll: poll)
     env = Tailwindcss::Commands.command_env(verbose: verbose)
     puts "Running: #{Shellwords.join(command)}" if verbose
@@ -28,8 +27,16 @@ namespace :tailwindcss do
   rescue Interrupt
     puts "Received interrupt, exiting tailwindcss:watch" if args.extras.include?("verbose")
   end
+
+  desc "Create Rails Engines entry points"
+  task engines: :environment do
+    Tailwindcss::Engines.bundle
+  end
 end
 
+Rake::Task["tailwindcss:build"].enhance(["tailwindcss:engines"])
+Rake::Task["tailwindcss:watch"].enhance(["tailwindcss:engines"])
+
 Rake::Task["assets:precompile"].enhance(["tailwindcss:build"])
 
 if Rake::Task.task_defined?("test:prepare")