## Description

<!-- What changed and why. Link design docs or discussions if relevant. -->

## Related issue

<!-- Link the issue this closes, if any. -->
Fixes #

## Type of change

- [ ] Bug fix
- [ ] New feature
- [ ] Breaking change
- [ ] Documentation
- [ ] Refactor
- [ ] Tests
- [ ] Packaging / CI

## Checklist

- [ ] Code follows project style (Black, isort, flake8)
- [ ] Documentation updated when user-facing behavior or install steps change
- [ ] Tests added or updated for the change
- [ ] Local tests pass (`pytest`)
- [ ] Conventional commit message style

## Screenshots (if applicable)

<!-- UI changes: before/after if helpful -->

## Notes for reviewers

<!-- Anything not obvious from the diff -->