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

/**
 * Runtime platform detection and system-level information.
 */
interface SystemNamespace {
  /**
   * Numeric identifier for the platform the engine is running on (read-only).
   * Compare against the `System.PLATFORM_*` constants.
   *
   * @example
   * if (System.platform === System.PLATFORM_PSP) { useLowResAssets(); }
   */
  readonly platform: number;

  /** Linux desktop. */
  readonly PLATFORM_LINUX: number;

  /** Knulli handheld (Linux-based). */
  readonly PLATFORM_KNULLI: number;

  /** Sony PlayStation Portable. */
  readonly PLATFORM_PSP: number;

  /** Nintendo GameCube. */
  readonly PLATFORM_GAMECUBE: number;

  /** Nintendo Wii. */
  readonly PLATFORM_WII: number;
}

/** Platform detection and system-level information. */
declare var System: SystemNamespace;