From 274ab8d457c3ffc8cb2cffcdb3110a0cba7d3bda Mon Sep 17 00:00:00 2001 From: Jordan Pittman Date: Wed, 18 Jun 2025 09:39:46 -0400 Subject: [PATCH 1/3] =?UTF-8?q?Document=20`=E2=80=94watch=3Dalways`=20in?= =?UTF-8?q?=20the=20CLI?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- packages/@tailwindcss-cli/src/commands/build/index.ts | 4 +++- packages/@tailwindcss-cli/src/commands/help/index.ts | 6 +++++- packages/@tailwindcss-cli/src/utils/args.ts | 1 + 3 files changed, 9 insertions(+), 2 deletions(-) diff --git a/packages/@tailwindcss-cli/src/commands/build/index.ts b/packages/@tailwindcss-cli/src/commands/build/index.ts index 8babb5654671..3257c539c676 100644 --- a/packages/@tailwindcss-cli/src/commands/build/index.ts +++ b/packages/@tailwindcss-cli/src/commands/build/index.ts @@ -42,8 +42,10 @@ export function options() { }, '--watch': { type: 'boolean | string', - description: 'Watch for changes and rebuild as needed', + description: + 'Watch for changes and rebuild as needed. Use `always` to keep watching when stdin is closed.', alias: '-w', + values: ['always'], }, '--minify': { type: 'boolean', diff --git a/packages/@tailwindcss-cli/src/commands/help/index.ts b/packages/@tailwindcss-cli/src/commands/help/index.ts index 20ee78208440..a28132062a85 100644 --- a/packages/@tailwindcss-cli/src/commands/help/index.ts +++ b/packages/@tailwindcss-cli/src/commands/help/index.ts @@ -112,7 +112,11 @@ export function help({ // `alias` followed by `, ` and followed by the `flag`. let maxOptionLength = 0 - for (let [flag, { alias }] of Object.entries(options)) { + for (let [flag, { alias, values }] of Object.entries(options)) { + if (values?.length) { + flag += `[=${values.join(', ')}]` + } + // The option string, which is the combination of the alias and the flag // but already properly indented based on the other aliases to ensure // everything is aligned properly. diff --git a/packages/@tailwindcss-cli/src/utils/args.ts b/packages/@tailwindcss-cli/src/utils/args.ts index 1e4e153b8a03..1306aa2f2500 100644 --- a/packages/@tailwindcss-cli/src/utils/args.ts +++ b/packages/@tailwindcss-cli/src/utils/args.ts @@ -7,6 +7,7 @@ export type Arg = { description: string alias?: `-${string}` default?: Types[keyof Types] + values?: string[] } } From c0e83e3c1a535bc06bdb726311a6f29681259e12 Mon Sep 17 00:00:00 2001 From: Jordan Pittman Date: Wed, 18 Jun 2025 09:43:43 -0400 Subject: [PATCH 2/3] Update changelog --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 70036c42a1a2..a3286bad67f0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [Unreleased] - Add heuristic to skip candidate migrations inside `emit(…)` ([#18330](https://github.com/tailwindlabs/tailwindcss/pull/18330)) +- Document `--watch=always` in the CLI's usage ([#18337](https://github.com/tailwindlabs/tailwindcss/pull/18337)) ## [4.1.10] - 2025-06-11 From a6c0f121a4c59acce336365b15f720053f12366c Mon Sep 17 00:00:00 2001 From: Jordan Pittman Date: Thu, 19 Jun 2025 14:48:45 -0400 Subject: [PATCH 3/3] tweak wording --- packages/@tailwindcss-cli/src/commands/build/index.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/@tailwindcss-cli/src/commands/build/index.ts b/packages/@tailwindcss-cli/src/commands/build/index.ts index 3257c539c676..206bf27fbca2 100644 --- a/packages/@tailwindcss-cli/src/commands/build/index.ts +++ b/packages/@tailwindcss-cli/src/commands/build/index.ts @@ -43,7 +43,7 @@ export function options() { '--watch': { type: 'boolean | string', description: - 'Watch for changes and rebuild as needed. Use `always` to keep watching when stdin is closed.', + 'Watch for changes and rebuild as needed, and use `always` to keep watching when stdin is closed', alias: '-w', values: ['always'], },