fractal-midi 0.1.0-alpha.0

package/dist/axe-fx-ii/setParam.d.ts

@@ -0,0 +1,560 @@
+/**
+ * Axe-Fx II family GET/SET_BLOCK_PARAMETER_VALUE message builders.
+ *
+ * Reference: Fractal Audio Wiki "MIDI_SysEx" page (cached at
+ * `docs/_private/wiki-cache/axe-fx-ii-midi-sysex.html`), §"GET/SET_
+ * BLOCK_PARAMETER_VALUE" + §"obtaining parameter values".
+ *
+ * Wire envelope (function ID `0x02`):
+ *
+ *   F0 00 01 74 [model] 02
+ *     [effectId  bits 6-0] [effectId  bits 13-7]
+ *     [paramId   bits 6-0] [paramId   bits 13-7]
+ *     [value     bits 6-0] [value     bits 13-7] [value bits 14-15]
+ *     [00=query, 01=set]
+ *     [checksum] F7
+ *
+ * Value range: 0..65534 (16-bit). Packed across three 7-bit septets
+ * because SysEx bytes can't have bit 7 set. The high 2 bits of the
+ * 16-bit value land in the bottom 2 bits of the third septet (bits
+ * 6..2 of that byte are zero).
+ *
+ * Status: 🟢 hardware-verified on Quantum 8.02 (2026-05-10). HW-075
+ * landed both halves of function 0x02 SET: normal paramId (Amp 1 Bass
+ * 5.30 → 6.30, audibly warmer) and paramId=255 bypass (Reverb 1 tail
+ * dropped, front-panel LED disengaged). Wiki spec matches Q8.02
+ * firmware behavior — no drift detected. HW-077 covers the GET half
+ * (function 0x02 query). Byte-exact goldens in
+ * `scripts/verify-axe-fx-ii-encoding.ts` lock the encoder.
+ */
+/** Default model byte for the founder's hardware (Axe-Fx II XL+). */
+export declare const AXE_FX_II_XL_PLUS_MODEL_ID = 7;
+/** Wire model byte for each Axe-Fx II family variant. */
+export declare const MODEL_IDS: Readonly<{
+    'axe-fx-ii': 3;
+    'axe-fx-ii-xl': 6;
+    'axe-fx-ii-xl-plus': 7;
+    ax8: 8;
+}>;
+export interface AxeFxIIParamId {
+    /** 14-bit block instance ID (e.g. 106 = Amp 1, 107 = Amp 2). */
+    effectId: number;
+    /** 14-bit parameter index within the block (e.g. 1 = Input Drive). */
+    paramId: number;
+}
+/**
+ * Pack a 16-bit unsigned value into the wire's three 7-bit septets.
+ *
+ *   septet 0 = bits 6..0   (lowest seven bits)
+ *   septet 1 = bits 13..7  (next seven bits)
+ *   septet 2 = bits 15..14 (top two bits, zero-padded into a 7-bit byte)
+ *
+ * Per wiki, valid input range is 0..65534. We accept up to 65535 (the
+ * full 16-bit range) so callers can passes through without an extra
+ * clamp; firmware reportedly clamps 65535 → 65534 internally.
+ */
+export declare function packValue16(value: number): [number, number, number];
+/** Inverse of `packValue16`. Inputs may have unused upper bits — masked. */
+export declare function unpackValue16(b0: number, b1: number, b2: number): number;
+/**
+ * Convert a display value to its corresponding 16-bit wire value, given
+ * a param's calibrated `displayMin` / `displayMax` / `displayScale`.
+ *
+ * Two scale shapes supported:
+ *
+ * **`'linear'`** (default) — wire 0..65534 maps linearly onto
+ * displayMin..displayMax. Confirmed by HW-079 / HW-088 / HW-089 across
+ * 0..10 (AMP knobs), 0..100% (mix), -100..+100% (feedback / balance /
+ * pan), -80..+20 dB (cab level).
+ *
+ * **`'log10'`** — wire 0..65534 maps log-base-10 onto
+ * displayMin..displayMax. Used for frequency knobs (HW-090 confirmed
+ * cab.low_cut 20..2000 Hz and cab.high_cut 200..20000 Hz both fit
+ * `displayHz = displayMin × (displayMax/displayMin)^(wire/65534)`
+ * exactly at every measured anchor). Requires displayMin > 0.
+ *
+ * Callers should only invoke this on params with populated displayMin
+ * AND displayMax. For uncalibrated params, the tool layer falls back
+ * to the wire-value path.
+ *
+ * Clamps to [displayMin, displayMax] silently — the wire value pins to
+ * [0, 65534] either way, so an out-of-range display value rounds to
+ * the same endpoint. The tool layer surfaces a clamp note when needed.
+ */
+export type DisplayScale = 'linear' | 'log10';
+export interface DisplayToWireOptions {
+    readonly displayMin: number;
+    readonly displayMax: number;
+    readonly displayScale?: DisplayScale;
+}
+export declare function displayToWire(display: number, opts: DisplayToWireOptions): number;
+/**
+ * Inverse of `displayToWire`. Wire 0..65534 → display value via the
+ * param's linear or log10 scale.
+ */
+export declare function wireToDisplay(wire: number, opts: DisplayToWireOptions): number;
+export interface BuildOptions {
+    /** Target hardware variant. Defaults to XL+ (the founder's device). */
+    modelId?: number;
+}
+/**
+ * Build a SET_BLOCK_PARAMETER_VALUE message (function `0x02`, action 1).
+ *
+ * `value` is the wire-level 16-bit integer (0..65534). Display ↔ wire
+ * conversion is the caller's responsibility — see KNOWN_PARAMS in
+ * `./params.ts` for per-param display ranges where the wiki documents
+ * them, and the §LOUDNESS BUDGET / display-anchor doc for params
+ * without populated ranges.
+ */
+export declare function buildSetBlockParameterValue(param: AxeFxIIParamId, value: number, opts?: BuildOptions): number[];
+/**
+ * Build a GET_BLOCK_PARAMETER_VALUE request (function `0x02`, action 0).
+ *
+ * Per wiki: "When you are getting a parameter value you still have to
+ * include a parameter value with your message but this value can be 0."
+ * We send three zero septets for the value field.
+ */
+export declare function buildGetBlockParameterValue(param: AxeFxIIParamId, opts?: BuildOptions): number[];
+/**
+ * Build a block-bypass toggle. Per wiki:
+ *
+ *   "Bypassing/Engaging a Block is also done with this function with
+ *    parameter 255. Send the value 0 to Engage, 1 to Bypass."
+ */
+export declare function buildSetBlockBypass(effectId: number, bypassed: boolean, opts?: BuildOptions): number[];
+/**
+ * Predicate: does `bytes` look like the response to our GET_BLOCK_PARAMETER_VALUE
+ * request for `(effectId, paramId)`? The device echoes the same
+ * envelope+function+effectId+paramId, then includes the actual wire
+ * value, then 5 unknown bytes, then a null-terminated label string.
+ *
+ * Per wiki §"GET/SET_BLOCK_PARAMETER_VALUE", response payload is:
+ *   [eff7-0][eff13-7][param7-0][param13-7][val7-0][val13-7][val15-14]
+ *   [unk1][unk2][unk3][unk4][unk5][label-bytes...][0x00][checksum] F7
+ *
+ * Distinguishing GET response from a SET echo: the GET response always
+ * carries a label string (>= 1 character + null terminator), so total
+ * length is well above the SET request's 14 bytes. We use the length
+ * cutoff as the discriminator.
+ */
+export declare function isGetBlockParameterResponse(bytes: number[], target: AxeFxIIParamId, expectedModelId?: number): boolean;
+export interface GetBlockParameterResponse {
+    /** 16-bit unsigned wire value the device reports as currently held. */
+    value: number;
+    /** Display label the device shows for this value (e.g. "5.00", "Plexi 50W Hi"). */
+    label: string;
+}
+/**
+ * Parse a GET_BLOCK_PARAMETER_VALUE response. Caller must have already
+ * matched it via `isGetBlockParameterResponse` for the right target —
+ * this just decodes the value + label string from a known-shape buffer.
+ */
+export declare function parseGetBlockParameterResponse(bytes: number[]): GetBlockParameterResponse;
+/**
+ * Build a GET_PRESET_NAME request (function 0x0F). Empty body —
+ * envelope + function + checksum + F7.
+ */
+export declare function buildGetPresetName(opts?: BuildOptions): number[];
+export declare function isGetPresetNameResponse(bytes: number[], expectedModelId?: number): boolean;
+/**
+ * Parse a GET_PRESET_NAME response. Body is null-terminated ASCII
+ * starting at byte 6.
+ */
+export declare function parseGetPresetNameResponse(bytes: number[]): string;
+/**
+ * Build a GET_GRID_LAYOUT_AND_ROUTING request (function 0x20). Empty
+ * body. Response carries 48× 4-byte grid cells (4 rows × 12 columns).
+ */
+export declare function buildGetGridLayout(opts?: BuildOptions): number[];
+export declare function isGetGridLayoutResponse(bytes: number[], expectedModelId?: number): boolean;
+/**
+ * One cell in the 4×12 routing grid. `blockId` is the 14-bit ID per
+ * `blockTypes.ts` — block IDs 100..170, shunt IDs 200..235, or 0 for
+ * an empty cell. `routingFlags` is a 4-bit mask: bit N set means
+ * "connect row (N+1) of the previous column to this cell's input".
+ */
+export interface GridCell {
+    /** Column 1..12. */
+    col: number;
+    /** Row 1..4. */
+    row: number;
+    /** 14-bit block ID (100-170 = block, 200-235 = shunt, 0 = empty). */
+    blockId: number;
+    /** Routing-input mask. Bit N (0..3) set ⇒ row N+1 of previous column connects to this input. */
+    routingFlags: number;
+}
+/**
+ * Parse a GET_GRID_LAYOUT_AND_ROUTING response into 48 grid cells.
+ *
+ * Per wiki §"GET_GRID_LAYOUT_AND_ROUTING": cell order is column-major,
+ * top-to-bottom within each column. Cell 0 = (col=1, row=1); cell 1 =
+ * (col=1, row=2); ...; cell 4 = (col=2, row=1); etc.
+ *
+ * Per cell (4 bytes):
+ *   bytes[0]: blockId bits 6-0
+ *   bytes[1]: blockId bits 13-7
+ *   bytes[2]: routing flags
+ *   bytes[3]: unused (per wiki)
+ */
+export declare function parseGetGridLayoutResponse(bytes: number[]): GridCell[];
+/**
+ * Build a SET_SCENE_NUMBER message (function 0x29). Pass scene 0..7
+ * to switch; pass undefined to query the current scene (sentinel 0x7F
+ * per wiki — response carries the actual scene number).
+ */
+export declare function buildSetSceneNumber(scene: number, opts?: BuildOptions): number[];
+export declare function buildGetSceneNumber(opts?: BuildOptions): number[];
+export declare function isSceneNumberResponse(bytes: number[], expectedModelId?: number): boolean;
+export declare function parseSceneNumberResponse(bytes: number[]): number;
+/**
+ * Block channel select (function 0x11) — Axe-Fx II has TWO channels
+ * per block (X and Y), distinct from AM4's four-channel A/B/C/D model.
+ *
+ * Wiki documents the envelope:
+ *
+ *   Request (host → device):
+ *     F0 00 01 74 [model] 11 [eff_lo] [eff_hi] [chan] [action] [cs] F7
+ *       chan   = 0 (X) or 1 (Y)
+ *       action = 0 (get current value) or 1 (set)
+ *
+ *   Response/broadcast (device → host):
+ *     F0 00 01 74 [model] 11 [eff_lo] [eff_hi] [chan] [cs] F7
+ *
+ * The device emits the response form whenever the active channel for a
+ * block changes (e.g. user clicks X/Y in AxeEdit or front-panel) —
+ * cross-confirmed via passive capture in
+ * `samples/captured/session-60-channel-toggle.syx` (HW-097, 2026-05-11):
+ * Amp 1 toggle X→Y produced `F0 00 01 74 07 11 6A 00 01 78 F7`;
+ * Y→X produced `F0 00 01 74 07 11 6A 00 00 79 F7`. Checksums verified.
+ *
+ * Status: 🟢 hardware-verified on Q8.02 (2026-05-11, HW-098). Amp 1
+ * X→Y SET round-tripped cleanly: pre-read = X, set wrote Y (12 bytes
+ * out), post-read = Y, front panel + AxeEdit both confirmed Y. The
+ * 0=X / 1=Y mapping holds; wire envelope is byte-exact with wiki spec
+ * and the broadcast capture from HW-097.
+ */
+export type AxeFxIIChannel = 'X' | 'Y';
+export declare function channelToWire(c: AxeFxIIChannel | 0 | 1): number;
+export declare function wireToChannel(b: number): AxeFxIIChannel;
+export declare function buildSetBlockChannel(effectId: number, channel: AxeFxIIChannel | 0 | 1, opts?: BuildOptions): number[];
+export declare function buildGetBlockChannel(effectId: number, opts?: BuildOptions): number[];
+export declare function isGetBlockChannelResponse(bytes: number[], expectedEffectId: number, expectedModelId?: number): boolean;
+export declare function parseGetBlockChannelResponse(bytes: number[]): AxeFxIIChannel;
+/**
+ * Switch preset (function 0x3C) — load preset N into the working buffer.
+ * Wiki documents the envelope as `F0 00 01 74 [model] 3C [pn_lo]
+ * [pn_hi] [cs] F7` where `pn_lo`/`pn_hi` is a 14-bit septet pair
+ * encoding the preset number.
+ *
+ * Axe-Fx II preset numbering: 0-based linear index 0..N across the
+ * bank (each bank holds 128 presets typically; XL+ has bigger
+ * capacity). 0x14 GET_PRESET_NUMBER returns the same number space.
+ *
+ * Status: 🟢 hardware-verified on Q8.02 (2026-05-11, HW-100).
+ * `preset_number: 0` loaded "59 Bassguy" into the working buffer
+ * cleanly; front panel showed slot "1" (the MIDI 0-based index maps
+ * to the device's 1-based front-panel display — preset N appears as
+ * slot N+1 on the front panel).
+ */
+export declare function buildSwitchPreset(presetNumber: number, opts?: BuildOptions): number[];
+/**
+ * Set working-buffer preset name (function 0x09). Wiki documents the
+ * envelope as the function byte followed by ASCII characters. Preset
+ * names on Axe-Fx II are 32 chars, space-padded.
+ *
+ * Status: 🟢 hardware-verified on Q8.02 (2026-05-11, HW-100).
+ * `"HW-100 Test"` written to the working buffer; immediate
+ * `axefx2_get_preset_name` echoed it back; front panel showed the
+ * new name. Working-buffer scope confirmed — switching presets
+ * discards it (no persistent change to factory slot).
+ */
+export declare function buildSetPresetName(name: string, opts?: BuildOptions): number[];
+/**
+ * STORE the working buffer to a user preset slot (function 0x1D).
+ *
+ * Wire envelope:
+ *
+ *   F0 00 01 74 [model] 1D [preset_high] [preset_low] [cs] F7
+ *     preset_high = (n >> 7) & 0x7F
+ *     preset_low  = n & 0x7F
+ *
+ * Note: this function uses **MSB-first** byte ordering for the 14-bit
+ * preset number, unlike `buildSwitchPreset` / `buildEnvelope(..., [0x02,
+ * ...effectId, ...paramId, ...])` which use LSB-first via `encode14()`.
+ * The MSB-first ordering for 0x1D is taken from bspaulding/axe-fx-midi
+ * (Rust) and matches the byte order the device uses for its own
+ * 0x14 GET_PRESET_NUMBER response (captured session-61 payload `05 3B`
+ * for preset 699 = display preset 700).
+ *
+ * Status: 🟢 hardware-verified on Q8.02 XL+ (HW-102, 2026-05-11).
+ * End-to-end round-trip from our encoder landed on the first attempt:
+ * `axefx2_save_preset({ preset_number: 699, name: "..." })` produced
+ * the captured save sequence, device returned `0x64 1D 00` (OK),
+ * working buffer persisted to slot 700 confirmed by founder front-
+ * panel inspection. Wire format derived from bspaulding/axe-fx-midi
+ * + session-61 passive capture (AxeEdit File → Save Preset); our
+ * encoder matches AxeEdit's behavior byte-for-byte.
+ *
+ * Cross-checks before shipping:
+ * - bspaulding's test case (Mark II, preset 217):
+ *   `[F0 00 01 74 03 1D 01 59 43 F7]` — locked as a golden in
+ *   `scripts/verify-axe-fx-ii-encoding.ts`.
+ * - XL+ encoding for preset 699:
+ *   `[F0 00 01 74 07 1D 05 3B 21 F7]` — also locked, paired with the
+ *   captured device-side 0x64 ACK pattern.
+ *
+ * 0-vs-1 indexing: same as `buildSwitchPreset` — wire is 0-based, the
+ * device's front panel displays 1-based. To save to what the user sees
+ * as "preset 700," pass `presetNumber: 699`. The tool layer surfaces
+ * this in `axefx2_save_preset`'s description so the agent translates.
+ */
+export declare function buildStorePreset(presetNumber: number, opts?: BuildOptions): number[];
+/**
+ * Match a MULTIPURPOSE_RESPONSE (function 0x64) acknowledging a
+ * STORE_PRESET (function 0x1D) request. The device's response format
+ * is `[echoed_fn, result_code]`:
+ *
+ *   F0 00 01 74 [model] 64 1D [result_code] [cs] F7
+ *     result_code 0x00 = OK
+ *     result_code 0x05 = parsed but not honored (e.g. malformed payload)
+ *
+ * Captured session-61, 2026-05-11 from AxeEdit's save-to-slot operation
+ * on Q8.02 XL+: `F0 00 01 74 07 64 1D 00 7B F7` (result=OK).
+ */
+export declare function isStorePresetResponse(bytes: readonly number[]): boolean;
+export interface StorePresetResult {
+    /** Raw device result code (0x00 = OK). */
+    resultCode: number;
+    /** True iff resultCode === 0x00. */
+    ok: boolean;
+}
+export declare function parseStorePresetResponse(bytes: readonly number[]): StorePresetResult;
+/**
+ * GET the device's currently-active preset number (function 0x14).
+ *
+ * Wire envelope (request):  F0 00 01 74 [model] 14 [cs] F7   (no payload)
+ * Wire envelope (response): F0 00 01 74 [model] 14 [hi] [lo] [cs] F7
+ *
+ * **Byte ordering is MSB-first** in the response — `[bits 13-7, bits 6-0]`
+ * — contrary to the wiki's "bits 6-0 first" documentation. Empirically
+ * disambiguated by session-61 passive capture: payload `05 3B` decodes
+ * to wire preset 699 (= front-panel display "slot 700") only under
+ * MSB-first, matching the founder's reported state at capture time.
+ * LSB-first decode would yield preset 7557, which is impossible (XL+
+ * user range is 0..767). See `docs/SYSEX-MAP-AXE-FX-II.md` § 6b.
+ *
+ * Status: 🟡 wire format from session-61 passive capture; will flip to
+ * 🟢 once axefx2_get_active_preset_number lands end-to-end on Q8.02.
+ */
+export declare function buildGetPresetNumber(opts?: BuildOptions): number[];
+export declare function isGetPresetNumberResponse(bytes: readonly number[]): boolean;
+export interface GetPresetNumberResult {
+    /** 0-based wire preset number (0..16383). */
+    presetNumber: number;
+    /** 1-based front-panel display slot (presetNumber + 1). */
+    displaySlot: number;
+}
+export declare function parseGetPresetNumberResponse(bytes: readonly number[]): GetPresetNumberResult;
+/**
+ * Set the block at a grid cell (function 0x05). Places a block at the
+ * specified cell, or clears the cell (blockId = 0). If the block was
+ * already on the grid elsewhere, the device MOVES it (clears its
+ * previous cell as a side effect).
+ *
+ * Wire envelope:
+ *
+ *   F0 00 01 74 [model] 05
+ *     [blockId_lo] [blockId_hi]
+ *     [cell_idx]
+ *     [reserved=0]
+ *     [cs] F7
+ *
+ *   cell_idx = (col_idx × 4) + row_idx
+ *              col_idx ∈ 0..11 (column 1..12 minus 1)
+ *              row_idx ∈ 0..3  (row 1..4 minus 1)
+ *              col-major, top-to-bottom — same ordering as the 0x20
+ *              GET_GRID_LAYOUT_AND_ROUTING response.
+ *
+ *   blockId  = 14-bit, LSB-first septet pair.
+ *              0 = empty cell (clears whatever was there)
+ *              100..170 = named blocks (see blockTypes.ts)
+ *              200..235 = shunts (pass-through cells)
+ *
+ *   reserved = the device accepts 0x00; non-zero behavior is unknown.
+ *              May be a routing-flag mask in some firmwares; on Q8.02 XL+
+ *              we observed no effect on routing when set. The device
+ *              auto-assigns a routing mask to newly-placed cells (e.g.
+ *              :2 for row-2 placements) regardless of this byte.
+ *
+ * Decoding evidence (session-62 + session-63 probes, 2026-05-11):
+ *
+ *   Probe (payload bytes after 0x05)         Observed effect
+ *   ─────────────────────────────────────────────────────────
+ *   64 00 00 00  → CPR1 at cell 0 (R1C1)     ✓ matches
+ *   00 00 02 00  → empty at cell 2 (R3C1)    ✓ matches (was already empty)
+ *   00 00 01 02  → empty at cell 1 (R2C1)    ✓ matches (CPR1 cleared)
+ *   64 00 01 00  → CPR1 at cell 1 (R2C1)     ✓ matches (CPR1 returned)
+ *
+ *   Cell index 1 disambiguates col-major vs row-major: under col-major
+ *   it points to (col 0, row 1) = R2C1, which IS where the change
+ *   landed. Under row-major it would point to (row 0, col 1) = R1C2,
+ *   which is empty and would show no change. Col-major confirmed.
+ *
+ *   Probes with bare (no payload) and 1-byte payload were rejected by
+ *   the device with non-OK result codes (0x06 / 0x0C) — the 4-byte
+ *   payload is the minimum the device accepts.
+ *
+ * KNOWN LIMITATION: this write does NOT propagate routing/cabling.
+ * Moving a block out of a cell leaves the downstream block's input
+ * mask pointing at empty space (audio dead-end). The agent / user is
+ * responsible for re-wiring via a separate mechanism (TBD — likely
+ * either byte[3] of this function with the right value, or a sibling
+ * function byte like 0x06 which also fires during grid-move captures).
+ *
+ * Status: 🟢 wire format hardware-validated on Q8.02 XL+
+ * (session-63 probe sequence). Routing-propagation limitation
+ * documented above.
+ */
+export declare function buildSetGridCell(opts: {
+    row: number;
+    col: number;
+    blockId: number;
+    modelId?: number;
+}): number[];
+/**
+ * Match a MULTIPURPOSE_RESPONSE (function 0x64) acknowledging a
+ * SET_GRID_CELL (function 0x05) request.
+ *
+ *   F0 00 01 74 [model] 64 05 [result_code] [cs] F7
+ *
+ * Result codes observed on Q8.02 XL+ during decode:
+ *   0x00 — OK, write applied
+ *   0x06 — payload too short (e.g. bare envelope)
+ *   0x0C — payload too short (e.g. 1-byte payload)
+ *
+ * Other values are unknown; treat any non-0x00 as a rejection.
+ */
+export declare function isSetGridCellResponse(bytes: readonly number[]): boolean;
+export interface SetGridCellResult {
+    resultCode: number;
+    ok: boolean;
+}
+export declare function parseSetGridCellResponse(bytes: readonly number[]): SetGridCellResult;
+/**
+ * Build a SET_CELL_ROUTING message (function 0x06) — add or remove a
+ * cable between two adjacent-column grid cells. Companion to
+ * `buildSetGridCell` (function 0x05): 0x05 places the block, 0x06 wires
+ * its inputs.
+ *
+ * Wire envelope:
+ *
+ *   F0 00 01 74 [model] 06
+ *     [src_cell_idx]    ← col-major linear index (col-1)*4 + (row-1)
+ *     [dst_cell_idx]    ← col-major linear index; MUST be src_col + 1
+ *     [connect]         ← 0x01 = add cable, 0x00 = remove cable
+ *     [cs] F7
+ *
+ * Effect: the device updates `dst_cell.routing_mask` by setting
+ * (connect=1) or clearing (connect=0) the bit at index `src_row_0indexed`.
+ * The mask byte uses 4-bit input-mask encoding — bit N set means "feed
+ * from row N+1 of previous column" (see `parseGetGridLayoutResponse`).
+ * So a cable from row 2 → row 2 with src_col=2, dst_col=3 toggles
+ * `dst_cell.routing_mask`'s bit 1 (= 0x02) on or off.
+ *
+ * Status: 🟢 hardware-decoded on Q8.02 XL+ (Session 70, 2026-05-13).
+ * Captured AxeEdit's outbound fn 0x06 from a click-to-connect on
+ * Amp(R2C2) → Cab(R2C3):
+ *
+ *   F0 00 01 74 07 06 05 09 01 09 F7
+ *     src_cell = 5  = (2-1)*4 + (2-1) = R2C2
+ *     dst_cell = 9  = (3-1)*4 + (2-1) = R2C3
+ *     connect  = 1  = add cable
+ *
+ * Replayed by our own probe with byte-exact match — device acked
+ * 0x00 OK and the grid-state read confirmed Cab's routing mask
+ * flipped 0x00 → 0x02 ("Cab now feeds from row 2 of col 2 = from Amp").
+ *
+ * Validates adjacency (`dstCol === srcCol + 1`); the device rejects
+ * non-adjacent cables. Cross-row cables (e.g. row 1 of col 5 → row 3
+ * of col 6) ARE allowed — that's how parallel paths are wired.
+ */
+export declare function buildSetCellRouting(opts: {
+    srcRow: number;
+    srcCol: number;
+    dstRow: number;
+    dstCol: number;
+    connect?: boolean;
+    modelId?: number;
+}): number[];
+/**
+ * Match a MULTIPURPOSE_RESPONSE (function 0x64) acknowledging a
+ * SET_CELL_ROUTING (function 0x06) request.
+ *
+ *   F0 00 01 74 [model] 64 06 [result_code] [cs] F7
+ *
+ * Result codes observed on Q8.02 XL+ during decode:
+ *   0x00 — OK, routing updated
+ *   0x01 — request rejected (e.g. non-adjacent columns, malformed shape)
+ *   0x0C — payload length too short
+ */
+export declare function isSetCellRoutingResponse(bytes: readonly number[]): boolean;
+export interface SetCellRoutingResult {
+    resultCode: number;
+    ok: boolean;
+}
+export declare function parseSetCellRoutingResponse(bytes: readonly number[]): SetCellRoutingResult;
+/**
+ * Axe-Fx II preset-state-dump triple builder (functions 0x74/0x75/0x76).
+ *
+ * Wire format decoded Session 60, 2026-05-11 from passive captures
+ * (`docs/axefx2-state-broadcast-decode-research.md`). The device
+ * broadcasts this triple every time AxeEdit makes a block-level
+ * edit — header announces target block + total item count, then 1+
+ * chunks of 16-bit values (3 septets each), then a one-byte footer.
+ *
+ * Layout per message:
+ *
+ *   HEADER (function 0x74, 13 bytes)
+ *     F0 00 01 74 [model] 74
+ *       [target_id 14b septet] [item_count 14b septet] [op_flag]
+ *       [cs] F7
+ *
+ *   CHUNK  (function 0x75, variable, 8 + 3·N bytes)
+ *     F0 00 01 74 [model] 75
+ *       [chunk_item_count 14b septet]
+ *       [N × packValue16]
+ *       [cs] F7
+ *
+ *   FOOTER (function 0x76, 8 bytes — checksum-only terminator)
+ *     F0 00 01 74 [model] 76 [cs] F7
+ *
+ * `target_id` matches `BLOCK_BY_ID` (e.g. 106 = Amp 1, 112 = Delay 1,
+ * 127 = Volume/Pan 1). `op_flag` observed values: 0x01 for direct-
+ * block edits (knob turn, grid move), 0x00 for preset-structure
+ * changes (block add). Value positions correspond to `paramId 0..N`
+ * of the target block's group in linear order (position-as-paramId
+ * model confirmed Session 60 across AMP 1 + Delay 1 captures).
+ *
+ * Returns a flat byte array — caller can transmit it as a single
+ * MIDI stream (the device receives the 3 messages in order). Use
+ * `buildStateBroadcastTripleMessages` if you need them as separate
+ * arrays.
+ *
+ * Status: 🟡 spec-derived from passive captures + decoded round-trip
+ * golden against the captured Volume/Pan 1 triple in
+ * `scripts/verify-axe-fx-ii-encoding.ts`. Has NOT been transmitted
+ * to hardware yet — Step 2 in STATE.md (synthesize an outgoing
+ * triple and observe AxeEdit's UI for state-change confirmation)
+ * is the unfinished hardware step.
+ */
+export interface BuildStateBroadcastOptions extends BuildOptions {
+    /** Op flag byte 10. 0x01 = direct block edit, 0x00 = preset-structure. Default 0x01. */
+    opFlag?: number;
+}
+export declare function buildStateBroadcastTripleMessages(targetId: number, values: readonly number[], opts?: BuildStateBroadcastOptions): {
+    header: number[];
+    chunks: number[][];
+    footer: number[];
+};
+export declare function buildStateBroadcastTriple(targetId: number, values: readonly number[], opts?: BuildStateBroadcastOptions): number[];
+//# sourceMappingURL=setParam.d.ts.map

package/dist/axe-fx-ii/setParam.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setParam.d.ts","sourceRoot":"","sources":["../../src/axe-fx-ii/setParam.ts"],"names":[],"mappings":"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"}