php-kilo/src/ANSI.php

<?php declare(strict_types=1);

namespace Aviat\Kilo;

/**
 * ANSI
 */
class ANSI {
	// ------------------------------------------------------------------------
	// General ANSI standard escape sequences
	// ------------------------------------------------------------------------

	/**
	 * Clear the terminal window
	 */
	public const CLEAR_SCREEN = "\e[2J";

	/**
	 * Clear the terminal line
	 */
	public const CLEAR_LINE = "\e[K";

	// ------------------------------------------------------------------------
	// Text formatting escape sequences
	// ------------------------------------------------------------------------

	/**
	 * Removes text attributes, such as bold, underline, blink, inverted colors
	 */
	public const RESET_TEXT = "\e[0m";

	public const BOLD_TEXT = "\e[1m";

	public const UNDERLINE_TEXT = "\e[4m";

	/**
	 * Move the cursor to position 0,0 which is the top left
	 */
	public const RESET_CURSOR = "\e[H";

	// ------------------------------------------------------------------------
	// VT-series escapes, not really ANSI standard
	// ------------------------------------------------------------------------

	public const HIDE_CURSOR = "\e[?25l";
	public const SHOW_CURSOR = "\e[?25h";

	/**
	 * Generate the ascii sequence for basic text color
	 *
	 * @param int $color
	 * @return string
	 */
	public static function color(int $color): string
	{
		return self::escapeSequence('%dm', $color);
	}

	/**
	 * Generate a sequence for an rgb color
	 *
	 * @param int $r
	 * @param int $g
	 * @param int $b
	 * @return string
	 */
	public static function rgbColor(int $r, int $g, int $b): string
	{
		return self::escapeSequence('38;2;%d;%d;%dm', $r, $g, $b);
	}

	/**
	 * Move the cursor the specified position
	 *
	 * @param int $line
	 * @param int $column
	 * @return string
	 */
	public static function moveCursor(int $line, int $column): string
	{
		// The terminal has a 1-based coordinate system,
		// add one to each to allow 0-based coordinate system input
		return self::escapeSequence('%d;%dH', $line + 1, $column + 1);
	}

	/**
	 * Scroll the specified number of lines up
	 *
	 * @param int $lines
	 * @return string
	 */
	public static function scrollUp(int $lines): string
	{
		return self::escapeSequence('%dS', $lines);
	}

	/**
	 * Scroll the specified number of lines down
	 *
	 * @param int $lines
	 * @return string
	 */
	public static function scrollDown(int $lines): string
	{
		return self::escapeSequence('%dT', $lines);
	}

	/**
	 * Simplify creating ansi escape codes
	 *
	 * @param string $pattern
	 * @param mixed ...$args
	 * @return string
	 */
	private static function escapeSequence(string $pattern, mixed ...$args): string
	{
		return sprintf("\e[{$pattern}", ...$args);
	}
}