tailwindcss Architecture Docs
Home / File/ migrate-tailwind-directives.ts — tailwindcss Source File

migrate-tailwind-directives.ts — tailwindcss Source File

Architecture documentation for migrate-tailwind-directives.ts, a typescript file in the tailwindcss codebase. 1 imports, 2 dependents.

File typescript UpgradeToolkit Codemods 1 imports 2 dependents 2 functions

Entity Profile

Dependency Diagram

graph LR
  66040ab2_cdeb_5acc_9ce9_433509fb3703["migrate-tailwind-directives.ts"]
  ba54c7c3_7b1e_9984_bfef_a693a3df2d84["postcss"]
  66040ab2_cdeb_5acc_9ce9_433509fb3703 --> ba54c7c3_7b1e_9984_bfef_a693a3df2d84
  8c7e8a4d_b48e_dd10_cef8_38f31c518cee["migrate-tailwind-directives.test.ts"]
  8c7e8a4d_b48e_dd10_cef8_38f31c518cee --> 66040ab2_cdeb_5acc_9ce9_433509fb3703
  67f80607_3a88_f275_79a1_b9557100d939["migrate.ts"]
  67f80607_3a88_f275_79a1_b9557100d939 --> 66040ab2_cdeb_5acc_9ce9_433509fb3703
  style 66040ab2_cdeb_5acc_9ce9_433509fb3703 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

import { AtRule, type ChildNode, type Plugin, type Root } from 'postcss'

const DEFAULT_LAYER_ORDER = ['theme', 'base', 'components', 'utilities']

export function migrateTailwindDirectives(options: { newPrefix: string | null }): Plugin {
  let prefixParams = options.newPrefix ? ` prefix(${options.newPrefix})` : ''

  function migrate(root: Root) {
    let baseNode = null as AtRule | null
    let utilitiesNode = null as AtRule | null
    let orderedNodes: AtRule[] = []

    let defaultImportNode = null as AtRule | null
    let utilitiesImportNode = null as AtRule | null
    let preflightImportNode = null as AtRule | null
    let themeImportNode = null as AtRule | null

    let layerOrder: string[] = []

    root.walkAtRules((node) => {
      // Migrate legacy `@import "tailwindcss/tailwind.css"`
      if (node.name === 'import' && node.params.match(/^["']tailwindcss\/tailwind\.css["']$/)) {
        node.params = node.params.replace('tailwindcss/tailwind.css', 'tailwindcss')
      }

      // Append any new prefix() param to existing `@import 'tailwindcss'` directives
      if (node.name === 'import' && node.params.match(/^["']tailwindcss["']/)) {
        node.params += prefixParams
      }

      // Track old imports and directives
      else if (
        (node.name === 'tailwind' && node.params === 'base') ||
        (node.name === 'import' && node.params.match(/^["']tailwindcss\/base["']$/))
      ) {
        layerOrder.push('base')
        orderedNodes.push(node)
        baseNode = node
      } else if (
        (node.name === 'tailwind' && node.params === 'utilities') ||
        (node.name === 'import' && node.params.match(/^["']tailwindcss\/utilities["']$/))
      ) {
        layerOrder.push('utilities')
        orderedNodes.push(node)
        utilitiesNode = node
      }

      // Remove directives that are not needed anymore
      else if (
        (node.name === 'tailwind' && node.params === 'components') ||
        (node.name === 'tailwind' && node.params === 'screens') ||
        (node.name === 'tailwind' && node.params === 'variants') ||
        (node.name === 'import' && node.params.match(/^["']tailwindcss\/components["']$/))
      ) {
        node.remove()
      }

      // Replace Tailwind CSS v2 directives that still worked in v3.
      else if (node.name === 'responsive') {
        if (node.nodes) {
// ... (129 more lines)

Domain

Subdomains

Functions

Dependencies

  • postcss

Imported By

Source

Frequently Asked Questions

What does migrate-tailwind-directives.ts do?
migrate-tailwind-directives.ts is a source file in the tailwindcss codebase, written in typescript. It belongs to the UpgradeToolkit domain, Codemods subdomain.
What functions are defined in migrate-tailwind-directives.ts?
migrate-tailwind-directives.ts defines 2 function(s): findTargetNode, migrateTailwindDirectives.
What does migrate-tailwind-directives.ts depend on?
migrate-tailwind-directives.ts imports 1 module(s): postcss.
What files import migrate-tailwind-directives.ts?
migrate-tailwind-directives.ts is imported by 2 file(s): migrate-tailwind-directives.test.ts, migrate.ts.
Where is migrate-tailwind-directives.ts in the architecture?
migrate-tailwind-directives.ts is located at packages/@tailwindcss-upgrade/src/codemods/css/migrate-tailwind-directives.ts (domain: UpgradeToolkit, subdomain: Codemods, directory: packages/@tailwindcss-upgrade/src/codemods/css).

Analyze Your Own Codebase

Get architecture documentation, dependency graphs, and domain analysis for your codebase in minutes.

Try Supermodel Free