Handle new source(…)

[RobinMalfait]

This PR introduces a new source(…) argument and improves on the existing @source. The goal of this PR is to make the automatic source detection configurable, let's dig in.

By default, we will perform automatic source detection starting at the current working directory. Auto source detection will find plain text files (no binaries, images, ...) and will ignore git-ignored files.

If you want to start from a different directory, you can use the new source(…) next to the @import "tailwindcss/utilities" layer(utilities) source(…).

E.g.:

/* ./src/styles/index.css */
@import 'tailwindcss/utilities' layer(utilities) source('../../');

Most people won't split their source files, and will just use the simple @import "tailwindcss";, because of this reason, you can use source(…) on the import as well:

E.g.:

/* ./src/styles/index.css */
@import 'tailwindcss' source('../../');

Sometimes, you want to rely on auto source detection, but also want to look in another directory for source files. In this case, yuo can use the @source directive:

/* ./src/index.css */
@import 'tailwindcss';

/* Look for `blade.php` files in `../resources/views` */
@source '../resources/views/**/*.blade.php';

However, you don't need to specify the extension, instead you can just point the directory and all the same automatic source detection rules will apply.

/* ./src/index.css */
@import 'tailwindcss';

@source '../resources/views';

If, for whatever reason, you want to disable the default source detection feature entirely, and only want to rely on very specific glob patterns you define, then you can disable it via source(none).

/* Completely disable the default auto source detection */
@import 'tailwindcss' source(none);

/* Only look at .blade.php files, nothing else  */
@source "../resources/views/**/*.blade.php";

Note: even with source(none), if your @source points to a directory, then auto source detection will still be performed in that directory. If you don't want that, then you can simply add explicit files in the globs as seen in the previous example.

/* Completely disable the default auto source detection */
@import 'tailwindcss' source(none);

/* Run auto source detection in `../resources/views` */
@source "../resources/views";

[RobinMalfait]

• Handle new source(…) #14767 : 2 dependent PRs (#14812 , #14814 ) 👈
• Hide skipped tests #14766
• Refactor @media handling #14765
• next

This stack of pull requests is managed by Graphite. Learn more about stacking.

Join @RobinMalfait and the rest of your teammates on Graphite

[RobinMalfait]

closed in favor of #14820