fractal-midi 0.1.0-alpha.0

package/dist/am4/variantResolverTables.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Per-variant resolver tables extracted from AM4-Edit.exe via
+ * scripts/extract-variant-resolver.ts. The XML loader's vtable-call
+ * resolver (FUN_1402e3da0) dispatches to one of these tables per
+ * effectType to translate parameterName -> cache_id.
+ *
+ * For our agent: this is the missing link that lets us bind any XML
+ * parameterName to its wire address (cache_id) given a known block.
+ *
+ * AUTO-GENERATED. Do not hand-edit.
+ */
+export interface ResolverEntry {
+    readonly cache_id: number;
+    readonly parameterName: string;
+}
+export declare const VARIANT_RESOLVER_FIRMWARE = "AM4-Edit Mar 20 2026 build";
+/** Per-effectType resolver tables. Multiple effectTypes may share a table. */
+export declare const VARIANT_RESOLVER_BY_EFFECT_TYPE: Readonly<Record<number, readonly ResolverEntry[]>>;
+/** Fallback table consulted when an effectType lookup fails. */
+export declare const VARIANT_RESOLVER_FALLBACK: readonly ResolverEntry[];
+/**
+ * Per-block consolidated parameterName -> cache_id bindings.
+ *
+ * Built by walking every variant's table and grouping entries by the
+ * parameterName prefix (DISTORT_ -> amp, FUZZ_ -> drive, etc.). For
+ * any (block, parameterName), this gives the canonical cache_id without
+ * needing to know the variant id.
+ *
+ * If multiple variants disagree on the cache_id for the same parameterName,
+ * all candidate cache_ids are listed (the variant resolver picks one at
+ * runtime; without variant context we surface the ambiguity).
+ */
+export declare const PARAMETER_NAME_TO_CACHE_ID: Readonly<Record<string, Readonly<Record<string, readonly number[]>>>>;
+/**
+ * Universal BLOCK_* parameterNames (BLOCK_PAN, BLOCK_MIX, BLOCK_LEVEL,
+ * BLOCK_BYPASS, BLOCK_BYPASSMODE, etc.) — apply to every block.
+ * Each block exposes these at the same cache_id.
+ */
+export declare const UNIVERSAL_BLOCK_PARAMETERS: Readonly<Record<string, number>>;
+/**
+ * Resolve a (block, parameterName) pair to a cache_id, preferring the
+ * unambiguous case. Returns:
+ *   - undefined if not found
+ *   - the single cache_id if exactly one variant binds it
+ *   - the first cache_id if multiple variants disagree (caller may want
+ *     to call resolveAllCacheIds for the full ambiguity set).
+ */
+export declare function resolveCacheId(block: string, parameterName: string): number | undefined;
+/** Same as resolveCacheId but returns every variant's cache_id (may be > 1). */
+export declare function resolveAllCacheIds(block: string, parameterName: string): readonly number[];
+//# sourceMappingURL=variantResolverTables.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"variantResolverTables.d.ts","sourceRoot":"","sources":["../../src/am4/variantResolverTables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAClC;AAED,eAAO,MAAM,yBAAyB,+BAA+B,CAAC;AAEtE,8EAA8E;AAC9E,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC,CA64D9F,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,EAAE,SAAS,aAAa,EAW7D,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC,CA0mC5G,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CACvE,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMvF;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAK1F"}