Class StaticLine

cli/unstable_static_line.ts:45–158

 * ```
 */
export class StaticLine {
  #id = ++nextID;
  #atTop: boolean;
  #lines: number[];
  #released = false;
  /**
   * Constructs a new instance.
   *
   * @param on What side of the terminal the line should be on.
   */
  constructor(on: "top" | "bottom" = "bottom") {
    this.#atTop = on === "top";
    this.#lines = this.#atTop ? linesAtTop : linesAtBottom;
    this.#lines.push(this.#id);
    const top = linesAtTop.length + 1;
    const bottom = getRows() - linesAtBottom.length;
    write(
      (this.#atTop ? "" : Ansi.shiftUpAndInsert()) +
        Ansi.setScrollableRegion(top, bottom) +
        Ansi.setCursorPosition(bottom),
    );
  }

  /**
   * Overwrites the contents of the line.
   *
   * @param line The new content to write.
   * @returns A promise that resolves when the line is written.
   *
   * @example Usage
   * ```ts ignore
   * import { delay } from "@std/async/delay";
   * import { StaticLine } from "@std/cli/unstable-static-line";
   *
   * const id = setInterval(() => console.log(Math.random()), 1000);
   *
   * const line = new StaticLine();
   * await line.write("Hello World!");
   * await delay(1500);
   * await line.write("How are you?");
   * await delay(1500);
   * await line.write("Doing good?");
   * await delay(1500);
   * await line.releaseLine();
   * ```
   */
  async write(line: string): Promise<void> {
    if (this.#released) throw new ReferenceError("Line has been released");
    await write(
      Ansi.SAVE_CURSOR +
        Ansi.DISABLE_ORIGIN_MODE +
        Ansi.DISABLE_AUTO_WRAP +
        Ansi.setCursorPosition(
          this.#atTop
            ? linesAtTop.indexOf(this.#id) + 1
            : getRows() - linesAtBottom.indexOf(this.#id),
        ) +
        Ansi.ERASE_LINE +