CHANGELOG.md

Changes to PostCSS Custom Media

12.0.1

February 21, 2026

• Fix importance of custom media in anonymous cascade layers.

12.0.0

January 14, 2026

• Updated: Support for Node 20.19.0 or later (major).
• Removed: commonjs API. In supported Node versions require(esm) will work without needing to make code changes.
• Updated @csstools/css-tokenizer to 4.0.0 (major)
• Updated @csstools/css-parser-algorithms to 4.0.0 (major)
• Updated @csstools/cascade-layer-name-parser to 3.0.0 (major)
• Updated @csstools/media-query-list-parser to 5.0.0 (major)

11.0.6

May 27, 2025

• Updated @csstools/css-tokenizer to 3.0.4 (patch)
• Updated @csstools/css-parser-algorithms to 3.0.5 (patch)
• Updated @csstools/cascade-layer-name-parser to 2.0.5 (patch)
• Updated @csstools/media-query-list-parser to 4.0.3 (patch)

11.0.5

November 1, 2024

• Updated @csstools/css-tokenizer to 3.0.3 (patch)
• Updated @csstools/css-parser-algorithms to 3.0.4 (patch)
• Updated @csstools/cascade-layer-name-parser to 2.0.4 (patch)
• Updated @csstools/media-query-list-parser to 4.0.2 (patch)

11.0.4

October 23, 2024

• Updated @csstools/css-parser-algorithms to 3.0.3 (patch)
• Updated @csstools/cascade-layer-name-parser to 2.0.3 (patch)
• Updated @csstools/media-query-list-parser to 4.0.1 (patch)

11.0.3

October 10, 2024

• Fix inversion of logical expressions
• Updated @csstools/css-tokenizer to 3.0.2 (patch)
• Updated @csstools/css-parser-algorithms to 3.0.2 (patch)
• Updated @csstools/cascade-layer-name-parser to 2.0.2 (patch)
• Updated @csstools/media-query-list-parser to 4.0.0 (major)

11.0.2

October 4, 2024

• Fix @custom-media --foo screen; @media (color) and (--foo) {} not transforming.

11.0.1

August 18, 2024

• Updated @csstools/css-tokenizer to 3.0.1 (patch)
• Updated @csstools/css-parser-algorithms to 3.0.1 (patch)
• Updated @csstools/cascade-layer-name-parser to 2.0.1 (patch)
• Updated @csstools/media-query-list-parser to 3.0.1 (patch)

11.0.0

August 3, 2024

• Updated: Support for Node v18+ (major).
• Updated @csstools/css-tokenizer to 3.0.0 (major)
• Updated @csstools/css-parser-algorithms to 3.0.0 (major)
• Updated @csstools/cascade-layer-name-parser to 2.0.0 (major)
• Updated @csstools/media-query-list-parser to 3.0.0 (major)

10.0.8

July 6, 2024

• Updated @csstools/css-tokenizer to 2.4.1 (patch)
• Updated @csstools/css-parser-algorithms to 2.7.1 (patch)
• Updated @csstools/cascade-layer-name-parser to 1.0.13 (patch)
• Updated @csstools/media-query-list-parser to 2.1.13 (patch)

10.0.7

June 29, 2024

• Updated @csstools/css-tokenizer to 2.3.2 (patch)
• Updated @csstools/css-parser-algorithms to 2.7.0 (minor)
• Updated @csstools/cascade-layer-name-parser to 1.0.12 (patch)
• Updated @csstools/media-query-list-parser to 2.1.12 (patch)

10.0.6

May 4, 2024

• Updated @csstools/css-tokenizer to 2.3.1 (patch)
• Updated @csstools/css-parser-algorithms to 2.6.3 (patch)
• Updated @csstools/cascade-layer-name-parser to 1.0.11 (patch)
• Updated @csstools/media-query-list-parser to 2.1.11 (patch)

10.0.5

May 4, 2024

• Updated @csstools/css-tokenizer to 2.3.0 (minor)
• Updated @csstools/css-parser-algorithms to 2.6.2 (patch)
• Updated @csstools/cascade-layer-name-parser to 1.0.10 (patch)
• Updated @csstools/media-query-list-parser to 2.1.10 (patch)

10.0.4

March 13, 2024

• Updated @csstools/css-tokenizer to 2.2.4 (patch)
• Updated @csstools/css-parser-algorithms to 2.6.1 (patch)
• Updated @csstools/cascade-layer-name-parser to 1.0.9 (patch)
• Updated @csstools/media-query-list-parser to 2.1.9 (patch)

10.0.3

February 19, 2024

• Fix type definitions
• Updated @csstools/cascade-layer-name-parser to 1.0.8 (patch)
• Updated @csstools/css-parser-algorithms to 2.6.0 (minor)
• Updated @csstools/css-tokenizer to 2.2.3 (patch)
• Updated @csstools/media-query-list-parser to 2.1.8 (patch)

10.0.2

October 9, 2023

• Updated @csstools/css-tokenizer to 2.2.1 (patch)
• Updated @csstools/css-parser-algorithms to 2.3.2 (patch)
• Updated @csstools/cascade-layer-name-parser to 1.0.5 (patch)
• Updated @csstools/media-query-list-parser to 2.1.5 (patch)

10.0.1

September 18, 2023

• Updated @csstools/css-tokenizer to 2.2.0 (minor)
• Updated @csstools/css-parser-algorithms to 2.3.1 (patch)
• Updated @csstools/cascade-layer-name-parser to 1.0.4 (patch)
• Updated @csstools/media-query-list-parser to 2.1.4 (patch)

10.0.0

July 3, 2023

• Change license to MIT-0 (read more about this change in the blog post)
• Updated @csstools/css-parser-algorithms to 2.3.0 (minor)
• Updated @csstools/cascade-layer-name-parser to 1.0.3 (patch)
• Updated @csstools/media-query-list-parser to 2.1.2 (patch)

9.1.5

June 21, 2023

• Updated @csstools/media-query-list-parser to 2.1.1 (patch)

9.1.4

June 1, 2023

• Updated @csstools/media-query-list-parser to 2.1.0 (minor)

9.1.3

April 10, 2023

• Updated @csstools/css-tokenizer to 2.1.1 (patch)
• Updated @csstools/css-parser-algorithms to 2.1.1 (patch)
• Updated @csstools/cascade-layer-name-parser to 1.0.2 (patch)
• Updated @csstools/media-query-list-parser to 2.0.4 (patch)

9.1.2

February 8, 2023

• Fixed: exception on missing media queries.
• Reduce the amount of duplicate fallback CSS.

9.1.1

January 28, 2023

• Improve types declaration in package.json

9.1.0

January 24, 2023

• Added: Support for Cascade Layers.

9.0.1

November 19, 2022

• Fixed: avoid complex generated CSS when @custom-media contains only a single simple media feature.

9.0.0

November 14, 2022

• Updated: Support for Node v14+ (major).
• Removed: importFrom feature (breaking).
• Removed: exportTo feature (breaking).
• Removed: References without parenthesis @media --foo {} (breaking).
• Fixed: implement logical evaluation of custom media queries.
• Added: Support for true and false keywords in @custom-media.

8.0.2

June 4, 2022

• Fixed: dependency declarations in package.json

8.0.1

June 3, 2022

• Updated: use specific AtRule visitor
• Fixed: allow any valid ident in custom media (@custom-media --🧑🏾‍🎤 (min-width: 320px);)
• Fixed: allow white space around custom media (@media ( --mq-1 );) (csstools/postcss-custom-media#59) (csstools/postcss-custom-media#71)

8.0.0

January 12, 2021

• Added: Support for PostCSS v8

7.0.8

March 30, 2019

• Fixed: Issue importing from .pcss files
• Updated: postcss to 7.0.14 (patch)

7.0.7

October 19, 2018

• Fixed: Issue combining custom media media queries with and

7.0.6

October 12, 2018

• Fixed: Issue combining multiple custom media

7.0.5

October 5, 2018

• Fixed: Possible issues resolving paths to imports and exports
• Added: Imports from customMedia and custom-media simultaneously
• Updated: postcss to 7.0.5

7.0.4

September 23, 2018

• Added: importFromPlugins option to process imports

7.0.3

September 20, 2018

• Fixed: Do not break on an empty importFrom object

7.0.2

September 15, 2018

• Fixed: An issue with re-assigning params as a non-string

7.0.1

September 14, 2018

• Fixed: An issue with how opposing queries are resolved.

7.0.0

September 14, 2018

• Added: New preserve option to preserve custom media and atrules using them
• Added: New exportTo function to specify where to export custom media
• Added: New importFrom option to specify where to import custom media
• Added: Support for PostCSS v7
• Added: Support for Node v6+

6.0.0 (May 12, 2017)

• Added: compatibility with postcss v6.x

5.0.1 (February 3, 2016)

• Fixed: circular dependencies are properly detected (csstools/postcss-custom-media#17)

5.0.0 (August 25, 2015)

• Removed: compatibility with postcss v4.x
• Added: compatibility with postcss v5.x

4.1.0 (06 30, 2015)

• Added: Allow custom media to reference each other (csstools/postcss-custom-media#10)

4.0.0 (May 17, 2015)

• Changed: warning messages are now sent via postcss messages api (^4.1.0)
• Added: automatic custom media -- prefixing (csstools/postcss-custom-media#11)
• Added: preserve allows you to preserve custom media query defintions
• Added: appendExtensions allows you (when preserve is truthy) to append your extensions as media queries

3.0.0 (January 29, 2015)

• Added: compatibility with postcss v4.x
• Removed: compatibility with postcss v3.x

2.0.0 [Yanked]

You never saw this version (this is a bad release that points to 1.0.0).

1.3.0 (November 25, 2014)

• Changed: better gnu message

1.2.1 (October 9, 2014)

• Fixed: npm description

1.2.0 (October 1, 2014)

• Added: support for multiples media in query list (ref reworkcss/rework-custom-media#5)

1.1.0 (September 30, 2014)

• Added: support for js-defined media queries (fix csstools/postcss-custom-media#3)

1.0.1 (September 16, 2014)

• Added: Allow whitespace around custom media name (fix csstools/postcss-custom-media#2)

1.0.0 (August 12, 2014)

✨ First release based on https://github.com/reworkcss/rework-custom-media v0.1.1