@tx5dr/contracts 1.7.12 → 2.5.0

package/dist/schema/spectrum.schema.d.ts

@@ -7,6 +7,8 @@ export declare const SpectrumSessionSourceModeSchema: z.ZodEnum<["baseband", "ce
 export type SpectrumSessionSourceMode = z.infer<typeof SpectrumSessionSourceModeSchema>;
 export declare const SpectrumSessionFrequencyRangeModeSchema: z.ZodEnum<["baseband", "absolute-center", "absolute-fixed", "absolute-windowed"]>;
 export type SpectrumSessionFrequencyRangeMode = z.infer<typeof SpectrumSessionFrequencyRangeModeSchema>;
+export declare const SpectrumSessionViewModeSchema: z.ZodEnum<["wide", "radio-center"]>;
+export type SpectrumSessionViewMode = z.infer<typeof SpectrumSessionViewModeSchema>;
 export declare const SpectrumFrequencyRangeSchema: z.ZodObject<{
     min: z.ZodNumber;
     max: z.ZodNumber;
@@ -17,6 +19,63 @@ export declare const SpectrumFrequencyRangeSchema: z.ZodObject<{
     min: number;
     max: number;
 }>;
+export declare const SpectrumViewportSchema: z.ZodEffects<z.ZodObject<{
+    min: z.ZodNumber;
+    max: z.ZodNumber;
+    displayBinCount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    min: number;
+    max: number;
+    displayBinCount: number;
+}, {
+    min: number;
+    max: number;
+    displayBinCount: number;
+}>, {
+    min: number;
+    max: number;
+    displayBinCount: number;
+}, {
+    min: number;
+    max: number;
+    displayBinCount: number;
+}>;
+export type SpectrumViewport = z.infer<typeof SpectrumViewportSchema>;
+export declare const SpectrumSessionViewportInteractionSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    canZoom: z.ZodBoolean;
+    canPan: z.ZodBoolean;
+    canTuneAtEdge: z.ZodBoolean;
+    bounds: z.ZodNullable<z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        min: number;
+        max: number;
+    }, {
+        min: number;
+        max: number;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    canZoom: boolean;
+    canPan: boolean;
+    canTuneAtEdge: boolean;
+    bounds: {
+        min: number;
+        max: number;
+    } | null;
+}, {
+    enabled: boolean;
+    canZoom: boolean;
+    canPan: boolean;
+    canTuneAtEdge: boolean;
+    bounds: {
+        min: number;
+        max: number;
+    } | null;
+}>;
+export type SpectrumSessionViewportInteraction = z.infer<typeof SpectrumSessionViewportInteractionSchema>;
 export declare const SpectrumBinaryFormatSchema: z.ZodObject<{
     type: z.ZodLiteral<"int16">;
     length: z.ZodNumber;
@@ -68,27 +127,317 @@ export declare const SpectrumBinaryDataSchema: z.ZodObject<{
         offset?: number | undefined;
     };
 }>;
+export declare const SpectrumLevelDomainSchema: z.ZodEnum<["dbfs", "calibrated-db", "raw"]>;
+export type SpectrumLevelDomain = z.infer<typeof SpectrumLevelDomainSchema>;
+export declare const SpectrumLevelUnitSchema: z.ZodEnum<["dBFS", "dB", "Level"]>;
+export type SpectrumLevelUnit = z.infer<typeof SpectrumLevelUnitSchema>;
+export declare const SpectrumLevelReferenceSchema: z.ZodEnum<["full-scale", "device", "none"]>;
+export type SpectrumLevelReference = z.infer<typeof SpectrumLevelReferenceSchema>;
+export declare const SpectrumLevelDescriptorSchema: z.ZodEffects<z.ZodObject<{
+    domain: z.ZodEnum<["dbfs", "calibrated-db", "raw"]>;
+    unit: z.ZodEnum<["dBFS", "dB", "Level"]>;
+    reference: z.ZodEnum<["full-scale", "device", "none"]>;
+    calibrated: z.ZodBoolean;
+    min: z.ZodNumber;
+    max: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    min: number;
+    max: number;
+    domain: "dbfs" | "calibrated-db" | "raw";
+    unit: "dBFS" | "dB" | "Level";
+    reference: "none" | "full-scale" | "device";
+    calibrated: boolean;
+}, {
+    min: number;
+    max: number;
+    domain: "dbfs" | "calibrated-db" | "raw";
+    unit: "dBFS" | "dB" | "Level";
+    reference: "none" | "full-scale" | "device";
+    calibrated: boolean;
+}>, {
+    min: number;
+    max: number;
+    domain: "dbfs" | "calibrated-db" | "raw";
+    unit: "dBFS" | "dB" | "Level";
+    reference: "none" | "full-scale" | "device";
+    calibrated: boolean;
+}, {
+    min: number;
+    max: number;
+    domain: "dbfs" | "calibrated-db" | "raw";
+    unit: "dBFS" | "dB" | "Level";
+    reference: "none" | "full-scale" | "device";
+    calibrated: boolean;
+}>;
+export type SpectrumLevelDescriptor = z.infer<typeof SpectrumLevelDescriptorSchema>;
+/** A lower-resolution, wider-range representation derived from the same FFT. */
+export declare const SpectrumFrameSupplementSchema: z.ZodObject<{
+    frequencyRange: z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        min: number;
+        max: number;
+    }, {
+        min: number;
+        max: number;
+    }>;
+    binaryData: z.ZodObject<{
+        data: z.ZodString;
+        format: z.ZodObject<{
+            type: z.ZodLiteral<"int16">;
+            length: z.ZodNumber;
+            scale: z.ZodOptional<z.ZodNumber>;
+            offset: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            type: "int16";
+            length: number;
+            scale?: number | undefined;
+            offset?: number | undefined;
+        }, {
+            type: "int16";
+            length: number;
+            scale?: number | undefined;
+            offset?: number | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        data: string;
+        format: {
+            type: "int16";
+            length: number;
+            scale?: number | undefined;
+            offset?: number | undefined;
+        };
+    }, {
+        data: string;
+        format: {
+            type: "int16";
+            length: number;
+            scale?: number | undefined;
+            offset?: number | undefined;
+        };
+    }>;
+    meta: z.ZodObject<{
+        sourceBinCount: z.ZodNumber;
+        displayBinCount: z.ZodNumber;
+        centerFrequency: z.ZodOptional<z.ZodNumber>;
+        spanHz: z.ZodOptional<z.ZodNumber>;
+        level: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            domain: z.ZodEnum<["dbfs", "calibrated-db", "raw"]>;
+            unit: z.ZodEnum<["dBFS", "dB", "Level"]>;
+            reference: z.ZodEnum<["full-scale", "device", "none"]>;
+            calibrated: z.ZodBoolean;
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        }, {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        }>, {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        }, {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        displayBinCount: number;
+        sourceBinCount: number;
+        centerFrequency?: number | undefined;
+        spanHz?: number | undefined;
+        level?: {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        } | undefined;
+    }, {
+        displayBinCount: number;
+        sourceBinCount: number;
+        centerFrequency?: number | undefined;
+        spanHz?: number | undefined;
+        level?: {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        } | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    frequencyRange: {
+        min: number;
+        max: number;
+    };
+    binaryData: {
+        data: string;
+        format: {
+            type: "int16";
+            length: number;
+            scale?: number | undefined;
+            offset?: number | undefined;
+        };
+    };
+    meta: {
+        displayBinCount: number;
+        sourceBinCount: number;
+        centerFrequency?: number | undefined;
+        spanHz?: number | undefined;
+        level?: {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        } | undefined;
+    };
+}, {
+    frequencyRange: {
+        min: number;
+        max: number;
+    };
+    binaryData: {
+        data: string;
+        format: {
+            type: "int16";
+            length: number;
+            scale?: number | undefined;
+            offset?: number | undefined;
+        };
+    };
+    meta: {
+        displayBinCount: number;
+        sourceBinCount: number;
+        centerFrequency?: number | undefined;
+        spanHz?: number | undefined;
+        level?: {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        } | undefined;
+    };
+}>;
+export type SpectrumFrameSupplement = z.infer<typeof SpectrumFrameSupplementSchema>;
 export declare const SpectrumFrameMetaSchema: z.ZodObject<{
     sourceBinCount: z.ZodNumber;
     displayBinCount: z.ZodNumber;
+    /** Original source range before a per-client server-side projection. */
+    nativeFrequencyRange: z.ZodOptional<z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        min: number;
+        max: number;
+    }, {
+        min: number;
+        max: number;
+    }>>;
     centerFrequency: z.ZodOptional<z.ZodNumber>;
     spanHz: z.ZodOptional<z.ZodNumber>;
     profileId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     radioModel: z.ZodOptional<z.ZodString>;
+    level: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        domain: z.ZodEnum<["dbfs", "calibrated-db", "raw"]>;
+        unit: z.ZodEnum<["dBFS", "dB", "Level"]>;
+        reference: z.ZodEnum<["full-scale", "device", "none"]>;
+        calibrated: z.ZodBoolean;
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        min: number;
+        max: number;
+        domain: "dbfs" | "calibrated-db" | "raw";
+        unit: "dBFS" | "dB" | "Level";
+        reference: "none" | "full-scale" | "device";
+        calibrated: boolean;
+    }, {
+        min: number;
+        max: number;
+        domain: "dbfs" | "calibrated-db" | "raw";
+        unit: "dBFS" | "dB" | "Level";
+        reference: "none" | "full-scale" | "device";
+        calibrated: boolean;
+    }>, {
+        min: number;
+        max: number;
+        domain: "dbfs" | "calibrated-db" | "raw";
+        unit: "dBFS" | "dB" | "Level";
+        reference: "none" | "full-scale" | "device";
+        calibrated: boolean;
+    }, {
+        min: number;
+        max: number;
+        domain: "dbfs" | "calibrated-db" | "raw";
+        unit: "dBFS" | "dB" | "Level";
+        reference: "none" | "full-scale" | "device";
+        calibrated: boolean;
+    }>>;
+    spectrumConfigRevision: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    sourceBinCount: number;
     displayBinCount: number;
+    sourceBinCount: number;
     centerFrequency?: number | undefined;
     spanHz?: number | undefined;
+    level?: {
+        min: number;
+        max: number;
+        domain: "dbfs" | "calibrated-db" | "raw";
+        unit: "dBFS" | "dB" | "Level";
+        reference: "none" | "full-scale" | "device";
+        calibrated: boolean;
+    } | undefined;
+    nativeFrequencyRange?: {
+        min: number;
+        max: number;
+    } | undefined;
     profileId?: string | null | undefined;
     radioModel?: string | undefined;
+    spectrumConfigRevision?: number | undefined;
 }, {
-    sourceBinCount: number;
     displayBinCount: number;
+    sourceBinCount: number;
     centerFrequency?: number | undefined;
     spanHz?: number | undefined;
+    level?: {
+        min: number;
+        max: number;
+        domain: "dbfs" | "calibrated-db" | "raw";
+        unit: "dBFS" | "dB" | "Level";
+        reference: "none" | "full-scale" | "device";
+        calibrated: boolean;
+    } | undefined;
+    nativeFrequencyRange?: {
+        min: number;
+        max: number;
+    } | undefined;
     profileId?: string | null | undefined;
     radioModel?: string | undefined;
+    spectrumConfigRevision?: number | undefined;
 }>;
 export declare const SpectrumFrameSchema: z.ZodObject<{
     timestamp: z.ZodNumber;
@@ -141,26 +490,272 @@ export declare const SpectrumFrameSchema: z.ZodObject<{
     meta: z.ZodObject<{
         sourceBinCount: z.ZodNumber;
         displayBinCount: z.ZodNumber;
+        /** Original source range before a per-client server-side projection. */
+        nativeFrequencyRange: z.ZodOptional<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            min: number;
+            max: number;
+        }, {
+            min: number;
+            max: number;
+        }>>;
         centerFrequency: z.ZodOptional<z.ZodNumber>;
         spanHz: z.ZodOptional<z.ZodNumber>;
         profileId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         radioModel: z.ZodOptional<z.ZodString>;
+        level: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            domain: z.ZodEnum<["dbfs", "calibrated-db", "raw"]>;
+            unit: z.ZodEnum<["dBFS", "dB", "Level"]>;
+            reference: z.ZodEnum<["full-scale", "device", "none"]>;
+            calibrated: z.ZodBoolean;
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        }, {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        }>, {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        }, {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        }>>;
+        spectrumConfigRevision: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        sourceBinCount: number;
         displayBinCount: number;
+        sourceBinCount: number;
         centerFrequency?: number | undefined;
         spanHz?: number | undefined;
+        level?: {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        } | undefined;
+        nativeFrequencyRange?: {
+            min: number;
+            max: number;
+        } | undefined;
         profileId?: string | null | undefined;
         radioModel?: string | undefined;
+        spectrumConfigRevision?: number | undefined;
     }, {
-        sourceBinCount: number;
         displayBinCount: number;
+        sourceBinCount: number;
         centerFrequency?: number | undefined;
         spanHz?: number | undefined;
+        level?: {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        } | undefined;
+        nativeFrequencyRange?: {
+            min: number;
+            max: number;
+        } | undefined;
         profileId?: string | null | undefined;
         radioModel?: string | undefined;
+        spectrumConfigRevision?: number | undefined;
     }>;
+    supplement: z.ZodOptional<z.ZodObject<{
+        frequencyRange: z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            min: number;
+            max: number;
+        }, {
+            min: number;
+            max: number;
+        }>;
+        binaryData: z.ZodObject<{
+            data: z.ZodString;
+            format: z.ZodObject<{
+                type: z.ZodLiteral<"int16">;
+                length: z.ZodNumber;
+                scale: z.ZodOptional<z.ZodNumber>;
+                offset: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                type: "int16";
+                length: number;
+                scale?: number | undefined;
+                offset?: number | undefined;
+            }, {
+                type: "int16";
+                length: number;
+                scale?: number | undefined;
+                offset?: number | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            data: string;
+            format: {
+                type: "int16";
+                length: number;
+                scale?: number | undefined;
+                offset?: number | undefined;
+            };
+        }, {
+            data: string;
+            format: {
+                type: "int16";
+                length: number;
+                scale?: number | undefined;
+                offset?: number | undefined;
+            };
+        }>;
+        meta: z.ZodObject<{
+            sourceBinCount: z.ZodNumber;
+            displayBinCount: z.ZodNumber;
+            centerFrequency: z.ZodOptional<z.ZodNumber>;
+            spanHz: z.ZodOptional<z.ZodNumber>;
+            level: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+                domain: z.ZodEnum<["dbfs", "calibrated-db", "raw"]>;
+                unit: z.ZodEnum<["dBFS", "dB", "Level"]>;
+                reference: z.ZodEnum<["full-scale", "device", "none"]>;
+                calibrated: z.ZodBoolean;
+                min: z.ZodNumber;
+                max: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                min: number;
+                max: number;
+                domain: "dbfs" | "calibrated-db" | "raw";
+                unit: "dBFS" | "dB" | "Level";
+                reference: "none" | "full-scale" | "device";
+                calibrated: boolean;
+            }, {
+                min: number;
+                max: number;
+                domain: "dbfs" | "calibrated-db" | "raw";
+                unit: "dBFS" | "dB" | "Level";
+                reference: "none" | "full-scale" | "device";
+                calibrated: boolean;
+            }>, {
+                min: number;
+                max: number;
+                domain: "dbfs" | "calibrated-db" | "raw";
+                unit: "dBFS" | "dB" | "Level";
+                reference: "none" | "full-scale" | "device";
+                calibrated: boolean;
+            }, {
+                min: number;
+                max: number;
+                domain: "dbfs" | "calibrated-db" | "raw";
+                unit: "dBFS" | "dB" | "Level";
+                reference: "none" | "full-scale" | "device";
+                calibrated: boolean;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            displayBinCount: number;
+            sourceBinCount: number;
+            centerFrequency?: number | undefined;
+            spanHz?: number | undefined;
+            level?: {
+                min: number;
+                max: number;
+                domain: "dbfs" | "calibrated-db" | "raw";
+                unit: "dBFS" | "dB" | "Level";
+                reference: "none" | "full-scale" | "device";
+                calibrated: boolean;
+            } | undefined;
+        }, {
+            displayBinCount: number;
+            sourceBinCount: number;
+            centerFrequency?: number | undefined;
+            spanHz?: number | undefined;
+            level?: {
+                min: number;
+                max: number;
+                domain: "dbfs" | "calibrated-db" | "raw";
+                unit: "dBFS" | "dB" | "Level";
+                reference: "none" | "full-scale" | "device";
+                calibrated: boolean;
+            } | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        frequencyRange: {
+            min: number;
+            max: number;
+        };
+        binaryData: {
+            data: string;
+            format: {
+                type: "int16";
+                length: number;
+                scale?: number | undefined;
+                offset?: number | undefined;
+            };
+        };
+        meta: {
+            displayBinCount: number;
+            sourceBinCount: number;
+            centerFrequency?: number | undefined;
+            spanHz?: number | undefined;
+            level?: {
+                min: number;
+                max: number;
+                domain: "dbfs" | "calibrated-db" | "raw";
+                unit: "dBFS" | "dB" | "Level";
+                reference: "none" | "full-scale" | "device";
+                calibrated: boolean;
+            } | undefined;
+        };
+    }, {
+        frequencyRange: {
+            min: number;
+            max: number;
+        };
+        binaryData: {
+            data: string;
+            format: {
+                type: "int16";
+                length: number;
+                scale?: number | undefined;
+                offset?: number | undefined;
+            };
+        };
+        meta: {
+            displayBinCount: number;
+            sourceBinCount: number;
+            centerFrequency?: number | undefined;
+            spanHz?: number | undefined;
+            level?: {
+                min: number;
+                max: number;
+                domain: "dbfs" | "calibrated-db" | "raw";
+                unit: "dBFS" | "dB" | "Level";
+                reference: "none" | "full-scale" | "device";
+                calibrated: boolean;
+            } | undefined;
+        };
+    }>>;
 }, "strip", z.ZodTypeAny, {
+    kind: "audio" | "radio-sdr" | "openwebrx-sdr";
     timestamp: number;
     frequencyRange: {
         min: number;
@@ -175,16 +770,58 @@ export declare const SpectrumFrameSchema: z.ZodObject<{
             offset?: number | undefined;
         };
     };
-    kind: "audio" | "radio-sdr" | "openwebrx-sdr";
     meta: {
-        sourceBinCount: number;
         displayBinCount: number;
+        sourceBinCount: number;
         centerFrequency?: number | undefined;
         spanHz?: number | undefined;
+        level?: {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        } | undefined;
+        nativeFrequencyRange?: {
+            min: number;
+            max: number;
+        } | undefined;
         profileId?: string | null | undefined;
         radioModel?: string | undefined;
+        spectrumConfigRevision?: number | undefined;
     };
+    supplement?: {
+        frequencyRange: {
+            min: number;
+            max: number;
+        };
+        binaryData: {
+            data: string;
+            format: {
+                type: "int16";
+                length: number;
+                scale?: number | undefined;
+                offset?: number | undefined;
+            };
+        };
+        meta: {
+            displayBinCount: number;
+            sourceBinCount: number;
+            centerFrequency?: number | undefined;
+            spanHz?: number | undefined;
+            level?: {
+                min: number;
+                max: number;
+                domain: "dbfs" | "calibrated-db" | "raw";
+                unit: "dBFS" | "dB" | "Level";
+                reference: "none" | "full-scale" | "device";
+                calibrated: boolean;
+            } | undefined;
+        };
+    } | undefined;
 }, {
+    kind: "audio" | "radio-sdr" | "openwebrx-sdr";
     timestamp: number;
     frequencyRange: {
         min: number;
@@ -199,15 +836,56 @@ export declare const SpectrumFrameSchema: z.ZodObject<{
             offset?: number | undefined;
         };
     };
-    kind: "audio" | "radio-sdr" | "openwebrx-sdr";
     meta: {
-        sourceBinCount: number;
         displayBinCount: number;
+        sourceBinCount: number;
         centerFrequency?: number | undefined;
         spanHz?: number | undefined;
+        level?: {
+            min: number;
+            max: number;
+            domain: "dbfs" | "calibrated-db" | "raw";
+            unit: "dBFS" | "dB" | "Level";
+            reference: "none" | "full-scale" | "device";
+            calibrated: boolean;
+        } | undefined;
+        nativeFrequencyRange?: {
+            min: number;
+            max: number;
+        } | undefined;
         profileId?: string | null | undefined;
         radioModel?: string | undefined;
+        spectrumConfigRevision?: number | undefined;
     };
+    supplement?: {
+        frequencyRange: {
+            min: number;
+            max: number;
+        };
+        binaryData: {
+            data: string;
+            format: {
+                type: "int16";
+                length: number;
+                scale?: number | undefined;
+                offset?: number | undefined;
+            };
+        };
+        meta: {
+            displayBinCount: number;
+            sourceBinCount: number;
+            centerFrequency?: number | undefined;
+            spanHz?: number | undefined;
+            level?: {
+                min: number;
+                max: number;
+                domain: "dbfs" | "calibrated-db" | "raw";
+                unit: "dBFS" | "dB" | "Level";
+                reference: "none" | "full-scale" | "device";
+                calibrated: boolean;
+            } | undefined;
+        };
+    } | undefined;
 }>;
 export declare const SpectrumSourceAvailabilitySchema: z.ZodObject<{
     kind: z.ZodEnum<["audio", "radio-sdr", "openwebrx-sdr"]>;
@@ -221,8 +899,8 @@ export declare const SpectrumSourceAvailabilitySchema: z.ZodObject<{
     frequencyRangeMode: z.ZodEnum<["absolute", "baseband"]>;
 }, "strip", z.ZodTypeAny, {
     available: boolean;
-    displayBinCount: number;
     kind: "audio" | "radio-sdr" | "openwebrx-sdr";
+    displayBinCount: number;
     supported: boolean;
     defaultSelected: boolean;
     supportsWaterfall: boolean;
@@ -231,8 +909,8 @@ export declare const SpectrumSourceAvailabilitySchema: z.ZodObject<{
     sourceBinCount?: number | null | undefined;
 }, {
     available: boolean;
-    displayBinCount: number;
     kind: "audio" | "radio-sdr" | "openwebrx-sdr";
+    displayBinCount: number;
     supported: boolean;
     defaultSelected: boolean;
     supportsWaterfall: boolean;
@@ -255,8 +933,8 @@ export declare const SpectrumCapabilitiesSchema: z.ZodObject<{
         frequencyRangeMode: z.ZodEnum<["absolute", "baseband"]>;
     }, "strip", z.ZodTypeAny, {
         available: boolean;
-        displayBinCount: number;
         kind: "audio" | "radio-sdr" | "openwebrx-sdr";
+        displayBinCount: number;
         supported: boolean;
         defaultSelected: boolean;
         supportsWaterfall: boolean;
@@ -265,8 +943,8 @@ export declare const SpectrumCapabilitiesSchema: z.ZodObject<{
         sourceBinCount?: number | null | undefined;
     }, {
         available: boolean;
-        displayBinCount: number;
         kind: "audio" | "radio-sdr" | "openwebrx-sdr";
+        displayBinCount: number;
         supported: boolean;
         defaultSelected: boolean;
         supportsWaterfall: boolean;
@@ -274,13 +952,222 @@ export declare const SpectrumCapabilitiesSchema: z.ZodObject<{
         reason?: string | undefined;
         sourceBinCount?: number | null | undefined;
     }>, "many">;
+    renderConfig: z.ZodObject<{
+        preset: z.ZodEnum<["responsive", "balanced", "fine", "custom"]>;
+        revision: z.ZodNumber;
+        analysisIntervalMs: z.ZodNumber;
+        frameRateHz: z.ZodNumber;
+        fftSize: z.ZodNumber;
+        targetSampleRate: z.ZodNumber;
+        fftWindowDurationMs: z.ZodNumber;
+        frequencyResolutionHz: z.ZodNumber;
+        frequencyRange: z.ZodEffects<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            min: number;
+            max: number;
+        }, {
+            min: number;
+            max: number;
+        }>, {
+            min: number;
+            max: number;
+        }, {
+            min: number;
+            max: number;
+        }>;
+        displayBinCount: z.ZodNumber;
+        windowFunction: z.ZodEnum<["hann", "hamming", "blackman", "blackmanHarris", "none"]>;
+        haloReduce: z.ZodBoolean;
+        customSettings: z.ZodOptional<z.ZodObject<{
+            analysisIntervalMs: z.ZodNumber;
+            fftSize: z.ZodUnion<[z.ZodLiteral<1024>, z.ZodLiteral<2048>, z.ZodLiteral<4096>, z.ZodLiteral<8192>, z.ZodLiteral<16384>]>;
+            targetSampleRate: z.ZodUnion<[z.ZodLiteral<3000>, z.ZodLiteral<4000>, z.ZodLiteral<6000>, z.ZodLiteral<8000>, z.ZodLiteral<12000>]>;
+            windowFunction: z.ZodEnum<["hann", "hamming", "blackman", "blackmanHarris", "none"]>;
+            haloReduce: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            analysisIntervalMs: number;
+            fftSize: 1024 | 2048 | 4096 | 8192 | 16384;
+            targetSampleRate: 8000 | 12000 | 3000 | 4000 | 6000;
+            windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+            haloReduce: boolean;
+        }, {
+            analysisIntervalMs: number;
+            fftSize: 1024 | 2048 | 4096 | 8192 | 16384;
+            targetSampleRate: 8000 | 12000 | 3000 | 4000 | 6000;
+            windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+            haloReduce: boolean;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        preset: "custom" | "balanced" | "responsive" | "fine";
+        frequencyRange: {
+            min: number;
+            max: number;
+        };
+        analysisIntervalMs: number;
+        fftSize: number;
+        targetSampleRate: number;
+        windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+        haloReduce: boolean;
+        revision: number;
+        frameRateHz: number;
+        fftWindowDurationMs: number;
+        frequencyResolutionHz: number;
+        displayBinCount: number;
+        customSettings?: {
+            analysisIntervalMs: number;
+            fftSize: 1024 | 2048 | 4096 | 8192 | 16384;
+            targetSampleRate: 8000 | 12000 | 3000 | 4000 | 6000;
+            windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+            haloReduce: boolean;
+        } | undefined;
+    }, {
+        preset: "custom" | "balanced" | "responsive" | "fine";
+        frequencyRange: {
+            min: number;
+            max: number;
+        };
+        analysisIntervalMs: number;
+        fftSize: number;
+        targetSampleRate: number;
+        windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+        haloReduce: boolean;
+        revision: number;
+        frameRateHz: number;
+        fftWindowDurationMs: number;
+        frequencyResolutionHz: number;
+        displayBinCount: number;
+        customSettings?: {
+            analysisIntervalMs: number;
+            fftSize: 1024 | 2048 | 4096 | 8192 | 16384;
+            targetSampleRate: 8000 | 12000 | 3000 | 4000 | 6000;
+            windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+            haloReduce: boolean;
+        } | undefined;
+    }>;
+    presets: z.ZodArray<z.ZodObject<Omit<{
+        preset: z.ZodEnum<["responsive", "balanced", "fine", "custom"]>;
+        revision: z.ZodNumber;
+        analysisIntervalMs: z.ZodNumber;
+        frameRateHz: z.ZodNumber;
+        fftSize: z.ZodNumber;
+        targetSampleRate: z.ZodNumber;
+        fftWindowDurationMs: z.ZodNumber;
+        frequencyResolutionHz: z.ZodNumber;
+        frequencyRange: z.ZodEffects<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            min: number;
+            max: number;
+        }, {
+            min: number;
+            max: number;
+        }>, {
+            min: number;
+            max: number;
+        }, {
+            min: number;
+            max: number;
+        }>;
+        displayBinCount: z.ZodNumber;
+        windowFunction: z.ZodEnum<["hann", "hamming", "blackman", "blackmanHarris", "none"]>;
+        haloReduce: z.ZodBoolean;
+        customSettings: z.ZodOptional<z.ZodObject<{
+            analysisIntervalMs: z.ZodNumber;
+            fftSize: z.ZodUnion<[z.ZodLiteral<1024>, z.ZodLiteral<2048>, z.ZodLiteral<4096>, z.ZodLiteral<8192>, z.ZodLiteral<16384>]>;
+            targetSampleRate: z.ZodUnion<[z.ZodLiteral<3000>, z.ZodLiteral<4000>, z.ZodLiteral<6000>, z.ZodLiteral<8000>, z.ZodLiteral<12000>]>;
+            windowFunction: z.ZodEnum<["hann", "hamming", "blackman", "blackmanHarris", "none"]>;
+            haloReduce: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            analysisIntervalMs: number;
+            fftSize: 1024 | 2048 | 4096 | 8192 | 16384;
+            targetSampleRate: 8000 | 12000 | 3000 | 4000 | 6000;
+            windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+            haloReduce: boolean;
+        }, {
+            analysisIntervalMs: number;
+            fftSize: 1024 | 2048 | 4096 | 8192 | 16384;
+            targetSampleRate: 8000 | 12000 | 3000 | 4000 | 6000;
+            windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+            haloReduce: boolean;
+        }>>;
+    }, "revision">, "strip", z.ZodTypeAny, {
+        preset: "custom" | "balanced" | "responsive" | "fine";
+        frequencyRange: {
+            min: number;
+            max: number;
+        };
+        analysisIntervalMs: number;
+        fftSize: number;
+        targetSampleRate: number;
+        windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+        haloReduce: boolean;
+        frameRateHz: number;
+        fftWindowDurationMs: number;
+        frequencyResolutionHz: number;
+        displayBinCount: number;
+        customSettings?: {
+            analysisIntervalMs: number;
+            fftSize: 1024 | 2048 | 4096 | 8192 | 16384;
+            targetSampleRate: 8000 | 12000 | 3000 | 4000 | 6000;
+            windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+            haloReduce: boolean;
+        } | undefined;
+    }, {
+        preset: "custom" | "balanced" | "responsive" | "fine";
+        frequencyRange: {
+            min: number;
+            max: number;
+        };
+        analysisIntervalMs: number;
+        fftSize: number;
+        targetSampleRate: number;
+        windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+        haloReduce: boolean;
+        frameRateHz: number;
+        fftWindowDurationMs: number;
+        frequencyResolutionHz: number;
+        displayBinCount: number;
+        customSettings?: {
+            analysisIntervalMs: number;
+            fftSize: 1024 | 2048 | 4096 | 8192 | 16384;
+            targetSampleRate: 8000 | 12000 | 3000 | 4000 | 6000;
+            windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+            haloReduce: boolean;
+        } | undefined;
+    }>, "many">;
 }, "strip", z.ZodTypeAny, {
+    presets: {
+        preset: "custom" | "balanced" | "responsive" | "fine";
+        frequencyRange: {
+            min: number;
+            max: number;
+        };
+        analysisIntervalMs: number;
+        fftSize: number;
+        targetSampleRate: number;
+        windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+        haloReduce: boolean;
+        frameRateHz: number;
+        fftWindowDurationMs: number;
+        frequencyResolutionHz: number;
+        displayBinCount: number;
+        customSettings?: {
+            analysisIntervalMs: number;
+            fftSize: 1024 | 2048 | 4096 | 8192 | 16384;
+            targetSampleRate: 8000 | 12000 | 3000 | 4000 | 6000;
+            windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+            haloReduce: boolean;
+        } | undefined;
+    }[];
     profileId: string | null;
     defaultKind: "audio" | "radio-sdr" | "openwebrx-sdr";
     sources: {
         available: boolean;
-        displayBinCount: number;
         kind: "audio" | "radio-sdr" | "openwebrx-sdr";
+        displayBinCount: number;
         supported: boolean;
         defaultSelected: boolean;
         supportsWaterfall: boolean;
@@ -288,13 +1175,60 @@ export declare const SpectrumCapabilitiesSchema: z.ZodObject<{
         reason?: string | undefined;
         sourceBinCount?: number | null | undefined;
     }[];
+    renderConfig: {
+        preset: "custom" | "balanced" | "responsive" | "fine";
+        frequencyRange: {
+            min: number;
+            max: number;
+        };
+        analysisIntervalMs: number;
+        fftSize: number;
+        targetSampleRate: number;
+        windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+        haloReduce: boolean;
+        revision: number;
+        frameRateHz: number;
+        fftWindowDurationMs: number;
+        frequencyResolutionHz: number;
+        displayBinCount: number;
+        customSettings?: {
+            analysisIntervalMs: number;
+            fftSize: 1024 | 2048 | 4096 | 8192 | 16384;
+            targetSampleRate: 8000 | 12000 | 3000 | 4000 | 6000;
+            windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+            haloReduce: boolean;
+        } | undefined;
+    };
 }, {
+    presets: {
+        preset: "custom" | "balanced" | "responsive" | "fine";
+        frequencyRange: {
+            min: number;
+            max: number;
+        };
+        analysisIntervalMs: number;
+        fftSize: number;
+        targetSampleRate: number;
+        windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+        haloReduce: boolean;
+        frameRateHz: number;
+        fftWindowDurationMs: number;
+        frequencyResolutionHz: number;
+        displayBinCount: number;
+        customSettings?: {
+            analysisIntervalMs: number;
+            fftSize: 1024 | 2048 | 4096 | 8192 | 16384;
+            targetSampleRate: 8000 | 12000 | 3000 | 4000 | 6000;
+            windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+            haloReduce: boolean;
+        } | undefined;
+    }[];
     profileId: string | null;
     defaultKind: "audio" | "radio-sdr" | "openwebrx-sdr";
     sources: {
         available: boolean;
-        displayBinCount: number;
         kind: "audio" | "radio-sdr" | "openwebrx-sdr";
+        displayBinCount: number;
         supported: boolean;
         defaultSelected: boolean;
         supportsWaterfall: boolean;
@@ -302,6 +1236,30 @@ export declare const SpectrumCapabilitiesSchema: z.ZodObject<{
         reason?: string | undefined;
         sourceBinCount?: number | null | undefined;
     }[];
+    renderConfig: {
+        preset: "custom" | "balanced" | "responsive" | "fine";
+        frequencyRange: {
+            min: number;
+            max: number;
+        };
+        analysisIntervalMs: number;
+        fftSize: number;
+        targetSampleRate: number;
+        windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+        haloReduce: boolean;
+        revision: number;
+        frameRateHz: number;
+        fftWindowDurationMs: number;
+        frequencyResolutionHz: number;
+        displayBinCount: number;
+        customSettings?: {
+            analysisIntervalMs: number;
+            fftSize: 1024 | 2048 | 4096 | 8192 | 16384;
+            targetSampleRate: 8000 | 12000 | 3000 | 4000 | 6000;
+            windowFunction: "none" | "hann" | "hamming" | "blackman" | "blackmanHarris";
+            haloReduce: boolean;
+        } | undefined;
+    };
 }>;
 export declare const SpectrumSessionControlIdSchema: z.ZodEnum<["zoom-step", "digital-window-toggle", "openwebrx-detail-toggle", "viewport-zoom"]>;
 export type SpectrumSessionControlId = z.infer<typeof SpectrumSessionControlIdSchema>;
@@ -321,17 +1279,17 @@ export declare const SpectrumSessionControlSchema: z.ZodObject<{
     id: "zoom-step" | "digital-window-toggle" | "openwebrx-detail-toggle" | "viewport-zoom";
     active: boolean;
     kind: "server" | "local";
+    enabled: boolean;
     action: "in" | "out" | "toggle";
     visible: boolean;
-    enabled: boolean;
     pending: boolean;
 }, {
     id: "zoom-step" | "digital-window-toggle" | "openwebrx-detail-toggle" | "viewport-zoom";
     active: boolean;
     kind: "server" | "local";
+    enabled: boolean;
     action: "in" | "out" | "toggle";
     visible: boolean;
-    enabled: boolean;
     pending: boolean;
 }>;
 export type SpectrumSessionControl = z.infer<typeof SpectrumSessionControlSchema>;
@@ -372,7 +1330,89 @@ export declare const SpectrumSessionPresetMarkerSchema: z.ZodObject<{
     clickable: boolean;
 }>;
 export type SpectrumSessionPresetMarker = z.infer<typeof SpectrumSessionPresetMarkerSchema>;
+export declare const SpectrumSessionFrequencyOverlaySchema: z.ZodEffects<z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    lineFrequency: z.ZodNumber;
+    rangeStartFrequency: z.ZodNumber;
+    rangeEndFrequency: z.ZodNumber;
+    variant: z.ZodEnum<["tx", "rx", "window"]>;
+    draggable: z.ZodBoolean;
+    frequencyTarget: z.ZodNullable<z.ZodEnum<["radio-frequency", "operator-tx", "split-frequency"]>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    label: string;
+    lineFrequency: number;
+    rangeStartFrequency: number;
+    rangeEndFrequency: number;
+    variant: "tx" | "rx" | "window";
+    draggable: boolean;
+    frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+}, {
+    id: string;
+    label: string;
+    lineFrequency: number;
+    rangeStartFrequency: number;
+    rangeEndFrequency: number;
+    variant: "tx" | "rx" | "window";
+    draggable: boolean;
+    frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+}>, {
+    id: string;
+    label: string;
+    lineFrequency: number;
+    rangeStartFrequency: number;
+    rangeEndFrequency: number;
+    variant: "tx" | "rx" | "window";
+    draggable: boolean;
+    frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+}, {
+    id: string;
+    label: string;
+    lineFrequency: number;
+    rangeStartFrequency: number;
+    rangeEndFrequency: number;
+    variant: "tx" | "rx" | "window";
+    draggable: boolean;
+    frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+}>;
+export type SpectrumSessionFrequencyOverlay = z.infer<typeof SpectrumSessionFrequencyOverlaySchema>;
 export declare const SpectrumSessionInteractionStateSchema: z.ZodObject<{
+    viewMode: z.ZodDefault<z.ZodEnum<["wide", "radio-center"]>>;
+    viewport: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        canZoom: z.ZodBoolean;
+        canPan: z.ZodBoolean;
+        canTuneAtEdge: z.ZodBoolean;
+        bounds: z.ZodNullable<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            min: number;
+            max: number;
+        }, {
+            min: number;
+            max: number;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        canZoom: boolean;
+        canPan: boolean;
+        canTuneAtEdge: boolean;
+        bounds: {
+            min: number;
+            max: number;
+        } | null;
+    }, {
+        enabled: boolean;
+        canZoom: boolean;
+        canPan: boolean;
+        canTuneAtEdge: boolean;
+        bounds: {
+            min: number;
+            max: number;
+        } | null;
+    }>>;
     showTxMarkers: z.ZodBoolean;
     showRxMarkers: z.ZodBoolean;
     canDragTx: z.ZodBoolean;
@@ -400,6 +1440,52 @@ export declare const SpectrumSessionInteractionStateSchema: z.ZodObject<{
         label: string;
         clickable: boolean;
     }>, "many">;
+    frequencyOverlays: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        lineFrequency: z.ZodNumber;
+        rangeStartFrequency: z.ZodNumber;
+        rangeEndFrequency: z.ZodNumber;
+        variant: z.ZodEnum<["tx", "rx", "window"]>;
+        draggable: z.ZodBoolean;
+        frequencyTarget: z.ZodNullable<z.ZodEnum<["radio-frequency", "operator-tx", "split-frequency"]>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label: string;
+        lineFrequency: number;
+        rangeStartFrequency: number;
+        rangeEndFrequency: number;
+        variant: "tx" | "rx" | "window";
+        draggable: boolean;
+        frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+    }, {
+        id: string;
+        label: string;
+        lineFrequency: number;
+        rangeStartFrequency: number;
+        rangeEndFrequency: number;
+        variant: "tx" | "rx" | "window";
+        draggable: boolean;
+        frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+    }>, {
+        id: string;
+        label: string;
+        lineFrequency: number;
+        rangeStartFrequency: number;
+        rangeEndFrequency: number;
+        variant: "tx" | "rx" | "window";
+        draggable: boolean;
+        frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+    }, {
+        id: string;
+        label: string;
+        lineFrequency: number;
+        rangeStartFrequency: number;
+        rangeEndFrequency: number;
+        variant: "tx" | "rx" | "window";
+        draggable: boolean;
+        frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+    }>, "many">;
     canDragVoiceOverlay: z.ZodBoolean;
     showVoiceOverlay: z.ZodBoolean;
     canLocalViewportZoom: z.ZodBoolean;
@@ -408,13 +1494,24 @@ export declare const SpectrumSessionInteractionStateSchema: z.ZodObject<{
     supportsAutoRange: z.ZodBoolean;
     defaultRangeMode: z.ZodNullable<z.ZodEnum<["auto", "manual"]>>;
 }, "strip", z.ZodTypeAny, {
+    viewMode: "wide" | "radio-center";
+    viewport: {
+        enabled: boolean;
+        canZoom: boolean;
+        canPan: boolean;
+        canTuneAtEdge: boolean;
+        bounds: {
+            min: number;
+            max: number;
+        } | null;
+    };
     showTxMarkers: boolean;
     showRxMarkers: boolean;
     canDragTx: boolean;
     canRightClickSetFrequency: boolean;
     canDoubleClickSetFrequency: boolean;
     canDragFrequency: boolean;
-    frequencyGestureTarget: "operator-tx" | "radio-frequency" | null;
+    frequencyGestureTarget: "radio-frequency" | "operator-tx" | null;
     frequencyStepHz: number | null;
     presetMarkers: {
         id: string;
@@ -423,6 +1520,16 @@ export declare const SpectrumSessionInteractionStateSchema: z.ZodObject<{
         label: string;
         clickable: boolean;
     }[];
+    frequencyOverlays: {
+        id: string;
+        label: string;
+        lineFrequency: number;
+        rangeStartFrequency: number;
+        rangeEndFrequency: number;
+        variant: "tx" | "rx" | "window";
+        draggable: boolean;
+        frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+    }[];
     canDragVoiceOverlay: boolean;
     showVoiceOverlay: boolean;
     canLocalViewportZoom: boolean;
@@ -437,7 +1544,7 @@ export declare const SpectrumSessionInteractionStateSchema: z.ZodObject<{
     canRightClickSetFrequency: boolean;
     canDoubleClickSetFrequency: boolean;
     canDragFrequency: boolean;
-    frequencyGestureTarget: "operator-tx" | "radio-frequency" | null;
+    frequencyGestureTarget: "radio-frequency" | "operator-tx" | null;
     frequencyStepHz: number | null;
     presetMarkers: {
         id: string;
@@ -446,6 +1553,16 @@ export declare const SpectrumSessionInteractionStateSchema: z.ZodObject<{
         label: string;
         clickable: boolean;
     }[];
+    frequencyOverlays: {
+        id: string;
+        label: string;
+        lineFrequency: number;
+        rangeStartFrequency: number;
+        rangeEndFrequency: number;
+        variant: "tx" | "rx" | "window";
+        draggable: boolean;
+        frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+    }[];
     canDragVoiceOverlay: boolean;
     showVoiceOverlay: boolean;
     canLocalViewportZoom: boolean;
@@ -453,6 +1570,17 @@ export declare const SpectrumSessionInteractionStateSchema: z.ZodObject<{
     supportsManualRange: boolean;
     supportsAutoRange: boolean;
     defaultRangeMode: "manual" | "auto" | null;
+    viewMode?: "wide" | "radio-center" | undefined;
+    viewport?: {
+        enabled: boolean;
+        canZoom: boolean;
+        canPan: boolean;
+        canTuneAtEdge: boolean;
+        bounds: {
+            min: number;
+            max: number;
+        } | null;
+    } | undefined;
 }>;
 export type SpectrumSessionInteractionState = z.infer<typeof SpectrumSessionInteractionStateSchema>;
 export declare const SpectrumSessionStateSchema: z.ZodObject<{
@@ -492,6 +1620,41 @@ export declare const SpectrumSessionStateSchema: z.ZodObject<{
         offsetModel: "upper" | "lower" | "symmetric" | null;
     }>;
     interaction: z.ZodObject<{
+        viewMode: z.ZodDefault<z.ZodEnum<["wide", "radio-center"]>>;
+        viewport: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodBoolean;
+            canZoom: z.ZodBoolean;
+            canPan: z.ZodBoolean;
+            canTuneAtEdge: z.ZodBoolean;
+            bounds: z.ZodNullable<z.ZodObject<{
+                min: z.ZodNumber;
+                max: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                min: number;
+                max: number;
+            }, {
+                min: number;
+                max: number;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            canZoom: boolean;
+            canPan: boolean;
+            canTuneAtEdge: boolean;
+            bounds: {
+                min: number;
+                max: number;
+            } | null;
+        }, {
+            enabled: boolean;
+            canZoom: boolean;
+            canPan: boolean;
+            canTuneAtEdge: boolean;
+            bounds: {
+                min: number;
+                max: number;
+            } | null;
+        }>>;
         showTxMarkers: z.ZodBoolean;
         showRxMarkers: z.ZodBoolean;
         canDragTx: z.ZodBoolean;
@@ -519,6 +1682,52 @@ export declare const SpectrumSessionStateSchema: z.ZodObject<{
             label: string;
             clickable: boolean;
         }>, "many">;
+        frequencyOverlays: z.ZodArray<z.ZodEffects<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            lineFrequency: z.ZodNumber;
+            rangeStartFrequency: z.ZodNumber;
+            rangeEndFrequency: z.ZodNumber;
+            variant: z.ZodEnum<["tx", "rx", "window"]>;
+            draggable: z.ZodBoolean;
+            frequencyTarget: z.ZodNullable<z.ZodEnum<["radio-frequency", "operator-tx", "split-frequency"]>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            label: string;
+            lineFrequency: number;
+            rangeStartFrequency: number;
+            rangeEndFrequency: number;
+            variant: "tx" | "rx" | "window";
+            draggable: boolean;
+            frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+        }, {
+            id: string;
+            label: string;
+            lineFrequency: number;
+            rangeStartFrequency: number;
+            rangeEndFrequency: number;
+            variant: "tx" | "rx" | "window";
+            draggable: boolean;
+            frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+        }>, {
+            id: string;
+            label: string;
+            lineFrequency: number;
+            rangeStartFrequency: number;
+            rangeEndFrequency: number;
+            variant: "tx" | "rx" | "window";
+            draggable: boolean;
+            frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+        }, {
+            id: string;
+            label: string;
+            lineFrequency: number;
+            rangeStartFrequency: number;
+            rangeEndFrequency: number;
+            variant: "tx" | "rx" | "window";
+            draggable: boolean;
+            frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+        }>, "many">;
         canDragVoiceOverlay: z.ZodBoolean;
         showVoiceOverlay: z.ZodBoolean;
         canLocalViewportZoom: z.ZodBoolean;
@@ -527,13 +1736,24 @@ export declare const SpectrumSessionStateSchema: z.ZodObject<{
         supportsAutoRange: z.ZodBoolean;
         defaultRangeMode: z.ZodNullable<z.ZodEnum<["auto", "manual"]>>;
     }, "strip", z.ZodTypeAny, {
+        viewMode: "wide" | "radio-center";
+        viewport: {
+            enabled: boolean;
+            canZoom: boolean;
+            canPan: boolean;
+            canTuneAtEdge: boolean;
+            bounds: {
+                min: number;
+                max: number;
+            } | null;
+        };
         showTxMarkers: boolean;
         showRxMarkers: boolean;
         canDragTx: boolean;
         canRightClickSetFrequency: boolean;
         canDoubleClickSetFrequency: boolean;
         canDragFrequency: boolean;
-        frequencyGestureTarget: "operator-tx" | "radio-frequency" | null;
+        frequencyGestureTarget: "radio-frequency" | "operator-tx" | null;
         frequencyStepHz: number | null;
         presetMarkers: {
             id: string;
@@ -542,6 +1762,16 @@ export declare const SpectrumSessionStateSchema: z.ZodObject<{
             label: string;
             clickable: boolean;
         }[];
+        frequencyOverlays: {
+            id: string;
+            label: string;
+            lineFrequency: number;
+            rangeStartFrequency: number;
+            rangeEndFrequency: number;
+            variant: "tx" | "rx" | "window";
+            draggable: boolean;
+            frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+        }[];
         canDragVoiceOverlay: boolean;
         showVoiceOverlay: boolean;
         canLocalViewportZoom: boolean;
@@ -556,7 +1786,7 @@ export declare const SpectrumSessionStateSchema: z.ZodObject<{
         canRightClickSetFrequency: boolean;
         canDoubleClickSetFrequency: boolean;
         canDragFrequency: boolean;
-        frequencyGestureTarget: "operator-tx" | "radio-frequency" | null;
+        frequencyGestureTarget: "radio-frequency" | "operator-tx" | null;
         frequencyStepHz: number | null;
         presetMarkers: {
             id: string;
@@ -565,6 +1795,16 @@ export declare const SpectrumSessionStateSchema: z.ZodObject<{
             label: string;
             clickable: boolean;
         }[];
+        frequencyOverlays: {
+            id: string;
+            label: string;
+            lineFrequency: number;
+            rangeStartFrequency: number;
+            rangeEndFrequency: number;
+            variant: "tx" | "rx" | "window";
+            draggable: boolean;
+            frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+        }[];
         canDragVoiceOverlay: boolean;
         showVoiceOverlay: boolean;
         canLocalViewportZoom: boolean;
@@ -572,6 +1812,17 @@ export declare const SpectrumSessionStateSchema: z.ZodObject<{
         supportsManualRange: boolean;
         supportsAutoRange: boolean;
         defaultRangeMode: "manual" | "auto" | null;
+        viewMode?: "wide" | "radio-center" | undefined;
+        viewport?: {
+            enabled: boolean;
+            canZoom: boolean;
+            canPan: boolean;
+            canTuneAtEdge: boolean;
+            bounds: {
+                min: number;
+                max: number;
+            } | null;
+        } | undefined;
     }>;
     controls: z.ZodArray<z.ZodObject<{
         id: z.ZodEnum<["zoom-step", "digital-window-toggle", "openwebrx-detail-toggle", "viewport-zoom"]>;
@@ -585,25 +1836,25 @@ export declare const SpectrumSessionStateSchema: z.ZodObject<{
         id: "zoom-step" | "digital-window-toggle" | "openwebrx-detail-toggle" | "viewport-zoom";
         active: boolean;
         kind: "server" | "local";
+        enabled: boolean;
         action: "in" | "out" | "toggle";
         visible: boolean;
-        enabled: boolean;
         pending: boolean;
     }, {
         id: "zoom-step" | "digital-window-toggle" | "openwebrx-detail-toggle" | "viewport-zoom";
         active: boolean;
         kind: "server" | "local";
+        enabled: boolean;
         action: "in" | "out" | "toggle";
         visible: boolean;
-        enabled: boolean;
         pending: boolean;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
+    kind: "audio" | "radio-sdr" | "openwebrx-sdr" | null;
     centerFrequency: number | null;
     spanHz: number | null;
-    kind: "audio" | "radio-sdr" | "openwebrx-sdr" | null;
     frequencyRangeMode: "baseband" | "absolute-center" | "absolute-fixed" | "absolute-windowed";
-    sourceMode: "unknown" | "center" | "fixed" | "scroll-center" | "scroll-fixed" | "baseband" | "full" | "detail";
+    sourceMode: "unknown" | "detail" | "fixed" | "center" | "scroll-center" | "scroll-fixed" | "baseband" | "full";
     displayRange: {
         min: number;
         max: number;
@@ -619,13 +1870,24 @@ export declare const SpectrumSessionStateSchema: z.ZodObject<{
         offsetModel: "upper" | "lower" | "symmetric" | null;
     };
     interaction: {
+        viewMode: "wide" | "radio-center";
+        viewport: {
+            enabled: boolean;
+            canZoom: boolean;
+            canPan: boolean;
+            canTuneAtEdge: boolean;
+            bounds: {
+                min: number;
+                max: number;
+            } | null;
+        };
         showTxMarkers: boolean;
         showRxMarkers: boolean;
         canDragTx: boolean;
         canRightClickSetFrequency: boolean;
         canDoubleClickSetFrequency: boolean;
         canDragFrequency: boolean;
-        frequencyGestureTarget: "operator-tx" | "radio-frequency" | null;
+        frequencyGestureTarget: "radio-frequency" | "operator-tx" | null;
         frequencyStepHz: number | null;
         presetMarkers: {
             id: string;
@@ -634,6 +1896,16 @@ export declare const SpectrumSessionStateSchema: z.ZodObject<{
             label: string;
             clickable: boolean;
         }[];
+        frequencyOverlays: {
+            id: string;
+            label: string;
+            lineFrequency: number;
+            rangeStartFrequency: number;
+            rangeEndFrequency: number;
+            variant: "tx" | "rx" | "window";
+            draggable: boolean;
+            frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+        }[];
         canDragVoiceOverlay: boolean;
         showVoiceOverlay: boolean;
         canLocalViewportZoom: boolean;
@@ -646,17 +1918,17 @@ export declare const SpectrumSessionStateSchema: z.ZodObject<{
         id: "zoom-step" | "digital-window-toggle" | "openwebrx-detail-toggle" | "viewport-zoom";
         active: boolean;
         kind: "server" | "local";
+        enabled: boolean;
         action: "in" | "out" | "toggle";
         visible: boolean;
-        enabled: boolean;
         pending: boolean;
     }[];
 }, {
+    kind: "audio" | "radio-sdr" | "openwebrx-sdr" | null;
     centerFrequency: number | null;
     spanHz: number | null;
-    kind: "audio" | "radio-sdr" | "openwebrx-sdr" | null;
     frequencyRangeMode: "baseband" | "absolute-center" | "absolute-fixed" | "absolute-windowed";
-    sourceMode: "unknown" | "center" | "fixed" | "scroll-center" | "scroll-fixed" | "baseband" | "full" | "detail";
+    sourceMode: "unknown" | "detail" | "fixed" | "center" | "scroll-center" | "scroll-fixed" | "baseband" | "full";
     displayRange: {
         min: number;
         max: number;
@@ -678,7 +1950,7 @@ export declare const SpectrumSessionStateSchema: z.ZodObject<{
         canRightClickSetFrequency: boolean;
         canDoubleClickSetFrequency: boolean;
         canDragFrequency: boolean;
-        frequencyGestureTarget: "operator-tx" | "radio-frequency" | null;
+        frequencyGestureTarget: "radio-frequency" | "operator-tx" | null;
         frequencyStepHz: number | null;
         presetMarkers: {
             id: string;
@@ -687,6 +1959,16 @@ export declare const SpectrumSessionStateSchema: z.ZodObject<{
             label: string;
             clickable: boolean;
         }[];
+        frequencyOverlays: {
+            id: string;
+            label: string;
+            lineFrequency: number;
+            rangeStartFrequency: number;
+            rangeEndFrequency: number;
+            variant: "tx" | "rx" | "window";
+            draggable: boolean;
+            frequencyTarget: "radio-frequency" | "operator-tx" | "split-frequency" | null;
+        }[];
         canDragVoiceOverlay: boolean;
         showVoiceOverlay: boolean;
         canLocalViewportZoom: boolean;
@@ -694,14 +1976,25 @@ export declare const SpectrumSessionStateSchema: z.ZodObject<{
         supportsManualRange: boolean;
         supportsAutoRange: boolean;
         defaultRangeMode: "manual" | "auto" | null;
+        viewMode?: "wide" | "radio-center" | undefined;
+        viewport?: {
+            enabled: boolean;
+            canZoom: boolean;
+            canPan: boolean;
+            canTuneAtEdge: boolean;
+            bounds: {
+                min: number;
+                max: number;
+            } | null;
+        } | undefined;
     };
     controls: {
         id: "zoom-step" | "digital-window-toggle" | "openwebrx-detail-toggle" | "viewport-zoom";
         active: boolean;
         kind: "server" | "local";
+        enabled: boolean;
         action: "in" | "out" | "toggle";
         visible: boolean;
-        enabled: boolean;
         pending: boolean;
     }[];
 }>;