prepare release 5.3.2.post5

Merge remote-tracking branch 'upstream/master'

Merge pull request #4101 from Itz-Agasta/artificial-postcodes

Add stable postcode refs for details lookup and search exclusion

Preserve postcode index usage for postcode refs

Removes hyphen normalization from postcode handling to match only on spaces,
ensuring consistency between API usage, documentation, and database queries.

Clarifies postcode reference format in API docs

Explains that spaces and hyphens in postcode IDs are replaced
with underscores in stable postcode references and adds new
examples for clarity. Improves guidance for constructing and
using postcode refs in API endpoints.

Add dedicated postcode param, stable IDs, normalised matching

Merge pull request #4099 from Janjko/master

Added the Croatian variants yaml

Merge pull request #4100 from lonvia/affix-expansion

Add sanitizer for handling name prefixes and suffixes

Document stable postcode references

Support postcode refs in excluded search results

Support postcode refs in lookup and details

- resolve postcode refs in postcode-table lookups
- accept `place_ref` in the v1 details endpoint
- add tests for details and lookup behavior

Add stable postcode reference type support

- add `PostcodeRef` and parsing helpers
- allow postcode refs in excluded IDs
- export the new public API type

adapt BDD test for new prefix handling

add affix handling to default config

Create variants-hr.yaml

add documentation for new sanitizer

add sanitizer for prefix/suffix expansion

prepare release 5.3.2.post4

Merge remote-tracking branch 'upstream/master'

Merge pull request #4088 from Itz-Agasta/language-reranking

Use locale-aware names for search result reranking

add function for choice parameters to sanitizer config

Improves locale name matching for address ranking

Enhances address ranking accuracy by comparing normalized query text
against all localized name variants and country code, rather than
a single locale name. Reduces false positives and improves ranking
for multilingual search scenarios.

Merge pull request #4097 from lonvia/more-sanatizing

New sanitizers: delete-names and derive-names

change to new delete-names sanitizer

Merge pull request #4081 from jeremy-code/jeremy-code-patch-1

Update JSON structure in Reverse.md documentation

new sanitizer to derive addtional names

add parameter to regex function to sanitizer config

replace delete-tags sanitizer with one with better parameter names

Use locale name comparison for low-rank results

Update JSON structure in Reverse.md documentation

- Update JSON structure in Reverse.md docs based on current API (see https://nominatim.openstreetmap.org/reverse?lon=11.3398676&lat=44.5015307&format=geojson)

generalise filter code of the delete tags sanitizer

Merge pull request #4095 from lonvia/restrict-country-search

Do not search for countries when country restriction is in place

check for illegal sanitizer names

do not search for countries when country retriction is in place

Removes unused Set import and updates set type hints

Improves geocoder reranking logic for locale-specific names

- Refines how result labels are aggregated for reranking by using sets of localized names instead of concatenated strings.

- Updates tests to reflect improved handling of locale-specific queries.

test: add BDD scenario for locale-aware reranking (#3871)

Add a test scenario where a place with a non-English local name
and an English name:en alias competes against a place with only
an English name. Verifies that accept-language=en correctly

use locale-aware names for query word matching

When reranking search results, the word matching pool was built only
from display_name, which returns the local name (e.g., "Αθήνα" for
Athens, Greece). This caused results with translated names to receive
unfair distance penalties when the caller used accept-language.
Introduce _get_result_rerank_text() which builds the reranking text
using locale-aware name resolution from locales.display_name(). This
ensures that name variants like name:en are included in the word
matching pool when the caller requests a specific language.

prepare release 5.3.2.post3

Merge remote-tracking branch 'upstream/master'

Merge pull request #4090 from lonvia/filter-bad-refs

Add sanitizer for suspicious ref values

fix new mypy warnings

increase minimum Python version for mypy to 3.10

Not raising the minimum required version yet.

add sanitizer for suspicious ref values

Mostly for filtering ref tags from German post boxes.

Merge pull request #4087 from lonvia/remove-special-cases-for-sk

Remove ranking exceptions for Slovakia

remove address level exceptions for Slovakia

The country has been reorganised and now follows general conventions.

prepare release 5.3.2.post2

Note: downgrading gunicorn because of
https://github.com/benoitc/gunicorn/discussions/3605

Merge remote-tracking branch 'upstream/master'

fix typo

Merge pull request #4086 from lonvia/fix-rank-11-boundaries

Fix display of rank 11 boundaries

rank 11 is not always a postcode

Merge pull request #4085 from lonvia/partial-terms

Add partial property for tokenizer

add documentation for new partial attribute

tokenizer: allow to mark names as partial only

These names will not be added as a full searchable token but only
with the partials they produce. Variants are still built as usual.

Merge pull request #4083 from lonvia/icu-data-types

Minor simplifications in ICU token generation code

structurize housenumber tokens

slightly simplify name token cache

simplify name token set handling

icu: move constants in separate file

remove unused constant

Merge pull request #4049 from Itz-Agasta/uv

Add uv support for development environment

prepare release 5.3.2-post1

Merge remote-tracking branch 'upstream/master'

Merge pull request #4077 from lonvia/fix-potential-null-in-place-delete

Fix failure on non-null constraint when marking place for delete

avoid null value for deferred, when no placex entry exists

Require SQLAlchemy with asyncio extra

Update development dependencies list

Add runtime dependency group and update docs

prepare release 5.3.1.post2

Merge remote-tracking branch 'upstream/master'

Merge pull request #4073 from lonvia/area-updates

Reorganise code for invalidation of dependent places on updates

update of addr:place works now

add more tests for updates of boundaries

rework invalidation of places on update

move code for checking unwanted places into extra function

This way it can be reused in the update code.

prepare release 5.3.1.post1

Merge remote-tracking branch 'upstream/master'

Merge pull request #4071 from lonvia/fix-associated-street-update

Make sure right index is hit when updating associatedStreet relations

add missing trigger migration for associated streets

split update of placex to accomodate partial indexes

Remove version constraint for mypy in dependency list

Add uv workspace support and pip dependency groups for development

Add root pyproject.toml with uv workspace configuration
- Add [project] section so pip can auto-install nominatim-api and nominatim-db
- Add dependency groups (runtime, test, lint, types, docs, serve) for easy setup
- Simplify development docs to use 'pip install --group dev .' instead of long package list
- Remove gunicorn from serve group (deployment only)
- Pin mypy to <=1.19.1 for compatibility with existing code
- Add *.egg-info/ to .gitignore

With these changes, developers can set up with:
- uv:  uv sync
- pip: pip install --group dev .

Document uv as alternative dev env setup

Introduce pyproject.toml with uv workspace

Add a root pyproject.toml that defines a uv workspace over the existing
packaging/ directory and declares PEP 735 dependency groups for development
tools (test, lint, types, docs, serve).
These groups are ignored by pip and only activated when using uv, so the
existing virtualenv + pip workflow is unaffected. The 'dev' group includes
all sub-groups by default, so 'uv sync' installs everything needed for
development in one command.

prepare release 5.3.0-post1

Merge remote-tracking branch 'upstream/master'

prepare release 5.3.0

Merge pull request #4069 from lonvia/adapt-czech-boundaries

Adapt address ranking for various countries

remove LGA boundaries in Australia

see https://community.openstreetmap.org/t/administrative-boundaries-for-non-administrative-areas-in-sydney-and-melbourne/140931

remove purely administrative boundaries in Brazil

adapt ranks for Czech Republic to new admin levels

Merge pull request #4067 from lonvia/postcode-geometry

Do not return box geometry for guessed postcodes

Merge pull request #4066 from lonvia/boundary-matching

Refuse to link boundary and places with wikidata mismatch

do not return box geometry for guessed postcodes

refuse to link boundary and places with wikidata mismatch

Merge pull request #4065 from lonvia/update-sqlalchemy-schema

Update sqlalchemy schema

Merge pull request #4064 from lonvia/abbreviations-pakistan

Add English abbreviations for Pakistan

adapt tests to newly added table constraints

add missing non-null constraints in SQLAlchemy schema

Merge pull request #4063 from lonvia/sqlalchemy-dep

Force installation of async requirement for SQLAlchemy