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

/**
 * Read-only information about the current display surface.
 */
interface ScreenNamespace {
  /** Current render-target width in pixels (read-only). */
  readonly width: number;

  /** Current render-target height in pixels (read-only). */
  readonly height: number;

  /**
   * Aspect ratio of the current render target: `width / height` (read-only).
   *
   * @example
   * if (Screen.aspect > 1) { /* landscape *\/ }
   */
  readonly aspect: number;
}

/** Current display / render-target dimensions. */
declare var Screen: ScreenNamespace;