All Versions
41
Latest Version
Avg Release Cycle
190 days
Latest Release
120 days ago

Changelog History
Page 1

  • v9.4.0 Changes

    June 18, 2026

    What's Changed

    🗄 Deprecated

    • 🗄 Deprecate support for PHP 7.2 and 7.3 (#1565)

    🛠 Fixed

    • 👍 Allow CSS containing only whitespace or comments (#1593)
    • 📜 Only allow strings as LineName components (#1590)

    Full Changelog : v9.3.0...v9.4.0

  • v9.3.0 Changes

    March 03, 2026

    ➕ Added

    • ➕ Add support for modern CSS at-rules: @layer, @scope, and @starting-style (#1549)

    🛠 Fixed

    • 📜 Avoid double autoloading of class aliases (#1552)

    🆕 New Contributors

    Full Changelog : v9.2.0...v9.3.0

  • v9.2.0 Changes

    February 21, 2026

    ➕ Added

    • ➕ Add OutputFormat::setSpaceAroundSelectorCombinator() (#1504)
    • ➕ Add support for escaped quotes in the selectors (#1485, #1489)
    • 👻 Provide line number in exception message for mismatched parentheses in
      📜 selector (#1435)
    • ➕ Add support for CSS container queries (#1400)

    🔄 Changed

    • 📜 RuleSet\RuleContainer is renamed to RuleSet\DeclarationList (#1530, #1539)
    • Methods like setRule() in RuleSet and DeclarationBlock have been renamed
      📜 to setDeclaration(), etc. (#1521)
    • Rule\Rule class is renamed to Property\Declaration
      📜 (#1508, #1512, #1513, #1522)
    • Rule::setRule() and getRule() are replaced with setPropertyName() and
      📜 getPropertyName() (#1506)
    • Selector is now represented as a sequence of Selector\Component objects
      which can be accessed via getComponents(), manipulated individually, or set
      📜 via setComponents() (#1478, #1486, #1487, #1488, #1494, #1496, #1536, #1537)
    • 👻 Selector::setSelector() and Selector constructor will now throw exception
      📜 upon provision of an invalid selectior (#1498, #1502)
    • 📜 Clean up extra whitespace in CSS selector (#1398)
    • The array keys passed to DeclarationBlock::setSelectors() are no longer
      📜 preserved (#1407)

    🗄 Deprecated

    • 🗄 RuleSet\RuleContainer is deprecated; use RuleSet\DeclarationList instead
      📜 (#1530)
    • 🗄 Methods like setRule() in RuleSet and DeclarationBlock are deprecated;
      📜 there are direct replacements such as setDeclaration() (#1521)
    • 🗄 Rule\Rule class is deprecated; Property\Declaration is a direct
      📜 replacement (#1508)
    • 🗄 Rule::setRule() and getRule() are deprecated and replaced with
      📜 setPropertyName() and getPropertyName() (#1506, #1519)

    🛠 Fixed

    • 📜 Do not escape characters that do not need escaping in CSS string (#1444)
    • 📜 Reject selector comprising only whitespace (#1433)
    • 👌 Improve recovery parsing when a rogue } is encountered (#1425, #1426)
    • 📜 Parse comment(s) immediately preceding a selector (#1421, #1424)
    • 📜 Parse consecutive comments (#1421)
    • 👌 Support attribute selectors with values containing commas in
      📜 DeclarationBlock::setSelectors() (#1419)
    • 👍 Allow removeDeclarationBlockBySelector() to be order-insensitve (#1406)
    • 🛠 Fix parsing of calc expressions when a newline immediately precedes or
      📜 follows a + or - operator (#1399)
    • 📜 Use typesafe versions of PHP functions (#1379, #1380, #1382, #1383, #1384)

    🆕 New Contributors

    Full Changelog : v9.1.0...v9.2.0

  • v9.1.0 Changes

    September 14, 2025

    ➕ Added

    • ➕ Add support for PHP 8.5 (#1355)

    🛠 Fixed

    • 👌 Improve performance of selector validation
      📜 (avoiding silent PCRE catastrophic failure) (#1372)
    • 📜 Use typesafe versions of PHP functions (#1368, #1370)

  • v9.0.0 Changes

    July 27, 2025

    ➕ Added

    • 📜 Interface RuleContainer for RuleSet Rule manipulation methods (#1256)

    • 👍 Partial support for CSS Color Module Level 4:

      • rgb and rgba, and hsl and hsla are now aliases (#797)
      • Parse color functions that use the "modern" syntax (#800)
      • Render RGB functions with "modern" syntax when required (#840)
      • Support none as color function component value (#859)

    • ➕ Add a class diagram to the README (#482)

    • ➕ Add more tests (#449)

    🔄 Changed

    • DeclarationBlock no longer extends RuleSet and instead has a RuleSet as
      📜 a property; use getRuleSet() to access it directly (#1194)
    • 0️⃣ The default line (and column) number is now null (not zero) (#1288)
    • setPosition() (in Rule and other classes) now has fluent interface,
      📜 returning itself (#1259)
    • 🚚 RuleSet::removeRule() now only allows Rule as the parameter
      (implementing classes are AtRuleSet and DeclarationBlock);
      🚚 use removeMatchingRules() or removeAllRules() for other functions (#1255)
    • RuleSet::getRules() and getRulesAssoc() now only allow string or null
      as the parameter (implementing classes are AtRuleSet and DeclarationBlock)
      📜 (#1253)
    • 🎉 Initialize KeyFrame properties to sensible defaults (#1146)
    • 📜 Make OutputFormat final (#1128)
    • 📜 Make Selector a Renderable (#1017)
    • 📜 Only allow string for some OutputFormat properties (#885)
    • 👉 Use more native type declarations and strict mode
      📜 (#641, #772, #774, #778, #804, #841, #873, #875, #891, #922, #923, #933, #958,
      📜 #964, #967, #1000, #1044, #1134, #1136, #1137, #1139, #1140, #1141, #1145,
      📜 #1162, #1163, #1166, #1172, #1174, #1178, #1179, #1181, #1183, #1184, #1186,
      📜 #1187, #1190, #1192, #1193, #1203)
    • ➕ Add visibility to all class/interface constants (#469)

    ✂ Removed

    • ✂ Remove getLineNo() from these classes (use getLineNumber() instead):
      Comment, CSSList, SourceException, Charset, CSSNamespace, Import,
      📜 Rule, DeclarationBlock, RuleSet, CSSFunction, Value (#1258)
    • ✂ Remove Rule::getColNo() (use getColumnNumber() instead) (#1287)
    • Passing a string as the first argument to getAllValues() is no longer
      👌 supported and will not work;
      📜 the search pattern should now be passed as the second argument (#1243)
    • Passing a Boolean as the second argument to getAllValues() is no longer
      👌 supported and will not work; the flag for searching in function arguments
      📜 should now be passed as the third argument (#1243)
    • ✂ Remove __toString() (#1046)
    • ⬇️ Drop magic method forwarding in OutputFormat (#898)
    • ⬇️ Drop atRuleArgs() from the AtRule interface (#1141)
    • ✂ Remove OutputFormat::get() and ::set() (#1108, #1110)
    • ⬇️ Drop special support for vendor prefixes (#1083)
    • ✂ Remove the IE hack in Rule (#995)
    • ⬇️ Drop getLineNo() from the Renderable interface (#1038)
    • ✂ Remove OutputFormat::level() (#874)
    • ✂ Remove expansion of shorthand properties (#838)
    • ✂ Remove Parser::setCharset/getCharset (#808)
    • ✂ Remove Rule::getValues() (#582)
    • ✂ Remove Rule::setValues() (#562)
    • ✂ Remove Document::getAllSelectors() (#561)
    • ✂ Remove DeclarationBlock::getSelector() (#559)
    • ✂ Remove DeclarationBlock::setSelector() (#560)
    • ⬇️ Drop support for PHP < 7.2 (#420)

    🛠 Fixed

    • ✂ Remove trailing semicolon from declaration blocks with 'compact'
      📜 OutputFormat (#1345)
    • 📜 Parse selector functions (like :not) with comma-separated arguments (#1292)
    • 📜 Parse quoted attribute selector value containing comma (#1323)
    • 👍 Allow comma in selectors (e.g. :not(html, body)) (#1293)
    • Insert Rule before sibling even with different property name
      📜 (in RuleSet::addRule()) (#1270)
    • Ensure RuleSet::addRule() sets non-negative column number when sibling
      📜 provided (#1268)
    • 📜 Don't render rgb colors with percentage values using hex notation (#803)

    📚 Documentation

    • ➕ Add an API and deprecation policy (#720)

    🚀 @ziegenberg is a new contributor to this release and did a lot of the heavy
    lifting. Thanks! ❤️

  • v8.9.0 Changes

    July 11, 2025

    ➕ Added

    • 🚚 RuleSet::removeMatchingRules() method
      📜 (for the implementing classes AtRuleSet and DeclarationBlock) (#1249)
    • 🚚 RuleSet::removeAllRules() method
      📜 (for the implementing classes AtRuleSet and DeclarationBlock) (#1249)
    • ➕ Add Interface CSSElement (#1231)
    • Methods getLineNumber and getColumnNumber which return a nullable int
      for the following classes:
      Comment, CSSList, SourceException, Charset, CSSNamespace, Import,
      📜 Rule, DeclarationBlock, RuleSet, CSSFunction, Value (#1225, #1263)
    • Positionable interface for CSS items that may have a position
      📜 (line and perhaps column number) in the parsed CSS (#1221)

    🔄 Changed

    • Parameters for getAllValues() are deconflated, so it now takes three (all
      optional), allowing $element and $ruleSearchPattern to be specified
      📜 separately (#1241)
    • Implement Positionable in the following CSS item classes:
      Comment, CSSList, SourceException, Charset, CSSNamespace, Import,
      📜 Rule, DeclarationBlock, RuleSet, CSSFunction, Value (#1225)

    🗄 Deprecated

    • 👌 Support for PHP < 7.2 is deprecated; version 9.0 will require PHP 7.2 or later
      📜 (#1264)
    • 🚚 Passing a string or null to RuleSet::removeRule() is deprecated
      (implementing classes are AtRuleSet and DeclarationBlock);
      🚚 use removeMatchingRules() or removeAllRules() instead (#1249)
    • 🗄 Passing a Rule to RuleSet::getRules() or getRulesAssoc() is deprecated,
      affecting the implementing classes AtRuleSet and DeclarationBlock
      📜 (call e.g. getRules($rule->getRule()) instead) (#1248)
    • 🗄 Passing a string as the first argument to getAllValues() is deprecated;
      📜 the search pattern should now be passed as the second argument (#1241)
    • 🗄 Passing a Boolean as the second argument to getAllValues() is deprecated;
      the flag for searching in function arguments should now be passed as the third
      📜 argument (#1241)
    • 🗄 getLineNo() is deprecated in these classes (use getLineNumber() instead):
      Comment, CSSList, SourceException, Charset, CSSNamespace, Import,
      📜 Rule, DeclarationBlock, RuleSet, CSSFunction, Value (#1225, #1233)
    • 🗄 Rule::getColNo() is deprecated (use getColumnNumber() instead)
      📜 (#1225, #1233)
    • Providing zero as the line number argument to Rule::setPosition() is
      🗄 deprecated (pass null instead if there is no line number) (#1225, #1233)

    🛠 Fixed

    • Set line number when RuleSet::addRule() called with only column number set
      📜 (#1265)
    • 📜 Ensure first rule added with RuleSet::addRule() has valid position (#1262)

  • v8.8.0 Changes

    March 23, 2025

    ➕ Added

    • 📜 OutputFormat properties for space around specific list separators (#880)

    🔄 Changed

    • 📜 Mark the OutputFormat constructor as @internal (#1131)
    • 📜 Mark OutputFormatter as @internal (#896)
    • 📜 Mark Selector::isValid() as @internal (#1037)
    • 📜 Mark parsing-related methods of most CSS elements as @internal (#908)
    • 📜 Mark OutputFormat::nextLevel() as @internal (#901)
    • 📜 Make all non-private properties @internal (#886)

    🗄 Deprecated

    • 🗄 Deprecate extending OutputFormat (#1131)
    • 🗄 Deprecate OutputFormat::get() and ::set() (#1107)
    • 🗄 Deprecate support for -webkit-calc and -moz-calc (#1086)
    • 🗄 Deprecate magic method forwarding from OutputFormat to OutputFormatter
      📜 (#894)
    • 🗄 Deprecate __toString() (#1006)
    • 🗄 Deprecate greedy calculation of selector specificity (#1018)
    • 🗄 Deprecate the IE hack in Rule (#993, #1003)
    • 📜 OutputFormat properties for space around list separators as an array (#880)
    • 🗄 Deprecate OutputFormat::level() (#870)

    🛠 Fixed

    • 📜 Include comments for all rules in declaration block (#1169)
    • 📜 Render rules in line and column number order (#1059)
    • 📜 Create Size with correct types in expandBackgroundShorthand (#814)
    • 📜 Parse @font-face src property as comma-delimited list (#794)

  • v8.7.0 Changes

    October 27, 2024

    ➕ Added

    🔄 Changed

    • 📜 Mark parsing-internal classes and methods as @internal (#711)
    • 📜 Block installations on unsupported higher PHP versions (#691)

    🗄 Deprecated

    • 🗄 Deprecate the expansion of shorthand properties (#719)
    • 🗄 Deprecate Parser::setCharset() and Parser::getCharset() (#703)

  • v8.6.0 Changes

    July 01, 2024

    ➕ Added

    • 👌 Support arithmetic operators in CSS function arguments (#607)
    • ➕ Add support for inserting an item in a CSS list (#545)
    • ➕ Add support for the dvh, lvh and svh length units (#415)

    🔄 Changed

    • 👌 Improve performance of Value::parseValue with many delimiters by refactoring to remove array_search() (#413)

  • v8.5.2 Changes

    June 28, 2024

    🔄 Changed

    • 📜 Mark all class constants as @internal (#500)

    🛠 Fixed

    • 🛠 Fix undefined local variable in CalcFunction::parse() (#593)