support running tailwindcss cli with `npx @tailwindcss/cli`

[scratchmex]

in the case of tailwindcss, even tho the cli has that name, the package is actually @tailwindcss/cli so running npx tailwindcss doesn't make sense. the proposal is to add an special case where it actually runs npx --no-install @tailwindcss/cli <args> whenever we call exec.Npx. this will allow to use tailwindcss without any prior setup (apart from having npx)

the objective of this change is to avoid needing to install tailwindcss cli globally, nor having a npm/js project setup under hugo (defeats the purpose of the standalone tailwindcss cli)

change should be in this function

hugo/common/hexec/exec.go

Lines 176 to 177 in 7624176

	// If name is "tailwindcss", we will try the PATH as the second option.
	func (e *Exec) Npx(name string, arg ...any) (Runner, error) {

particulary adding a new exception here

hugo/common/hexec/exec.go

Lines 215 to 218 in 7624176

	if name == "tailwindcss" {
	// See https://github.com/gohugoio/hugo/issues/13221#issuecomment-2574801253
	locations = []binaryLocation{binaryLocationNodeModules, binaryLocationPath, binaryLocationNpx}
	}

I am open to do the PR after the heads up

[bep]

@tailwindcss/cli so running npx tailwindcss doesn't make sense.

It would make sense if npx resolved it correctly. I'm pretty sure I have tested this, but I may have been mistaken.

[scratchmex]

this is how I thought of running it and how it works

$ npm -g list
/opt/homebrew/lib
├── corepack@0.23.0
└── npm@10.8.1

$ npx --no-install @tailwindcss/cli -- -h
≈ tailwindcss v4.1.11

Invalid command: -h
...

edit: this also works, I don't know if it's more specific

$ npx --no-install --package=@tailwindcss/cli tailwindcss -- -h
≈ tailwindcss v4.1.11

Invalid command: -h
...

[jmooring]

jmooring@ubuntu:~/code/hugo-feature-test (main)$ npm -g list

/home/jmooring/.npm-global/lib
├── cspell@8.6.0
├── markdownlint@0.37.4
├── npm@11.4.0
└── pnpm@9.1.0

jmooring@ubuntu:~/code/hugo-feature-test (main)$ npx --no-install @tailwindcss/cli -- -h

npm error npx canceled due to missing packages and no YES option: ["@tailwindcss/cli@4.1.11"]
npm error A complete log of this run can be found in: /home/jmooring/.npm/_logs/2025-06-26T18_32_17_488Z-debug-0.log

[scratchmex]

can you try with the --package= option? can't reproduce it on my side

[jmooring]

Needs the --yes flag:

npx --no-install --yes @tailwindcss/cli -- -h