Release 5.3.1

Author: carlosame

Diff for: RELEASE_NOTES.md

@@ -1,62 +1,28 @@
-# css4j version 5.3 Release Notes
+# css4j version 5.3.1 Release Notes
 
-### March 31, 2025
+### April 1, 2025
 
 <br/>
 
 ## Highlights
 
-### Improved CSS function management
+### Regression fix
 
-- Function names are now converted to a canonical form (mostly lowercase, except for names like `rotateX` or `skewY`).
-- New type identifiers for many functions.
-- New `<easing-function>` syntax.
-- Add `LexicalUnit.shallowMatch(CSSValueSyntax)`, use in shorthand decompositions.
-- Prefixed functions are processed separately and no longer used in style computations.
-- Allow trailing comma in function arguments, see CSSWG issue 4968.
-- Added method `getContextIndex()` to `LexicalUnit`.
-- Undeprecate `CSSMathFunctionValue.MathFunction`, keep backwards compatibility broken by 5.2.
+This release fixes a DOM regression introduced in 5.3. All users of 5.3 should
+upgrade to 5.3.1.
 
-### `CSSEnvVariableValue` values
+### XML entities in pseudo-attributes
 
-`CSSEnvVariableValue` was updated to the latest specification which allows indices.
+The library now replaces XML predefined entities in the pseudo-attributes of
+Processing Instructions, for example `title="1&amp;2"`.
 
-In web browsers, `env()` is substituted at parse time. But given the multiplicity
-of use cases for this library, the substitution is done at computed-value time
-and this requires a CSSOM value interface.
+For details about the syntax, see
 
-### DOM wrapper
-
-A few improvements. For example, insert/remove/replace/append child operations
-are now allowed in elements.
+https://www.w3.org/TR/xml-stylesheet/xml-stylesheet.xml#NT-PseudoAtt
 
 <br/>
 
 ## Detail of changes
 
-- Undeprecate `CSSMathFunctionValue.MathFunction`, keep backwards compatibility broken by 5.2.
-- agent: deprecate archaic cookie management code for removal.
-- NSAC: convert function names to a canonical form (mostly lowercase, except for names like `rotateX` or `skewY`).
-- NSAC: allow trailing comma in function arguments, see CSSWG issue 4968.
-- NSAC: add method `getContextIndex()` to `LexicalUnit`. It may be useful to implementations.
-- NSAC: add `LexicalUnit.shallowMatch(CSSValueSyntax)`, use in shorthand decompositions.
-- NSAC,CSSOM: new type identifiers for many functions, including the `circle`, `ellipse`, `inset`, `path`, `polygon`, `shape` and `xywh` functions from CSS Shapes Module.
-- NSAC,CSSOM: new `<easing-function>` syntax.
-- NSAC,CSSOM: prefixed functions are processed separately and no longer used in style computations.
-- CSSOM: `CSSEnvVariableValue` update.
-- CSSOM: use the syntax match infrastructure in shorthand decomposition and gradients.
-- CSSOM: stop using `StyleDatabase.getWidthSize()` in `SimpleBoxModel`.
-- CSSOM: use the `BaseCSSStyleSheetFactory` class to load the default UA sheets. This avoids potential classloader issues when the factory is subclassed.
-- CSSOM: clamp RGB conversion in `HSLColorValue` (HSL colors belong to the sRGB color space, so in principle it is not needed to clamp. But clamp for safety anyway, in case that some numeric inaccuracy causes out-of-gamut mappings).
-- DOM wrapper: a few improvements, especially to element child handling.
-- DOM: stricter hierarchy checks in the native DOM.
-- Deprecation clean-up: Do not use java.net.URL() constructors.
-- Tests: add a couple of no-EntityResolver tests to `XMLDocumentBuilderTest`.
-- Tests: more URI management tests in the DOM & wrapper.
-- Code clean-up & formatting.
-- Gradle: move dependency versions to a separate properties file.
-- Add a SECURITY.md.
-- Upgrade to JUnit 5.12.1.
-- Upgrade to TokenProducer 3.1.
-- Upgrade to checkstyle 10.22.0.
-- Upgrade Gradle wrapper to 8.13.
+- Fix DOM regression introduced in be35ef9cea4.
+- Support XML entities in PI pseudo-attributes.

Diff for: build.gradle

@@ -17,7 +17,7 @@ plugins {
 }
 
 group = 'io.sf.carte'
-version = '6.0-SNAPSHOT'
+version = '5.3.1'
 description = 'css4j'
 
 java {