Function optimizeAst

packages/tailwindcss/src/ast.ts:222–683

(
  ast: AstNode[],
  designSystem: DesignSystem,
  polyfills: Polyfills = Polyfills.All,
)

class="cm">// Optimize the AST for printing where all the special nodes that require custom
class="cm">// handling are handled such that the printing is a 1-to-1 transformation.
export function optimizeAst(
  ast: AstNode[],
  designSystem: DesignSystem,
  polyfills: Polyfills = Polyfills.All,
) {
  let atRoots: AstNode[] = []
  let seenAtProperties = new Set<string>()
  let cssThemeVariables = new DefaultMap<AstNode[], Set<Declaration>>(() => new Set())
  let colorMixDeclarations = new DefaultMap<AstNode[], Set<Declaration>>(() => new Set())
  let keyframes = new Set<AtRule>()
  let usedKeyframeNames = new Set()

  let propertyFallbacksRoot: Declaration[] = []
  let propertyFallbacksUniversal: Declaration[] = []

  let variableDependencies = new DefaultMap<string, Set<string>>(() => new Set())

  function transform(
    node: AstNode,
    parent: AstNode[],
    context: Record<string, string | boolean> = {},
    depth = 0,
  ) {
    class="cm">// Declaration
    if (node.kind === class="st">'declaration') {
      if (node.property === class="st">'--tw-sort' || node.value === undefined || node.value === null) {
        return
      }

      class="cm">// Track variables defined in `@theme`
      if (context.theme && node.property[0] === class="st">'-' && node.property[1] === class="st">'-') {
        class="cm">// Variables that resolve to `initial` should never be emitted. This can happen because of
        class="cm">// the `--theme(…)` being used and evaluated lazily
        if (node.value === class="st">'initial') {
          node.value = undefined
          return
        }

        if (!context.keyframes) {
          cssThemeVariables.get(parent).add(node)
        }
      }

      class="cm">// Track used CSS variables
      if (node.value.includes(class="st">'var(')) {
        class="cm">// Declaring another variable does not count as usage. Instead, we mark
        class="cm">// the relationship
        if (context.theme && node.property[0] === class="st">'-' && node.property[1] === class="st">'-') {
          for (let variable of extractUsedVariables(node.value)) {
            variableDependencies.get(variable).add(node.property)
          }
        } else {
          designSystem.trackUsedVariables(node.value)
        }
      }

      class="cm">// Track used animation names
      if (node.property === class="st">'animation') {