chore: release 4.0.0

[github-actions]

I have created a release PR for this version

4.0.0 (2025-12-02)

⚠ 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 ST_DWithin function martin-georgiev/postgresql-for-doctrine#432: Add support for PostGIS functions for topological and distance relationships (#434) (2922b63)
• Support PostGIS martin-georgiev/postgresql-for-doctrine#305: Add support for PostGIS measurement, overlay and geometry processing functions (#435) (9724452)
• Support PostGIS martin-georgiev/postgresql-for-doctrine#305: Add support for PostGIS operators (#430) (5b5583b)
• 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)
• Feature Request: add support for ltree data type martin-georgiev/postgresql-for-doctrine#410:  add support for LTREE type (#411) (5a6563d)
• feat(#410): add support for functions to use with the LTREE data type martin-georgiev/postgresql-for-doctrine#440: Add support for functions to use with the LTREE data type (#440) (745b269)
• Unknown database type "geometry" requested, Doctrine\DBAL\Platforms\PostgreSQL120Platform may not support it. martin-georgiev/postgresql-for-doctrine#456: Add convenience factory methods to WktSpatialData (#459) (7242665)
• Invalid geometry format in database: '0101000020E61000006F9BA9108F4418401BD82AC1E2634940' martin-georgiev/postgresql-for-doctrine#458: Ensure Doctrine returns PostgreSQL spatial data in text format (EWKT) instead of binary format (EWKB) (#462) (8ac7a70)
• 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 uuid_extract_timestamp and uuid_extract_version (#466) (77a513f)
• Add support for websearch_to_tsquery (#437) (be90545)
• 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 some new functions from PostgreSQL 18 (#464) (118bfa3)
• 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)
• Loss of original data type in TextArray class martin-georgiev/postgresql-for-doctrine#424: Address unintentional loss of string data type when retrieving PHP array item values from a stored TextArray value (#443) (bdb8df2)
• Overlaps moved to PostGIS namespace martin-georgiev/postgresql-for-doctrine#446: Restore OVERLAPS to its intended namespace and strengthen its test coverage (#447) (6435f06)
• Access to range type properties martin-georgiev/postgresql-for-doctrine#473: Add public getter methods to Range value objects (#477) (9ba319e)
• Arithmetic expression inside round() leads to infinite parsing loop martin-georgiev/postgresql-for-doctrine#474: Support usage of arithmetic expressions in mathematical functions (#475) (75b025d)
• [Bug]: Loss of data when converting from a PostgreSQL text array to a PHP array martin-georgiev/postgresql-for-doctrine#482: Always preserve strings (even if they are obviously numerical) when transforming a TEXTARRAY value into a PHP array (#488) (77eed3e)
• Add support for Lexer v1 (allowed by ORM < v2.15) (#300) (16fd227)
• Address broken escaping of array items for JsonbArray and preserve integer values as strings if they are outside PHP integer range (#442) (d213967)
• 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

• Support PostGIS martin-georgiev/postgresql-for-doctrine#305: Move PostGIS operators in a dedicated namespace (#433) (522e653)
• 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.