mirror of
https://github.com/tailwindlabs/tailwindcss.git
synced 2025-12-08 21:36:08 +00:00
In Tailwind v4 the CSS file is the main entry point to your project and is generally configured via `@theme`. However, given that all v3 projects were configured via a `tailwind.config.js` file we definitely need to support those. This PR adds support for loading existing Tailwind config files by adding an `@config` directive to the CSS — similar to how v3 supported multiple config files except that this is now _required_ to use a config file. You can load a config file like so: ``` @import "tailwindcss"; @config "./path/to/tailwind.config.js"; ``` A few notes: - Both CommonJS and ESM config files are supported (loaded directly via `import()` in Node) - This is not yet supported in Intellisense or Prettier — should hopefully land next week - TypeScript is **not yet** supported in the config file — this will be handled in a future PR. --------- Co-authored-by: Philipp Spiess <hello@philippspiess.com> Co-authored-by: Adam Wathan <adam.wathan@gmail.com> Co-authored-by: Robin Malfait <malfait.robin@gmail.com>
107 lines
2.9 KiB
TypeScript
107 lines
2.9 KiB
TypeScript
import fs from 'node:fs/promises'
|
|
import path from 'node:path'
|
|
|
|
// Patterns we use to match dependencies in a file whether in CJS, ESM, or TypeScript
|
|
const DEPENDENCY_PATTERNS = [
|
|
/import[\s\S]*?['"](.{3,}?)['"]/gi,
|
|
/import[\s\S]*from[\s\S]*?['"](.{3,}?)['"]/gi,
|
|
/export[\s\S]*from[\s\S]*?['"](.{3,}?)['"]/gi,
|
|
/require\(['"`](.+)['"`]\)/gi,
|
|
]
|
|
|
|
// Given the current file `a.ts`, we want to make sure that when importing `b` that we resolve
|
|
// `b.ts` before `b.js`
|
|
//
|
|
// E.g.:
|
|
//
|
|
// a.ts
|
|
// b // .ts
|
|
// c // .ts
|
|
// a.js
|
|
// b // .js or .ts
|
|
const JS_EXTENSIONS = ['.js', '.cjs', '.mjs']
|
|
const JS_RESOLUTION_ORDER = ['', '.js', '.cjs', '.mjs', '.ts', '.cts', '.mts', '.jsx', '.tsx']
|
|
const TS_RESOLUTION_ORDER = ['', '.ts', '.cts', '.mts', '.tsx', '.js', '.cjs', '.mjs', '.jsx']
|
|
|
|
async function resolveWithExtension(file: string, extensions: string[]) {
|
|
// Try to find `./a.ts`, `./a.cts`, ... from `./a`
|
|
for (let ext of extensions) {
|
|
let full = `${file}${ext}`
|
|
|
|
let stats = await fs.stat(full).catch(() => null)
|
|
if (stats?.isFile()) return full
|
|
}
|
|
|
|
// Try to find `./a/index.js` from `./a`
|
|
for (let ext of extensions) {
|
|
let full = `${file}/index${ext}`
|
|
|
|
let exists = await fs.access(full).then(
|
|
() => true,
|
|
() => false,
|
|
)
|
|
if (exists) {
|
|
return full
|
|
}
|
|
}
|
|
|
|
return null
|
|
}
|
|
|
|
async function traceDependencies(
|
|
seen: Set<string>,
|
|
filename: string,
|
|
base: string,
|
|
ext: string,
|
|
): Promise<void> {
|
|
// Try to find the file
|
|
let extensions = JS_EXTENSIONS.includes(ext) ? JS_RESOLUTION_ORDER : TS_RESOLUTION_ORDER
|
|
let absoluteFile = await resolveWithExtension(path.resolve(base, filename), extensions)
|
|
if (absoluteFile === null) return // File doesn't exist
|
|
|
|
// Prevent infinite loops when there are circular dependencies
|
|
if (seen.has(absoluteFile)) return // Already seen
|
|
|
|
// Mark the file as a dependency
|
|
seen.add(absoluteFile)
|
|
|
|
// Resolve new base for new imports/requires
|
|
base = path.dirname(absoluteFile)
|
|
ext = path.extname(absoluteFile)
|
|
|
|
let contents = await fs.readFile(absoluteFile, 'utf-8')
|
|
|
|
// Recursively trace dependencies in parallel
|
|
let promises = []
|
|
|
|
for (let pattern of DEPENDENCY_PATTERNS) {
|
|
for (let match of contents.matchAll(pattern)) {
|
|
// Bail out if it's not a relative file
|
|
if (!match[1].startsWith('.')) continue
|
|
|
|
promises.push(traceDependencies(seen, match[1], base, ext))
|
|
}
|
|
}
|
|
|
|
await Promise.all(promises)
|
|
}
|
|
|
|
/**
|
|
* Trace all dependencies of a module recursively
|
|
*
|
|
* The result is an unordered set of absolute file paths. Meaning that the order
|
|
* is not guaranteed to be equal to source order or across runs.
|
|
**/
|
|
export async function getModuleDependencies(absoluteFilePath: string) {
|
|
let seen = new Set<string>()
|
|
|
|
await traceDependencies(
|
|
seen,
|
|
absoluteFilePath,
|
|
path.dirname(absoluteFilePath),
|
|
path.extname(absoluteFilePath),
|
|
)
|
|
|
|
return Array.from(seen)
|
|
}
|