release: prepare ExcelAlchemy 2.2.4

[ruicore]

Summary

This PR prepares the 2.2.3 release of ExcelAlchemy.

It continues the stable 2.x line with a focused validation fix in the Pydantic adapter, continued metadata and typing cleanup, and a stronger examples directory with smoke coverage.

What changed

Validation fix

• restore explicit ProgrammaticError handling for unsupported Annotated[..., Field(...), ExcelMeta(...)] declarations that use native Python types instead of ExcelFieldCodec subclasses
• tighten codec resolution in the Pydantic adapter so unsupported declarations fail at the codec resolution boundary instead of being treated as valid runtime metadata
• preserve existing behavior for valid ExcelFieldCodec and CompositeExcelFieldCodec declarations

Metadata and typing cleanup

• continue treating FieldMetaInfo as a compatibility facade over layered metadata objects
• move more internal consumers and codecs onto declared, runtime, presentation, and constraints
• reduce remaining runtime typing gray areas by replacing a number of loose Any annotations with explicit workbook-boundary aliases or object
• remove the remaining type: ignore hotspot in the number codec path

Examples and documentation

• add business-oriented examples for:
  • end-to-end import workflow
  • create-or-update import workflow
  • date and range fields
  • selection-heavy forms
  • export workflow
  • Minio-backed storage configuration
• add examples/README.md with a recommended reading order
• update README.md and README_cn.md to point users to the expanded examples

Test coverage

• add smoke coverage for repository examples
• keep FastAPI and Minio examples optional where dependencies are not installed
• continue protecting the validation fix with an explicit integration regression test

Compatibility notes

• no public import/export workflow API was removed
• valid codec-based declarations continue to work unchanged
• unsupported native annotations with ExcelMeta(...) now fail early with the intended ProgrammaticError
• the built-in Minio path remains available in 2.x and still reflects the current compatibility-based configuration path

Verification

• ./.venv/bin/ruff check .
• ./.venv/bin/uv run pyright
• ./.venv/bin/pytest -q

Release intent

After merge, this branch is intended to be tagged and published as:

• v2.2.3

[codecov]

Codecov Report

❌ Patch coverage is 89.50000% with 42 lines in your changes missing coverage. Please review.
✅ Project coverage is 87.19%. Comparing base (9533324) to head (9415da9).
⚠️ Report is 4 commits behind head on main.

Files with missing lines	Patch %	Lines
src/excelalchemy/metadata.py	87.69%	8 Missing and 8 partials ⚠️
src/excelalchemy/core/import_session.py	66.66%	2 Missing and 3 partials ⚠️
src/excelalchemy/core/alchemy.py	80.00%	2 Missing and 2 partials ⚠️
src/excelalchemy/codecs/string.py	75.00%	1 Missing and 2 partials ⚠️
src/excelalchemy/core/schema.py	82.35%	1 Missing and 2 partials ⚠️
src/excelalchemy/helper/pydantic.py	76.92%	2 Missing and 1 partial ⚠️
src/excelalchemy/codecs/date_range.py	86.66%	1 Missing and 1 partial ⚠️
src/excelalchemy/core/writer.py	87.50%	0 Missing and 2 partials ⚠️
src/excelalchemy/codecs/multi_checkbox.py	90.00%	0 Missing and 1 partial ⚠️
src/excelalchemy/codecs/number.py	96.42%	0 Missing and 1 partial ⚠️
... and 2 more

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #63      +/-   ##
==========================================
+ Coverage   86.56%   87.19%   +0.62%     
==========================================
  Files          48       48              
  Lines        3313     3475     +162     
  Branches      377      379       +2     
==========================================
+ Hits         2868     3030     +162     
+ Misses        277      271       -6     
- Partials      168      174       +6     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.