bombshell-dev/clack
Clack
Clack is a Node.js CLI framework and prompt library designed for building stylized, interactive command-line user interfaces. It provides a toolkit for creating terminal applications that collect structured user input and display formatted information.
The library includes a set of interactive terminal UI components, such as validated input fields for text and passwords, searchable selection menus with autocomplete, and grouped options for user choice. It also provides mechanisms for process visualization, including loading spinners, progress bars, and sequential task lists to communicate background activity.
The framework covers terminal user interface design through the use of boxed text, notes, and structured layouts to improve readability. These capabilities are supported by an architecture that handles ANSI-based rendering and asynchronous input collection.
Features
- Interactive CLI Prompts - Provides a comprehensive library of interactive CLI prompts for collecting structured user input.
- Interactive Menus - Ships interactive selection menus featuring searchable autocomplete and grouped options for user choice.
- Interactive Terminal Menus - Implements searchable selection menus and autocomplete lists for choosing options in terminal applications.
- Screen Buffers - Uses screen buffers to accumulate UI changes in memory and prevent flickering during terminal updates.
- Interactive CLI Tooling - Offers a framework for building command-line tools with stylized interfaces and real-time updates.
- Terminal Interaction - Provides a kit of terminal interaction components including spinners, progress bars, and structured text blocks.
- Input Event Loops - Employs a non-blocking input event loop to capture raw keystrokes for immediate UI responsiveness.
- Interactive Input Collection - Provides validated forms and interactive prompts for collecting text, passwords, and file paths.
- ANSI Escape Sequence Renderers - Implements ANSI escape sequences to control text styling, colors, and cursor positioning in the terminal.
- CLI Process Visualizations - Communicating background activity to users through loading spinners, progress bars, and sequential task lists.
- State-Driven UI Rendering - Updates the terminal display by reconciling current and desired screen states to overwrite specific lines.
- Input Collection Components - Provides validated input fields and masks for collecting text, passwords, dates, and file paths.
- Status Indicators - Includes loading spinners, progress bars, and sequential task lists to indicate background process status.
- Node.js Terminal Frameworks - A comprehensive Node.js framework for creating stylized, interactive terminal user interfaces.
- Visual Layout Formatters - Renders structured information using boxed text, notes, and streamed multi-line output for improved readability.
- Promise-Based Flow Control - Wraps synchronous terminal interactions in promises to enable asynchronous control flow during user input.
- Extensible Component Architectures - Decouples visual prompt and spinner presentation from the underlying input collection and validation logic.
- Terminal User Interfaces - Provides tools to build, style, and manage structured layouts and interactive text-based interfaces.
