# Pull Request

## Description

<!-- Provide a clear and concise description of your changes -->

## Type of Change

<!-- Mark with an 'x' all that apply -->

- [ ] 🐛 Bug fix (non-breaking change which fixes an issue)
- [ ] ✨ New feature (non-breaking change which adds functionality)
- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
- [ ] 📚 Documentation update
- [ ] 🎨 Code style/formatting
- [ ] ♻️ Refactoring (no functional changes)
- [ ] ⚡ Performance improvement
- [ ] ✅ Test addition/update
- [ ] 🔧 Configuration change
- [ ] 🏗️ Build/CI change

## Related Issues

<!-- Link to related issues using #issue_number -->

- Fixes #
- Relates to #

## Changes Made

<!-- List the main changes made in this PR -->

-
-
-

## Testing

<!-- Describe the tests you've added or how you've tested these changes -->

### Test Coverage

- [ ] Unit tests added/updated
- [ ] Integration tests added/updated
- [ ] All tests pass locally (`pytest tests/`)
- [ ] Test coverage maintained or improved

### Manual Testing

<!-- Describe manual testing performed -->

```bash
# Example commands used for testing
pytest tests/ -v
pytest --benchmark-collect
```

**Test Results:**
<!-- Paste test output or summary -->

## Checklist

<!-- Mark with an 'x' all that apply -->

### Code Quality

- [ ] Code follows the style guidelines (black, isort, ruff)
- [ ] Self-review of code completed
- [ ] Comments added for complex logic
- [ ] No debugging code or print statements left
- [ ] Code is DRY (Don't Repeat Yourself)

### Documentation

- [ ] Documentation updated (if applicable)
- [ ] Docstrings added/updated for public APIs
- [ ] README.md updated (if applicable)
- [ ] CHANGELOG.md updated
- [ ] Examples added/updated (if applicable)

### Testing

- [ ] New tests added for new functionality
- [ ] Existing tests pass
- [ ] Edge cases covered
- [ ] Error handling tested

### Compatibility

- [ ] Changes are backwards compatible
- [ ] Migration guide added (if breaking changes)
- [ ] Works on Python 3.8+
- [ ] Works on Linux, macOS, Windows

### Performance

- [ ] Performance impact assessed
- [ ] No performance regression
- [ ] Benchmarks run (if performance-related)

### Security

- [ ] No security vulnerabilities introduced
- [ ] Input validation added where necessary
- [ ] No sensitive data exposed

## Screenshots/Examples

<!-- If applicable, add screenshots or examples -->

## Performance Impact

<!-- If this PR affects performance, describe the impact -->

### Before
```
# Performance before changes
```

### After
```
# Performance after changes
```

## Breaking Changes

<!-- If this PR includes breaking changes, describe them and provide migration guide -->

### Migration Guide

```python
# Example of how to migrate from old to new API
```

## Additional Notes

<!-- Any additional information reviewers should know -->

## Reviewer Checklist

<!-- For reviewers to fill out -->

- [ ] Code reviewed for correctness
- [ ] Tests reviewed and adequate
- [ ] Documentation reviewed
- [ ] No security concerns
- [ ] Performance acceptable
- [ ] Ready to merge

---

**By submitting this pull request, I confirm that my contribution is made under the terms of the MIT License.**
