v1.0.0

v1! 🎉

Overview

After being 5 months on v0 I think it's time to release a stable version of tailwind-merge. Tailwind v3 was released yesterday and it's no coincidence that I'm releasing tailwind-merge v1 today. I added full support for Tailwind v3 so you can update both at once.

There are no breaking changes in the tailwind-merge types and some breaking changes for a small number of users in the return values, so you should get through smoothly.

By the way, you can now sponsor this project. 😊

Breaking Changes

• twMerge, extendTailwindMerge

  • Outline utilities from Tailwind v2 don't get merged anymore since they were replaced by outline width, outline style, outline offset and outline color in Tailwind v3 (55ab167, #63)
  • The classes overflow-ellipsis and overflow-clip will not get merged with class truncate anymore, but the new Tailwind v3 classes text-ellipsis and text-clip will. (65b03e4, #63)
  • The classes decoration-slice and decoration-clone won't get merged anymore and box-decoration-slide nad box-decoration-clone will (bfe2cc9, #63)

• getDefaultConfig

  • Removed class group outline since it was removed in Tailwind v3 (55ab167, #63)
  • Renamed class group vertival-alignment (yes, the typo was in the code) to vertical-align (1269ce6, #63)
  • Renamed class groups flex-basis, flex-grow and flex-shrink to basis, grow and shrink to stay consistent with Tailwind v3 (e6d8912, #63)

• validators

  • isCustomLength and isCustomValue were renamed to isArbitraryLength and isArbitraryValue to be consistent with naming in Tailwind v3 documentation (adc3c02, #63)

New Features

• Add support for Tailwind v3 by @dcastil in #63
  • Support for all the new utility classes and variants in Tailwind v3.0.0
  • Support for arbitrary properties like [--my-var:20px]
  • Support for important modifiers in arbitrary properties like ![--my-very-important-var: 21px]
  • Support for new labels for classes with arbitrary value: size, position, url, weight and family
  • New validators isTshirtSize, isArbitrarySize, isArbitraryPosition, isArbitraryUrl and isArbitraryWeight, check them out in the documentation! (fec2b18, f8acd7c, #63)

Full Changelog: v0.9.0...v1.0.0