/**
 * Copyright (c) 2026 Dominic Masters
 *
 * This software is released under the MIT License.
 * https://opensource.org/licenses/MIT
 */

/** Controls over the engine main loop. */
interface EngineNamespace {
  /**
   * Whether the engine main loop is still running.
   * Becomes `false` after `Engine.exit()` is called.
   */
  readonly running: boolean;

  /**
   * Requests an orderly shutdown. Sets `running` to `false`; the main loop
   * exits at the end of the current tick.
   */
  exit(): void;
}

/** Engine lifecycle controls. */
declare var Engine: EngineNamespace;