[tlambert03]

Routine tooling refresh. One commit per step, so they can be reviewed, reverted or cherry-picked independently.

ci: autoupdate pre-commit hooks

• validate-pyproject v0.25 → 0.26 (upstream dropped the v prefix)
• ruff-pre-commit v0.15.4 → v0.16.10
• mirrors-mypy v1.19.1 → v2.4.0

style: fix lint errors from hook updates

• ruff 0.16 now formats Python code blocks inside Markdown, so README.md and docs/v2-migration.md are reformatted (quote style, blank lines, line wrapping). This is the same diff as ci(pre-commit.ci): autoupdate #271. In one place a trailing comment forced v2.ZRangeAround(range=4, step=1.0) onto three lines, so I moved that comment above the line.
• mypy 2.4: the # type: ignore[no-any-return] in _point_visiting._distance_matrix is unused with recent numpy stubs but still needed with older ones. The mypy hook env resolves a different numpy under prek than under pre-commit-uv. I changed it to [no-any-return, unused-ignore] so it passes either way.

ci: bump GitHub Actions

• actions/checkout v6 → v7. v7 refuses to check out fork PRs under pull_request_target/workflow_run, which this repo doesn't use.
• pyvista/setup-headless-display-action v4 → v5. The new Wayland/weston option is opt-in and Linux-only, and the job runs on macOS; the qt input is unchanged.
• softprops/action-gh-release v2 → v3. The runtime moves to Node 24; the inputs used here are unchanged.
• astral-sh/setup-uv v7 → v10.2.0, as a commit-SHA pin with a # v10.2.0 comment, in its own commit. setup-uv stopped publishing floating major tags after v7. None of the v8–v10 breaking changes affect this repo: the old manifest-file format isn't used, prune-cache now defaults to false, and enable-cache: auto now disables caching on pull_request_target/workflow_run/release, but the workflows here set enable-cache: true and don't use those events.

chore: drop Python 3.10, add 3.15

• requires-python = ">=3.11", 3.10 classifier removed, 3.15 classifier added, ruff target-version = "py311".
• CI main list ["3.10", "3.12", "3.14"] → ["3.11", "3.12", "3.14"] (min/middle/max on all three OSes). I kept 3.12 as the middle because the include rows already cover 3.13. The lowest-direct ubuntu row moves from 3.10 to 3.11.
• New ubuntu-latest / "3.15" row. setup-uv resolves the pre-release without a flag, and numpy, pydantic-core and shapely already publish cp315 wheels.
• No dependency markers became always-true at 3.11, because all existing markers are >= 3.12.

refactor: modernize syntax for Python >= 3.11

Ruff UP fixes for the py311 target:

• Self and Required are now imported from typing (UP035).
• Axis(str, Enum) → Axis(StrEnum) (UP042). Axis already defines __str__ returning .value, so str(), f-strings and repr() give the same output.
• typing_extensions remains a dependency because deprecated and TypedDict still come from it.

The test suite passes locally on 3.11 (378 passed, 2 xfailed).

Decisions

• Dropped 3.10: it reached EOL on 2026-10-01, per peps.python.org release-cycle data.
• Added 3.15 (RC phase, final release planned for this month): classifier added, and it runs in one CI row on ubuntu.

Superseded PRs

Closes #273
Closes #271

Branch protection

Updated the classic branch protection on main (required status checks; strict: true and app IDs unchanged), because the matrix change renames two required jobs:

• macos-latest py3.10 → macos-latest py3.11
• ubuntu-latest py3.10 lowest-direct → ubuntu-latest py3.11 lowest-direct

pre-commit.ci - pr, windows-latest py3.12 and ubuntu-latest py3.14 are unchanged.

• Other open PRs built on the old matrix (e.g. fix: apply channel z_offset to stage position z when there is no z_plan #274, feat: add non_dimension_coords to MDAEvent #216, [WIP] Fix: update time interval exceeded boolean #147) won't report the new names until they're rebased or re-run.
• If this PR is closed without merging, revert the change:

  gh api -X PATCH repos/pymmcore-plus/useq-schema/branches/main/protection/required_status_checks --input - <<'JSON'
  {"strict": true, "checks": [{"context": "pre-commit.ci - pr", "app_id": 68672}, {"context": "windows-latest py3.12", "app_id": 15368}, {"context": "ubuntu-latest py3.14", "app_id": 15368}, {"context": "macos-latest py3.10", "app_id": 15368}, {"context": "ubuntu-latest py3.10 lowest-direct", "app_id": 15368}]}
  JSON
  

Needs attention

• Pyright (manual hook stage) reported 6 errors that already existed on main. They are fixed in fix: resolve pyright errors in useq.v2, which adds 5 # pyright: ignore[reportIncompatibleVariableOverride] comments on frozen axis_key: Literal[...] overrides and replaces one hasattr check with getattr(val, "z", val).

🤖 Generated with Claude Code

[codecov]

Codecov Report

❌ Patch coverage is 90.00000% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 93.62%. Comparing base (942a551) to head (c2d2c82).

Files with missing lines	Patch %	Lines
src/useq/v2/_transformers.py	0.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #275      +/-   ##
==========================================
- Coverage   93.62%   93.62%   -0.01%     
==========================================
  Files          33       33              
  Lines        2590     2589       -1     
==========================================
- Hits         2425     2424       -1     
  Misses        165      165              

☔ View full report in Codecov by Harness.
📢 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.