fractal-midi 0.1.0-alpha.0

package/dist/am4/paramNamesGenerated.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Generated by scripts/gen-paramnames-from-resolver.ts — do not hand-edit.
+ *
+ * Friendly parameter names synthesized from the resolver MISSING set.
+ * Each entry is a (cache_id → snake_case_name) binding for a wire address
+ * the AM4-Edit variant resolver knows about but `paramNames.ts` has no
+ * hand-curated entry for.
+ *
+ * Source authority chain (firmware-truth):
+ *   1. AM4-Edit.exe variant resolver (FUN_1402e3da0)
+ *      -> src/protocol/variantResolverTables.ts
+ *      provides (block, parameterName, cache_id) bindings.
+ *   2. AM4-Edit.exe BinaryData ZIP -> __block_layout*.xml
+ *      -> src/protocol/editorControlLabels.ts
+ *      provides parameterName -> canonical display label.
+ *   3. AM4-Edit metadata cache (effectDefinitions_15_2p0.cache)
+ *      -> samples/captured/decoded/cache-section{2,3}.json
+ *      provides typecode / a / b / c -> unit + display range.
+ *
+ * Merge with the hand-curated `paramNames.ts` happens in
+ * `scripts/gen-params-from-cache.ts`. Resolver-derived entries are
+ * firmware-truth (from AM4-Edit.exe's per-variant dispatcher), so they
+ * win on (block, cache_id) → parameterName conflicts. Hand-curated
+ * entries from `paramNames.ts` were seeded from hardware captures —
+ * messy and occasionally mis-bound — so they yield to the resolver
+ * where the two disagree. For THIS regen, the generator only emits to
+ * cache_ids where `paramNames.ts` has no entry (the diff's MISSING
+ * set), so there is no actual conflict to resolve; the conflict-
+ * resolution rule applies to future broader regenerations.
+ *
+ * Coverage as of regen: 158 new wire-bound friendly names
+ * across 11 blocks.
+ *
+ * Comment beside each entry shows: <canonicalLabel> (<parameterName>) —
+ * the canonical AM4-Edit display label as users will see it on screen,
+ * paired with the firmware symbolic ID for cross-reference.
+ */
+import type { ParamNameEntry } from './paramNames.js';
+export declare const GENERATED_PARAM_NAMES: Readonly<Record<string, Readonly<Record<number, ParamNameEntry>>>>;
+export declare const GENERATED_PARAM_NAMES_FIRMWARE = "AM4-Edit Mar 20 2026 build";
+//# sourceMappingURL=paramNamesGenerated.d.ts.map

package/dist/am4/paramNamesGenerated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paramNamesGenerated.d.ts","sourceRoot":"","sources":["../../src/am4/paramNamesGenerated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAqL3F,CAAC;AAEX,eAAO,MAAM,8BAA8B,+BAA+B,CAAC"}

package/dist/am4/paramNamesGenerated.js

@@ -0,0 +1,183 @@
+export const GENERATED_PARAM_NAMES = {
+    amp: {
+        21: 'proximity', // Proximity (CABINET_PROXIMITY2)
+        38: 'master_vol_cap', // Master Vol Cap (DISTORT_MVCAP)
+        51: 'hi_reso', // Hi Reso (DISTORT_SPKRHFGAIN)
+        57: 'drive', // Drive (DISTORT_SPKRDRIVE)
+        71: 'distance', // Distance (CABINET_DYNACAB_Z1)
+        72: 'distance_dynacab_z2', // Distance (CABINET_DYNACAB_Z2)
+        79: 'frequency', // Frequency (DISTORT_INEQFREQ)
+        81: 'overdrive', // Overdrive (DISTORT_DRIVE2)
+        86: 'definition', // Definition (DISTORT_DEFINITION)
+        87: 'compression', // Compression (DISTORT_CFTHRESH)
+        88: 'cfgrid', // DISTORT_CFGRID
+        90: 'high_cut', // High Cut (DISTORT_HICUT)
+        91: 'dynpres', // DISTORT_DYNPRES
+        92: 'dyndepth', // DISTORT_DYNDEPTH
+        96: 'tremfreq', // DISTORT_TREMFREQ
+        97: 'tremdepth', // DISTORT_TREMDEPTH
+        100: 'cathode_resistance', // Cathode Resistance (DISTORT_CBRATIO)
+        102: 'dynimp', // DISTORT_DYNIMP
+        106: 'indynamics', // DISTORT_INDYNAMICS
+        110: 'gridhardness', // DISTORT_GRIDHARDNESS
+        114: 'triode2extime', // DISTORT_TRIODE2EXTIME
+        115: 'triode2rectime', // DISTORT_TRIODE2RECTIME
+        119: 'triode1ratio', // DISTORT_TRIODE1RATIO
+        120: 'cfhardness', // DISTORT_CFHARDNESS
+        124: 'resolution', // DISTORT_RESOLUTION
+        125: 'vccmon', // B+ (DISTORT_VCCMON)
+        126: 'gain_gainmon', // Gain (DISTORT_GAINMON)
+        127: 'mdmon', // DISTORT_MDMON
+        128: 'indynmon', // DISTORT_INDYNMON
+        137: 'headroom', // HEADROOM (DISTORT_VPLATEMON)
+        138: 'presence_prepresence', // Presence (DISTORT_PREPRESENCE)
+        140: 'high_cut_pahicut', // High Cut (DISTORT_PAHICUT)
+        145: 'overdrive_volume', // Overdrive Volume (DISTORT_GLOBALMASTER)
+        151: 'disablecabsync', // DISTORT_DISABLECABSYNC
+    },
+    drive: {
+        15: 'slew_rate_slew', // Slew Rate (FUZZ_SLEW)
+        19: 'bias_bias', // Bias (FUZZ_BIAS)
+        40: 'diode_quantity_pdqty', // Diode+ Quantity (FUZZ_PDQTY)
+        42: 'diode_quantity', // Diode- Quantity (FUZZ_NDQTY)
+        43: 'dry_level', // Dry Level (FUZZ_DRYGAIN)
+        44: 'bass_bass', // Bass (FUZZ_BASS)
+        49: 'drive_drive2', // Drive (FUZZ_DRIVE2)
+    },
+    reverb: {
+        13: 'high_decay', // High Decay (REVERB_HFRATIO)
+        14: 'scattering', // Scattering (REVERB_DIFFUSION)
+        16: 'reverbdelay', // REVERB_REVERBDELAY
+        17: 'early_level', // Early Level (REVERB_EARLYLEVEL)
+        18: 'late_level', // Late Level  (REVERB_REVERBLEVEL)
+        21: 'depth', // Depth (REVERB_DEPTH)
+        22: 'rate', // Rate (REVERB_RATE)
+        25: 'diffusion', // Diffusion (REVERB_INPDIFF)
+        26: 'diffusion_time', // Diffusion Time (REVERB_INDIFFTIME)
+        29: 'pickup_spacing', // Pickup Spacing (REVERB_WIDTH)
+        30: 'frequency_1', // Frequency 1 (REVERB_FREQ1)
+        31: 'frequency_2', // Frequency 2 (REVERB_FREQ2)
+        32: 'q_1', // Q 1 (REVERB_Q1)
+        33: 'q_2', // Q 2 (REVERB_Q2)
+        34: 'gain_1', // Gain 1 (REVERB_GAIN1)
+        35: 'gain_2', // Gain 2 (REVERB_GAIN2)
+        37: 'low_decay', // Low Decay (REVERB_LFTIME)
+        38: 'xover_frequency', // Xover Frequency (REVERB_LFXOVER)
+        41: 'threshold', // Threshold (REVERB_THRESH)
+        42: 'release_time', // Release Time (REVERB_RELEASE)
+        43: 'early_diffusion', // Early Diffusion (REVERB_EARLYDIFF)
+        44: 'early_diff_time', // Early Diff Time (REVERB_EARLYDIFFTIME)
+        45: 'early_decay', // Early Decay (REVERB_EARLYDECAY)
+        46: 'late_input_mix', // Late Input Mix (REVERB_EARLYSEND)
+        49: 'basetype', // REVERB_BASETYPE
+        50: 'lfo_phase', // LFO Phase (REVERB_LFOPHASE)
+        55: 'pitch_mix', // Pitch Mix (REVERB_PITCHMIX)
+        58: 'pitch_feedback', // Pitch Feedback (REVERB_PITCHFDBK)
+        60: 'splice_time', // Splice Time (REVERB_PITCHTIME)
+        62: 'pitch_modulation', // Pitch Modulation (REVERB_PITCHMOD)
+        63: 'voice_balance', // Voice Balance (REVERB_PITCHBAL)
+        65: 'feedback', // Feedback (REVERB_PREDLYFDBK)
+        66: 'echo_mix', // Echo Mix (REVERB_PREDLYMIX)
+        67: 'pitch_high_cut', // Pitch High Cut (REVERB_PITCHLPF)
+        69: 'tonetype', // REVERB_TONETYPE
+        71: 'low_cut_q', // Low Cut Q (REVERB_LOWQ)
+        72: 'high_cut_q', // High Cut Q (REVERB_HIGHQ)
+    },
+    delay: {
+        15: 'tempo_1', // Tempo 1 (MULTITAP_TEMPO1)
+        17: 'echo_pan', // Echo Pan (DELAY_DELAYPAN)
+        22: 'mod_rate', // Mod Rate (DELAY_RATE1)
+        23: 'rate', // Rate (DELAY_RATE2)
+        24: 'mod_depth', // Mod Depth (DELAY_DEPTH1)
+        25: 'mod_depth_depth2', // Mod Depth (DELAY_DEPTH2)
+        30: 'time_r', // Time R (DELAY_TIMER)
+        34: 'rotation', // Rotation (DELAY_FEEDLR)
+        35: 'lfo_1_type', // LFO 1 Type (MULTITAP_LFOTYPE1)
+        36: 'level_l', // Level L (DELAY_LEVELL)
+        37: 'level_r', // Level R (DELAY_LEVELR)
+        38: 'pan_l', // Pan L (DELAY_PANL)
+        39: 'pan_r', // Pan R (DELAY_PANR)
+        40: 'modulation_phase', // Modulation Phase (DELAY_LFO1PHASE)
+        41: 'lfo_phase', // LFO Phase (DELAY_LFO2PHASE)
+        42: 'crossfade_time', // Crossfade Time (DELAY_SPLICETIME)
+        56: 'sweep_rate', // Sweep Rate (DELAY_RATE3)
+        58: 'sweep_phase', // Sweep Phase (DELAY_LFO3PHASE)
+        60: 'sweep_start_freq', // Sweep Start Freq (DELAY_FSTART)
+        61: 'sweep_stop_freq', // Sweep Stop Freq (DELAY_FSTOP)
+        62: 'sweep_resonance', // Sweep Resonance (DELAY_Q)
+        73: 'right_post_delay', // Right Post Delay (DELAY_OFFSET)
+        82: 'pan_rate', // Pan Rate (DELAY_RATE4)
+        84: 'pan_depth', // Pan Depth (DELAY_DEPTH4)
+        85: 'lfo_phase_lfo4phase', // LFO Phase (DELAY_LFO4PHASE)
+    },
+    chorus: {
+        28: 'left_depth', // Left Depth (CHORUS_DEPTHL)
+        29: 'center_depth', // Center Depth (CHORUS_DEPTHC)
+        30: 'right_depth', // Right Depth (CHORUS_DEPTHR)
+    },
+    flanger: {
+        16: 'dry_delay', // Dry Delay (FLANGER_DRYDELAY)
+        19: 'smooth_steps', // Smooth Steps (FLANGER_LFOFILTER)
+        23: 'high_cut', // High Cut (FLANGER_LPFREQ)
+        24: 'drive', // Drive (FLANGER_DRIVE)
+        25: 'low_cut', // Low Cut (FLANGER_HPFREQ)
+        26: 'stereo_spread', // Stereo Spread (FLANGER_SPREAD)
+        30: 'bass_focus', // Bass Focus (FLANGER_FOCUS)
+        32: 'min_time', // Min Time (FLANGER_TMIN)
+        33: 'max_time', // Max Time (FLANGER_TMAX)
+        35: 'vpo_exponent', // VPO Exponent (FLANGER_VCOK)
+    },
+    phaser: {
+        17: 'min_frequency', // Min Frequency (PHASER_FMIN)
+        18: 'max_frequency', // Max Frequency (PHASER_FMAX)
+        20: 'bias', // Bias (PHASER_BIAS)
+        22: 'feedback_point', // Feedback Point (PHASER_FBTAP)
+        23: 'tone', // Tone (PHASER_TONE)
+        25: 'q', // Q (PHASER_Q)
+        29: 'shape_vcrk', // Shape (PHASER_VCRK)
+        30: 'shape', // Shape (PHASER_LFOBETA)
+        31: 'high_cut', // High Cut (PHASER_LFOLPF)
+        32: 'attack', // Attack (PHASER_ATTACK)
+        33: 'release', // Release (PHASER_RELEASE)
+        35: 'low_cut', // Low Cut (PHASER_HPF)
+        36: 'high_cut_lpf', // High Cut (PHASER_LPF)
+    },
+    compressor: {
+        20: 'compression', // Compression (COMP_SUSTAIN)
+        24: 'dynamics', // Dynamics (COMP_DYNAMICS)
+        33: 'threshold_thresh2', // Threshold (COMP_THRESH2)
+        36: 'ratio_compansion', // Ratio (COMP_COMPANSION)
+        37: 'time', // Time (COMP_COMPTIME)
+        38: 'transients', // Transients (COMP_COMPMATCH)
+        40: 'tone', // Tone (COMP_TONE)
+    },
+    filter: {
+        12: 'q', // Q (FILTER_Q)
+        13: 'gain', // Gain (FILTER_GAIN)
+        15: 'pan_left', // Pan Left (FILTER_PANL)
+        16: 'pan_right', // Pan Right (FILTER_PANR)
+        20: 'delay_time', // Delay Time (FILTER_COMBTIME)
+        24: 'rate', // Rate (FILTER_LFOFREQ)
+        25: 'lfo_duty', // LFO Duty (FILTER_LFODUTY)
+        26: 'mod_frequency', // Mod Frequency (FILTER_MODFREQ)
+        30: 'resonance', // Resonance (FILTER_EVFQ)
+        31: 'start_frequency', // Start Frequency (FILTER_START)
+        32: 'stop_frequency', // Stop Frequency (FILTER_STOP)
+        34: 'attack_time', // Attack Time (FILTER_ATTACK)
+        35: 'release_time', // Release Time (FILTER_RELEASE)
+        36: 'sweep_shape', // Sweep Shape (FILTER_BETA)
+        39: 'emphasis', // Emphasis (FILTER_EMPH)
+    },
+    tremolo: {
+        14: 'duty', // Duty (TREMOLO_DUTY)
+        19: 'start_phase', // Start Phase (TREMOLO_STARTPHASE)
+        21: 'crossover_freq', // Crossover Freq (TREMOLO_XOVER)
+        22: 'trigger_threshold', // Trigger Threshold (TREMOLO_THRESH)
+        23: 'shape', // Shape (TREMOLO_BETA)
+    },
+    enhancer: {
+        16: 'pan_left', // Pan Left (ENHANCER_PANL)
+        17: 'pan_right', // Pan Right (ENHANCER_PANR)
+    },
+};
+export const GENERATED_PARAM_NAMES_FIRMWARE = 'AM4-Edit Mar 20 2026 build';

package/dist/am4/parameterBridge.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Generated by scripts/bridge-paramnames-to-xml.ts. Do not hand-edit.
+ *
+ * Joins the hand-curated paramNames.ts to the XML-derived
+ * editorControlLabels.ts and exposes the result as a runtime lookup
+ * keyed by (block, snake_case_name). Each entry binds:
+ *   - parameterName: AM4-Edit's internal symbolic ID
+ *     (e.g. "DISTORT_BRIGHTCAP" — usable as a stable cross-firmware key)
+ *   - canonicalLabel: the display label AM4-Edit shows on its UI
+ *     (e.g. "Bright Cap" — used in tool descriptions and agent output
+ *     so the agent's vocabulary matches what the user reads on screen)
+ *
+ * This module is a strict refinement layer over paramNames.ts: the
+ * underlying wire IDs are unchanged. Only labels and parameterNames
+ * are added. Coverage is reached via four passes: display-label
+ * match, positional alignment (GEQ/PEQ band patterns), resolver-
+ * direct fallback for entries the AM4-Edit dispatcher binds, and a
+ * universal block-level register fallback (mix/balance/level/bypass)
+ * for wire registers AM4-Edit does not surface in every block UI.
+ */
+export interface ParameterBridgeEntry {
+    block: string;
+    name: string;
+    parameterName: string;
+    canonicalLabel: string;
+}
+export declare const PARAMETER_BRIDGE_FIRMWARE = "AM4-Edit Mar 20 2026 build";
+export declare const PARAMETER_BRIDGE: Readonly<Record<string, Readonly<Record<string, {
+    readonly parameterName: string;
+    readonly canonicalLabel: string;
+}>>>>;
+/**
+ * Resolve the AM4-Edit canonical display label and symbolic
+ * parameterName for a (block, name) pair from paramNames.ts.
+ *
+ * Returns undefined if the (block, name) has no XML correspondence
+ * yet — the caller should fall back to the snake_case name from
+ * paramNames.ts as the display label.
+ */
+export declare function resolveBridge(block: string, name: string): {
+    parameterName: string;
+    canonicalLabel: string;
+} | undefined;
+/** Canonical label for a (block, name), or the original `name`. */
+export declare function preferredDisplayLabel(block: string, name: string): string;
+//# sourceMappingURL=parameterBridge.d.ts.map

package/dist/am4/parameterBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameterBridge.d.ts","sourceRoot":"","sources":["../../src/am4/parameterBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,yBAAyB,+BAA+B,CAAC;AAEtE,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAAC,CAuQpJ,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GACnD;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACjD,SAAS,CAGd;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzE"}

package/dist/am4/parameterBridge.js

@@ -0,0 +1,300 @@
+/**
+ * Generated by scripts/bridge-paramnames-to-xml.ts. Do not hand-edit.
+ *
+ * Joins the hand-curated paramNames.ts to the XML-derived
+ * editorControlLabels.ts and exposes the result as a runtime lookup
+ * keyed by (block, snake_case_name). Each entry binds:
+ *   - parameterName: AM4-Edit's internal symbolic ID
+ *     (e.g. "DISTORT_BRIGHTCAP" — usable as a stable cross-firmware key)
+ *   - canonicalLabel: the display label AM4-Edit shows on its UI
+ *     (e.g. "Bright Cap" — used in tool descriptions and agent output
+ *     so the agent's vocabulary matches what the user reads on screen)
+ *
+ * This module is a strict refinement layer over paramNames.ts: the
+ * underlying wire IDs are unchanged. Only labels and parameterNames
+ * are added. Coverage is reached via four passes: display-label
+ * match, positional alignment (GEQ/PEQ band patterns), resolver-
+ * direct fallback for entries the AM4-Edit dispatcher binds, and a
+ * universal block-level register fallback (mix/balance/level/bypass)
+ * for wire registers AM4-Edit does not surface in every block UI.
+ */
+export const PARAMETER_BRIDGE_FIRMWARE = 'AM4-Edit Mar 20 2026 build';
+export const PARAMETER_BRIDGE = {
+    amp: {
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "bass": { parameterName: "DISTORT_BASS", canonicalLabel: "Bass" },
+        "bright_cap": { parameterName: "DISTORT_BRIGHTCAP", canonicalLabel: "Bright Cap" },
+        "compressor_amount": { parameterName: "DISTORT_COMPRESSION", canonicalLabel: "Amount" },
+        "compressor_clarity": { parameterName: "DISTORT_CLARITY", canonicalLabel: "Clarity" },
+        "compressor_threshold": { parameterName: "DISTORT_THRESHOLD", canonicalLabel: "Threshold" },
+        "depth": { parameterName: "DISTORT_DEPTH", canonicalLabel: "Depth" },
+        "gain": { parameterName: "DISTORT_DRIVE", canonicalLabel: "Gain" },
+        "geq_band_1": { parameterName: "DISTORT_EQ1", canonicalLabel: "Low" },
+        "geq_band_2": { parameterName: "DISTORT_EQ2", canonicalLabel: "Mid" },
+        "geq_band_3": { parameterName: "DISTORT_EQ3", canonicalLabel: "Treble" },
+        "geq_band_4": { parameterName: "DISTORT_EQ4", canonicalLabel: "Presence" },
+        "geq_band_5": { parameterName: "DISTORT_EQ5", canonicalLabel: "1K" },
+        "geq_band_6": { parameterName: "DISTORT_EQ6", canonicalLabel: "2K" },
+        "geq_band_7": { parameterName: "DISTORT_EQ7", canonicalLabel: "4K" },
+        "geq_band_8": { parameterName: "DISTORT_EQ8", canonicalLabel: "8K" },
+        "high_treble": { parameterName: "DISTORT_HITREBLE", canonicalLabel: "High Treble" },
+        "input_trim": { parameterName: "DISTORT_TRIM", canonicalLabel: "Input Trim" },
+        "master": { parameterName: "DISTORT_MASTER", canonicalLabel: "Master" },
+        "master_vol_trim": { parameterName: "DISTORT_MVTRIM", canonicalLabel: "Master Vol Trim" },
+        "mid": { parameterName: "DISTORT_MID", canonicalLabel: "Mid" },
+        "out_boost_level": { parameterName: "BLOCK_OUTBOOSTDB", canonicalLabel: "Out Boost Level" },
+        "presence": { parameterName: "DISTORT_PRESENCE", canonicalLabel: "Presence" },
+        "treble": { parameterName: "DISTORT_TREBLE", canonicalLabel: "Treble" },
+        "type": { parameterName: "DISTORT_TYPE", canonicalLabel: "Type" },
+    },
+    chorus: {
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "depth": { parameterName: "CHORUS_DEPTH", canonicalLabel: "Depth" },
+        "drive": { parameterName: "CHORUS_DRIVE", canonicalLabel: "Drive" },
+        "high_cut": { parameterName: "CHORUS_HICUT", canonicalLabel: "High Cut" },
+        "lfo_depth_2": { parameterName: "CHORUS_SPREAD", canonicalLabel: "Stereo Spread" },
+        "lfo_freq": { parameterName: "CHORUS_LOWCUT", canonicalLabel: "Low Cut" },
+        "lfo_phase_pct": { parameterName: "CHORUS_WIDTH", canonicalLabel: "Right\nTime Ratio" },
+        "lfo_rate": { parameterName: "CHORUS_RATE2", canonicalLabel: "Rate Right" },
+        "mix": { parameterName: "BLOCK_MIX", canonicalLabel: "Mix" },
+        "number_of_voices": { parameterName: "CHORUS_VOICES", canonicalLabel: "Number of Voices" },
+        "rate": { parameterName: "CHORUS_RATE", canonicalLabel: "Rate" },
+        "type": { parameterName: "CHORUS_TYPE", canonicalLabel: "CHORUS_TYPE" },
+        "width": { parameterName: "CHORUS_DEPTH2", canonicalLabel: "LFO 2 Depth" },
+    },
+    compressor: {
+        "attack": { parameterName: "COMP_ATTACK", canonicalLabel: "Attack" },
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "drive": { parameterName: "COMP_DRIVE", canonicalLabel: "Drive" },
+        "emphasis": { parameterName: "COMP_EMPHASIS", canonicalLabel: "Emphasis" },
+        "look_ahead_time": { parameterName: "COMP_DELAYTIME", canonicalLabel: "Look-Ahead Time" },
+        "mix": { parameterName: "BLOCK_MIX", canonicalLabel: "Mix" },
+        "ratio": { parameterName: "COMP_RATIO", canonicalLabel: "Ratio" },
+        "release": { parameterName: "COMP_RELEASE", canonicalLabel: "Release Time" },
+        "sidechain_emphasis_freq": { parameterName: "COMP_EMPHFREQ", canonicalLabel: "Emphasis Freq" },
+        "sidechain_frequency": { parameterName: "COMP_FREQ", canonicalLabel: "Frequency" },
+        "sidechain_gain": { parameterName: "COMP_GAIN", canonicalLabel: "Gain" },
+        "sidechain_high_cut": { parameterName: "COMP_HIGHCUT", canonicalLabel: "High Cut" },
+        "sidechain_low_cut": { parameterName: "COMP_LOWCUT", canonicalLabel: "Low Cut" },
+        "sidechain_q": { parameterName: "COMP_Q", canonicalLabel: "Q" },
+        "threshold": { parameterName: "COMP_THRESH", canonicalLabel: "Threshold" },
+        "type": { parameterName: "COMP_TYPE", canonicalLabel: "COMP_TYPE" },
+    },
+    delay: {
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "bit_reduction": { parameterName: "DELAY_BITREDUCE", canonicalLabel: "Bit Reduction" },
+        "compander_threshold": { parameterName: "DELAY_COMPTHRESH", canonicalLabel: "Threshold" },
+        "compander_time": { parameterName: "DELAY_COMPTIME", canonicalLabel: "Time" },
+        "diffusion_time": { parameterName: "DELAY_DIFFTIME", canonicalLabel: "Diffusion Time" },
+        "diffusor": { parameterName: "DELAY_DIFFUSE", canonicalLabel: "Diffuser" },
+        "ducker_release": { parameterName: "DELAY_RELEASE", canonicalLabel: "Release" },
+        "ducker_threshold": { parameterName: "DELAY_THRESH", canonicalLabel: "Threshold" },
+        "ducking": { parameterName: "DELAY_ATTEN", canonicalLabel: "Ducking" },
+        "eq_freq_1": { parameterName: "DELAY_FREQ1", canonicalLabel: "Frequency 1" },
+        "eq_freq_2": { parameterName: "DELAY_FREQ2", canonicalLabel: "Frequency 2" },
+        "eq_gain_1": { parameterName: "DELAY_GAIN1", canonicalLabel: "Gain 1" },
+        "eq_gain_2": { parameterName: "DELAY_GAIN2", canonicalLabel: "Gain 2" },
+        "eq_q_1": { parameterName: "DELAY_Q1", canonicalLabel: "Q 1" },
+        "eq_q_2": { parameterName: "DELAY_Q2", canonicalLabel: "Q 2" },
+        "eq_q_high_low": { parameterName: "DELAY_FILTERQ", canonicalLabel: "Q (High + Low)" },
+        "feedback": { parameterName: "DELAY_FEED", canonicalLabel: "Feedback" },
+        "feedback_r": { parameterName: "DELAY_FEEDR", canonicalLabel: "Feedback R" },
+        "high_cut": { parameterName: "DELAY_HICUT", canonicalLabel: "High Cut" },
+        "hold_feedback": { parameterName: "DELAY_HOLDFDBK", canonicalLabel: "Hold Feedback" },
+        "input_gain": { parameterName: "DELAY_GAIN", canonicalLabel: "Input Gain" },
+        "lfo_depth": { parameterName: "DELAY_DIFFDEPTH", canonicalLabel: "LFO Depth" },
+        "lfo_rate": { parameterName: "DELAY_DIFFRATE", canonicalLabel: "LFO Rate" },
+        "low_cut": { parameterName: "DELAY_LOCUT", canonicalLabel: "Low Cut" },
+        "lr_time_ratio": { parameterName: "DELAY_RATIO", canonicalLabel: "L/R Time Ratio" },
+        "master_feedback": { parameterName: "DELAY_MSTRFDBK", canonicalLabel: "Master Feedback" },
+        "master_time": { parameterName: "DELAY_MSTRTIME", canonicalLabel: "Master Time" },
+        "mix": { parameterName: "BLOCK_MIX", canonicalLabel: "Mix" },
+        "motor_speed": { parameterName: "DELAY_SPEED", canonicalLabel: "Motor\nSpeed" },
+        "stack_feedback": { parameterName: "DELAY_STACKFDBK", canonicalLabel: "Stack Feedback" },
+        "stereo_spread": { parameterName: "DELAY_SPREAD", canonicalLabel: "Stereo Spread" },
+        "time": { parameterName: "DELAY_TIME", canonicalLabel: "Time" },
+        "type": { parameterName: "DELAY_MODEL", canonicalLabel: "DELAY_MODEL" },
+    },
+    drive: {
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "bass": { parameterName: "FUZZ_LOW", canonicalLabel: "Bass" },
+        "bit_reduce": { parameterName: "FUZZ_BITREDUCE", canonicalLabel: "Bit Reduce" },
+        "drive": { parameterName: "FUZZ_DRIVE", canonicalLabel: "Drive" },
+        "geq_band_1": { parameterName: "FUZZ_EQ1", canonicalLabel: "100" },
+        "geq_band_10": { parameterName: "FUZZ_EQ10", canonicalLabel: "6400" },
+        "geq_band_2": { parameterName: "FUZZ_EQ2", canonicalLabel: "160" },
+        "geq_band_3": { parameterName: "FUZZ_EQ3", canonicalLabel: "250" },
+        "geq_band_4": { parameterName: "FUZZ_EQ4", canonicalLabel: "400" },
+        "geq_band_5": { parameterName: "FUZZ_EQ5", canonicalLabel: "640" },
+        "geq_band_6": { parameterName: "FUZZ_EQ6", canonicalLabel: "1000" },
+        "geq_band_7": { parameterName: "FUZZ_EQ7", canonicalLabel: "1600" },
+        "geq_band_8": { parameterName: "FUZZ_EQ8", canonicalLabel: "2500" },
+        "geq_band_9": { parameterName: "FUZZ_EQ9", canonicalLabel: "4000" },
+        "high_cut": { parameterName: "FUZZ_HICUT", canonicalLabel: "High Cut" },
+        "high_mid": { parameterName: "FUZZ_HIMID", canonicalLabel: "High Mid" },
+        "level": { parameterName: "FUZZ_LEVEL", canonicalLabel: "Level" },
+        "low_cut": { parameterName: "FUZZ_LOCUT", canonicalLabel: "Low Cut" },
+        "mid": { parameterName: "FUZZ_MID", canonicalLabel: "Mid" },
+        "mid_freq": { parameterName: "FUZZ_MIDFREQ", canonicalLabel: "Mid Frequency" },
+        "mix": { parameterName: "FUZZ_MIX", canonicalLabel: "Blend" },
+        "tone": { parameterName: "FUZZ_TONE", canonicalLabel: "Tone" },
+        "treble": { parameterName: "FUZZ_TREBLE", canonicalLabel: "Treble" },
+        "type": { parameterName: "FUZZ_TYPE", canonicalLabel: "FUZZ_TYPE" },
+    },
+    enhancer: {
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "depth": { parameterName: "ENHANCER_DEPTH", canonicalLabel: "Depth" },
+        "high_cut": { parameterName: "ENHANCER_HICUT", canonicalLabel: "High Cut" },
+        "low_cut": { parameterName: "ENHANCER_LOWCUT", canonicalLabel: "Low Cut" },
+        "mix": { parameterName: "BLOCK_MIX", canonicalLabel: "Mix" },
+        "type": { parameterName: "ENHANCER_TYPE", canonicalLabel: "ENHANCER_TYPE" },
+        "width": { parameterName: "ENHANCER_WIDTH", canonicalLabel: "Width" },
+    },
+    filter: {
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "feedback": { parameterName: "FILTER_FEEDBACK", canonicalLabel: "Feedback" },
+        "freq": { parameterName: "FILTER_FREQ", canonicalLabel: "Frequency" },
+        "high_cut": { parameterName: "FILTER_HICUT", canonicalLabel: "High Cut" },
+        "low_cut": { parameterName: "FILTER_LOWCUT", canonicalLabel: "Low Cut" },
+        "mix": { parameterName: "BLOCK_MIX", canonicalLabel: "Mix" },
+        "order": { parameterName: "FILTER_APORDER", canonicalLabel: "Order" },
+        "sensitivity": { parameterName: "FILTER_SENS", canonicalLabel: "Sensitivity" },
+        "type": { parameterName: "FILTER_TYPE", canonicalLabel: "Type" },
+    },
+    flanger: {
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "depth": { parameterName: "FLANGER_DEPTH", canonicalLabel: "Depth" },
+        "feedback": { parameterName: "FLANGER_FEEDBACK", canonicalLabel: "Feedback" },
+        "mix": { parameterName: "BLOCK_MIX", canonicalLabel: "Mix" },
+        "rate": { parameterName: "FLANGER_RATE", canonicalLabel: "Rate" },
+        "type": { parameterName: "FLANGER_TYPE", canonicalLabel: "FLANGER_TYPE" },
+    },
+    gate: {
+        "attack": { parameterName: "GATE_ATTACK", canonicalLabel: "Attack" },
+        "attenuation": { parameterName: "GATE_RANGE", canonicalLabel: "Attenuation" },
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "hold": { parameterName: "GATE_HOLD", canonicalLabel: "Hold" },
+        "release": { parameterName: "GATE_RELEASE", canonicalLabel: "Release" },
+        "threshold": { parameterName: "GATE_THRESH", canonicalLabel: "Threshold" },
+        "type": { parameterName: "GATE_TYPE", canonicalLabel: "GATE_TYPE" },
+    },
+    geq: {
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "band_1": { parameterName: "GEQ_GAIN1", canonicalLabel: "100" },
+        "band_10": { parameterName: "GEQ_GAIN10", canonicalLabel: "16k" },
+        "band_2": { parameterName: "GEQ_GAIN2", canonicalLabel: "160" },
+        "band_3": { parameterName: "GEQ_GAIN3", canonicalLabel: "400" },
+        "band_4": { parameterName: "GEQ_GAIN4", canonicalLabel: "800" },
+        "band_5": { parameterName: "GEQ_GAIN5", canonicalLabel: "500" },
+        "band_6": { parameterName: "GEQ_GAIN6", canonicalLabel: "1k" },
+        "band_7": { parameterName: "GEQ_GAIN7", canonicalLabel: "2k" },
+        "band_8": { parameterName: "GEQ_GAIN8", canonicalLabel: "4k" },
+        "band_9": { parameterName: "GEQ_GAIN9", canonicalLabel: "8k" },
+        "master_q": { parameterName: "GEQ_MASTERQ", canonicalLabel: "Master Q" },
+        "mix": { parameterName: "BLOCK_MIX", canonicalLabel: "Mix" },
+        "type": { parameterName: "GEQ_TYPE", canonicalLabel: "GEQ_TYPE" },
+    },
+    peq: {
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "channel_1_frequency": { parameterName: "PEQ_FREQ1", canonicalLabel: "Freq 1" },
+        "channel_1_gain": { parameterName: "PEQ_GAIN1", canonicalLabel: "Gain 1" },
+        "channel_1_q": { parameterName: "PEQ_Q1", canonicalLabel: "Q1" },
+        "channel_2_frequency": { parameterName: "PEQ_FREQ2", canonicalLabel: "Freq 2" },
+        "channel_2_gain": { parameterName: "PEQ_GAIN2", canonicalLabel: "Gain 2" },
+        "channel_2_q": { parameterName: "PEQ_Q2", canonicalLabel: "Q2" },
+        "channel_3_frequency": { parameterName: "PEQ_FREQ3", canonicalLabel: "Freq 3" },
+        "channel_3_gain": { parameterName: "PEQ_GAIN3", canonicalLabel: "Gain 3" },
+        "channel_3_q": { parameterName: "PEQ_Q3", canonicalLabel: "Q3" },
+        "channel_4_frequency": { parameterName: "PEQ_FREQ4", canonicalLabel: "Freq 4" },
+        "channel_4_gain": { parameterName: "PEQ_GAIN4", canonicalLabel: "Gain 4" },
+        "channel_4_q": { parameterName: "PEQ_Q4", canonicalLabel: "Q4" },
+        "channel_5_frequency": { parameterName: "PEQ_FREQ5", canonicalLabel: "Freq 5" },
+        "channel_5_gain": { parameterName: "PEQ_GAIN5", canonicalLabel: "Gain 5" },
+        "channel_5_q": { parameterName: "PEQ_Q5", canonicalLabel: "Q5" },
+        "mix": { parameterName: "BLOCK_MIX", canonicalLabel: "Mix" },
+    },
+    phaser: {
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "feedback": { parameterName: "PHASER_FEEDBACK", canonicalLabel: "Feedback" },
+        "mix": { parameterName: "BLOCK_MIX", canonicalLabel: "Mix" },
+        "rate": { parameterName: "PHASER_RATE", canonicalLabel: "Rate" },
+        "type": { parameterName: "PHASER_TYPE", canonicalLabel: "Type" },
+    },
+    reverb: {
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "mix": { parameterName: "BLOCK_MIX", canonicalLabel: "Mix" },
+        "shift_1": { parameterName: "REVERB_SHIFT1", canonicalLabel: "Voice 1 Shift" },
+        "shift_2": { parameterName: "REVERB_SHIFT2", canonicalLabel: "Voice 2 Shift" },
+        "size": { parameterName: "REVERB_SIZE", canonicalLabel: "Size" },
+        "spring_tone": { parameterName: "REVERB_TONE", canonicalLabel: "Tone" },
+        "springs": { parameterName: "REVERB_NUMSPRINGS", canonicalLabel: "# of Springs" },
+        "time": { parameterName: "REVERB_TIME", canonicalLabel: "Time" },
+        "type": { parameterName: "REVERB_TYPE", canonicalLabel: "REVERB_TYPE" },
+    },
+    rotary: {
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "drive": { parameterName: "ROTARY_DRIVE", canonicalLabel: "Drive" },
+        "high_depth": { parameterName: "ROTARY_HFDEPTH", canonicalLabel: "High Depth" },
+        "high_level": { parameterName: "ROTARY_HFLEVEL", canonicalLabel: "High Level" },
+        "high_time_constant": { parameterName: "ROTARY_HIGHTIME", canonicalLabel: "High Time Constant" },
+        "low_depth": { parameterName: "ROTARY_LFDEPTH", canonicalLabel: "Low Depth" },
+        "low_rate_multiplier": { parameterName: "ROTARY_LOWRATE", canonicalLabel: "Low Rate Multiplier" },
+        "low_time_constant": { parameterName: "ROTARY_LOWTIME", canonicalLabel: "Low Time Constant" },
+        "mic_distance": { parameterName: "ROTARY_MICDIST", canonicalLabel: "Mic Distance" },
+        "mic_spacing": { parameterName: "ROTARY_WIDTH", canonicalLabel: "Mic\nSpacing" },
+        "mix": { parameterName: "BLOCK_MIX", canonicalLabel: "Mix" },
+        "rate": { parameterName: "ROTARY_RATE", canonicalLabel: "Rate" },
+        "rotor_length": { parameterName: "ROTARY_HFLENGTH", canonicalLabel: "Rotor Length" },
+        "stereo_spread": { parameterName: "ROTARY_SPREAD", canonicalLabel: "Stereo Spread" },
+    },
+    tremolo: {
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "depth": { parameterName: "TREMOLO_DEPTH", canonicalLabel: "Depth" },
+        "mix": { parameterName: "BLOCK_MIX", canonicalLabel: "Mix" },
+        "rate": { parameterName: "TREMOLO_RATE", canonicalLabel: "Rate" },
+        "type": { parameterName: "TREMOLO_TYPE", canonicalLabel: "Type" },
+    },
+    volpan: {
+        "attack": { parameterName: "VOLUME_ATTACK", canonicalLabel: "Attack" },
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "mode": { parameterName: "VOLUME_TYPE", canonicalLabel: "VOLUME_TYPE" },
+        "threshold": { parameterName: "VOLUME_THRESHOLD", canonicalLabel: "Threshold" },
+    },
+    wah: {
+        "balance": { parameterName: "BLOCK_PAN", canonicalLabel: "Balance" },
+        "drive": { parameterName: "WAH_DRIVE", canonicalLabel: "Drive" },
+        "fat": { parameterName: "WAH_MIX", canonicalLabel: "Fat" },
+        "graphic_eq_band_1": { parameterName: "WAH_EQ1", canonicalLabel: "160" },
+        "graphic_eq_band_2": { parameterName: "WAH_EQ2", canonicalLabel: "250" },
+        "graphic_eq_band_3": { parameterName: "WAH_EQ3", canonicalLabel: "400" },
+        "graphic_eq_band_4": { parameterName: "WAH_EQ4", canonicalLabel: "640" },
+        "graphic_eq_band_5": { parameterName: "WAH_EQ5", canonicalLabel: "1000" },
+        "graphic_eq_band_6": { parameterName: "WAH_EQ6", canonicalLabel: "1600" },
+        "graphic_eq_band_7": { parameterName: "WAH_EQ7", canonicalLabel: "2500" },
+        "graphic_eq_band_8": { parameterName: "WAH_EQ8", canonicalLabel: "4000" },
+        "inductor_bias": { parameterName: "WAH_BIAS", canonicalLabel: "Inductor Bias" },
+        "low_cut_frequency": { parameterName: "WAH_HPF", canonicalLabel: "Low Cut Frequency" },
+        "max_frequency": { parameterName: "WAH_FSTOP", canonicalLabel: "Maximum Frequency" },
+        "min_frequency": { parameterName: "WAH_FSTART", canonicalLabel: "Minimum Frequency" },
+        "mix": { parameterName: "BLOCK_MIX", canonicalLabel: "Mix" },
+        "q_resonance": { parameterName: "WAH_Q", canonicalLabel: "Resonance" },
+        "q_tracking": { parameterName: "WAH_TRACK", canonicalLabel: "Q Tracking " },
+        "type": { parameterName: "WAH_TYPE", canonicalLabel: "WAH_TYPE" },
+        "wah_control": { parameterName: "WAH_CONTROL", canonicalLabel: "Wah Control" },
+    },
+};
+/**
+ * Resolve the AM4-Edit canonical display label and symbolic
+ * parameterName for a (block, name) pair from paramNames.ts.
+ *
+ * Returns undefined if the (block, name) has no XML correspondence
+ * yet — the caller should fall back to the snake_case name from
+ * paramNames.ts as the display label.
+ */
+export function resolveBridge(block, name) {
+    return PARAMETER_BRIDGE[block]?.[name];
+}
+/** Canonical label for a (block, name), or the original `name`. */
+export function preferredDisplayLabel(block, name) {
+    return PARAMETER_BRIDGE[block]?.[name]?.canonicalLabel ?? name;
+}