Function getTailwindConfig

src/sorter.ts:107–202

(options: TailwindConfigOptions)

 * @internal
 */
export async function getTailwindConfig(options: TailwindConfigOptions): Promise<UnifiedApi> {
  let base = options.base ?? process.cwd()
  let inputDir = options.filepath ? path.dirname(options.filepath) : base

  let configPath = resolveIfRelative(base, options.configPath)
  let stylesheetPath = resolveIfRelative(base, options.stylesheetPath)

  // Locate Tailwind CSS itself
  //
  // We resolve this like we're in `inputDir` for better monorepo support as
  // Prettier may be configured at the workspace root but Tailwind CSS is
  // installed for a workspace package rather than the entire monorepo
  let [mod, pkgDir] = await resolveTailwindPath({ packageName: options.packageName }, inputDir)

  // Locate project stylesheet relative to the formatter config file
  //
  // We resolve this relative to the config file because it is *required*
  // to work with a project's custom config. Given that, resolving it
  // relative to where the path is defined makes the most sense.
  let stylesheet = resolveStylesheet(stylesheetPath, base)

  // Locate *explicit* v3 configs relative to the formatter config file
  //
  // We use this as a signal that we should always use v3 to format files even
  // when the local install is v4 — which means we'll use the bundled v3.
  let jsConfig = resolveJsConfigPath(configPath)

  // Locate the closest v3 config file
  //
  // Note:
  // We only need to do this when a stylesheet has not been provided otherwise
  // we'd know for sure this was a v4 project regardless of what local Tailwind
  // CSS installation is present. Additionally, if the local version is v4 we
  // skip this as we assume that the user intends to use that version.
  //
  // The config path is resolved in one of two ways:
  //
  // 1. When automatic, relative to the input file
  //
  // This ensures monorepos can load the "closest" JS config for a given file
  // which is important when a workspace package includes Tailwind CSS *and*
  // Prettier is configured globally instead of per-package.
  //
  // 2. When explicit via `configPath`, relative to `base`
  if (!stylesheet && !mod?.__unstable__loadDesignSystem) {
    jsConfig = jsConfig ?? findClosestJsConfig(inputDir)
  }

  // We've found a JS config either because it was specified by the user
  // or because it was automatically located. This means we should use v3.
  if (jsConfig) {
    if (!stylesheet) {
      return pathToApiMap.remember(`${pkgDir}:${jsConfig}`, async () => {
        const { loadV3 } = await import('./versions/v3')
        return loadV3(pkgDir, jsConfig)
      })
    }