You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
2 weeks ago | |
|---|---|---|
| .. | ||
| LICENSE | 2 weeks ago | |
| README.md | 2 weeks ago | |
| package.json | 2 weeks ago | |
README.md
@inquirer/ansi
A lightweight package providing ANSI escape sequences for terminal cursor manipulation and screen clearing.
Installation
| npm | yarn |
|---|---|
|
|
Usage
import {
cursorUp,
cursorDown,
cursorTo,
cursorLeft,
cursorHide,
cursorShow,
eraseLines,
} from '@inquirer/ansi';
// Move cursor up 3 lines
process.stdout.write(cursorUp(3));
// Move cursor to specific position (x: 10, y: 5)
process.stdout.write(cursorTo(10, 5));
// Hide/show cursor
process.stdout.write(cursorHide);
process.stdout.write(cursorShow);
// Clear 5 lines
process.stdout.write(eraseLines(5));
Or when used inside an inquirer prompt:
import { cursorHide } from '@inquirer/ansi';
import { createPrompt } from '@inquirer/core';
export default createPrompt((config, done: (value: void) => void) => {
return `Choose an option${cursorHide}`;
});
API
Cursor Movement
cursorUp(count?: number)- Move cursor up bycountlines (default: 1)cursorDown(count?: number)- Move cursor down bycountlines (default: 1)cursorTo(x: number, y?: number)- Move cursor to position (x, y). If y is omitted, only moves horizontallycursorLeft- Move cursor to beginning of line
Cursor Visibility
cursorHide- Hide the cursorcursorShow- Show the cursor
Screen Manipulation
eraseLines(count: number)- Clearcountlines and position cursor at the beginning of the first cleared line
License
Copyright (c) 2025 Simon Boudrias (twitter: @vaxilart)
Licensed under the MIT license.