chore(nam): update nam-rs to 0.3.0 from crates.io (#256)

Author: OpenSauce

CLAUDE.md

@@ -73,15 +73,16 @@ Input → [Tuner bypass] → Input Filters (HP/LP) → [Upsample] → Amp Chain
 
 #### rustortion-core
 - **`src/amp/chain.rs`** — Ordered list of processing stages.
-- **`src/amp/stages/`** — 10 registered DSP stages: preamp, compressor, noise_gate, tonestack, poweramp, multiband_saturator, level, delay, reverb, eq. Plus utilities: `clipper`, `filter`, `common`.
+- **`src/amp/stages/`** — 11 registered DSP stages: preamp, compressor, noise_gate, tonestack, poweramp, multiband_saturator, level, nam, delay, reverb, eq. Plus utilities: `clipper`, `filter`, `common`.
 - **`src/audio/engine.rs`** — Core audio processing loop. Controlled via crossbeam channels.
 - **`src/ir/`** — IR cabinet, convolver (FIR/FFT), loader.
-- **`src/preset/`** — Preset save/load/delete, `StageConfig` enum, `InputFilterConfig`.
+- **`src/nam/`** — NAM model loader and process-global registry (models resolved by name in `NamConfig::to_stage`).
+- **`src/preset/`** — Preset save/load/delete, `StageConfig` enum, `InputFilterConfig`. Note: core's `StageConfig` in `stage_config.rs` is **hand-maintained** (the variant list repeats across ~9 match sites) — it is NOT generated by the UI macro.
 
 #### rustortion-ui
 - **`src/app.rs`** — `SharedApp<B>` — shared state, update(), view(), subscription().
 - **`src/backend.rs`** — `ParamBackend` trait, `Capabilities`, `ExternalEvent`.
-- **`src/stages/mod.rs`** — `gui_stage_registry!` macro, `ParamUpdate`, all 10 stage view modules.
+- **`src/stages/mod.rs`** — `gui_stage_registry!` macro, `ParamUpdate`, all 11 stage view modules.
 - **`src/components/`** — Reusable UI components: widgets, dialogs, preset_bar, peak_meter, ir_cabinet_control, minimap, etc.
 - **`src/handlers/`** — Portable handlers: preset, hotkey.
 - **`src/messages/`** — Message enums for Iced event-driven updates.
@@ -99,16 +100,17 @@ Input → [Tuner bypass] → Input Filters (HP/LP) → [Upsample] → Amp Chain
 - **`src/lib.rs`** — nih-plug `Plugin` impl, audio processing, initialization.
 - **`src/editor.rs`** — `PluginEditor` (nih-plug `Editor` trait) + `PluginApp` (iced_baseview `Application`).
 - **`src/backend.rs`** — `PluginBackend` implementing `ParamBackend` via `EngineHandle` + `GuiContext`.
-- **`src/params.rs`** — Full nih-plug parameter set: global params + 8 slots × 10 stage types.
+- **`src/params.rs`** — Full nih-plug parameter set: global params + 8 slots × 11 stage types. (Note: the per-slot stage params are not yet read by `process()` — see REF-Q3/REV-4 in `claude/tasks.md`.)
 
 ### Stage Registration (`rustortion-ui/src/stages/mod.rs`)
 
-The `gui_stage_registry!` macro generates `StageType`, `StageConfig`, and `StageMessage` enums plus all boilerplate. Adding a new stage requires:
+The `gui_stage_registry!` macro generates the **UI-side** `StageType`, `StageConfig`, and `StageMessage` enums plus boilerplate. Core's `StageConfig` (`rustortion-core/src/preset/stage_config.rs`) is hand-maintained. Adding a new stage requires:
 1. Add one line to the macro invocation
 2. Create `rustortion-ui/src/stages/new_stage.rs` with config, message, and view implementations
 3. Create `rustortion-core/src/amp/stages/new_stage.rs` implementing the `Stage` trait
-4. Add i18n keys to EN and ZH_CN in `rustortion-ui/src/i18n/mod.rs`
-5. Add slot params to `rustortion-plugin/src/params.rs`
+4. Add the variant to `rustortion-core/src/preset/stage_config.rs` (every match site — the compiler will point at them)
+5. Add i18n keys to EN and ZH_CN in `rustortion-ui/src/i18n/mod.rs`
+6. Add slot params to `rustortion-plugin/src/params.rs`
 
 ### Thread Model
 
@@ -121,6 +123,7 @@ The JACK process callback (standalone) or nih-plug `process()` (plugin) runs on
 - **The `gui_stage_registry!` macro** in `rustortion-ui/src/stages/mod.rs` generates boilerplate. Do not hand-write — add one line to the macro invocation instead.
 - **Preset JSON format** — each preset is a JSON file in `~/.config/rustortion/presets/`. Structure: `{ "name": "...", "stages": [...], "ir_name": "...", "ir_gain": N, "pitch_shift_semitones": N, "input_filters": {...} }`.
 - **IR files** are in `impulse_responses/` and `~/.config/rustortion/impulse_responses/`. Loading is async (off RT thread).
+- **NAM models** (`.nam`, WaveNet + LSTM via the `nam-rs` crate) load from a user-configurable folder with rescan; loaded models live in a process-global registry and stages resolve them by name. No rfd file-picker (rfd/gtk3 breaks CI).
 - **Clippy is strict** — CI runs `-D warnings -D clippy::all -D clippy::pedantic -D clippy::nursery`.
 - **iced_baseview** is a fork at `github.com/OpenSauce/iced_baseview`, upgraded to iced 0.14 crates.io.
 

Cargo.lock

@@ -3,7 +3,9 @@
 
 English | [简体中文](README.zh-CN.md)
 
-A guitar amp simulator built in Rust using JACK.
+![CI](https://github.com/OpenSauce/rustortion/actions/workflows/ci.yaml/badge.svg)
+
+A guitar and bass amp simulator built in Rust. Runs standalone with JACK, or as a VST3/CLAP plugin in your DAW.
 
 ## Screenshot
 
@@ -12,14 +14,16 @@ A guitar amp simulator built in Rust using JACK.
 ## Features
 
 - Low-latency audio processing with configurable oversampling (1x–16x)
-- 10 DSP stages: preamp (with 12AX7 triode clipper), compressor, tone stack, power amp, noise gate, level, multi-band saturator, delay, reverb, and 16-band graphic EQ
+- 11 DSP stages: preamp (with 12AX7 triode clipper), compressor, tone stack, power amp, noise gate, level, multi-band saturator, delay, reverb, 16-band graphic EQ, and NAM (Neural Amp Modeler) model loading (WaveNet + LSTM `.nam` files)
 - Impulse response cabinet simulation for both guitar and bass
 - Saving and loading presets with keyboard hotkey switching
 - Real-time recording capability
 - Built-in tuner
 - FFT-based pitch shifting for alternate tunings without retuning your instrument
 - MIDI controller support
+- VST3 and CLAP plugin builds for DAW use (experimental — see [Plugin](#vst3clap-plugin))
 - Tabbed GUI with minimap, collapsible stage cards, and input filter controls - built with [Iced](https://github.com/iced-rs/iced)
+- English and Simplified Chinese UI
 
 ## Requirements
 
@@ -57,6 +61,15 @@ cargo run --release
 > pw-jack cargo run --release
 > ```
 
+### VST3/CLAP Plugin
+
+The plugin is experimental and not yet included in releases — build it from source:
+
+```bash
+make plugin           # builds target/bundled/Rustortion.{clap,vst3}
+make plugin-install   # copies them into ~/.clap and ~/.vst3
+```
+
 ## Contributing
 
 This is an experimental project. Feel free to open issues or submit pull requests.

README.md

@@ -2,7 +2,9 @@
 
 [English](README.md) | 简体中文
 
-一款使用 Rust 和 JACK 构建的吉他音箱模拟器。
+![CI](https://github.com/OpenSauce/rustortion/actions/workflows/ci.yaml/badge.svg)
+
+一款使用 Rust 构建的吉他/贝斯音箱模拟器。可作为 JACK 独立应用运行，也可作为 VST3/CLAP 插件在 DAW 中使用。
 
 ## 截图
 
@@ -11,14 +13,16 @@
 ## 功能特性
 
 - 低延迟音频处理，支持可配置的过采样（1x–16x）
-- 10 个 DSP 处理级：前级放大（含 12AX7 三极管削波器）、压缩器、音色堆栈、后级放大、噪声门、电平、多频段饱和器、延迟、混响、16 频段图形均衡器
+- 11 个 DSP 处理级：前级放大（含 12AX7 三极管削波器）、压缩器、音色堆栈、后级放大、噪声门、电平、多频段饱和器、延迟、混响、16 频段图形均衡器，以及 NAM（Neural Amp Modeler）模型加载（支持 WaveNet 与 LSTM 的 `.nam` 文件）
 - 支持吉他和贝斯的脉冲响应箱体模拟
 - 预设的保存与加载，支持键盘快捷键切换
 - 实时录音功能
 - 内置调音器
 - 基于 FFT 的变调功能，无需重新调弦即可切换至不同调音
 - MIDI 控制器支持
+- VST3 与 CLAP 插件构建，可在 DAW 中使用（实验性 — 参见[插件](#vst3clap-插件)）
 - 标签式界面，支持缩略图、可折叠级卡片和输入滤波器控制 - 使用 [Iced](https://github.com/iced-rs/iced) 构建
+- 界面支持英文与简体中文
 
 ## 系统要求
 
@@ -57,6 +61,15 @@ cargo run --release
 > pw-jack cargo run --release
 > ```
 
+### VST3/CLAP 插件
+
+插件目前为实验性功能，尚未包含在发布版本中——需从源码构建：
+
+```bash
+make plugin           # 构建 target/bundled/Rustortion.{clap,vst3}
+make plugin-install   # 复制到 ~/.clap 与 ~/.vst3
+```
+
 ## 参与贡献
 
 这是一个实验性项目。欢迎提交 issue 或 pull request。

README.zh-CN.md

@@ -16,7 +16,7 @@ anyhow = "1.0"
 rustfft = "6.4"
 realfft = "3.5"
 arc-swap = "1.8"
-nam-rs = "0.2.0"
+nam-rs = "0.3.0"
 
 [dev-dependencies]
 criterion = { version = "0.8", features = ["html_reports"] }

rustortion-core/Cargo.toml

@@ -194,7 +194,7 @@ impl NamConfig {
             return NamStage::passthrough(input_gain, output_gain, mix);
         };
 
-        let native_sample_rate = model.sample_rate() as f32;
+        let native_sample_rate = model.expected_sample_rate() as f32;
         if (native_sample_rate - sample_rate).abs() > 1.0 {
             // Resampling is intentionally avoided (too expensive on the RT path), so a
             // rate mismatch bypasses the model entirely: pass the dry signal through.

rustortion-core/src/amp/stages/nam.rs

@@ -58,7 +58,7 @@ impl NamLoader {
                 Ok(model) => {
                     info!(
                         "Loaded NAM model '{name}' ({} Hz)",
-                        model.sample_rate() as u32
+                        model.expected_sample_rate() as u32
                     );
                     models.insert(name, Arc::new(model));
                 }

rustortion-core/src/nam/loader.rs

@@ -118,7 +118,7 @@ pub fn view(idx: usize, cfg: &NamConfig, state: StageViewState) -> Element<'_, M
         let info_line: Element<'_, Message> = match model_name.as_deref() {
             Some(name) => match registry::get(name) {
                 Some(model) => {
-                    let native_rate = model.sample_rate() as u32;
+                    let native_rate = model.expected_sample_rate() as u32;
                     if native_rate.abs_diff(engine_rate) > 1 {
                         text(format!(
                             "{}: {native_rate} Hz · {engine_rate} Hz",