fractal-midi 0.5.0 → 0.6.0

package/README.md

@@ -8,8 +8,10 @@ device speaks, without pulling in a MIDI transport library.
 > family (Axe-Fx III / FM3 / FM9 / VP4) at codec and calibration via
 > public-capture verification and editor-binary mining, and the Axe-Fx
 > Standard/Ultra (gen-1) as a set + parameter-read descriptor. The gen-3
-> family stays community-driven for hardware verification; see the
-> per-device notes in the coverage table.
+> family stays community-driven for hardware verification, with owner
+> confirmation now accumulating (the FM3's core surface field-confirmed,
+> and Axe-Fx III + FM9 reads and continuous writes owner-confirmed in
+> 2026-06); see the per-device notes in the coverage table.
 
 > **Unaffiliated community library.** "Fractal Audio", "AM4",
 > "Axe-Fx", "Axe-Fx II", "Axe-Fx III", "FM3", "FM9", and "VP4" are
@@ -60,7 +62,7 @@ import { buildSetParam, KNOWN_PARAMS } from 'fractal-midi/am4';
 
 // Build the SysEx bytes for "set amp gain to 7.5" (display value in)
 const bytes = buildSetParam('amp.gain', 7.5);
-// → number[] starting with 0xF0 ... ending 0xF7 — send via your MIDI library
+// → number[] starting with 0xF0 ... ending 0xF7. Send via your MIDI library
 
 // Inspect the dictionary directly
 console.log(KNOWN_PARAMS['amp.gain']);
@@ -76,20 +78,20 @@ import { buildSetBlockParameterValue, KNOWN_PARAMS } from 'fractal-midi/gen2/axe
 import { buildSetParameter, PARAMS_BY_FAMILY } from 'fractal-midi/gen3/axe-fx-iii';
 ```
 
-> **Breaking change in 0.4.0 — generation-prefixed subpaths.** Device
+> **Breaking change in 0.4.0: generation-prefixed subpaths.** Device
 > subpaths are now organized by Fractal codec generation:
 > `fractal-midi/gen1` (Axe-Fx Standard/Ultra, formerly `/axe-fx-gen1`),
 > `fractal-midi/gen2/axe-fx-ii` (formerly `/axe-fx-ii`), and
 > `fractal-midi/gen3/{axe-fx-iii,fm3,fm9,vp4}` (formerly `/axe-fx-iii`,
 > `/fm3`, `/fm9`, `/vp4`). `fractal-midi/am4` and `fractal-midi/shared`
 > are unchanged (the AM4 is its own codec, not one of the three
-> generations), and **`catalog/*.json` paths are unchanged** — JSON
+> generations), and **`catalog/*.json` paths are unchanged**, JSON
 > consumers are unaffected.
 
 ### Not using TypeScript? Use the JSON catalog
 
 `catalog/` ships a generated, language-agnostic export of every device's
-parameter dictionary, block tables, enum rosters, and ranges — one JSON file
+parameter dictionary, block tables, enum rosters, and ranges: one JSON file
 per device. Read it straight from the installed package
 (`node_modules/fractal-midi/catalog/<device>.json`) or from a pinned git tag.
 Pin a version rather than copying the files: calibration fixes and enum-roster
@@ -103,11 +105,11 @@ the TypeScript source on every change and CI-gated against drift.
 |---|---|---|---|---|
 | AM4 | ✅ | ✅ | ✅ | ✅ |
 | Axe-Fx II | ✅ | ✅ | ✅ | ✅ |
-| Axe-Fx III | ✅ (full catalog) | ✅ ([see note](#axe-fx-iii-codec-note)) | ✅ ([see note](#axe-fx-iii-calibration-note)) | 🟡 community beta ([see note](#axe-fx-iii-hardware-note)) |
-| FM3 | ✅ (device-true, mined from FM3-Edit) | ✅ (shared gen-3) | 🟡 (linear; some non-linear pending) | 🟡 community beta ([see note](#fm3--fm9) — core surface field-confirmed 2026-06) |
-| FM9 | ✅ (device-true, mined from FM9-Edit) | ✅ (shared gen-3) | 🟡 (linear; some non-linear pending) | ❌ community beta |
+| Axe-Fx III | ✅ (full catalog) | ✅ ([see note](#axe-fx-iii-codec-note)) | ✅ ([see note](#axe-fx-iii-calibration-note)) | 🟡 community beta ([see note](#axe-fx-iii-hardware-note), owner-confirmed reads + continuous writes 2026-06) |
+| FM3 | ✅ (device-true, mined from FM3-Edit) | ✅ (shared gen-3) | 🟡 (linear; some non-linear pending) | 🟡 community beta ([see note](#fm3--fm9), core surface field-confirmed 2026-06) |
+| FM9 | ✅ (device-true, mined from FM9-Edit) | ✅ (shared gen-3) | 🟡 (linear; some non-linear pending) | 🟡 community beta ([see note](#fm3--fm9), owner-confirmed reads + continuous writes 2026-06) |
 | VP4 | ✅ (device-true, mined from VP4-Edit) | ✅ (gen-3 envelope; own fn=0x01 write frame, decoded byte-exact from community captures, fw 4.03) | 🟡 (continuous writes take raw wire values; calibration pending) | 🟡 community beta (reads confirmed via community captures; decoded writes untested on hardware) |
-| Axe-Fx Standard/Ultra (gen-1) | ✅ (922 params) | ✅ (nibble-split, set + param read) | 🟡 (linear; 171 non-linear pending) | ❌ community beta (no gen-1 hardware) |
+| Axe-Fx Standard/Ultra (gen-1) | ✅ (922 params) | ✅ (nibble-split; set, param read, patch-dump get_preset subset) | 🟡 (linear; 171 non-linear pending) | ❌ community beta (no gen-1 hardware) |
 
 ### Coverage notes
 
@@ -144,9 +146,13 @@ as display guidance the user can correct via GitHub issue.
 #### Axe-Fx III hardware note
 
 The 🟡 hardware-verified status means the maintainer does not own an
-Axe-Fx III for round-trip confirmation. Community users running the
-device are invited to file GitHub issues against any wire or label
-that disagrees with their hardware.
+Axe-Fx III for round-trip confirmation. A 2026-06 owner test did confirm
+`get_param` and continuous `set_param` on real III hardware (device echo
+plus a read-back matching the front panel), the first on-device
+confirmation of the III (the gen-3 byte-identity anchor); discrete
+set-by-name, `save_preset`, `set_block`, and the live grid read stay
+community beta. Community users running the device are invited to file
+GitHub issues against any wire or label that disagrees with their hardware.
 
 #### FM3 / FM9
 
@@ -158,7 +164,11 @@ never reused from the III) on the shared gen-3 codec. Calibration
 covers the linear params; some non-linear display formulas are still
 pending. Neither has been hardware-verified by the maintainer, so they
 remain community beta. The FM9 has real community captures confirming
-the shared read and preset-dump paths. The FM3's core surface was
+the shared read and preset-dump paths, plus a 2026-06 owner test that
+round-tripped `get_param` and continuous `set_param` on the device
+(acknowledged, values confirmed on the FM9-Editor display); discrete
+set-by-name, `save_preset`, `set_block`, and the live grid read stay
+community beta on the FM9. The FM3's core surface was
 hardware-confirmed end-to-end by a 2026-06-12 community field test over
 its USB-serial transport (discovery, framing, the whole read path,
 continuous SET, bypass, scene and preset switching, all through this

package/catalog/axe-fx-iii.json

@@ -16379,6 +16379,7 @@
         "9": "Brit JM45",
         "10": "Plexi 50W Normal",
         "11": "Plexi 50W High 1",
+        "12": "1987X Normal",
         "13": "1987X Treble",
         "14": "Brit 800 2204 High",
         "15": "Brit Super",
@@ -16387,6 +16388,7 @@
         "18": "USA MK IV Rhythm 1",
         "19": "USA Pre Clean",
         "20": "USA MK IV Rhythm 2",
+        "21": "USA MK IIC+",
         "22": "USA MK IIC+ Bright",
         "23": "USA MK IV Lead",
         "24": "USA MK IV Lead Bright",
@@ -16411,6 +16413,7 @@
         "43": "Wrecker Rocket",
         "44": "Cornfed M50",
         "45": "Carol-Ann OD-2",
+        "46": "Fryette D60 Less",
         "47": "Fryette D60 More",
         "48": "Brit Brown",
         "49": "Citrus RV50",
@@ -16429,7 +16432,9 @@
         "62": "Matchbox Chiefman 2",
         "63": "Cameron CCV 1A",
         "64": "Cameron CCV 2A",
+        "65": "SV Bass 2",
         "66": "Tube Pre",
+        "67": "FAS Brown",
         "68": "Big Hair",
         "69": "Solo 99 Lead",
         "70": "Supertweed",
@@ -16452,6 +16457,8 @@
         "87": "Herbie CH2+",
         "88": "Herbie CH3",
         "89": "Dirty Shirley 1",
+        "90": "Dizzy V4 Blue 2",
+        "91": "Dizzy V4 Blue 3",
         "92": "Dizzy V4 Blue 4",
         "93": "Suhr Badger 18",
         "94": "Suhr Badger 30",
@@ -16465,6 +16472,7 @@
         "102": "Spawn Q-Rod OD2-3",
         "103": "Brit Silver",
         "104": "Spawn Nitrous 2",
+        "105": "FAS Crunch",
         "106": "Two Stone J35 PAB",
         "107": "Fox ODS",
         "108": "Hot Kitty",
@@ -16491,15 +16499,18 @@
         "129": "AC-20 EF86 Bass",
         "130": "Princetone Reverb",
         "131": "Comet Concourse",
+        "132": "FAS Modern II",
         "133": "Carol-Ann Triptik Modern",
         "134": "Carol-Ann Triptik Classic",
         "135": "Carol-Ann Triptik Clean",
         "136": "Thordendal Vintage",
+        "137": "Thordendal Modern",
         "138": "ODS-100 HRM Mid",
         "139": "Euro Blue Modern",
         "140": "Euro Red Modern",
         "141": "Plexi 50W Jumped",
         "142": "AC-20 EF86 Treble",
+        "143": "Comet 60",
         "144": "Hipower Jumped",
         "145": "Plexi 100W Jumped",
         "146": "Brit JM45 Jumped",
@@ -16513,6 +16524,7 @@
         "154": "Wrecker Express",
         "155": "Two Stone J35",
         "156": "ODS-100 Ford",
+        "157": "Mr Z MZ-8",
         "158": "Car Ambler",
         "159": "USA Metro Blues",
         "160": "Wrecker Liverpool",
@@ -16524,7 +16536,11 @@
         "166": "Matchbox D-30",
         "167": "FAS Class-A",
         "168": "USA Bass 400 1",
+        "169": "USA Bass 400 2",
+        "170": "Citrus Bass 200",
+        "171": "FAS Bass",
         "172": "Tremolo Lux",
+        "173": "FAS Brootalz",
         "174": "Recto1 Orange Modern",
         "175": "Angle Severe 1",
         "176": "Angle Severe 2",
@@ -16543,10 +16559,13 @@
         "189": "Dizzy V4 Silver 3",
         "190": "Dizzy V4 Silver 2",
         "191": "Dizzy V4 Silver 4",
+        "192": "1959SLP Normal",
         "193": "1959SLP Treble",
         "194": "1959SLP Jumped",
+        "195": "FAS Modern III",
         "196": "ODS-100 Ford PAB Mid",
         "197": "Mr Z Highway 66",
+        "198": "6G4 Super",
         "199": "6G12 Concert",
         "200": "65 Bassguy Bass",
         "201": "Vibra-King Fat",
@@ -16563,11 +16582,13 @@
         "212": "Friedman Small Box",
         "213": "5153 50W Blue",
         "214": "Div/13 CJ Boost",
+        "215": "USA MK IIC+ Deep",
         "216": "USA MK IIC+ Deep Bright",
         "217": "5F8 Tweed Bright",
         "218": "Double Verb Silverface",
         "219": "Vibrato Verb Custom",
         "220": "JMPre-1 OD1",
+        "221": "JMPre-1 OD2",
         "222": "JMPre-1 OD1 Bass Shift",
         "223": "JMPre-1 OD2 Bass Shift",
         "224": "Deluxe Verb Normal",
@@ -16579,6 +16600,7 @@
         "230": "PVH 6160+ Crunch",
         "231": "PVH 6160+ Clean",
         "232": "Solo 88 Clean",
+        "233": "Class-A 30W Bright",
         "234": "Plexi 50W High 2",
         "235": "Spawn Nitrous 1",
         "236": "Ruby Rocket",
@@ -16610,15 +16632,18 @@
         "262": "Friedman HBE C45",
         "263": "Porta-Bass",
         "264": "SV Bass 1",
+        "265": "FAS Skull Crusher",
         "266": "USA JP IIC+ Red",
         "267": "USA JP IIC+ Yellow",
         "268": "USA JP IIC+ Green",
         "269": "Wrecker Express Bright",
         "270": "Wrecker Liverpool Bright",
+        "271": "Matchbox D-30 EF86",
         "272": "FAS Express",
         "273": "Triple Crest 2",
         "274": "Triple Crest 3",
         "275": "PVH 6160+ Crunch Bright",
+        "276": "PVH 6160+ Clean Bright",
         "277": "Plexi 50W 6CA7",
         "278": "Solo 99 Lead Bright",
         "279": "Archean",
@@ -16628,24 +16653,46 @@
         "283": "Deluxe Tweed",
         "284": "USA JP IIC+ Red Shred",
         "285": "USA JP IIC+ Yellow Shred",
+        "286": "Friedman BE C45",
+        "287": "Friedman BE 2010",
+        "288": "Friedman HBE 2010",
         "289": "FAS Buttery",
         "290": "59 Bassguy Normal",
         "291": "5F8 Tweed Normal",
         "292": "5F8 Tweed Jumped",
         "293": "JMPre-1 Clean1",
+        "294": "JMPre-1 Clean1 Bass Shift",
+        "295": "JMPre-1 Clean2",
+        "296": "JMPre-1 Clean2 Bass Shift",
+        "297": "Diamante Fire",
         "298": "PVH 6160 Block Crunch",
         "299": "Plexi Studio 20",
+        "300": "Plexi 50W 6CA7 Jumped",
+        "301": "Herbie MK3",
+        "302": "59 Bassguy RI Jumped",
         "303": "Revv Gen Purple 1",
         "304": "Revv Gen Purple 2",
+        "305": "Revv Gen Purple 3",
+        "306": "Revv Gen Red 1",
         "307": "Revv Gen Red 2",
+        "308": "Revv Gen Red 3",
+        "309": "Revv Gen Green 1",
+        "310": "Revv Gen Green 2",
+        "311": "Revv Gen Green 3",
+        "312": "JS410 Lead Green",
         "313": "5153 100W Stealth Blue",
         "314": "Brit 800 2203 High",
+        "315": "5153 100W Stealth Green",
         "316": "5153 100W Stealth Red",
         "317": "USA MK V Green",
+        "318": "Brit 800 2204 Low",
         "319": "Brit 800 2203 Low",
         "320": "USA MK V Red IIC+",
+        "321": "USA MK V Red IIC+ Bright",
         "322": "USA MK V Red MKIV",
+        "323": "USA MK V Red MKIV Bright",
         "324": "USA MK V Red XT",
+        "325": "USA MK V Red XT Bright",
         "326": "Class-A 30W Brilliant",
         "327": "FAS Stealth Blue",
         "328": "Brit 800 Studio 20",
@@ -16663,6 +16710,7 @@
         "7": "Fat Rat",
         "8": "T808 Mod",
         "9": "Octave Distortion",
+        "10": "Plus Distortion",
         "11": "Hard Fuzz",
         "12": "FET Boost",
         "13": "Tape Distortion",
@@ -16674,6 +16722,7 @@
         "19": "BB Pre",
         "20": "Master Fuzz",
         "21": "Face Fuzz",
+        "22": "Bit Crusher",
         "23": "Eternal Love",
         "24": "Esoteric ACB",
         "25": "Esoteric RCB",
@@ -16691,26 +16740,52 @@
         "37": "Suhr Riot LED (L)",
         "38": "Timothy Up",
         "39": "Tone of Kings",
+        "40": "Heartpedal 11",
         "41": "Jam Ray",
+        "42": "Suhr Riot LED/Si (M)",
+        "43": "OD 250",
         "44": "Timothy Down",
         "45": "TS9DX +",
         "46": "Box o' Crunch",
+        "47": "OD 250 Gray",
         "48": "Horizon Precision Drive",
+        "49": "Compulsion Distortion LP",
         "50": "Hoodoo Drive",
+        "51": "Compulsion Distortion HP",
+        "52": "TS9DX Hot",
+        "53": "DS1 Distortion",
         "54": "DS1 Distortion Mod",
+        "55": "MCMLXXXI Drive",
         "56": "Sonic Drive",
         "57": "Valve Screamer VS9",
         "58": "Maxoff 808",
         "59": "Klone Chiron",
+        "60": "Esoteric Bass RCB",
+        "61": "BB Pre AT",
+        "62": "Griddle Cake",
+        "63": "Bosom Boost",
+        "64": "OD-One Overdrive",
         "65": "Nobelium OVD-1",
+        "66": "Sunrise Splendor Hi-Cut",
+        "67": "Gauss Drive",
         "68": "Sunrise Splendor",
+        "69": "Integral Pre",
+        "70": "PI Fuzz - Triangle",
         "71": "PI Fuzz - Ram's Head",
         "72": "Colortone Booster",
         "73": "Colortone OD",
+        "74": "MOSFET Distortion",
         "75": "PI Fuzz - Russian",
         "76": "Super Fuzz",
         "77": "Tube Drive 5-Knob",
-        "79": "Angry Chuck"
+        "78": "77 Custom OD",
+        "79": "Angry Chuck",
+        "80": "Guardian Photon Speed",
+        "81": "Paradigm Shifter",
+        "82": "PI Fuzz - Bass",
+        "83": "NoAmp Bass DI",
+        "84": "NoAmp Bass Pre",
+        "85": "Royal Bass DI"
       },
       "REVERB_TYPE": {
         "0": "Small Room",
@@ -16744,34 +16819,54 @@
         "28": "Sun Plate",
         "29": "Huge Room",
         "30": "Drum Room",
+        "31": "Hallway",
         "32": "Tunnel",
+        "33": "Deep Chamber",
         "34": "Large Wooden Room",
+        "35": "Gymnasium",
         "36": "Asylum Hall",
         "37": "Deep Space",
         "38": "Recording Studio A",
+        "39": "Large Tiled Room",
         "40": "Vocal Plate",
         "41": "Wide Hall",
         "42": "Mechanic's Hall",
         "43": "Chorus Hall",
+        "44": "Ice Castle",
         "45": "Music Hall",
+        "46": "Symphony Hall",
         "47": "Cirrocumulus",
         "48": "Cumulonimbus",
         "49": "Nimbostratus",
         "50": "Stratocumulus",
         "51": "Deluxe Spring",
         "52": "Opera House",
+        "53": "Colosseum",
         "54": "Sagittarius",
+        "55": "Gemini",
+        "56": "Capricorn",
+        "57": "Aquarius",
         "58": "Andromeda",
+        "59": "Pegasus",
+        "60": "Centaurus",
         "61": "Ursa Major",
         "62": "Pleiades",
         "63": "Echo Plate",
+        "64": "Echo Hall",
         "65": "Echo Room",
         "66": "Tube Spring",
         "67": "Studio Spring",
         "68": "Vibrato-King Spring",
         "69": "British Spring",
+        "70": "Fields of Pyrite",
         "71": "Gold Plate",
-        "75": "Nashville Church"
+        "72": "Echo Pitch Plate",
+        "73": "Marble Hall",
+        "74": "Mausoleum",
+        "75": "Nashville Church",
+        "76": "Warehouse",
+        "77": "Lush Spring",
+        "78": "Vibrato-King Custom Spring"
       },
       "DELAY_TYPE": {
         "0": "Digital Mono",
@@ -16828,13 +16923,16 @@
         "6": "Analog Compressor",
         "7": "Dynami-Comp Classic",
         "8": "JFET Studio Compressor",
+        "9": "VCA FF Sustainer",
         "10": "VCA Bus Compressor",
+        "11": "VCA FB Sustainer",
         "12": "Compander",
         "13": "Classic VCA Compressor",
         "14": "Analog Sustainer",
         "15": "JFET Pedal Compressor",
         "16": "Rockguy Compressor",
-        "17": "Dynami-Comp Soft"
+        "17": "Dynami-Comp Soft",
+        "18": "Citrus Juicer"
       },
       "FLANGER_TYPE": {
         "0": "Digital Mono",
@@ -16889,8 +16987,10 @@
         "2": "Cry Babe",
         "3": "VX846",
         "4": "Color-Tone",
+        "5": "Funk Wah",
         "6": "Mortal",
-        "7": "VX845"
+        "7": "VX845",
+        "8": "Paragon"
       },
       "FILTER_TYPE": {
         "0": "Null",