/**
 Contains specialized functions that execute fatal errors that terminate the program and print the message to the console.
 */
internal struct FatalError {
  /**
   Signals that a function or one of its case is not implemented (intentionally or not).
   */
  internal static func unimplemented() -> Never {
    fatalError("Unimplemented")
  }

  /**
   Stops program execution when the JS runtime is not available but required to proceed.
   */
  internal static func runtimeLost() -> Never {
    fatalError("The JavaScript runtime has been deallocated")
  }

  /**
   Stops program execution when trying to access buffer's elements out of its range.
   */
  internal static func valuesBufferIndexOutRange(index: Int, capacity: Int) -> Never {
    fatalError("Index \(index) is out of range of values buffer capacity \(capacity), valid range is 0..<\(capacity)")
  }

  /**
   Stops program execution when trying to represent a `JavaScriptValuesBuffer` as a single JS value.
   */
  internal static func valuesBufferNotRepresentable() -> Never {
    fatalError("JavaScript values buffer cannot be represented as a single value")
  }

  /**
   Stops program execution when the Swift setter trampoline runs for a host object that
   was created with `set: nil`. The C++ `HostObjectCallbacks::set` is supposed to throw a
   `jsi::JSError` for read-only host objects without re-entering Swift, so reaching this
   means that contract has drifted — check its null-setter short-circuit.
   */
  internal static func readOnlyHostObjectSetterInvoked() -> Never {
    fatalError(
      "createHostObject setter trampoline ran despite set: nil — HostObjectCallbacks::set should throw a jsi::JSError for read-only host objects without re-entering Swift. "
      + "Check that its null-setter short-circuit is still in place."
    )
  }
}