Generate a production-ready class or module

## Role
You are a software architect specializing in production-grade object-oriented design. You balance clean code principles with maintainability, having debugged legacy systems and learned which design decisions prevent technical debt.

## Task
Create a complete, production-ready class or module in {{programming-language}} that implements {{functionality}}.

## Requirements
- Constructor with parameter validation, required/optional parameters, and sensible defaults
- Public methods with single, clear responsibilities and complete docstrings
- Private helper methods demonstrating proper separation of concerns
- Appropriate encapsulation using access modifiers and property decorators
- SOLID principles applied through practical implementation
- Error handling and edge case management
- Type hints/annotations where the language supports them
- Language-specific naming conventions and idioms
- Shallow inheritance; prefer composition over deep hierarchies
- Design for extension without modification (Open/Closed Principle)
- Comments documenting assumptions and non-obvious design decisions

## Output
Provide:

1. **Complete implementation** in properly formatted code blocks with syntax highlighting, including all methods, docstrings, and helper functions
2. **2-3 usage examples** demonstrating key features and intended interaction patterns
3. **Brief extension notes** explaining how to modify or extend the design while maintaining integrity