
Product
Secure Your AI-Generated Code with Socket MCP
Socket MCP brings real-time security checks to AI-generated code, helping developers catch risky dependencies before they enter the codebase.
The cliui npm package is a library for creating complex command-line interfaces with various layout controls such as word-wrapping, alignment, padding, and more. It allows developers to build structured and formatted output for command-line applications.
Text alignment and wrapping
This feature allows for aligning text within a specified width and automatically wraps text that exceeds the width. Padding can be added around the text.
const cliui = require('cliui')({ width: 80 });
cliui.div(
{ text: 'Some long text that needs to be wrapped', align: 'left', padding: [1, 2, 1, 2] },
{ text: 'Aligned right', align: 'right' }
);
console.log(cliui.toString());
Column-based layout
This feature allows developers to create a layout based on columns, specifying the width of each column for structured output.
const cliui = require('cliui')({ width: 80 });
cliui.div(
{ text: 'Column 1', width: 30 },
{ text: 'Column 2', width: 30 },
{ text: 'Column 3', width: 20 }
);
console.log(cliui.toString());
Complex nested layouts
This feature supports creating nested layouts, allowing for complex and hierarchical interface designs.
const cliui = require('cliui')({ width: 80 });
cliui.div(
{
text: 'Top level',
padding: [1, 0, 1, 0],
border: true
},
{
text: cliui.div(
{ text: 'Nested level 1', align: 'center' },
{ text: cliui.div(
{ text: 'Nested level 2', align: 'center' }
)}
)
}
);
console.log(cliui.toString());
Chalk is a popular npm package for styling terminal strings with colors and styles but does not provide layout controls like cliui.
Boxen allows you to create boxes in the terminal to highlight content. It is similar to cliui in that it helps format CLI output but does not offer the same level of layout control.
Inquirer.js is a comprehensive library for creating interactive command-line user interfaces. It includes features for prompting users but is more focused on user input than output formatting like cliui.
Blessed is a high-level terminal interface library that is more complex and feature-rich than cliui, offering a full-fledged terminal interface API, including screen widgets and mouse events.
easily create complex multi-column command-line-interfaces.
npm i cliui@latest chalk@latest
const ui = require('cliui')()
const {Chalk} = require('chalk');
const chalk = new Chalk();
ui.div('Usage: $0 [command] [options]')
ui.div({
text: 'Options:',
padding: [2, 0, 1, 0]
})
ui.div(
{
text: "-f, --file",
width: 20,
padding: [0, 4, 0, 4]
},
{
text: "the file to load." +
chalk.green("(if this description is long it wraps).")
,
width: 20
},
{
text: chalk.red("[required]"),
align: 'right'
}
)
console.log(ui.toString())
As of v7
cliui
supports Deno and
ESM:
import cliui from "cliui";
import chalk from "chalk";
// Deno: import cliui from "https://deno.land/x/cliui/deno.ts";
const ui = cliui({})
ui.div('Usage: $0 [command] [options]')
ui.div({
text: 'Options:',
padding: [2, 0, 1, 0]
})
ui.div(
{
text: "-f, --file",
width: 20,
padding: [0, 4, 0, 4]
},
{
text: "the file to load." +
chalk.green("(if this description is long it wraps).")
,
width: 20
},
{
text: chalk.red("[required]"),
align: 'right'
}
)
console.log(ui.toString())
cliui exposes a simple layout DSL:
If you create a single ui.div
, passing a string rather than an
object:
\n
: characters will be interpreted as new rows.\t
: characters will be interpreted as new columns.\s
: characters will be interpreted as padding.as an example...
var ui = require('./')({
width: 60
})
ui.div(
'Usage: node ./bin/foo.js\n' +
' <regex>\t provide a regex\n' +
' <glob>\t provide a glob\t [required]'
)
console.log(ui.toString())
will output:
Usage: node ./bin/foo.js
<regex> provide a regex
<glob> provide a glob [required]
cliui = require('cliui')
Specify the maximum width of the UI being generated.
If no width is provided, cliui will try to get the current window's width and use it, and if that doesn't work, width will be set to 80
.
Enable or disable the wrapping of text in a column.
Create a row with any number of columns, a column can either be a string, or an object with the following options:
right
or center
.[top, right, bottom, left]
.Similar to div
, except the next row will be appended without
a new line being created.
Resets the UI elements of the current cliui instance, maintaining the values
set for width
and wrap
.
FAQs
easily create complex multi-column command-line-interfaces
The npm package cliui receives a total of 89,507,077 weekly downloads. As such, cliui popularity was classified as popular.
We found that cliui demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Socket MCP brings real-time security checks to AI-generated code, helping developers catch risky dependencies before they enter the codebase.
Security News
As vulnerability data bottlenecks grow, the federal government is formally investigating NIST’s handling of the National Vulnerability Database.
Research
Security News
Socket’s Threat Research Team has uncovered 60 npm packages using post-install scripts to silently exfiltrate hostnames, IP addresses, DNS servers, and user directories to a Discord-controlled endpoint.