Mod

data class Checkbox(val name: String, val label: String, val description: String, val defaultValue: Boolean = false,
    /** Pour un avertissement importé : visible tant qu'il reste à acquitter. */
    val onlyWhenEnabled: Boolean = false)

data class SignalType(
    val id: String,
    val title: String,
    val textureSet: String,
    val checkboxes: List<Checkbox> = emptyList(),
    /** Demande l'observation du premier train orienté vers ce signal.
     * Ne constitue pas une réservation ni une autorisation de mouvement. */
    val observeApproach: Boolean = false,
    val actions: List<SignalAction> = emptyList()
)

enum class Occupancy {
Unknown, Clear, Occupied
}

enum class SettingsStatus {
Unavailable, Absent, Present
}

data class Observation(
    val block: Occupancy = Occupancy.Unknown, val fresh: Boolean = false,
    val routeKnown: Boolean = false, val forcedStop: Boolean = false,
    val lampFailed: Boolean = false, val redFlashCondition: Boolean = false, val next: Int = 0,
    val approachingTrain: Long? = null
)

data class Decision(val aspect: Int, val reason: Int)

data class Signal(
    val id: Long = 0, val nextSignal: Long = 0, val settings: Map<String, Boolean> = emptyMap(),
    val observation: Observation = Observation(), val settingsStatus: SettingsStatus = SettingsStatus.Present,
    /** Identifiant de SignalType, fourni par le SDK à partir du catalogue observé. */
    val type: String = ""
)

data class Vehicle(
    val maxSpeedMps: Double = 0.0, val maxAccelerationMps2: Double = 0.0,
    val serviceBrakingMps2: Double = 0.0, val tractiveEffortN: Double = 0.0,
    val powerW: Double = 0.0, val emptyMassKg: Double = 0.0,
    val extraMassKg: Double = 0.0, val lengthM: Double = 0.0
)

data class DrivingSettings(val brakeUse: Double = 0.8, val responseSeconds: Double = 2.0, val marginM: Double = 10.0)

data class Constraint(val source: Long, val beginM: Double, val endM: Double, val speedMps: Double, val releaseByRear: Boolean = true)

data class DrivingInput(
    val headM: Double = 0.0, val speedMps: Double = 0.0, val lineSpeedMps: Double = 0.0,
    val fresh: Boolean = false, val routeKnown: Boolean = false,
    val onSight: Boolean = false, val visibleClearM: Double? = null
)

data class DrivingPlan(
    val available: Boolean = false, val speedCeilingMps: Double = 0.0,
    val serviceDecelerationMps2: Double = 0.0, val accelerationMps2: Double = 0.0,
    val brakingRequired: Boolean = false, val limitingSource: Long = 0
)

enum class DrivingFlag(val bit: Int) {
Clear(1), HoldToClear(2), Stop(4), FollowTarget(8), OnSight(16), StopThenProceed(32), CancelAtNextClear(64),
    /** Passage permis selon la vitesse memorisee
}

data class DrivingRule(
    val speedMps: Double = -1.0, val reopenedSpeedMps: Double = 0.0,
    val signalsAhead: Int = 0, val flags: Set<DrivingFlag> = emptySet()
)

abstract class SignallingMod : GameMod()

open val textureSet: String = ""

open val checkboxes: List<Checkbox> = emptyList()

open val signalTypes: List<SignalType> get() = listOf(SignalType(id, title, textureSet, checkboxes))

open fun migrateSettings(type: String, saved: Map<String, Boolean>): Map<String, Boolean> = saved

open val maximumLineSpeed = false

open val diagnosticFile: String = "nimby-kotlin-faults.jsonl"

abstract val unknownDecision: Decision

abstract val invalidNetworkDecision: Decision

open val modelLocalIndications: Boolean = false

open fun unknownDecision(type: String): Decision = unknownDecision

open fun invalidNetworkDecision(type: String): Decision = invalidNetworkDecision

open fun indication(decision: Decision): SignalIndication? = null

abstract fun evaluate(settings: Map<String, Boolean>, observation: Observation): Decision

open fun evaluate(type: String, settings: Map<String, Boolean>, observation: Observation): Decision =

abstract fun decide(signal: Signal, next: Decision?): Decision?

open fun fromLive(signal: Signal): Signal = signal

abstract fun texture(decision: Decision, simulationMs: Long, halfPeriodMs: Long): String

open fun forcedDecision(aspect: Int): Decision? = null

open fun forcedDecision(type: String, aspect: Int): Decision? = forcedDecision(aspect)

abstract fun drivingRule(decision: Decision): DrivingRule?

abstract fun isFault(decision: Decision): Boolean

open fun isActive(decision: Decision): Boolean = true

open fun aspectName(aspect: Int): String = aspect.toString()

abstract fun reasonName(reason: Int): String

open fun plan(vehicle: Vehicle, settings: DrivingSettings, input: DrivingInput, constraints: List<Constraint>) = DrivingPlan()

fun SignallingMod.evaluateNetwork(input: List<Signal>): List<Decision>