npmpackage.info

Gathering detailed insights and metrics for @isaacs/cliui

Other packages similar to @isaacs/cliui

isaacs-cliui

5.1.1

Gathering detailed insights and metrics for @isaacs/cliui

@isaacs/cliui - 8.0.2 | npmpackage.info

@isaacs/cliui

easily create complex multi-column command-line-interfaces.

8.0.2

374

ISC

JavaScript

7.79 kB

1,986,325,909 5

Installations

npm install @isaacs/cliui

Developer Guide

BETA

Typescript

No

Module System

ESM

Min. Node Version

>=12

Node Version

18.16.0

NPM Version

9.6.5 Score

98.6

Supply Chain

99.1

Quality

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

1

Total

139

Closed

70

Merged

68

Issues

Open

12

Total

31

Closed

19

Releases

v9.0.1

Updated on Mar 17, 2025

v9.0.0

Updated on Mar 16, 2025

v8.0.1

Updated on Oct 01, 2022

v8.0.0

Updated on Sep 30, 2022

cliui v7.0.4

v7.0.4

Updated on Nov 08, 2020

cliui v7.0.3

v7.0.3

Updated on Oct 16, 2020

View All 10 releases

Languages

JavaScript

TypeScript

JavaScript (55.42%)

TypeScript (44.58%)

Developer

yargs

Download Statistics

Total Downloads

1,986,325,909

Last Day

5,590,214

Last Week

37,453,455

Last Month

151,391,879

Last Year

1,381,424,199

GitHub Statistics

ISC License

374 Stars

134 Commits

43 Forks

10 Watchers

10 Branches

20 Contributors

Updated on May 27, 2025

Bundle Size

27.86 kB

Minified

7.79 kB

Minified + Gzipped

Bundlephobia

Maintainers

View All 20 Contributors

Package Meta Information

Latest Version

8.0.2

Package Id

@isaacs/cliui@8.0.2

Unpacked Size

27.15 kB

Size

5.95 kB

File Count

NPM Version

9.6.5

Node Version

18.16.0

Published on

May 02, 2023

Total Downloads

Cumulative downloads

Total Downloads

1,986,325,909

Last Day

-18.6%

5,590,214

Compared to previous day

Last Week

1.5%

37,453,455

Compared to previous week

Last Month

1.3%

151,391,879

Compared to previous month

Last Year

132.1%

1,381,424,199

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

@isaacs/cliui

Temporary fork of cliui.

nycrc config on GitHub

easily create complex multi-column command-line-interfaces.

Example

1const ui = require('cliui')()
2
3ui.div('Usage: $0 [command] [options]')
4
5ui.div({
6  text: 'Options:',
7  padding: [2, 0, 1, 0]
8})
9
10ui.div(
11  {
12    text: "-f, --file",
13    width: 20,
14    padding: [0, 4, 0, 4]
15  },
16  {
17    text: "the file to load." +
18      chalk.green("(if this description is long it wraps).")
19    ,
20    width: 20
21  },
22  {
23    text: chalk.red("[required]"),
24    align: 'right'
25  }
26)
27
28console.log(ui.toString())

Deno/ESM Support

As of v7 cliui supports Deno and ESM:

1import cliui from "https://deno.land/x/cliui/deno.ts";
2
3const ui = cliui({})
4
5ui.div('Usage: $0 [command] [options]')
6
7ui.div({
8  text: 'Options:',
9  padding: [2, 0, 1, 0]
10})
11
12ui.div({
13  text: "-f, --file",
14  width: 20,
15  padding: [0, 4, 0, 4]
16})
17
18console.log(ui.toString())

Layout DSL

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...

1var ui = require('./')({
2  width: 60
3})
4
5ui.div(
6  'Usage: node ./bin/foo.js\n' +
7  '  <regex>\t  provide a regex\n' +
8  '  <glob>\t  provide a glob\t [required]'
9)
10
11console.log(ui.toString())

will output:

1Usage: node ./bin/foo.js
2  <regex>  provide a regex
3  <glob>   provide a glob          [required]

Methods

1cliui = require('cliui')

cliui({width: integer})

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.

cliui({wrap: boolean})

Enable or disable the wrapping of text in a column.

cliui.div(column, column, column)

Create a row with any number of columns, a column can either be a string, or an object with the following options:

text: some text to place in the column.
width: the width of a column.
align: alignment, right or center.
padding: [top, right, bottom, left].
border: should a border be placed around the div?

cliui.span(column, column, column)

Similar to div, except the next row will be appended without a new line being created.

cliui.resetOutput()

Resets the UI elements of the current cliui instance, maintaining the values set for width and wrap.

No vulnerabilities found.

10

Maintained

Determines if the project is "actively maintained".

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

10

License

Determines if the project has defined a license.

2

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 0

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/cliui/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/cliui/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/cliui/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/cliui/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:39: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/cliui/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/cliui/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:51: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/cliui/ci.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yaml:52: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/cliui/ci.yaml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yaml:57: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/cliui/ci.yaml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/release-please.yml:10: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/cliui/release-please.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-please.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/cliui/release-please.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-please.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/cliui/release-please.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-please.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/yargs/cliui/release-please.yml/master?enable=pin
Warn: npmCommand not pinned by hash: .github/workflows/ci.yaml:21
Warn: npmCommand not pinned by hash: .github/workflows/ci.yaml:44
Warn: npmCommand not pinned by hash: .github/workflows/ci.yaml:56
Warn: npmCommand not pinned by hash: .github/workflows/release-please.yml:21
Warn: npmCommand not pinned by hash: .github/workflows/release-please.yml:42
Info: 0 out of 11 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 2 third-party GitHubAction dependencies pinned
Info: 0 out of 5 npmCommand dependencies pinned

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

SAST

Determines if the project uses static code analysis.

Score

5

/10

Last Scanned on 2025-05-19

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to @isaacs/cliui

Other packages similar to @isaacs/cliui

@isaacs/cliui

Installations

Developer Guide

No

ESM

>=12

18.16.0

9.6.5

Score

Pull Requests

1

139

70

68

Issues

12

31

19

Releases

Languages

Developer

yargs

Download Statistics

GitHub Statistics

Bundle Size

27.86 kB

7.79 kB

Maintainers

Package Meta Information

Total Downloads

1,986,325,909

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Dev Dependencies

@isaacs/cliui

Example

Deno/ESM Support

Layout DSL

Methods

cliui({width: integer})

cliui({wrap: boolean})

cliui.div(column, column, column)

cliui.span(column, column, column)

cliui.resetOutput()

10

10

10

10

10

2

0

0

0

0

0

0

5

/10