refactor: Rework core playback, backend, and add APM extension

Implement fractional sample rate playback, improve device handling,
add the WebRTC Audio Processing Module (APM) as an extension.

This commit introduces significant changes across multiple areas:

- Core Engine Playback (`SoundPlayerBase`):
  - Reworked audio generation logic to use fractional sample position.
  - Implemented robust linear interpolation for flexible playback speed.
  - Improved buffering and seek handling for better audio continuity, accuracy and fix distortions.
  - Made `CreateEncoder` and `CreateDecoder` public on `AudioEngine`.

- MiniAudio Backend (`MiniAudioEngine`, `Native`):
  - Refactored device initialization and switching to handle both playback and capture devices simultaneously.
  - Added `SwitchDevices` method for changing both devices at once.
  - Configured miniaudio device init for low latency and disabled WASAPI SRC auto-conversion.
  - Fixed issues in device enumeration info handling.

- WebRTC APM Extension (`SoundFlow.Extensions.WebRtc.Apm`):
  - Added a new extension package integrating the WebRTC Audio Processing Module.
  - Provides `WebRtcApmModifier` for real-time processing (AEC, NS, AGC, HPF, Pre-Amp).
  - Includes `NoiseSuppressor` component for offline/batch noise suppression.
  - Added necessary native libraries for cross-platform support via runtimes.

- Build System and CI (`.github/workflows`, `Native/CMakeLists.txt`, `Src/SoundFlow.targets`):
  - Overhauled GitHub Actions workflow for native library builds, simplifying Windows setup and standardizing artifact handling.
  - Added `.targets` files for improved NuGet package native library distribution.
  - Updated native CMake build files for better platform targeting and project structure.

- Other Improvements:
  - Refactored Algorithmic Reverb modifier for improved robustness and clarity.
  - Added `IDisposable` interface to `ISoundDataProvider` and implemented it across built-in providers.
  - Added `Volume` property to `ISoundPlayer`.
  - Added new utility math functions (`Mod`, `PrincipalAngle`).
  - Added a new sample project (`SoundFlow.Samples.NoiseSuppression`) and updated existing samples.
  - Added GitHub issue templates for structured bug reports, feature requests, etc.

Author: LSXPrime

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,82 @@
+---
+name: "\U0001F41B Bug Report"
+about: Create a report to help us improve SoundFlow
+title: "[BUG] Brief description of the bug"
+labels: bug, documentation
+assignees: ''
+
+---
+
+**Thank you for reporting a bug! To help us understand and fix the issue, please provide the following information:**
+
+**Requirements:**
+*   [ ] I have searched the existing issues to ensure this bug has not already been reported.
+*   [ ] I have provided a clear and concise description of the bug.
+*   [ ] I have provided detailed steps to reproduce the bug.
+*   [ ] I have included a minimal reproducible example (MRE) if applicable.
+*   [ ] I have provided error messages and stack traces if applicable.
+*   [ ] I have completed the environment information.
+
+**1. Describe the Bug**
+
+A clear and concise description of what the bug is.
+
+**2. Steps to Reproduce**
+
+Please provide detailed steps to reproduce the behavior:
+1. Go to '...'
+2. Call method '....' with parameters '....'
+3. Configure component '....' with settings '....'
+4. See error / Observe unexpected behavior
+
+**3. Expected Behavior**
+
+A clear and concise description of what you expected to happen.
+
+**4. Current Behavior**
+
+A clear and concise description of what actually happens.
+
+**5. Minimal Reproducible Example (MRE)**
+
+Please provide a *minimal* code snippet that demonstrates the bug. This is crucial for us to quickly identify and fix the issue.
+If the code is too long, please link to a Gist or a small repository.
+
+```csharp
+// Your MRE code here
+```
+
+**6. Error Messages and Stack Trace (if applicable)**
+
+If an exception is thrown, please paste the full error message and stack trace below.
+
+```
+(Paste full error message and stack trace here)
+```
+
+**7. Environment (please complete the following information):**
+*   **SoundFlow Version:** [e.g., 1.0.0, or commit SHA if building from source]
+*   **.NET Version:** [e.g., .NET 8.0, .NET 9.0]
+*   **Operating System:** [e.g., Windows 11, macOS Sonoma 14.2, Ubuntu 22.04]
+*   **Architecture:** [e.g., x64, ARM64]
+*   **Audio Backend Used (if known):** [e.g., WASAPI, CoreAudio, etc.]
+*   **Specific Audio Hardware (if relevant):** [e.g., Realtek HD Audio, Focusrite Scarlett 2i2]
+
+**8. Affected Components/Modules (if known)**
+
+List any specific SoundFlow components, modifiers, providers, or extensions you believe are related to this bug.
+*   [e.g., `SoundPlayer`, `WebRtcApmModifier`, `MiniAudioDecoder`, `NetworkDataProvider`]
+
+**9. Impact**
+
+Describe the impact of this bug (e.g., crash, incorrect audio output, performance degradation, minor inconvenience).
+
+**10. Possible Workaround (if known)**
+
+If you've found a way to work around the issue, please describe it.
+
+**11. Additional Context**
+
+Add any other context about the problem here.
+*   Were there any recent changes to your environment or the library version?
+*   Is this bug consistently reproducible, or does it happen intermittently?

.github/ISSUE_TEMPLATE/documentation_issue.md

@@ -0,0 +1,57 @@
+---
+name: "\U0001F4D6 Documentation Issue"
+about: Report an issue or suggest an improvement for the documentation
+title: "[DOCS] Brief description of the documentation issue"
+labels: documentation
+assignees: ''
+
+---
+
+**Thank you for helping us improve the SoundFlow documentation!**
+
+**Requirements:**
+*   [ ] I have searched the existing issues to ensure this documentation issue has not already been reported.
+*   [ ] I have clearly identified the affected documentation.
+*   [ ] I have described the problem and proposed a clear improvement.
+
+**1. Affected Page/Section**
+
+Please provide the URL or a clear description of the documentation page or section that has an issue.
+*   URL (if applicable):
+*   Section/Topic: [e.g., "SoundPlayer Looping", "WebRtcApmModifier Configuration", "API reference for Mixer.AddComponent"]
+
+**2. Describe the Issue**
+
+A clear and concise description of what is wrong with the current documentation.
+*   Is something missing?
+*   Is something unclear or confusing?
+*   Is something incorrect or outdated?
+*   Are there typos or grammatical errors?
+
+**3. Suggested Improvement**
+
+Please describe how the documentation could be improved.
+*   What information should be added, changed, or removed?
+*   Provide a corrected version if possible.
+
+**4. Why is this Improvement Important?**
+
+Explain how this change would make the documentation better or easier to understand for users.
+
+**5. Code Examples (if relevant)**
+
+If the documentation issue relates to code examples, please provide the problematic example and/or a corrected/improved version.
+
+**Current Example (if applicable):**
+```csharp
+// Problematic code example
+```
+
+**Suggested Example (if applicable):**
+```csharp
+// Improved code example
+```
+
+**6. Additional Context**
+
+Add any other relevant information, screenshots, or links.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,54 @@
+---
+name: "✨ Feature Request"
+about: Suggest an idea or enhancement for SoundFlow
+title: "[FEAT] Brief description of the feature"
+labels: enhancement
+assignees: ''
+
+---
+
+**Thank you for suggesting a feature! We appreciate your input.**
+
+**Requirements:**
+*   [ ] I have searched the existing issues to ensure this feature has not already been requested.
+*   [ ] I have clearly described the problem and the proposed solution.
+*   [ ] I have considered alternative solutions.
+
+**1. Is your feature request related to a problem? Please describe.**
+
+A clear and concise description of what the problem is.
+
+*Example: I'm always frustrated when [...] because [...] and I would like to be able to [...]*
+
+**2. Describe the Solution You'd Like**
+
+A clear and concise description of what you want to happen.
+*   What is the desired behavior?
+*   How would this feature be used? (e.g., API examples, new component, modification to existing one)
+
+**3. Describe Alternatives You've Considered**
+
+A clear and concise description of any alternative solutions or features you've considered.
+*   Why were they not suitable?
+
+**4. Proposed API (if applicable)**
+
+If this involves new or changed API, please provide a sketch of how it might look.
+```csharp
+// public class NewComponent : SoundComponent { ... }
+// public void ExistingComponent.NewMethod(ParameterType param) { ... }
+```
+
+**5. Benefits**
+
+What are the benefits of implementing this feature?
+*   Who would benefit from this?
+*   How would it improve SoundFlow?
+
+**6. Potential Drawbacks/Challenges**
+
+Are there any potential downsides or implementation challenges you foresee?
+
+**7. Additional Context**
+
+Add any other context, examples, mockups, or links to relevant resources or similar features in other libraries.

.github/ISSUE_TEMPLATE/performance_issue.md

@@ -0,0 +1,74 @@
+---
+name: "⏱️ Performance Issue"
+about: Report a performance problem with SoundFlow
+title: "[PERF] Brief description of the performance issue"
+labels: ''
+assignees: ''
+
+---
+
+**Thank you for reporting a performance issue! Accurate details are key to helping us optimize SoundFlow.**
+
+**1. Describe the Performance Issue**
+
+A clear and concise description of the performance problem.
+*   Is it high CPU usage, high memory consumption, audio stuttering/glitches, slow initialization, etc.?
+
+**2. Area of the Library Affected**
+
+Which part of SoundFlow seems to be causing the performance issue?
+*   [e.g., `SoundPlayer` with many instances, a specific `SoundModifier`, `MiniAudioEngine` processing, `NetworkDataProvider` streaming]
+
+**3. Scenario Causing Slowness**
+
+Describe the specific scenario or operations that trigger the performance problem.
+*   Please provide steps if possible.
+
+**4. Expected Performance**
+
+What level of performance were you expecting in this scenario?
+*   [e.g., "CPU usage below 10%", "No audible glitches", "Modifier should process X samples in Y ms"]
+
+**5. Actual Performance**
+
+Describe the observed performance. Provide metrics if possible:
+*   **CPU Usage:** [e.g., "Sustained 80% on one core", "Spikes to 100%"]
+*   **Memory Usage:** [e.g., "Increases by 100MB per minute", "Consumes 2GB RAM"]
+*   **Latency/Glitches:** [e.g., "Audio stutters every 5 seconds", "Noticeable delay in processing"]
+*   **Timing:** [e.g., "Method X takes 500ms to complete for a 1s buffer"]
+
+**6. Minimal Reproducible Example (MRE) (Highly Recommended)**
+
+Please provide a *minimal* code snippet that demonstrates the performance issue. This is extremely helpful.
+```csharp
+// Your MRE code here
+```
+
+**7. Profiling Data (if available)**
+
+If you have run a profiler (e.g., dotTrace, PerfView, Visual Studio Profiler), please share:
+*   Screenshots of hot paths.
+*   Exported profiling sessions (if shareable).
+*   Key findings from the profiler.
+
+**8. Environment (please complete the following information):**
+*   **SoundFlow Version:** [e.g., 1.0.0, or commit SHA]
+*   **.NET Version:** [e.g., .NET 8.0]
+*   **Operating System:** [e.g., Windows 11, macOS Sonoma, Ubuntu 22.04]
+*   **Architecture:** [e.g., x64, ARM64]
+*   **Audio Backend Used (if known):** [e.g., MiniAudioEngine with WASAPI, CoreAudio, ALSA]
+*   **Specific Audio Hardware (if relevant):** [e.g., CPU model, RAM amount, Audio Interface model]
+*   **Audio Buffer Size / Sample Rate:** [e.g., 480 samples / 48000 Hz]
+
+**9. Additional Context**
+
+Add any other relevant information.
+*   Does the issue scale with input size, number of components, etc.?
+*   Have you tried different configurations or settings?
+
+**Requirements:**
+*   [ ] I have searched the existing issues to ensure this performance issue has not already been reported.
+*   [ ] I have provided a clear description of the issue and the scenario.
+*   [ ] I have included performance metrics if possible.
+*   [ ] I have considered providing an MRE.
+*   [ ] I have completed the environment information.

.github/ISSUE_TEMPLATE/platform_specific_issue.md

@@ -0,0 +1,70 @@
+---
+name: "\U0001F4BB Platform Specific Issue"
+about: Report an issue that only occurs on specific platforms or environments
+title: "[PLAT] Brief description of the platform-specific issue"
+labels: bug
+assignees: ''
+
+---
+
+**Thank you for reporting a platform-specific issue! This helps us ensure SoundFlow works well everywhere.**
+
+**1. Affected Platform(s)**
+
+Please specify the platform(s) where this issue occurs. Be as specific as possible.
+*   **Operating System & Version:** [e.g., Windows 10 Pro 22H2, macOS Monterey 12.5, Ubuntu 20.04 LTS]
+*   **Architecture:** [e.g., x64, ARM64, x86]
+*   **.NET Runtime & Version:** [e.g., .NET Core 3.1, .NET 7, Mono 6.12]
+*   **Audio Backend Used (if known):** [e.g., MiniAudioEngine with WASAPI, CoreAudio, ALSA]
+*   **Specific Hardware (if relevant):** [e.g., M1 Mac, Raspberry Pi 4, specific sound card model]
+
+**2. Description of the Issue**
+
+A clear and concise description of the problem as it manifests on the affected platform(s).
+*   How does the behavior differ from other platforms (if you've tested)?
+
+**3. Does it work correctly on other platforms?**
+*   [ ] Yes (Please specify which platforms work correctly: ____________)
+*   [ ] No (This might be a general bug, consider the Bug Report template)
+*   [ ] Not Tested / Don't Know
+
+**4. Steps to Reproduce (on the affected platform)**
+
+Please provide detailed steps to reproduce the behavior *on the affected platform(s)*.
+1.
+2.
+3.
+
+**5. Expected Behavior (on the affected platform)**
+
+What should happen on this platform?
+
+**6. Current Behavior (on the affected platform)**
+
+What actually happens on this platform?
+
+**7. Minimal Reproducible Example (MRE)**
+
+If possible, provide a *minimal* code snippet that demonstrates the issue on the affected platform.
+```csharp
+// Your MRE code here
+```
+
+**8. Error Messages and Stack Trace (if applicable, from the affected platform)**
+```
+(Paste full error message and stack trace here)
+```
+
+**9. SoundFlow Version:** [e.g., 1.0.0, or commit SHA]
+
+**10. Additional Context**
+
+Any other details that might be relevant to this platform-specific issue.
+*   Have you tried any platform-specific configurations or workarounds?
+*   Are there any known quirks or limitations of the OS, runtime, or hardware involved?
+
+**Requirements:**
+*   [ ] I have searched the existing issues to ensure this platform-specific issue has not already been reported.
+*   [ ] I have clearly specified the affected platform(s) and environment details.
+*   [ ] I have provided detailed steps to reproduce the issue on the affected platform.
+*   [ ] I have indicated if the issue is confirmed to work correctly on other platforms.

.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,47 @@
+---
+name: "\U0001F914 Question"
+about: Ask a question about SoundFlow
+title: "[QSTN] Your question in a few words"
+labels: question
+assignees: ''
+
+---
+
+**Before asking, please ensure your question isn't answered in the [documentation](https://lsxprime.github.io/soundflow-docs/) or existing issues.**
+
+**Requirements:**
+*   [ ] I have searched the documentation and existing issues for an answer.
+*   [ ] My question is specific and clearly formulated.
+*   [ ] This is not a bug report or a feature request.
+
+**1. What are you trying to achieve?**
+
+A clear and concise description of your goal.
+
+**2. What have you tried so far?**
+
+Please describe the steps you've taken, what you've looked at in the documentation, or any code you've experimented with.
+
+**3. What are you unsure about / What is your specific question?**
+
+Be precise.
+
+**4. Relevant Code Snippet (if applicable)**
+
+If your question relates to a specific piece of code, please include a minimal, runnable snippet.
+```csharp
+// Your code here
+```
+
+**5. Environment (if relevant to your question):**
+*   **SoundFlow Version:** [e.g., 1.0.0]
+*   **.NET Version:** [e.g., .NET 8.0]
+*   **Operating System:** [e.g., Windows 11]
+
+**6. Additional Context**
+
+Any other information that might help us understand and answer your question.
+
+**Important:**
+*   This issue tracker is primarily for bugs and feature requests. For general "how-to" questions, please use the [Discussions tab](https://github.com/LSXPrime/SoundFlow/discussions) if available. However, if your question might reveal a documentation gap or an unintuitive aspect of the library, this is the right place.
+*   **This is NOT for reporting bugs or requesting features.** Please use the appropriate templates for those.