migrateSimpleLegacyClasses() — tailwindcss Function Reference

Source Code

packages/@tailwindcss-upgrade/src/codemods/template/migrate-simple-legacy-classes.ts lines 31–63

export function migrateSimpleLegacyClasses(
  designSystem: DesignSystem,
  _userConfig: Config | null,
  rawCandidate: string,
): string {
  // `outline-none` in v3 has the same meaning as `outline-hidden` in v4. However,
  // `outline-none` in v4 _also_ exists but has a different meaning.
  //
  // We can only migrate `outline-none` to `outline-hidden` if we are migrating a
  // v3 project to v4.
  if (version.isMajor(3)) {
    LEGACY_CLASS_MAP['outline-none'] = 'outline-hidden'
  }

  // Prepare design system with the unknown legacy classes
  if (!seenDesignSystems.has(designSystem)) {
    for (let old in LEGACY_CLASS_MAP) {
      designSystem.utilities.static(old, () => [])
    }
    seenDesignSystems.add(designSystem)
  }

  for (let candidate of designSystem.parseCandidate(rawCandidate)) {
    if (candidate.kind === 'static' && Object.hasOwn(LEGACY_CLASS_MAP, candidate.root)) {
      return designSystem.printCandidate({
        ...candidate,
        root: LEGACY_CLASS_MAP[candidate.root as keyof typeof LEGACY_CLASS_MAP],
      })
    }
  }

  return rawCandidate
}