AquaSynth/src/AquaSynth.Core/Model.cs

namespace AquaSynth.Dsl;

public enum Waveform
{
    Sine,
    Square,
    Sawtooth,
    Triangle,
    Noise
}

public enum ModWaveform
{
    Sine,
    Triangle,
    Square,
    SampleHold
}

public enum ModTarget
{
    Gain,
    Pitch,
    Duty,
    LowPass,
    HighPass,
    Noise,
    Drive,
    Fold,
    FormantMix,
    FmIndex
}

public sealed record Envelope(
    float AttackSeconds = 0,
    float DecaySeconds = 0.01f,
    float SustainLevel = 1,
    float ReleaseSeconds = 0.1f)
{
    public float DurationSeconds => AttackSeconds + DecaySeconds + ReleaseSeconds;
}

public enum RateLevelCurve
{
    Linear,
    Exponential
}

public sealed record RateLevelEnvelope(
    float Rate1Seconds,
    float Level1,
    float Rate2Seconds,
    float Level2,
    float Rate3Seconds,
    float Level3,
    float Rate4Seconds,
    float Level4,
    RateLevelCurve Curve1 = RateLevelCurve.Linear,
    RateLevelCurve Curve2 = RateLevelCurve.Linear,
    RateLevelCurve Curve3 = RateLevelCurve.Linear,
    RateLevelCurve Curve4 = RateLevelCurve.Linear,
    float StartLevel = 0);

public enum NoteSource
{
    OneShot,
    Host
}

public enum PlaybackMode
{
    OneShot,
    Mono,
    Poly
}

public sealed record Note(
    float FrequencyHz = 440,
    float GateSeconds = 0.1f,
    NoteSource Source = NoteSource.OneShot);

public sealed record Playback(
    PlaybackMode Mode = PlaybackMode.OneShot,
    int Voices = 1,
    bool Midi = false,
    float FrequencyHz = 440,
    float Gain = 1);

public sealed record Oscillator(
    Waveform Waveform = Waveform.Sine,
    float FrequencyHz = 440,
    float Duty = 0.5f,
    float Phase = 0);

public sealed record PitchMotion(
    float MinFrequencyHz = 20,
    float RampPerSecond = 0,
    float DeltaRampPerSecond = 0,
    float VibratoDepth = 0,
    float VibratoHz = 0,
    float VibratoDelaySeconds = 0);

public sealed record DutyMotion(float RampPerSecond = 0);

public sealed record Filter(
    float LowPass = 1,
    float LowPassRamp = 0,
    float LowPassResonance = 0,
    float LowPassQ = 0,
    int LowPassOrder = 1,
    float HighPass = 0,
    float HighPassRamp = 0,
    int HighPassOrder = 1,
    float BandPass = 0,
    float BandPassQ = 1,
    int BandPassOrder = 1,
    float Notch = 0,
    float NotchQ = 1,
    int NotchOrder = 1,
    RateLevelEnvelope? LowPassEnvelope = null,
    RateLevelEnvelope? HighPassEnvelope = null);

public sealed record Phaser(float OffsetSeconds = 0, float RampSecondsPerSecond = 0);

public sealed record Arpeggio(float DelaySeconds, float Multiplier);

public sealed record FrequencyModulation(float Ratio = 1, float Index = 0, float IndexDecaySeconds = 0);

public sealed record VoiceColor(
    float NoiseMix = 0,
    float Drive = 0,
    float Fold = 0,
    float TremoloDepth = 0,
    float TremoloHz = 0,
    float FormantMix = 0);

public sealed record Formant(float FrequencyHz, float BandwidthHz, float Gain);

public sealed record FormantFrame(IReadOnlyList<Formant> Formants);

public sealed record TractAreaFunction(IReadOnlyList<float> Diameters, float LengthCentimeters = 17)
{
    public int Sections => Diameters.Count;

    public float LengthMeters => MathF.Max(0, LengthCentimeters) / 100;

    public float SectionLengthMeters => Sections == 0 ? 0 : LengthMeters / Sections;

    public float CellDelaySamples(float sampleRate, float propagationSpeedMetersPerSecond = 343) =>
        propagationSpeedMetersPerSecond <= 0
            ? 0
            : SectionLengthMeters / propagationSpeedMetersPerSecond * MathF.Max(0, sampleRate);

    public int AcousticUnitDelaySections(float sampleRate, float propagationSpeedMetersPerSecond = 343, int minimumSections = 1)
    {
        if (propagationSpeedMetersPerSecond <= 0 || sampleRate <= 0 || LengthMeters <= 0)
        {
            return Math.Max(1, minimumSections);
        }

        return Math.Max(Math.Max(1, minimumSections), (int)MathF.Round(LengthMeters / propagationSpeedMetersPerSecond * sampleRate));
    }

    public IReadOnlyList<float> Areas => Diameters.Select(diameter => MathF.Max(0, diameter) * MathF.Max(0, diameter)).ToArray();

    public IReadOnlyList<float> ReflectionCoefficients
    {
        get
        {
            if (Diameters.Count < 2) return Array.Empty<float>();
            var reflections = new float[Diameters.Count - 1];
            for (var i = 1; i < Diameters.Count; i++)
            {
                var previousArea = MathF.Max(0.000001f, Diameters[i - 1] * Diameters[i - 1]);
                var area = MathF.Max(0.000001f, Diameters[i] * Diameters[i]);
                reflections[i - 1] = (previousArea - area) / (previousArea + area);
            }

            return reflections;
        }
    }

    public float AverageDiameter(float startFraction, float endFraction)
    {
        if (Diameters.Count == 0) return 0;
        var start = Math.Clamp((int)MathF.Floor(Math.Clamp(startFraction, 0, 1) * Diameters.Count), 0, Diameters.Count - 1);
        var end = Math.Clamp((int)MathF.Ceiling(Math.Clamp(endFraction, 0, 1) * Diameters.Count), start + 1, Diameters.Count);
        var sum = 0f;
        for (var i = start; i < end; i++)
        {
            sum += Diameters[i];
        }

        return sum / Math.Max(1, end - start);
    }

    public float DiameterAt(float normalizedPosition)
    {
        if (Diameters.Count == 0) return 0;
        if (Diameters.Count == 1) return Diameters[0];
        var position = Math.Clamp(normalizedPosition, 0, 1) * (Diameters.Count - 1);
        var left = (int)MathF.Floor(position);
        var right = Math.Min(Diameters.Count - 1, left + 1);
        var mix = position - left;
        return Diameters[left] + (Diameters[right] - Diameters[left]) * mix;
    }

    public TractAreaFunction Resample(int sections)
    {
        if (sections < 1) throw new ArgumentOutOfRangeException(nameof(sections), "section count must be positive");
        if (sections == 1) return new TractAreaFunction([DiameterAt(0)], LengthCentimeters);
        var diameters = Enumerable.Range(0, sections)
            .Select(i => DiameterAt((float)i / (sections - 1)))
            .ToArray();
        return new TractAreaFunction(diameters, LengthCentimeters);
    }

    public float MinimumDiameter => Diameters.Count == 0 ? 0 : Diameters.Min();

    public static TractAreaFunction FromAreas(IReadOnlyList<float> areas, float lengthCentimeters = 17) =>
        new(areas.Select(area => MathF.Sqrt(MathF.Max(0, area))).ToArray(), lengthCentimeters);
}

public sealed record TractShape(string Name, TractAreaFunction AreaFunction);

public enum AcousticSourceKind
{
    Glottal,
    Labial,
    Reed,
    TurbulenceJet,
    Click,
    Synthetic
}

public enum AcousticSourceModel
{
    Default,
    Legacy,
    TissueValve
}

public enum AcousticValveLaw
{
    OneMass,
    TwoMass,
    BodyCover
}

public enum AcousticBranchKind
{
    SideBranch,
    Nasal,
    Bronchial,
    Lateral,
    Resonator
}

public enum AcousticRadiationKind
{
    Lip,
    Nostril,
    Beak,
    Vent,
    Membrane
}

public enum AcousticLossModel
{
    Custom,
    None,
    Viscous,
    Birkholz2024,
    Wall
}

public enum AcousticRadiationModel
{
    SimpleReflection,
    LipPiston,
    Beak,
    Nostril,
    Wall
}

public enum WaveClockDelayStrategy
{
    UnitGrid,
    HalfSampleGrid,
    FractionalLinear,
    FractionalLagrange,
    FractionalThiran,
    CrossfadedVariable
}

public enum AcousticTerminalKind
{
    Junction,
    Source,
    Radiation,
    Contact,
    Open,
    Closed,
    Probe
}

public enum AcousticConnectionLaw
{
    AreaScattering,
    PressureContinuity,
    AdmittanceScattering,
    Lossy,
    Bypass
}

public sealed record AcousticPath(
    string Name,
    TractAreaFunction AreaFunction,
    float PropagationSpeedMetersPerSecond = 343,
    float Loss = 0.999f,
    AcousticAreaControl? AreaControl = null,
    string AreaCurve = "",
    AcousticLossModel LossModel = AcousticLossModel.Custom);

public sealed record AcousticAreaCurve(string Name, TractAreaFunction AreaFunction);

public sealed record AcousticAreaControl(
    float TongueIndex = 12.9f,
    float TongueDiameter = 2.43f,
    float TongueWidth = 0.18f,
    float ConstrictionIndex = 32,
    float ConstrictionDiameter = 1,
    float ConstrictionWidth = 0.09f,
    float LipOpening = 1.5f,
    float LipWidth = 0.04f,
    float IndexScale = 1);

public sealed record AcousticSourcePort(
    string Name,
    string Path,
    float Position = 0,
    AcousticSourceKind Kind = AcousticSourceKind.Glottal,
    float Pressure = 0.72f,
    float Tension = 0.6f,
    float Opening = 0.5f,
    float Noise = 0.08f,
    float Transient = 0,
    float Balance = 1,
    bool Active = true,
    AcousticSourcePositionControl? PositionControl = null,
    float Impedance = 0.35f,
    AcousticSourceModel Model = AcousticSourceModel.Default,
    float Mass = 0.35f,
    float Damping = 0.18f,
    float Stiffness = 0,
    float Saturation = 0.8f,
    float Drive = 1,
    float FlowScale = 1,
    float TissueLoss = 0.12f,
    float ApertureShape = 0.35f,
    float FlowLoss = 0.35f,
    float LoadCoupling = 0.35f,
    float RestOpening = 0.02f,
    AcousticValveLaw Law = AcousticValveLaw.OneMass,
    float UpperMass = 0.20f,
    float LowerMass = 0.35f,
    float UpperStiffness = 0,
    float LowerStiffness = 0,
    float CouplingStiffness = 0.08f,
    float CollisionStiffness = 0.6f,
    float CollisionDamping = 0.15f,
    float VerticalPhase = 0.18f,
    float ReservoirPressure = 1,
    float DownstreamPressure = 0);

public sealed record AcousticSourcePositionControl(
    float Index = 0,
    float Width = 1,
    float IndexScale = 1);

public sealed record AcousticBranch(
    string Name,
    string FromPath,
    float FromPosition,
    string ToPath,
    float ToPosition = 0,
    AcousticBranchKind Kind = AcousticBranchKind.SideBranch,
    float Opening = 0,
    float Coupling = 1,
    bool Passive = true);

public sealed record AcousticRadiationPort(
    string Name,
    string Path,
    float Position = 1,
    AcousticRadiationKind Kind = AcousticRadiationKind.Lip,
    float Opening = 1,
    float Reflection = -0.85f,
    float Loss = 1,
    AcousticRadiationModel Model = AcousticRadiationModel.SimpleReflection);

public sealed record AcousticTerminal(
    string Name,
    string Path,
    float Position,
    AcousticTerminalKind Kind = AcousticTerminalKind.Junction,
    string Port = "",
    float AreaScale = 1,
    float Reflection = 0);

public sealed record AcousticConnection(
    string Name,
    IReadOnlyList<string>? Terminals = null,
    AcousticConnectionLaw Law = AcousticConnectionLaw.AreaScattering,
    float Coupling = 1,
    float Loss = 1)
{
    public IReadOnlyList<string> Terminals { get; init; } = Terminals ?? Array.Empty<string>();
}

public sealed record WaveClockPolicy(
    string Name,
    WaveClockDelayStrategy Strategy = WaveClockDelayStrategy.UnitGrid,
    int FractionalOrder = 1,
    int MaxDelaySamples = 2048,
    float SmoothingMilliseconds = 5);

public sealed record AcousticPortNetwork(
    string Name,
    string PrimaryPath,
    string WaveClock = "",
    IReadOnlyList<string>? SourcePorts = null,
    IReadOnlyList<string>? Branches = null,
    IReadOnlyList<string>? RadiationPorts = null,
    IReadOnlyList<string>? Terminals = null,
    IReadOnlyList<string>? Connections = null)
{
    public IReadOnlyList<string> SourcePorts { get; init; } = SourcePorts ?? Array.Empty<string>();
    public IReadOnlyList<string> Branches { get; init; } = Branches ?? Array.Empty<string>();
    public IReadOnlyList<string> RadiationPorts { get; init; } = RadiationPorts ?? Array.Empty<string>();
    public IReadOnlyList<string> Terminals { get; init; } = Terminals ?? Array.Empty<string>();
    public IReadOnlyList<string> Connections { get; init; } = Connections ?? Array.Empty<string>();
}

public sealed record AreaFunction(
    string Name,
    TractAreaFunction Shape,
    AcousticAreaControl? Deformation = null,
    int EmitSections = 8);

public sealed record WaveguidePath(
    string Name,
    string AreaFunction,
    float PropagationSpeedMetersPerSecond = 343,
    WaveClockDelayStrategy DelayStrategy = WaveClockDelayStrategy.FractionalThiran,
    int DelayOrder = 1,
    int MaxDelaySamples = 4096,
    float Loss = 0.999f);

public sealed record SourcePort(
    string Name,
    string Path,
    float Position = 0,
    AcousticSourceKind Kind = AcousticSourceKind.Glottal,
    float Pressure = 0.72f,
    float Tension = 0.6f,
    float Opening = 0.5f,
    float Noise = 0.08f,
    float Impedance = 0.35f,
    float FlowScale = 0.02f);

public sealed record ConstrictionContact(
    string Name,
    string Path,
    float Position = 0.5f,
    float Opening = 1,
    float Resistance = 0.35f,
    float StoredPressure = 0,
    float ReleaseFlow = 0);

public sealed record BranchPort(
    string Name,
    string FromPath,
    float FromPosition,
    string ToPath,
    float ToPosition = 0,
    float Opening = 0,
    float Coupling = 1);

public sealed record RadiationLoad(
    string Name,
    string Path,
    float Position = 1,
    AcousticRadiationKind Kind = AcousticRadiationKind.Lip,
    float Aperture = 1,
    float Reflection = -0.85f,
    float Impedance = 0.35f);

public sealed record ProbeTimeline(string Name, IReadOnlyList<string>? Networks = null, int BlockSize = 64, int Blocks = 16)
{
    public IReadOnlyList<string> Networks { get; init; } = Networks ?? Array.Empty<string>();
}

public sealed record ControlSurface(
    string Path,
    string FieldPath,
    string Owner,
    string Field,
    float DefaultNormalized,
    float MinValue,
    float MaxValue,
    string Label = "",
    string Unit = "",
    string AutomationRate = "control");

public enum ControlSplineInterpolation
{
    Linear,
    Hold,
    Bezier
}

public sealed record ControlSplinePoint(
    float TimeSeconds,
    float Value,
    float OutTimeOffsetSeconds = 0,
    float OutValue = 0,
    float InTimeOffsetSeconds = 0,
    float InValue = 0);

public sealed record ControlSpline(
    string Name,
    string SurfacePath,
    IReadOnlyList<ControlSplinePoint> Points,
    ControlSplineInterpolation Interpolation = ControlSplineInterpolation.Bezier,
    bool Loop = false,
    bool Enabled = true)
{
    public IReadOnlyList<ControlSplinePoint> Points { get; init; } = Points ?? Array.Empty<ControlSplinePoint>();
}

public sealed record PhonemeGesture(
    string Name,
    string Ipa,
    string Descriptor,
    float StartSeconds,
    float DurationSeconds,
    float Intensity = 1);

public sealed record VocalNetwork(
    string Name,
    IReadOnlyList<string>? Paths = null,
    IReadOnlyList<string>? Sources = null,
    IReadOnlyList<string>? Contacts = null,
    IReadOnlyList<string>? Branches = null,
    IReadOnlyList<string>? Radiation = null,
    string ProbeTimeline = "")
{
    public IReadOnlyList<string> Paths { get; init; } = Paths ?? Array.Empty<string>();
    public IReadOnlyList<string> Sources { get; init; } = Sources ?? Array.Empty<string>();
    public IReadOnlyList<string> Contacts { get; init; } = Contacts ?? Array.Empty<string>();
    public IReadOnlyList<string> Branches { get; init; } = Branches ?? Array.Empty<string>();
    public IReadOnlyList<string> Radiation { get; init; } = Radiation ?? Array.Empty<string>();
}

public sealed record GlottalSource(
    string Name = "",
    float Intensity = 0.72f,
    float Tenseness = 0.6f,
    float Aspiration = 0.08f,
    float Reflection = 0.75f,
    float Skew = 0.42f);

public sealed record TractInjection(
    string Name = "",
    float Position = 32,
    float Diameter = 1,
    float Turbulence = 0,
    float Burst = 0,
    float Width = 1);

public enum TractPropagationMode
{
    Graph
}

public sealed record NasalBranch(
    string Name = "",
    TractAreaFunction? AreaFunction = null,
    int JunctionIndex = 17,
    float Velum = 0.01f,
    float Reflection = -0.85f,
    float Loss = 0.999f);

public sealed record TractMotion(
    string Name = "",
    float DiameterSlewPerSecond = 18,
    float ShapeReturnPerSecond = 8,
    float ConstrictionSlewPerSecond = 24,
    float VelumSlewPerSecond = 16,
    float ObstructionThreshold = 0.05f);

public sealed record Modulator(
    ModTarget Target,
    ModWaveform Waveform = ModWaveform.Sine,
    float FrequencyHz = 1,
    float Depth = 0,
    float Phase = 0,
    float Bias = 0);

public sealed record ControlLane(string Name, Modulator Modulator);

public sealed record OperatorNode(
    int Id,
    float Ratio = 1,
    float Level = 1,
    float Feedback = 0,
    Note Note = null!,
    Envelope Envelope = null!,
    RateLevelEnvelope? RateLevelEnvelope = null)
{
    public Note Note { get; init; } = Note ?? new();
    public Envelope Envelope { get; init; } = Envelope ?? new();
}

public sealed record OperatorEdge(int SourceId, int TargetId, float Index = 1);

public sealed record OperatorGraph(
    string Name,
    float FrequencyHz,
    IReadOnlyList<OperatorNode> Operators,
    IReadOnlyList<OperatorEdge> Edges,
    IReadOnlyList<int> Carriers,
    Note Note = null!,
    float Gain = 0.2f,
    float VibratoDepth = 0,
    float VibratoHz = 0,
    float VibratoDelaySeconds = 0)
{
    public Note Note { get; init; } = Note ?? new();
}

public sealed record VocalTract(
    int Sections = 44,
    int NoseSections = 28,
    float Intensity = 0.72f,
    float Tenseness = 0.6f,
    float TongueIndex = 12.9f,
    float TongueDiameter = 2.43f,
    float Velum = 0.01f,
    float ConstrictionIndex = 32,
    float ConstrictionDiameter = 1,
    float Turbulence = 0,
    float LipOpening = 1.5f,
    float GlottalReflection = 0.75f,
    float LipReflection = -0.85f,
    TractAreaFunction? AreaFunction = null,
    GlottalSource? Glottis = null,
    TractInjection? Injection = null,
    NasalBranch? Nasal = null,
    TractMotion? Motion = null,
    TractPropagationMode Propagation = TractPropagationMode.Graph,
    float PropagationLoss = 0.999f,
    float IndexScale = 1,
    AcousticPortNetwork? AcousticNetwork = null,
    VocalNetwork? VocalNetwork = null);

public sealed record PatchParameter(
    string Path,
    string Label,
    float Default,
    float Min,
    float Max,
    float Step,
    string Unit = "",
    string AutomationRate = "control",
    string Notes = "");

public enum ControlCurveMode
{
    Blend,
    Add
}

public enum ControlCurveInterpolation
{
    Linear,
    Hold,
    Smooth
}

public sealed record ControlCurvePoint(float TimeSeconds, float Value);

public sealed record ControlCurve(
    string Name,
    string ParameterPath,
    IReadOnlyList<ControlCurvePoint> Points,
    ControlCurveMode Mode = ControlCurveMode.Blend,
    ControlCurveInterpolation Interpolation = ControlCurveInterpolation.Linear,
    float Depth = 1,
    float TimeScale = 1,
    float TimeOffsetSeconds = 0,
    bool Loop = false,
    string AutomationRate = "control")
{
    public IReadOnlyList<ControlCurvePoint> Points { get; init; } = Points ?? Array.Empty<ControlCurvePoint>();
}

public sealed record GestureGroup(
    string Name,
    IReadOnlyList<string> Curves,
    float Depth = 1,
    bool Enabled = true)
{
    public IReadOnlyList<string> Curves { get; init; } = Curves ?? Array.Empty<string>();
}

public enum ParameterBindingTransform
{
    Identity,
    Square
}

public sealed record ParameterBinding(
    string FieldPath,
    string ParameterPath,
    ParameterBindingTransform Transform = ParameterBindingTransform.Identity,
    float Scale = 1);

public sealed record ReferenceSource(
    string Kind,
    string Uri,
    string License,
    string Hash,
    string Notes = "");

public sealed record ReferenceFeature(string Name, string Value, string Notes = "");

public sealed record PatchLayer(
    string Name,
    string Engine = "",
    int? MinKey = null,
    int? MaxKey = null,
    float Gain = 1,
    string EffectSend = "");

public sealed record HarmonicPartial(float Ratio, float Gain);

public sealed record HarmonicBank(
    string LayerName,
    float RootFrequencyHz,
    IReadOnlyList<HarmonicPartial> Partials);

public enum PadSpectrumMode
{
    Generic,
    Bandwidth,
    Discrete,
    Continuous
}

public enum PadProfileBaseType
{
    Gaussian = 0,
    Square = 1,
    DoubleExponential = 2
}

public enum PadProfileAmplitudeType
{
    Off = 0,
    Gaussian = 1,
    Sine = 2,
    Flat = 3
}

public enum PadProfileAmplitudeMode
{
    Sum = 0,
    Mult = 1,
    Div1 = 2,
    Div2 = 3
}

public enum PadProfileHalf
{
    Full = 0,
    Upper = 1,
    Lower = 2
}

public enum PadHarmonicPositionType
{
    Harmonic = 0,
    ShiftUp = 1,
    ShiftDown = 2,
    PowerUp = 3,
    PowerDown = 4,
    Sine = 5,
    Power = 6,
    Shift = 7
}

public sealed record PadHarmonicProfile(
    PadProfileBaseType BaseType = PadProfileBaseType.Gaussian,
    int BaseParameter = 80,
    int FrequencyMultiplier = 0,
    int ModulatorParameter = 0,
    int ModulatorFrequency = 30,
    int Width = 127,
    PadProfileAmplitudeType AmplitudeType = PadProfileAmplitudeType.Off,
    PadProfileAmplitudeMode AmplitudeMode = PadProfileAmplitudeMode.Sum,
    int AmplitudeParameter1 = 80,
    int AmplitudeParameter2 = 64,
    bool AutoScale = true,
    PadProfileHalf Half = PadProfileHalf.Full);

public sealed record PadHarmonicPosition(
    PadHarmonicPositionType Type = PadHarmonicPositionType.Harmonic,
    int Parameter1 = 0,
    int Parameter2 = 0,
    int Parameter3 = 0);

public sealed record PadSpectrumProfile(
    PadSpectrumMode Mode = PadSpectrumMode.Generic,
    int Bandwidth = 500,
    int BandwidthScale = 0,
    PadHarmonicProfile HarmonicProfile = null!,
    PadHarmonicPosition HarmonicPosition = null!)
{
    public static PadSpectrumProfile Generic { get; } = new();

    public PadHarmonicProfile HarmonicProfile { get; init; } = HarmonicProfile ?? new();

    public PadHarmonicPosition HarmonicPosition { get; init; } = HarmonicPosition ?? new();
}

public sealed record SpectralBank(
    string LayerName,
    float RootFrequencyHz,
    float SpreadRatio,
    IReadOnlyList<HarmonicPartial> Partials,
    Voice Treatment,
    PadSpectrumProfile Profile = null!)
{
    public PadSpectrumProfile Profile { get; init; } = Profile ?? PadSpectrumProfile.Generic;
}

public sealed record ReferencePatch(
    string Id,
    string Family,
    string Name,
    ReferenceSource Source,
    IReadOnlyList<ReferenceFeature> Features,
    IReadOnlyList<PatchParameter> Parameters,
    string? AquaSynthScript = null);

public sealed record Repeat(float IntervalSeconds);

public sealed record Voice
{
    public PatchLayer? Layer { get; init; }
    public Oscillator Oscillator { get; init; } = new();
    public Note Note { get; init; } = new();
    public Envelope Envelope { get; init; } = new();
    public RateLevelEnvelope? RateLevelEnvelope { get; init; }
    public PitchMotion Pitch { get; init; } = new();
    public DutyMotion Duty { get; init; } = new();
    public Filter Filter { get; init; } = new();
    public Phaser Phaser { get; init; } = new();
    public Arpeggio? Arpeggio { get; init; }
    public FrequencyModulation Fm { get; init; } = new();
    public VocalTract? Tract { get; init; }
    public AcousticPortNetwork? AcousticNetwork { get; init; }
    public VocalNetwork? VocalNetwork { get; init; }
    public VoiceColor Color { get; init; } = new();
    public IReadOnlyList<Formant> Formants { get; init; } = Array.Empty<Formant>();
    public IReadOnlyList<FormantFrame> FormantFrames { get; init; } = Array.Empty<FormantFrame>();
    public float FormantFrameRateHz { get; init; } = 0.5f;
    public IReadOnlyList<Modulator> Modulators { get; init; } = Array.Empty<Modulator>();
    public float Gain { get; init; } = 0.2f;
}

public sealed record SynthPatch
{
    public IReadOnlyList<Voice> Voices { get; init; } = Array.Empty<Voice>();
    public IReadOnlyList<PatchLayer> Layers { get; init; } = Array.Empty<PatchLayer>();
    public IReadOnlyList<HarmonicBank> HarmonicBanks { get; init; } = Array.Empty<HarmonicBank>();
    public IReadOnlyList<SpectralBank> SpectralBanks { get; init; } = Array.Empty<SpectralBank>();
    public IReadOnlyList<TractShape> TractShapes { get; init; } = Array.Empty<TractShape>();
    public IReadOnlyList<GlottalSource> GlottalSources { get; init; } = Array.Empty<GlottalSource>();
    public IReadOnlyList<TractInjection> TractInjections { get; init; } = Array.Empty<TractInjection>();
    public IReadOnlyList<NasalBranch> NasalBranches { get; init; } = Array.Empty<NasalBranch>();
    public IReadOnlyList<TractMotion> TractMotions { get; init; } = Array.Empty<TractMotion>();
    public IReadOnlyList<AcousticAreaCurve> AcousticAreaCurves { get; init; } = Array.Empty<AcousticAreaCurve>();
    public IReadOnlyList<AcousticPath> AcousticPaths { get; init; } = Array.Empty<AcousticPath>();
    public IReadOnlyList<AcousticSourcePort> AcousticSourcePorts { get; init; } = Array.Empty<AcousticSourcePort>();
    public IReadOnlyList<AcousticBranch> AcousticBranches { get; init; } = Array.Empty<AcousticBranch>();
    public IReadOnlyList<AcousticRadiationPort> AcousticRadiationPorts { get; init; } = Array.Empty<AcousticRadiationPort>();
    public IReadOnlyList<AcousticTerminal> AcousticTerminals { get; init; } = Array.Empty<AcousticTerminal>();
    public IReadOnlyList<AcousticConnection> AcousticConnections { get; init; } = Array.Empty<AcousticConnection>();
    public IReadOnlyList<WaveClockPolicy> WaveClocks { get; init; } = Array.Empty<WaveClockPolicy>();
    public IReadOnlyList<AcousticPortNetwork> AcousticNetworks { get; init; } = Array.Empty<AcousticPortNetwork>();
    public IReadOnlyList<AreaFunction> AreaFunctions { get; init; } = Array.Empty<AreaFunction>();
    public IReadOnlyList<WaveguidePath> WaveguidePaths { get; init; } = Array.Empty<WaveguidePath>();
    public IReadOnlyList<SourcePort> SourcePorts { get; init; } = Array.Empty<SourcePort>();
    public IReadOnlyList<ConstrictionContact> ConstrictionContacts { get; init; } = Array.Empty<ConstrictionContact>();
    public IReadOnlyList<BranchPort> BranchPorts { get; init; } = Array.Empty<BranchPort>();
    public IReadOnlyList<RadiationLoad> RadiationLoads { get; init; } = Array.Empty<RadiationLoad>();
    public IReadOnlyList<ProbeTimeline> ProbeTimelines { get; init; } = Array.Empty<ProbeTimeline>();
    public IReadOnlyList<VocalNetwork> VocalNetworks { get; init; } = Array.Empty<VocalNetwork>();
    public IReadOnlyList<OperatorGraph> OperatorGraphs { get; init; } = Array.Empty<OperatorGraph>();
    public IReadOnlyList<ControlLane> Controls { get; init; } = Array.Empty<ControlLane>();
    public IReadOnlyList<PatchParameter> Parameters { get; init; } = Array.Empty<PatchParameter>();
    public IReadOnlyList<ControlCurve> ControlCurves { get; init; } = Array.Empty<ControlCurve>();
    public IReadOnlyList<ControlSurface> ControlSurfaces { get; init; } = Array.Empty<ControlSurface>();
    public IReadOnlyList<ControlSpline> ControlSplines { get; init; } = Array.Empty<ControlSpline>();
    public IReadOnlyList<PhonemeGesture> PhonemeGestures { get; init; } = Array.Empty<PhonemeGesture>();
    public IReadOnlyList<GestureGroup> GestureGroups { get; init; } = Array.Empty<GestureGroup>();
    public IReadOnlyList<ParameterBinding> ParameterBindings { get; init; } = Array.Empty<ParameterBinding>();
    public Playback Playback { get; init; } = new();
    public Repeat? Repeat { get; init; }
    public float Gain { get; init; } = 1;
    public bool SoftClip { get; init; } = true;
}