cronvel/terminal-kit
Terminal Kit
Terminal-kit is a Node.js toolkit for building command-line applications and console user interfaces. It provides a comprehensive suite of utilities for console text styling, terminal graphics rendering, input parsing, and interactive interface construction.
The library features a cell-based text grid model, a component document tree for hierarchical layout of interactive widgets, and off-screen pixel buffering for multi-layered image composition and manipulation. It handles direct escape-sequence output control and raw-mode input parsing to manage display regions and capture user interactions.
Additional capabilities cover buffer management and drawing primitives, animated typing effects, text formatting and string interpolation, interactive user prompts, menus, file selectors, data tables, and progress indicators. Process control and window configuration utilities handle clean exits, cursor queries, and resize detection.
Features
- Terminal Application Development - Builds command-line applications and console user interfaces with screen rendering and window management.
- Cell Styling Systems - Applies foreground and background colors, alpha channels, and typographic styles to individual grid cells.
- Terminal Progress Bar Animations - Displays visual progress indicators featuring completion percentages and item tracking.
- Interactive CLI Prompts - Provides interactive prompts, confirmation dialogs, and auto-completion to collect user input.
- Screen Buffers - Renders off-screen buffers, handles cursor positioning, and supports high-definition image composition.
- Keyboard and Mouse Event Capture - Captures keyboard events, mouse interactions, and input events in command-line applications.
- Terminal Escape Sequences - Manipulates cursor position, styling, and screen modes by writing ANSI and VT escape sequences directly to output streams.
- Terminal UI Libraries - Builds interactive command-line interfaces and console applications with screen buffers and widgets.
- Terminal Graphics Rendering - Renders high-definition graphics, off-screen pixel buffers, and transparency blending inside terminal windows.
- Interactive Input Collection - Collects user input lines with support for history, auto-completion, masking, and key bindings.
- Command Line Interface Design - Constructs rich console interfaces using layout managers, interactive widgets, menus, progress bars, and data tables.
- Document Tree Hierarchies - Organizes interactive interface widgets into a hierarchical layout supporting automatic positioning, overlapping bounds, and keyboard focus routing.
- Terminal Buffer Rendering - Draws interactive elements like input fields, progress bars, and multi-layered screen buffers.
- Terminal Grid Cell Stores - Represents console screens as a two-dimensional grid of character cells storing distinct color attributes, unicode flags, and styles.
- Display Layout Managers - Arranges multiple interactive widgets across the display simultaneously, supporting overlapping elements.
- Terminal Input Handling - Captures keyboard events, mouse interactions, and interactive console menus inside terminal-based applications.
- Raw Mode Input Handlers - Captures and decodes raw keyboard bytes and mouse tracking escape sequences into high-level events without echoing characters.
- User Input Capture - Provides interactive input fields, menus, and prompts to collect data directly from terminal users.
- Terminal Application Frameworks - Constructs rich console applications using a document model, layout components, tables, and progress bars.
- Terminal Tables - Displays structured text cells in organized tabular layouts with optional borders and styling.
- Rectangular Renderers - Manages rectangular areas of characters, colors, and styles in memory before drawing.
- Interactive File Pickers - Prompts users to choose a file path with automatic relative directory path completion.
- Terminal Resize Detectors - Fires an event with new character dimensions whenever the display area is altered.
- Display Area Modifiers - Clears display sections, inserts or deletes lines and characters, and manages scroll regions.
- Node.js Terminal Styling - Formats console output with colors, typographic styles, and custom markup strings.
- CLI Progress Indicators - Shows visual progress bars, spinners, and structured tables with automatic column computing.
- Mouse Activity Tracking - Reports clicks, drags, wheel movement, and coordinate tracking through active input listeners.
- Layer Blending Operations - Combines source and destination graphics using standard composite modes or custom mathematical functions.
- Bar Column Renderers - Draws graphical bars representing fractional values using high-precision unicode characters.
- CLI Confirmation Prompts - Prompts users for yes/no confirmation responses during interactive terminal workflows.
- Horizontal Menus - Displays horizontal interactive selection menus supporting paging and mouse navigation.
- Cursor Visibility & Positioning - Relocates the text cursor absolutely or relatively, saves coordinate positions, and manages tab stops.
- Vertical Menus - Displays vertical stacked menus for navigating and selecting items across multiple lines.
- Terminal Image Renderers - Loads graphic files into a high-density character buffer using half-block characters and color channels.
- Grid Menus - Organizes selectable items into rows and columns for interactive multi-directional navigation.
- Text Buffer Management - Maintains multi-layered text, color attributes, and custom metadata in memory for console editors.
- Terminal Loading Animations - Shows loading indicators with customizable animations to signal background activity.
- Terminal Text Formatting - Applies colors, styles, mixing, and markup to text strings so output stands out visually.
- Terminal Text Styling - Applies 256 colors and text formatting styles directly to console output without native dependencies.
- Fullscreen Simulation - Switches to an alternate display buffer to provide a clean full-screen view without cluttering history.
- Buffer Composition - Copies buffer contents with support for coordinate clipping, tiling, and transparency blending.
