This PR ensure that we lazy load the `@parcel/watcher` in the `@tailwindcss/cli`. This means that we don't have to load it at all when using a normal build or when using `--watch --poll` combination. The bigger reason is that on some platforms `@parcel/watcher` might not work, and therefore the build will fail even if you don't use `--watch` at all. This PR fixes that by lazy loading it. Then, if we can't load it when using `--watch`, a useful workaround is shown by using `--watch --poll` instead. This PR also improves showing errors such that the `error.cause` property can be rendered as well. Maybe in the future we can make use of deferred imports (https://github.com/tc39/proposal-defer-import-eval) Fixes: #20322 ## Test plan 1. All tests still pass [ci-all] 2. Fabricated a fake error locally to prove that we can still use a normal build and `--watch --poll` as a workaround <img width="1122" height="1376" alt="file-2f91d99cfb9eb0e24a196c2dd358c1f3" src="https://github.com/user-attachments/assets/e37658ee-0827-422e-bd50-8ea5a85e1b7c" />
104 lines
2.5 KiB
TypeScript
104 lines
2.5 KiB
TypeScript
import fs from 'node:fs'
|
|
import path from 'node:path'
|
|
import { stripVTControlCharacters } from 'node:util'
|
|
import pc from 'picocolors'
|
|
import { resolve } from '../utils/resolve'
|
|
import { formatNanoseconds } from './format-ns'
|
|
|
|
export const UI = {
|
|
indent: 2,
|
|
}
|
|
export function header() {
|
|
return `${pc.italic(pc.bold(pc.blue('\u2248')))} tailwindcss ${pc.blue(`v${getVersion()}`)}`
|
|
}
|
|
|
|
export function highlight(file: string) {
|
|
return `${pc.dim(pc.blue('`'))}${pc.blue(file)}${pc.dim(pc.blue('`'))}`
|
|
}
|
|
|
|
/**
|
|
* Convert an `absolute` path to a `relative` path from the current working
|
|
* directory.
|
|
*/
|
|
export function relative(
|
|
to: string,
|
|
from = process.cwd(),
|
|
{ preferAbsoluteIfShorter = true } = {},
|
|
) {
|
|
let result = path.relative(from, to)
|
|
if (!result.startsWith('..')) {
|
|
result = `.${path.sep}${result}`
|
|
}
|
|
|
|
if (preferAbsoluteIfShorter && result.length > to.length) {
|
|
return to
|
|
}
|
|
|
|
return result
|
|
}
|
|
|
|
/**
|
|
* Wrap `text` into multiple lines based on the `width`.
|
|
*/
|
|
export function wordWrap(text: string, width: number) {
|
|
let words = text.split(' ')
|
|
let lines = []
|
|
|
|
let line = ''
|
|
let lineLength = 0
|
|
for (let word of words) {
|
|
let wordLength = stripVTControlCharacters(word).length
|
|
|
|
// A word longer than `width` is kept on its own line rather than
|
|
// introducing an empty line before it.
|
|
if (lineLength > 0 && lineLength + wordLength + 1 > width) {
|
|
lines.push(line)
|
|
line = ''
|
|
lineLength = 0
|
|
}
|
|
|
|
line += (lineLength ? ' ' : '') + word
|
|
lineLength += wordLength + (lineLength ? 1 : 0)
|
|
}
|
|
|
|
if (lineLength) {
|
|
lines.push(line)
|
|
}
|
|
|
|
return lines
|
|
}
|
|
|
|
/**
|
|
* Format a duration in nanoseconds to a more human readable format.
|
|
*/
|
|
export function formatDuration(ns: bigint) {
|
|
let formatted = formatNanoseconds(ns)
|
|
|
|
if (ns <= 50 * 1e6) return pc.green(formatted)
|
|
if (ns <= 300 * 1e6) return pc.blue(formatted)
|
|
if (ns <= 1000 * 1e6) return pc.yellow(formatted)
|
|
|
|
return pc.red(formatted)
|
|
}
|
|
|
|
export function indent(value: string, offset = 0) {
|
|
return `${' '.repeat(offset + UI.indent)}${value}`
|
|
}
|
|
|
|
// Rust inspired functions to print to the console:
|
|
|
|
export function eprintln(value = '') {
|
|
process.stderr.write(`${value}\n`)
|
|
}
|
|
|
|
export function println(value = '') {
|
|
process.stdout.write(`${value}\n`)
|
|
}
|
|
|
|
function getVersion(): string {
|
|
if (typeof globalThis.__tw_version === 'string') {
|
|
return globalThis.__tw_version
|
|
}
|
|
let { version } = JSON.parse(fs.readFileSync(resolve('tailwindcss/package.json'), 'utf-8'))
|
|
return version
|
|
}
|