chore: release 4.0.0

[github-actions]

I have created a release PR for this version

4.0.0 (2025-08-25)

⚠ BREAKING CHANGES

• refactor exceptions handling for JsonbArray in the style used for the network types (#311)
• preserve the type of booleans, floats, integers & scientific notations when transforming back and forth between PostgreSQL and PHP (#304)

Features

• Support PostGIS martin-georgiev/postgresql-for-doctrine#305: Add support for PostGIS's types of GEOGRAPHY, GEOMETRY and their array variations (#421) (d97caae)
• JSON_GET_FIELD fails when using integer for array element access martin-georgiev/postgresql-for-doctrine#401: Improve JSON field extraction by adding index support (#402) (8d18b35)
• Add (limited) support for json_exists, json_query, json_scalar, json_serialize and json_value (#277) (4a26400)
• Add NULL value support for array_append(), array_replace(), array_prepend(), array_remove() and improve test scenarios for NULL (#322) (396856f)
• Add limited support for json_build_object and jsonb_build_object (#268) (2605f5a)
• Add multiple arguments support for ARRAY (#279) (7f2b05d)
• Add support for any_value() (#323) (19ee3db)
• Add support for ARRAY_POSITION() and ARRAY_POSITIONS() (#366) (a1dc059)
• Add support for array_shuffle() (#324) (90a9b9e)
• Add support for DATE_ADD(), DATE_SUBTRACT() and DATE_BIN() (#345) (c3cb08d)
• Add support for DISTINCT and ORDER BY clauses to json_agg() and jsonb_agg() (#317) (4cdc638)
• Add support for DISTINCT clause to array_agg() (#316) (3c46021)
• Add support for JSONB_PATH_EXISTS(), JSONB_PATH_MATCH(), JSONB_PATH_QUERY(), JSONB_PATH_QUERY_ARRAY() and JSONB_PATH_QUERY_FIRST() (#346) (0cda902)
• Add support for ORDER BY clause for array_agg() (#267) (7c64742)
• Add support for POINT and POINT[] data types (#348) (18ec906)
• Add support for REGEXP_COUNT(), REGEXP_INSTR() and REGEXP_SUBSTR() and extend support for REGEXP_REPLACE() (#352) (9959476)
• Add support for xmlagg() (#318) (0b4db8a)
• Add support for arithmetic functions ABS, CEIL, FLOOR, ROUND and TRUNC (#369) (3f04c0e)
• Add support for arrays of REAL and DOUBLE PRECISION (#307) (1db35ac)
• Add support for distance operator <@> (#361) (8dbbf8c)
• Add support for formatting functions to_char, to_date, to_number, to_timestamp (#386) (7a047e8)
• Add support for mathematical functions CBRT, DEGREES, EXP, LN, LOG, PI, POWER, RADIANS, RANDOM, SIGN and WIDTH_BUCKET (#383) (3665a25)
• Add support for network types inet, _inet, cidr, _cidr, macaddr, _macaddr (#310) (ba3f9f2)
• Add support for range functions (#263) (2fa8434)
• Add support for range types (#396) (cc4749c)
• Add support for specifying explicit range bounds (#380) (d83a099)
• Extend existing function support with optional boolean parameters (#347) (67265cc)
• Extend support of REGEXP_LIKE(), REGEXP_MATCH() and REGEXP_REPLACE() while deprecating the legacy limited flagged variations of FlaggedRegexpLike, FlaggedRegexpMatch and FlaggedRegexpReplace (#357) (ef688dc)
• Preserve the type of booleans, floats, integers & scientific notations when transforming back and forth between PostgreSQL and PHP (#304) (c584099)
• Refactor exceptions handling for JsonbArray in the style used for the network types (#311) (0058d1c)

Bug Fixes

• DataStructure::transformPostgresTextArrayToPHPArray (v2) vs PostgresArrayToPHPArrayTransformer::transformPostgresArrayToPHPArray (v3) martin-georgiev/postgresql-for-doctrine#351: Correct round-trip handling of special characters between PHP and PostgreSQL (#391) (979a581)
• DataStructure::transformPostgresTextArrayToPHPArray (v2) vs PostgresArrayToPHPArrayTransformer::transformPostgresArrayToPHPArray (v3) martin-georgiev/postgresql-for-doctrine#351: Remove invalid or non-PostgreSQL-compliant test cases; ensure edge cases for backslashes, quotes, special characters, and NULL handling are covered (#385) (c5f7327)
• Change case of the getSQLDeclaration function martin-georgiev/postgresql-for-doctrine#367: Change to uppercase the return value of getSQLDeclaration (#368) (7e4be89)
• Cast not working with arrays martin-georgiev/postgresql-for-doctrine#399: Support array types for CAST (#406) (465963e)
• Add support for Lexer v1 (allowed by ORM < v2.15) (#300) (16fd227)
• Avoid infinite parsing loop for GREATEST() and LEAST() by using SimpleArithmeticExpression (#338) (169192b)
• Improve BC by deprecating customiseFunction instead of renaming it straight away (#294) (910d328)
• Restore support for unquoted string values stored in text[] (#333) (339e988)
• Wrap up ORM v3 throwable when parsing fails in variadic functions (#285) (59a8cb9)

Code Refactoring

• Allow multiple node mapping patterns to be used and their arguments to be validated in variadic functions (#350) (e111dd2)
• Allow node mapping in variadic functions to have different patterns, thus opening the path to a combination of node types (compared to the previous single type support) (#349) (6a5ba9e)
• Introduce BaseRegexpFunction and ParserException (#269) (fed0367)
• Modernise the validation in active code and the associated tests when dealing with integer arrays (#308) (67c344e)
• Stricter method argument types when handling variadic functions (#343) (553a30c)
• Validate that variadic functions have only the expected count of arguments (#274) (019f84d)

---

This PR was generated with Release Please. See documentation.