feat: Add model cards documentation infrastructure

[sunt05]

Summary

Introduces a comprehensive model cards system for all 22 SUEWS physics schemes, with a tabbed index page organised by enum class and an interactive comparison widget.

Key Changes

• Schema & validation: src/supy/model_cards/_schema.py — Pydantic-based YAML schema covering identity, scientific basis, evaluation, technical characteristics, operational status, and user guidance
• 22 model cards: YAML files for every physics scheme (narp, ohm, stebbs, spartacus, ehc, beers, lumps, etc.)
• RST generator: docs/generate_model_cards_rst.py — produces sphinx-design cards, tabs, badges, and embedded HTML/JS comparison widget
• Tabbed index page: Schemes grouped by enum_class in a tab-set layout; multi-value cards expanded into per-option cards using enum docstrings (e.g. StabilityMethod shows 3 separate cards for each formulation); toggle enums (On/Off) kept as single cards
• Category pages: Scheme cards with status badges, computational/data-prep demand indicators, and direct links to individual model card pages
• Comparison widget: Interactive scheme comparison with category filtering and sortable badges

Dependencies

This PR provides a working prototype of the model cards UI. The current organisation (flat enum-class grouping) is a temporary structure — the proper hierarchical sub-category grouping depends on #972, which introduces sub-options for model physics options.

Test Plan

• All 22 model cards validate against Pydantic schema
• RST generator runs without errors
• make test-smoke passes (13 passed, 2 skipped)
• Documentation builds successfully
• Tabbed index renders correctly with expanded per-option cards
• Interactive comparison widget works in browser

🤖 Generated with Claude Code

[github-actions]

CI Build Plan

Changed Files

Build system (1 file)

• src/supy/meson.build

Documentation (32 files)

• docs/generate_model_cards_rst.py
• docs/source/index.rst
• docs/source/scheme-reference/anohm.rst
• docs/source/scheme-reference/beers.rst
• docs/source/scheme-reference/biogen_co2.rst
• docs/source/scheme-reference/boundary_layer.rst
• docs/source/scheme-reference/co2_vegetation.rst
• docs/source/scheme-reference/dyohm.rst
• docs/source/scheme-reference/ehc.rst
• docs/source/scheme-reference/emissions.rst
• docs/source/scheme-reference/estm.rst
• docs/source/scheme-reference/fai.rst
• docs/source/scheme-reference/gs_model.rst
• docs/source/scheme-reference/index.rst
• docs/source/scheme-reference/lumps.rst
• ...and 17 more

Build Configuration

	Configuration
Platforms	Linux x86_64, macOS ARM64, Windows x64
Python	3.9, 3.14
Test tier	cfg (configuration + smoke)
UMEP build	Yes (compiled extension may differ)
PR status	Draft (reduced matrix)

Rationale

• Build system changed -> multiplatform build required
• Compiled extension ABI may differ -> UMEP (NumPy 1.x) build included

---

_{Updated by CI on each push. See path-filters.yml for category definitions.}

[github-actions]

Preview Deployed

Content	Preview URL
Site	https://suews.io/preview/pr-1210/
Docs	https://suews.io/preview/pr-1210/docs/

Note

This preview is ephemeral. It will be lost when:

• Another PR with site/ or docs/ changes is pushed
• Changes are merged to master
• A manual workflow dispatch runs

To restore, push any commit to this PR.

[sunt05]

Dependency note: The model cards index currently organises schemes by enum_class in a flat tab layout. This works as a prototype, but the proper hierarchical grouping (e.g. Net Radiation split into forcing / NARP / SPARTACUS families) depends on #972 landing first.

Once #972 introduces sub-options for model physics options, we can restructure the index to reflect the sub-category hierarchy rather than the current flat enum-class grouping.

Blocked by: #972