@map-audio/pam-mcp-server 1.7.0 → 1.18.1

package/dist/mixAssist.d.ts

@@ -0,0 +1,155 @@
+export interface CellStemAnalysis {
+    cellId: number;
+    lufsI?: number;
+    lufsS?: number;
+    lufsRoll?: number;
+    lra?: number;
+    truePeakDb?: number;
+    samplePeakDb?: number;
+    psr?: number;
+    plr?: number;
+    corr?: number;
+    corrLow?: number;
+    onsets: number;
+    onsetDensity: number;
+    seconds: number;
+    barkDb: number[];
+}
+export interface MixAnalysis {
+    epoch: number;
+    live?: boolean;
+    sampleRate: number;
+    durationSeconds: number;
+    bpm: number;
+    cells: CellStemAnalysis[];
+    master: Omit<CellStemAnalysis, 'cellId'>;
+}
+export interface CellContext {
+    cellId: number;
+    hasSource: boolean;
+    muted: boolean;
+    soloed: boolean;
+    volume: number;
+    pan: number;
+    eqLowGain: number;
+    eqMidGain: number;
+    eqHighGain: number;
+    eqEnabled: boolean;
+    compressorEnabled: boolean;
+    compressorThreshold: number;
+    compressorRatioAmount: number;
+    compressorAttack: number;
+    compressorRelease: number;
+    volumeModulated: boolean;
+    panModulated: boolean;
+    eqModulated: boolean;
+    compModulated: boolean;
+}
+export interface MixCell {
+    analysis: CellStemAnalysis;
+    context: CellContext;
+}
+export interface MixMeasurement {
+    cells: MixCell[];
+    masterLufsI?: number;
+    masterCorrLow?: number;
+    epoch: number;
+}
+export type MixScope = 'balance' | 'pan' | 'eq' | 'dynamics';
+export interface MixAssistOptions {
+    scopes: MixScope[];
+}
+export interface MixMove {
+    key: string;
+    value: number;
+    why: string;
+    cellId: number;
+}
+export interface MixSuggestion {
+    moves: MixMove[];
+    guardsHit: string[];
+    flat: Record<string, number>;
+    summary?: string;
+}
+export type CurrentFlatState = Record<string, number | undefined>;
+export declare const MAX_FADER_MOVE_DB = 12;
+export declare const FADER_EPSILON_DB = 0.3;
+export declare const FADER_COMPENSATION_EPSILON_DB = 0.05;
+export declare const MIN_STEM_LUFS = -50;
+export declare const MASK_PENALTY_DB_PER_UNIT = 3;
+export declare const ROLE_OFFSETS_DB: {
+    readonly kick: 2;
+    readonly drums: 0;
+    readonly bass: 0;
+    readonly melodic: -2;
+    readonly ambient: -5;
+};
+export type CellRole = keyof typeof ROLE_OFFSETS_DB;
+export declare const FADER_FLOOR_DB = -59;
+export declare const FADER_CEIL_DB = 12;
+export declare const BASS_LOW_FRACTION = 0.5;
+export declare const LOW_TRANSIENT_ONSET_DENSITY = 0.5;
+export declare const DRUMS_CREST_MIN_DB = 10;
+export declare const DRUMS_ONSET_DENSITY = 3;
+export declare const AMBIENT_ONSET_DENSITY = 0.3;
+export declare const AMBIENT_MAX_PLR = 8;
+export declare const PAN_EPSILON = 0.05;
+export declare const MAX_PAN_SPREAD = 0.35;
+export declare const PAN_CENTER_GUARD = 0.15;
+export declare const BASS_RECENTER_CORR_LOW = 0.7;
+export declare const MASKING_PAIR_THRESHOLD = 0.5;
+export declare const MAX_EQ_CUT_DB = 3;
+export declare const MAX_EQ_LOW_CUT_DB = 1.5;
+export declare const MAX_EQ_CUTS = 2;
+export declare const EQ_EPSILON_DB = 0.3;
+export declare const CREST_ENGAGE_DB = 14;
+export declare const COMP_RATIO_MIN = 1.5;
+export declare const COMP_RATIO_MAX = 4;
+export declare const COMP_EPSILON = 0.05;
+export declare const PERCUSSIVITY_FULL_ONSET_DENSITY = 8;
+export declare const MIX_PARAM_DEFAULTS: Record<string, number>;
+export declare function mixParamDefault(key: string): number;
+export declare const BARK_BAND_COUNT = 25;
+export declare const BARK_BAND_EDGES_HZ: readonly number[];
+export declare function bandForFrequency(hz: number): number;
+export declare function barkBandCenterHz(band: number): number;
+export declare const dbToPower: (db: number) => number;
+export declare function barkCentroidHz(barkDb: readonly number[]): number;
+export declare function lowFraction(barkDb: readonly number[], belowHz?: number): number;
+export declare function maskingOverlap(aDb: readonly number[], bDb: readonly number[]): number;
+export declare function maskingMatrix(barkDbByCell: readonly (readonly number[])[]): number[][];
+export type OverlapRegion = 'low' | 'mid' | 'high';
+export declare function dominantOverlapRegion(aDb: readonly number[], bDb: readonly number[]): OverlapRegion;
+export declare function parseMixAnalysisPayload(raw: unknown): MixAnalysis | null;
+export interface ModulationLists {
+    lfos?: Array<{
+        paramId?: string;
+        enabled?: number | boolean;
+    }>;
+    envelopes?: Array<{
+        paramId?: string;
+    }>;
+    vary?: Array<{
+        paramId?: string;
+    }>;
+    paramSeqs?: Array<{
+        paramId?: string;
+    }>;
+    macros?: Array<{
+        paramId?: string;
+        enabled?: number | boolean;
+        [key: string]: unknown;
+    }>;
+}
+export interface MixContextOptions {
+    hasSource?: (cellId: number) => boolean;
+}
+export declare function paramIsModulated(lists: ModulationLists, paramId: string): boolean;
+export declare const MIX_CURRENT_SUFFIXES: readonly ["volume", "pan", "eqLowGain", "eqMidGain", "eqHighGain", "compressorThreshold", "compressorRatioAmount", "compressorAttack", "compressorRelease", "compressorRatio"];
+export declare function buildMixMeasurementFromState(analysis: MixAnalysis, flatState: Record<string, unknown>, mods?: ModulationLists, options?: MixContextOptions): MixMeasurement;
+export declare function currentFlatFromState(analysis: MixAnalysis, flatState: Record<string, unknown>): CurrentFlatState;
+export declare function isLowDominant(a: CellStemAnalysis): boolean;
+export declare function classifyCellRole(a: CellStemAnalysis): CellRole;
+export declare function normalizeMovesToBus(deltasDb: number[], lufs: number[]): number[];
+export declare function normalizeMovesToBusBounded(rawDeltasDb: number[], lufs: number[], currentVolumes: number[]): number[];
+export declare function suggestMix(m: MixMeasurement, options: MixAssistOptions, current?: CurrentFlatState): MixSuggestion;