initial
This commit is contained in:
parent
2d73e91eb8
commit
4cdf3fdf5d
|
@ -23,7 +23,7 @@ defined('BASEPATH') OR exit('No direct script access allowed');
|
||||||
| a PHP script and you can easily do that on your own.
|
| a PHP script and you can easily do that on your own.
|
||||||
|
|
|
|
||||||
*/
|
*/
|
||||||
$config['base_url'] = 'http://192.168.2.110/google_forms';
|
$config['base_url'] = 'http://localhost/google_forms';
|
||||||
|
|
||||||
/*
|
/*
|
||||||
|--------------------------------------------------------------------------
|
|--------------------------------------------------------------------------
|
||||||
|
|
|
@ -4,25 +4,18 @@ defined('BASEPATH') or exit('No direct script access allowed');
|
||||||
class Form_controller extends CI_Controller
|
class Form_controller extends CI_Controller
|
||||||
{
|
{
|
||||||
|
|
||||||
public function index() {
|
|
||||||
// Fetch the data
|
|
||||||
$this->load->model('Form_model');
|
|
||||||
$this->load->model('Response_model');
|
|
||||||
$data['total_forms'] = $this->Form_model->get_total_forms();
|
|
||||||
$data['published_forms'] = $this->Form_model->get_published_forms();
|
|
||||||
$data['total_responses'] = $this->Response_model->get_total_responses();
|
|
||||||
// var_dump($data);
|
|
||||||
// Load the view and pass the data
|
|
||||||
$this->load->view('list_forms', $data);
|
|
||||||
}
|
|
||||||
public function index_forms($form_id = null)
|
public function index_forms($form_id = null)
|
||||||
{
|
{
|
||||||
$this->load->model('Frontend_model');
|
$this->load->model('Frontend_model');
|
||||||
|
$this->load->model('Form_model');
|
||||||
|
$this->load->model('Response_model');
|
||||||
|
|
||||||
// Check if the user is logged in
|
// Check if the user is logged in
|
||||||
if (!$this->session->userdata('logged_in')) {
|
if (!$this->session->userdata('logged_in')) {
|
||||||
// If not logged in, redirect to login page
|
// If not logged in, redirect to login page
|
||||||
redirect('users/login');
|
redirect('users/login');
|
||||||
}
|
}
|
||||||
|
$user_id = $this->session->userdata('user_id');
|
||||||
|
|
||||||
// Retrieve form title from the forms table using form_id
|
// Retrieve form title from the forms table using form_id
|
||||||
$form_title = 'Untitled Form'; // Default title
|
$form_title = 'Untitled Form'; // Default title
|
||||||
|
@ -33,15 +26,20 @@ class Form_controller extends CI_Controller
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Fetch data from models
|
||||||
|
$data['total_forms'] = $this->Form_model->get_total_forms($user_id);
|
||||||
|
$data['published_forms'] = $this->Form_model->get_published_forms($user_id);
|
||||||
|
$data['total_responses'] = $this->Response_model->get_total_responses($user_id);
|
||||||
|
$data['forms'] = $this->Form_model->get_all_forms($user_id);
|
||||||
|
$data['form_title'] = $form_title;
|
||||||
|
|
||||||
// Load views and data if user is logged in
|
// Load views and data if user is logged in
|
||||||
$this->load->view('templates/header');
|
$this->load->view('templates/header');
|
||||||
|
$this->load->view('Tables/list_forms', $data);
|
||||||
$data = $this->Frontend_model->getforms();
|
|
||||||
$this->load->view('Tables/list_forms', ['forms' => $data, 'form_title' => $form_title]);
|
|
||||||
|
|
||||||
$this->load->view('templates/footer');
|
$this->load->view('templates/footer');
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
public function delete($id)
|
public function delete($id)
|
||||||
{
|
{
|
||||||
if (!$this->session->userdata('logged_in')) {
|
if (!$this->session->userdata('logged_in')) {
|
||||||
|
|
|
@ -34,7 +34,7 @@ class Publish_controller extends CI_Controller {
|
||||||
|
|
||||||
$this->load->view('templates/header');
|
$this->load->view('templates/header');
|
||||||
$this->load->view('publish_view', $data);
|
$this->load->view('publish_view', $data);
|
||||||
$this->load->view('templates/footer');
|
// $this->load->view('templates/footer');
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -25,7 +25,7 @@ class Response_submit extends CI_Controller {
|
||||||
|
|
||||||
$this->load->view('templates/header');
|
$this->load->view('templates/header');
|
||||||
$this->load->view('responses_list', $data);
|
$this->load->view('responses_list', $data);
|
||||||
$this->load->view('templates/footer');
|
// $this->load->view('templates/footer');
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@ -93,5 +93,37 @@ class Response_submit extends CI_Controller {
|
||||||
$this->load->view('templates/footer');
|
$this->load->view('templates/footer');
|
||||||
}
|
}
|
||||||
|
|
||||||
|
public function summary($form_id)
|
||||||
|
{
|
||||||
|
$this->load->model('Form_model');
|
||||||
|
$this->load->model('Response_model');
|
||||||
|
|
||||||
|
// Check if the user is logged in
|
||||||
|
if (!$this->session->userdata('logged_in')) {
|
||||||
|
redirect('users/login');
|
||||||
|
}
|
||||||
|
|
||||||
|
// Fetch form details
|
||||||
|
$form = $this->Form_model->get_form_by_id($form_id);
|
||||||
|
if (!$form) {
|
||||||
|
show_404();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Fetch summary data
|
||||||
|
$summary_data = $this->Response_model->get_summary_data($form_id);
|
||||||
|
|
||||||
|
$data['form'] = $form;
|
||||||
|
$data['summary_data'] = $summary_data;
|
||||||
|
|
||||||
|
$this->load->view('templates/header');
|
||||||
|
$this->load->view('Forms/summary', $data);
|
||||||
|
$this->load->view('templates/footer');
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|
|
@ -4,22 +4,38 @@ defined('BASEPATH') or exit('No direct script access allowed');
|
||||||
class Form_model extends CI_Model
|
class Form_model extends CI_Model
|
||||||
{
|
{
|
||||||
|
|
||||||
|
// Function to get form details by ID
|
||||||
|
public function get_form_by_id($form_id)
|
||||||
|
{
|
||||||
|
$this->load->database();
|
||||||
|
$this->db->where('id', $form_id);
|
||||||
|
$query = $this->db->get('forms');
|
||||||
|
return $query->row();
|
||||||
|
}
|
||||||
// Get the total number of forms
|
// Get the total number of forms
|
||||||
public function get_total_forms()
|
public function get_total_forms($user_id) {
|
||||||
{
|
// Ensure user_id is passed as a parameter and used in the query
|
||||||
$this->load->database();
|
$this->db->where('user_id', $user_id);
|
||||||
|
return $this->db->count_all_results('forms'); // Use count_all_results to ensure WHERE conditions are applied
|
||||||
return $this->db->count_all('forms');
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// Get the number of published forms
|
// Function to count published forms
|
||||||
public function get_published_forms()
|
public function get_published_forms($user_id) {
|
||||||
{
|
// Ensure user_id and is_published are passed as parameters and used in the query
|
||||||
$this->load->database();
|
$this->db->where('user_id', $user_id);
|
||||||
|
|
||||||
$this->db->where('is_published', 1);
|
$this->db->where('is_published', 1);
|
||||||
return $this->db->count_all_results('forms');
|
return $this->db->count_all_results('forms'); // Use count_all_results to ensure WHERE conditions are applied
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Function to get all forms
|
||||||
|
public function get_all_forms($user_id)
|
||||||
|
{
|
||||||
|
$this->db->where('user_id', $user_id);
|
||||||
|
$this->db->order_by('created_at', 'DESC');
|
||||||
|
$query = $this->db->get('forms');
|
||||||
|
return $query->result();
|
||||||
|
}
|
||||||
|
|
||||||
public function save_form($form_data)
|
public function save_form($form_data)
|
||||||
{
|
{
|
||||||
$this->db->trans_start();
|
$this->db->trans_start();
|
||||||
|
|
|
@ -6,8 +6,14 @@ class Response_model extends CI_Model
|
||||||
}
|
}
|
||||||
|
|
||||||
// Get the total number of responses
|
// Get the total number of responses
|
||||||
public function get_total_responses() {
|
public function get_total_responses($user_id) {
|
||||||
return $this->db->count_all('responses');
|
// Join the responses table with the forms table
|
||||||
|
$this->db->select('responses.id');
|
||||||
|
$this->db->from('responses');
|
||||||
|
$this->db->join('forms', 'responses.form_id = forms.id');
|
||||||
|
// Filter by user_id in the forms table
|
||||||
|
$this->db->where('forms.user_id', $user_id);
|
||||||
|
return $this->db->count_all_results();
|
||||||
}
|
}
|
||||||
|
|
||||||
public function insert_response($data)
|
public function insert_response($data)
|
||||||
|
@ -113,5 +119,54 @@ class Response_model extends CI_Model
|
||||||
$query = $this->db->get();
|
$query = $this->db->get();
|
||||||
return $query->row();
|
return $query->row();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
// Function to get summary data for a form
|
||||||
|
public function get_summary_data($form_id)
|
||||||
|
{
|
||||||
|
$this->load->database();
|
||||||
|
|
||||||
|
$summary_data = array();
|
||||||
|
|
||||||
|
// Get questions for the form
|
||||||
|
$this->db->select('id,text,type');
|
||||||
|
$this->db->where('form_id', $form_id);
|
||||||
|
$questions = $this->db->get('questions')->result_array();
|
||||||
|
|
||||||
|
// Get responses count
|
||||||
|
$this->db->where('form_id', $form_id);
|
||||||
|
$responses = $this->db->get('responses')->result_array();
|
||||||
|
|
||||||
|
if (count($responses) > 0) {
|
||||||
|
$response_ids = array_column($responses, 'id');
|
||||||
|
|
||||||
|
// Get response answers
|
||||||
|
$this->db->where_in('response_id', $response_ids);
|
||||||
|
$response_answers = $this->db->get('response_answers')->result_array();
|
||||||
|
|
||||||
|
// Process response answers
|
||||||
|
foreach ($questions as $question) {
|
||||||
|
$question_id = $question['id'];
|
||||||
|
$summary_data[$question_id] = [
|
||||||
|
'text' => $question['text'],
|
||||||
|
'type' => $question['type'],
|
||||||
|
'answers' => []
|
||||||
|
];
|
||||||
|
}
|
||||||
|
|
||||||
|
foreach ($response_answers as $answer) {
|
||||||
|
$question_id = $answer['question_id'];
|
||||||
|
$answered_text = $answer['answered_text'];
|
||||||
|
|
||||||
|
if (!isset($summary_data[$question_id]['answers'][$answered_text])) {
|
||||||
|
$summary_data[$question_id]['answers'][$answered_text] = 1;
|
||||||
|
} else {
|
||||||
|
$summary_data[$question_id]['answers'][$answered_text]++;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return $summary_data;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
@ -0,0 +1,100 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="en">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8">
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||||
|
<title>Form Summary</title>
|
||||||
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css">
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
|
||||||
|
<style>
|
||||||
|
.chart-container {
|
||||||
|
width: 50%;
|
||||||
|
margin: 0 auto;
|
||||||
|
margin-bottom: 50px; /* Add margin to avoid overlap */
|
||||||
|
}
|
||||||
|
.short-answer, .paragraph {
|
||||||
|
margin-bottom: 20px;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<div class="container">
|
||||||
|
<div class="row">
|
||||||
|
<div class="col-md-12 mt-4">
|
||||||
|
<div class="card">
|
||||||
|
<div class="card-header">
|
||||||
|
<h3>Summary for "<?php echo $form->title; ?>"</h3>
|
||||||
|
<a href="<?php echo base_url('forms/view/' . $form->id); ?>" class="btn btn-primary">Back to Responses</a>
|
||||||
|
</div>
|
||||||
|
<div class="card-body">
|
||||||
|
<div id="charts">
|
||||||
|
<?php foreach ($summary_data as $question): ?>
|
||||||
|
<h5><?php echo $question['text']; ?></h5>
|
||||||
|
<?php if (is_array($question['answers'])): ?>
|
||||||
|
<div class="chart-container">
|
||||||
|
<canvas id="chart-<?php echo $question['question_id']; ?>"></canvas>
|
||||||
|
</div>
|
||||||
|
<?php else: ?>
|
||||||
|
<div class="short-answer">
|
||||||
|
<ul>
|
||||||
|
<?php foreach ($question['answers'] as $answer): ?>
|
||||||
|
<li><?php echo $answer; ?></li>
|
||||||
|
<?php endforeach; ?>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
<?php endif; ?>
|
||||||
|
<?php endforeach; ?>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<script>
|
||||||
|
document.addEventListener('DOMContentLoaded', function() {
|
||||||
|
var summaryData = <?php echo json_encode($summary_data); ?>;
|
||||||
|
console.log('Summary Data:', summaryData); // Debugging information
|
||||||
|
|
||||||
|
summaryData.forEach(function(question) {
|
||||||
|
var answers = question['answers'];
|
||||||
|
if (typeof answers === 'object') {
|
||||||
|
var ctx = document.getElementById('chart-' + question['question_id']).getContext('2d');
|
||||||
|
var labels = Object.keys(answers);
|
||||||
|
var data = Object.values(answers);
|
||||||
|
console.log('Question ID:', question['question_id'], 'Labels:', labels, 'Data:', data); // Debugging information
|
||||||
|
|
||||||
|
var chartType = (question['type'] === 'checkboxes') ? 'bar' : 'pie';
|
||||||
|
|
||||||
|
new Chart(ctx, {
|
||||||
|
type: chartType,
|
||||||
|
data: {
|
||||||
|
labels: labels,
|
||||||
|
datasets: [{
|
||||||
|
data: data,
|
||||||
|
backgroundColor: [
|
||||||
|
'#FF6384',
|
||||||
|
'#36A2EB',
|
||||||
|
'#FFCE56',
|
||||||
|
'#4BC0C0',
|
||||||
|
'#9966FF',
|
||||||
|
'#FF9F40'
|
||||||
|
]
|
||||||
|
}]
|
||||||
|
},
|
||||||
|
options: {
|
||||||
|
responsive: true,
|
||||||
|
legend: {
|
||||||
|
position: 'top',
|
||||||
|
},
|
||||||
|
title: {
|
||||||
|
display: true,
|
||||||
|
text: question['text']
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
});
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
</body>
|
||||||
|
</html>
|
|
@ -6,7 +6,9 @@
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||||
<title>Form List</title>
|
<title>Form List</title>
|
||||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css">
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css">
|
||||||
<link rel="stylesheet" href="styles.css"> <!-- Link to your stylesheet -->
|
<!-- <link rel="stylesheet" href="<?php echo base_url(); ?>assets/css/styles.css"> -->
|
||||||
|
<link rel="stylesheet" href="<?php echo base_url(); ?>assets/css/header_styles.css">
|
||||||
|
|
||||||
<style>
|
<style>
|
||||||
.title-column {
|
.title-column {
|
||||||
color: darkblue; /* Dark blue color for title */
|
color: darkblue; /* Dark blue color for title */
|
||||||
|
@ -92,5 +94,4 @@
|
||||||
rows.forEach(row => tbody.appendChild(row));
|
rows.forEach(row => tbody.appendChild(row));
|
||||||
});
|
});
|
||||||
</script>
|
</script>
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
|
|
|
@ -6,17 +6,99 @@
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||||
<title>Form List</title>
|
<title>Form List</title>
|
||||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css">
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css">
|
||||||
<link rel="stylesheet" href="styles.css"> <!-- Link to your stylesheet -->
|
<!-- <link rel="stylesheet" href="styles.css"> -->
|
||||||
<style>
|
<style>
|
||||||
|
/* CSS styles */
|
||||||
.title-column {
|
.title-column {
|
||||||
color: darkblue; /* Dark blue color for title */
|
color: darkblue;
|
||||||
|
/* Dark blue color for title */
|
||||||
|
}
|
||||||
|
|
||||||
|
.draft-row {
|
||||||
|
background-color: #f0f0f0;
|
||||||
|
/* Light grey background for draft status */
|
||||||
|
}
|
||||||
|
|
||||||
|
.card-stats {
|
||||||
|
background-color: white;
|
||||||
|
border-radius: 10px;
|
||||||
|
box-shadow: 0 4px 8px rgba(0, 0, 0, 0.1);
|
||||||
|
margin-bottom: 20px;
|
||||||
|
padding: 20px;
|
||||||
|
text-align: center;
|
||||||
|
transition: transform 0.2s, box-shadow 0.2s;
|
||||||
|
}
|
||||||
|
|
||||||
|
.card-stats:hover {
|
||||||
|
transform: translateY(-10px);
|
||||||
|
box-shadow: 0 8px 16px rgba(0, 0, 0, 0.2);
|
||||||
|
}
|
||||||
|
|
||||||
|
.card-title {
|
||||||
|
color: rgb(103, 58, 183); /* Match the color theme */
|
||||||
|
margin-bottom: 10px;
|
||||||
|
font-size: 20px; /* Increase the font size of the title */
|
||||||
|
font-weight: bold; /* Make the title bold */
|
||||||
|
}
|
||||||
|
|
||||||
|
.card-text {
|
||||||
|
font-size: 28px; /* Increase the font size */
|
||||||
|
font-weight: bold; /* Make the text bold */
|
||||||
|
}
|
||||||
|
|
||||||
|
.card-text.green {
|
||||||
|
color: #28a745;
|
||||||
|
}
|
||||||
|
|
||||||
|
.card-text.red {
|
||||||
|
color: #dc3545;
|
||||||
|
}
|
||||||
|
|
||||||
|
.card-text.blue {
|
||||||
|
color: #007bff;
|
||||||
|
}
|
||||||
|
|
||||||
|
.card-text.yellow {
|
||||||
|
color: #ffc107;
|
||||||
|
}
|
||||||
|
|
||||||
|
.card-text.purple {
|
||||||
|
color: #6f42c1;
|
||||||
}
|
}
|
||||||
</style>
|
</style>
|
||||||
</head>
|
</head>
|
||||||
<body>
|
<body>
|
||||||
<div class="container">
|
<div class="container">
|
||||||
<div class="row">
|
<div class="row">
|
||||||
<div class="col-md-12 mt-4">
|
<div class="col-md-4">
|
||||||
|
<div class="card card-stats">
|
||||||
|
<div class="card-body">
|
||||||
|
<h5 class="card-title">Total Forms Created</h5>
|
||||||
|
<p class="card-text" id="total-forms"><?php echo $total_forms; ?></p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="col-md-4">
|
||||||
|
<div class="card card-stats">
|
||||||
|
<div class="card-body">
|
||||||
|
<h5 class="card-title">Published Forms</h5>
|
||||||
|
<p class="card-text" id="published-forms"><?php echo $published_forms; ?></p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="col-md-4">
|
||||||
|
<div class="card card-stats">
|
||||||
|
<div class="card-body">
|
||||||
|
<h5 class="card-title">Responses Submitted</h5>
|
||||||
|
<p class="card-text" id="total-responses"><?php echo $total_responses; ?></p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Your existing table code here -->
|
||||||
|
<div class="row">
|
||||||
|
<div class="col-md-12 mt-4 ">
|
||||||
<div class="card">
|
<div class="card">
|
||||||
<div class="card-header">
|
<div class="card-header">
|
||||||
<?php if ($this->session->flashdata('status')): ?>
|
<?php if ($this->session->flashdata('status')): ?>
|
||||||
|
@ -24,36 +106,37 @@
|
||||||
<?= $this->session->flashdata('status'); ?>
|
<?= $this->session->flashdata('status'); ?>
|
||||||
</div>
|
</div>
|
||||||
<?php endif; ?>
|
<?php endif; ?>
|
||||||
<h3>Drafts</h3>
|
<h3>List of Forms</h3>
|
||||||
</div>
|
</div>
|
||||||
<div class="card-body">
|
<div class="card-body">
|
||||||
|
<!-- here your table will occur -->
|
||||||
<table id="basetable1" class="table table-bordered">
|
<table id="basetable1" class="table table-bordered">
|
||||||
<thead>
|
<thead>
|
||||||
<tr>
|
<tr>
|
||||||
<th>Drafts</th>
|
<th>Forms</th>
|
||||||
<th>Title</th>
|
<th>Title</th>
|
||||||
|
<th>Description</th>
|
||||||
<th>Created On</th>
|
<th>Created On</th>
|
||||||
<th>Edit</th>
|
<th>Status</th>
|
||||||
<th>Delete</th>
|
<th>Responses</th>
|
||||||
<th>Preview</th>
|
|
||||||
</tr>
|
</tr>
|
||||||
</thead>
|
</thead>
|
||||||
<tbody>
|
<tbody>
|
||||||
<?php
|
<?php
|
||||||
$serialNumber = 1; // Initialize the counter variable
|
$serialNumber = 1; // Initialize the counter variable
|
||||||
foreach ($forms as $row): ?>
|
foreach ($forms as $row): ?>
|
||||||
<tr>
|
<tr class="<?php echo ($row->is_published ? '' : 'draft-row'); ?>">
|
||||||
<td><?php echo $serialNumber++; ?></td>
|
<td><?php echo $serialNumber++; ?></td>
|
||||||
<td class="title-column"><?php echo $row->title; ?></td>
|
<td class="title-column">
|
||||||
<td><?php echo date('Y-m-d H:i:s', strtotime($row->created_at)); ?></td> <!-- Ensure date is in a sortable format -->
|
<a href="<?php echo base_url('publish/' . $row->id); ?>"><?php echo $row->title; ?></a>
|
||||||
<td>
|
</td>
|
||||||
<a href="<?php echo base_url('edit/' . $row->id); ?>" class="btn btn-success btn-sm" style="background-color: rgb(103, 58, 183); border-color: rgb(103, 58, 183); color: white;">Edit</a>
|
<td><?php echo $row->description; ?></td>
|
||||||
|
<td><?php echo $row->created_at; ?></td>
|
||||||
|
<td style="color: <?php echo ($row->is_published ? '#006400' : 'red'); ?>;">
|
||||||
|
<?php echo ($row->is_published ? 'Published' : 'Draft'); ?>
|
||||||
</td>
|
</td>
|
||||||
<td>
|
<td>
|
||||||
<a href="<?php echo base_url('forms/delete/' . $row->id); ?>" class="btn btn-danger btn-sm" style="background-color: rgb(103, 58, 183); border-color: rgb(103, 58, 183); color: white;">Delete</a>
|
<a href="<?php echo base_url('responses/' . $row->id); ?>">
|
||||||
</td>
|
|
||||||
<td>
|
|
||||||
<a href="<?php echo base_url('publish/' . $row->id); ?>">
|
|
||||||
<i class="fas fa-eye"></i> <!-- Eye icon -->
|
<i class="fas fa-eye"></i> <!-- Eye icon -->
|
||||||
</a>
|
</a>
|
||||||
</td>
|
</td>
|
||||||
|
@ -66,31 +149,3 @@
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<script>
|
|
||||||
document.addEventListener('DOMContentLoaded', function() {
|
|
||||||
const table = document.getElementById('basetable1');
|
|
||||||
const tbody = table.querySelector('tbody');
|
|
||||||
const rows = Array.from(tbody.querySelectorAll('tr'));
|
|
||||||
|
|
||||||
rows.sort((rowA, rowB) => {
|
|
||||||
const dateTextA = rowA.cells[2].textContent.trim();
|
|
||||||
const dateTextB = rowB.cells[2].textContent.trim();
|
|
||||||
|
|
||||||
const dateA = new Date(dateTextA);
|
|
||||||
const dateB = new Date(dateTextB);
|
|
||||||
|
|
||||||
if (isNaN(dateA.getTime())) {
|
|
||||||
return 1;
|
|
||||||
}
|
|
||||||
if (isNaN(dateB.getTime())) {
|
|
||||||
return -1;
|
|
||||||
}
|
|
||||||
|
|
||||||
return dateB - dateA;
|
|
||||||
});
|
|
||||||
|
|
||||||
rows.forEach(row => tbody.appendChild(row));
|
|
||||||
});
|
|
||||||
</script>
|
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
|
|
|
@ -22,7 +22,18 @@
|
||||||
|
|
||||||
<body>
|
<body>
|
||||||
<style>
|
<style>
|
||||||
|
.custom-select {
|
||||||
|
width: 220px;
|
||||||
|
height: 44px;
|
||||||
|
display: block;
|
||||||
|
padding: -20px 15px;
|
||||||
|
font-size: 15px;
|
||||||
|
line-height: 1.42857143;
|
||||||
|
background-color: #ffffff;
|
||||||
|
background-image: none;
|
||||||
|
border: 1px solid #dce4ec;
|
||||||
|
border-radius: 4px;
|
||||||
|
}
|
||||||
|
|
||||||
</style>
|
</style>
|
||||||
<!-- Navbar -->
|
<!-- Navbar -->
|
||||||
|
@ -140,7 +151,15 @@
|
||||||
$(document).ready(function () {
|
$(document).ready(function () {
|
||||||
var base_url = '<?php echo base_url(); ?>';
|
var base_url = '<?php echo base_url(); ?>';
|
||||||
var activeSection = null;
|
var activeSection = null;
|
||||||
|
$('#form-container').sortable({
|
||||||
|
placeholder: 'ui-state-highlight',
|
||||||
|
start: function (event, ui) {
|
||||||
|
ui.placeholder.height(ui.item.height());
|
||||||
|
},
|
||||||
|
stop: function (event, ui) {
|
||||||
|
positionAddSectionButton();
|
||||||
|
}
|
||||||
|
});
|
||||||
function positionAddSectionButton() {
|
function positionAddSectionButton() {
|
||||||
if (activeSection) {
|
if (activeSection) {
|
||||||
var position = activeSection.position();
|
var position = activeSection.position();
|
||||||
|
@ -294,7 +313,7 @@
|
||||||
positionAddSectionButton();
|
positionAddSectionButton();
|
||||||
});
|
});
|
||||||
|
|
||||||
positionAddSectionButton();
|
// positionAddSectionButton();
|
||||||
$(document).ready(function () {
|
$(document).ready(function () {
|
||||||
var base_url = '<?php echo base_url(); ?>';
|
var base_url = '<?php echo base_url(); ?>';
|
||||||
|
|
||||||
|
|
|
@ -8,10 +8,7 @@
|
||||||
<link rel="stylesheet" href="<?php echo base_url(); ?>assets/css/form_preview.css">
|
<link rel="stylesheet" href="<?php echo base_url(); ?>assets/css/form_preview.css">
|
||||||
</head>
|
</head>
|
||||||
<body>
|
<body>
|
||||||
<style>.form-header {
|
|
||||||
margin-left: 251px; /* Adjust the value as needed */
|
|
||||||
}
|
|
||||||
</style>
|
|
||||||
<div class="container">
|
<div class="container">
|
||||||
<div class="form-header">
|
<div class="form-header">
|
||||||
<h2><?php echo $form->title; ?></h2>
|
<h2><?php echo $form->title; ?></h2>
|
||||||
|
|
|
@ -1,95 +1,3 @@
|
||||||
<style>
|
|
||||||
/* CSS styles */
|
|
||||||
.title-column {
|
|
||||||
color: darkblue;
|
|
||||||
/* Dark blue color for title */
|
|
||||||
}
|
|
||||||
|
|
||||||
.draft-row {
|
|
||||||
background-color: #f0f0f0;
|
|
||||||
/* Light grey background for draft status */
|
|
||||||
}
|
|
||||||
|
|
||||||
.switch {
|
|
||||||
position: relative;
|
|
||||||
display: inline-block;
|
|
||||||
width: 34px;
|
|
||||||
height: 20px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.switch input {
|
|
||||||
opacity: 0;
|
|
||||||
width: 0;
|
|
||||||
height: 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
.slider {
|
|
||||||
position: absolute;
|
|
||||||
cursor: pointer;
|
|
||||||
top: 0;
|
|
||||||
left: 0;
|
|
||||||
right: 0;
|
|
||||||
bottom: 0;
|
|
||||||
background-color: #ccc;
|
|
||||||
transition: .4s;
|
|
||||||
}
|
|
||||||
|
|
||||||
.slider:before {
|
|
||||||
position: absolute;
|
|
||||||
content: "";
|
|
||||||
height: 14px;
|
|
||||||
width: 14px;
|
|
||||||
left: 3px;
|
|
||||||
bottom: 3px;
|
|
||||||
background-color: white;
|
|
||||||
transition: .4s;
|
|
||||||
}
|
|
||||||
|
|
||||||
input:checked+.slider {
|
|
||||||
background-color: #673AB7;
|
|
||||||
}
|
|
||||||
|
|
||||||
input:checked+.slider:before {
|
|
||||||
transform: translateX(14px);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Rounded sliders */
|
|
||||||
.slider.round {
|
|
||||||
border-radius: 20px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.slider.round:before {
|
|
||||||
border-radius: 50%;
|
|
||||||
}
|
|
||||||
|
|
||||||
.switch {
|
|
||||||
position: relative;
|
|
||||||
display: inline-block;
|
|
||||||
}
|
|
||||||
|
|
||||||
.switch .tooltip {
|
|
||||||
visibility: hidden;
|
|
||||||
width: 70px;
|
|
||||||
background-color: #555;
|
|
||||||
color: #fff;
|
|
||||||
text-align: center;
|
|
||||||
border-radius: 5px;
|
|
||||||
padding: 5px;
|
|
||||||
position: absolute;
|
|
||||||
z-index: 1;
|
|
||||||
bottom: 125%;
|
|
||||||
/* Position above the switch */
|
|
||||||
left: 290%;
|
|
||||||
margin-left: -60px;
|
|
||||||
opacity: 0;
|
|
||||||
transition: opacity 0.3s;
|
|
||||||
}
|
|
||||||
|
|
||||||
.switch:hover .tooltip {
|
|
||||||
visibility: visible;
|
|
||||||
opacity: 1;
|
|
||||||
}
|
|
||||||
</style>
|
|
||||||
<div class="container">
|
<div class="container">
|
||||||
<div class="row">
|
<div class="row">
|
||||||
<div class="col-md-12 mt-4">
|
<div class="col-md-12 mt-4">
|
||||||
|
@ -100,9 +8,7 @@
|
||||||
<?= $this->session->flashdata('status'); ?>
|
<?= $this->session->flashdata('status'); ?>
|
||||||
</div>
|
</div>
|
||||||
<?php endif; ?>
|
<?php endif; ?>
|
||||||
<h3>
|
<h3>Published Forms</h3>
|
||||||
Published Forms
|
|
||||||
</h3>
|
|
||||||
</div>
|
</div>
|
||||||
<div class="card-body">
|
<div class="card-body">
|
||||||
<!-- here your table will occur -->
|
<!-- here your table will occur -->
|
||||||
|
@ -121,24 +27,17 @@
|
||||||
foreach ($forms as $row): ?>
|
foreach ($forms as $row): ?>
|
||||||
<tr>
|
<tr>
|
||||||
<td><?php echo $serialNumber++; ?></td>
|
<td><?php echo $serialNumber++; ?></td>
|
||||||
<td class="title-column">
|
<td class="title-column"><?php echo $row->title; ?></td>
|
||||||
<?php echo $row->title; ?>
|
|
||||||
</td>
|
|
||||||
<td>
|
<td>
|
||||||
<a href="<?php echo $row->response_link; ?>"
|
<a href="<?php echo $row->response_link; ?>" target="_blank"><?php echo $row->response_link; ?></a>
|
||||||
target="_blank"><?php echo $row->response_link; ?></a>
|
|
||||||
</td>
|
</td>
|
||||||
<td>
|
<td>
|
||||||
<label class="switch">
|
<label class="switch">
|
||||||
<input type="checkbox" class="toggle-switch"
|
<input type="checkbox" class="toggle-switch" data-form-id="<?php echo $row->id; ?>" <?php echo $row->is_responsive ? 'checked' : ''; ?>>
|
||||||
data-form-id="<?php echo $row->id; ?>" <?php echo $row->is_responsive ? 'checked' : ''; ?>>
|
|
||||||
<span class="slider round"></span>
|
<span class="slider round"></span>
|
||||||
<span
|
<span class="tooltip"><?php echo $row->is_responsive ? 'Active' : 'Inactive'; ?></span>
|
||||||
class="tooltip"><?php echo $row->is_responsive ? 'Active' : 'Disabled'; ?>
|
|
||||||
</span>
|
|
||||||
</label>
|
</label>
|
||||||
</td>
|
</td>
|
||||||
|
|
||||||
<td>
|
<td>
|
||||||
<a href="<?php echo base_url('form_preview/' . $row->id); ?>">
|
<a href="<?php echo base_url('form_preview/' . $row->id); ?>">
|
||||||
<i class="fas fa-eye"></i> <!-- Eye icon -->
|
<i class="fas fa-eye"></i> <!-- Eye icon -->
|
||||||
|
@ -150,3 +49,50 @@
|
||||||
</table>
|
</table>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<script>
|
||||||
|
$(document).ready(function() {
|
||||||
|
$('#basetable1').DataTable({
|
||||||
|
"pagingType": "full_numbers", // Full pagination controls
|
||||||
|
"lengthMenu": [10, 25, 50], // Options for number of rows per page
|
||||||
|
"language": {
|
||||||
|
"search": "Filter records:", // Custom search label
|
||||||
|
"lengthMenu": "Show _MENU_ entries" // Custom length menu label
|
||||||
|
},
|
||||||
|
"columnDefs": [
|
||||||
|
{ "orderable": false, "targets": 4 } // Disable sorting for the "View" column (index 4)
|
||||||
|
],
|
||||||
|
"order": [[0, "asc"]] // Default sort by "Title" column (index 1) in descending order
|
||||||
|
});
|
||||||
|
});
|
||||||
|
document.addEventListener('DOMContentLoaded', function() {
|
||||||
|
document.querySelectorAll('.toggle-switch').forEach(function(switchElement) {
|
||||||
|
switchElement.addEventListener('change', function() {
|
||||||
|
var formId = this.getAttribute('data-form-id');
|
||||||
|
var isResponsive = this.checked ? 1 : 0;
|
||||||
|
|
||||||
|
fetch(`<?php echo base_url('Publish_controller/toggle_responsive/'); ?>${formId}`, {
|
||||||
|
method: 'POST',
|
||||||
|
headers: {
|
||||||
|
'Content-Type': 'application/x-www-form-urlencoded',
|
||||||
|
'X-Requested-With': 'XMLHttpRequest'
|
||||||
|
},
|
||||||
|
body: `is_responsive=${isResponsive}`
|
||||||
|
})
|
||||||
|
.then(response => response.json())
|
||||||
|
.then(data => {
|
||||||
|
if (data.success) {
|
||||||
|
// Optionally, handle success
|
||||||
|
} else {
|
||||||
|
// Optionally, handle failure
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.catch(error => {
|
||||||
|
console.error('Error:', error);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
|
</script>
|
|
@ -59,17 +59,46 @@
|
||||||
.popup-message {
|
.popup-message {
|
||||||
display: none;
|
display: none;
|
||||||
position: fixed;
|
position: fixed;
|
||||||
top: 50%;
|
top: 10%;
|
||||||
left: 50%;
|
left: 40%;
|
||||||
transform: translate(-50%, -50%);
|
transform: translate(-20%, -40%);
|
||||||
background-color: white;
|
background-color: white;
|
||||||
padding: 20px;
|
padding: 30px;
|
||||||
box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
|
width: 80%;
|
||||||
|
max-width: 600px;
|
||||||
|
box-shadow: 0 0 15px rgba(0, 0, 0, 0.2);
|
||||||
z-index: 1000;
|
z-index: 1000;
|
||||||
|
border-top: 10px solid rgb(103, 58, 183);
|
||||||
|
border-radius: 8px;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
.popup-message h2 {
|
||||||
|
margin-top: 0;
|
||||||
|
color: rgb(103, 58, 183);
|
||||||
|
font-size: 24px; /* Increase font size */
|
||||||
|
}
|
||||||
|
|
||||||
|
.popup-message p {
|
||||||
|
font-size: 18px; /* Increase font size */
|
||||||
|
}
|
||||||
|
|
||||||
|
.popup-message button {
|
||||||
|
background-color: rgb(103, 58, 183);
|
||||||
|
color: white;
|
||||||
|
border: none;
|
||||||
|
padding: 10px 20px;
|
||||||
|
border-radius: 5px;
|
||||||
|
cursor: pointer;
|
||||||
|
}
|
||||||
|
|
||||||
|
.popup-message button:hover {
|
||||||
|
background-color: darkviolet;
|
||||||
}
|
}
|
||||||
</style>
|
</style>
|
||||||
|
|
||||||
</head>
|
</head>
|
||||||
|
|
||||||
<body>
|
<body>
|
||||||
<div class="container">
|
<div class="container">
|
||||||
<!-- <div class="form-header">
|
<!-- <div class="form-header">
|
||||||
|
|
|
@ -1,51 +1,75 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="en">
|
||||||
|
<head>
|
||||||
|
<!-- Other head elements -->
|
||||||
|
<meta charset="UTF-8">
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||||
|
<title>Responses for "<?php echo $form->title; ?>"</title>
|
||||||
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css">
|
||||||
<style>
|
<style>
|
||||||
.username-column {
|
.username-column {
|
||||||
color: darkblue; /* Dark blue color for title */
|
color: darkblue; /* Dark blue color for title */
|
||||||
}
|
}
|
||||||
</style>
|
</style>
|
||||||
<div class="container">
|
</head>
|
||||||
<div class="row">
|
<body>
|
||||||
<div class="col-md-12 mt-4">
|
<div class="container">
|
||||||
<div class="card">
|
<div class="row">
|
||||||
<div class="card-header">
|
<div class="col-md-12 mt-4">
|
||||||
<?php if ($this->session->flashdata('status')): ?>
|
<div class="card">
|
||||||
<div class="alert alert-success">
|
<div class="card-header">
|
||||||
<?= $this->session->flashdata('status'); ?>
|
<?php if ($this->session->flashdata('status')): ?>
|
||||||
</div>
|
<div class="alert alert-success">
|
||||||
<?php endif; ?>
|
<?= $this->session->flashdata('status'); ?>
|
||||||
<h3>
|
</div>
|
||||||
Responses for "<?php echo $form->title; ?>"
|
<?php endif; ?>
|
||||||
</h3>
|
<h3>Responses for "<?php echo $form->title; ?>"</h3>
|
||||||
</div>
|
<!-- <a href="<?php echo base_url('Response_submit/summary/' . $form->id); ?>" class="btn btn-primary">View Summary</a> -->
|
||||||
<div class="card-body">
|
</div>
|
||||||
<table id="basetable1" class="table table-bordered">
|
<div class="card-body">
|
||||||
<thead>
|
<table id="basetable1" class="table table-bordered">
|
||||||
<tr>
|
<thead>
|
||||||
<th>Username</th>
|
|
||||||
<th>Submitted At</th>
|
|
||||||
<th>View</th>
|
|
||||||
</tr>
|
|
||||||
</thead>
|
|
||||||
<tbody>
|
|
||||||
<?php foreach ($responses as $response): ?>
|
|
||||||
<tr>
|
<tr>
|
||||||
|
<th>Username</th>
|
||||||
<td class="username-column"><?php echo $response->username; ?></td>
|
<th>Submitted At</th>
|
||||||
<td><?php echo $response->submitted_at; ?></td>
|
<th>View</th>
|
||||||
<td>
|
|
||||||
<a href="<?php echo base_url('responses/view/' . $response->response_id); ?>">
|
|
||||||
<i class="fas fa-eye"></i> <!-- Eye icon -->
|
|
||||||
</a>
|
|
||||||
</td>
|
|
||||||
</tr>
|
</tr>
|
||||||
<?php endforeach; ?>
|
</thead>
|
||||||
</tbody>
|
<tbody>
|
||||||
</table>
|
<?php foreach ($responses as $response): ?>
|
||||||
|
<tr>
|
||||||
|
<td class="username-column"><?php echo $response->username; ?></td>
|
||||||
|
<td><?php echo $response->submitted_at; ?></td>
|
||||||
|
<td>
|
||||||
|
<a href="<?php echo base_url('responses/view/' . $response->response_id); ?>">
|
||||||
|
<i class="fas fa-eye"></i> <!-- Eye icon -->
|
||||||
|
</a>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<?php endforeach; ?>
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
|
||||||
|
<script>
|
||||||
|
$(document).ready(function() {
|
||||||
|
$('#basetable1').DataTable({
|
||||||
|
"pagingType": "full_numbers",
|
||||||
|
"lengthMenu": [10, 25, 50],
|
||||||
|
"language": {
|
||||||
|
"search": "Filter records:",
|
||||||
|
"lengthMenu": "Show _MENU_ entries"
|
||||||
|
},
|
||||||
|
"columnDefs": [
|
||||||
|
{ "orderable": false, "targets": 2 }
|
||||||
|
],
|
||||||
|
"order": [[1, "desc"]]
|
||||||
|
});
|
||||||
|
});
|
||||||
|
</script>
|
||||||
</body>
|
</body>
|
||||||
</html>
|
</html>
|
||||||
|
|
|
@ -1,17 +1,78 @@
|
||||||
|
|
||||||
<script>
|
<script>
|
||||||
$('#basetable1').DataTable({
|
$(document).ready(function() {
|
||||||
"pagingType": "full_numbers", // Full pagination controls
|
$('#basetable1').DataTable({
|
||||||
"lengthMenu": [10, 25, 50], // Options for number of rows per page
|
"pagingType": "full_numbers", // Full pagination controls
|
||||||
"language": {
|
"lengthMenu": [10, 25, 50], // Options for number of rows per page
|
||||||
"search": "Filter records:", // Custom search label
|
"language": {
|
||||||
"lengthMenu": "Show _MENU_ entries" // Custom length menu label
|
"search": "Filter records:", // Custom search label
|
||||||
},
|
"lengthMenu": "Show _MENU_ entries" // Custom length menu label
|
||||||
"columnDefs": [
|
},
|
||||||
{ "orderable": false, "targets": 2 } // Disable sorting for the "View" column (index 2)
|
"columnDefs": [
|
||||||
],
|
{ "orderable": false, "targets": 5 } // Disable sorting for the "View" column (index 5)
|
||||||
"order": [[1, "desc"]] // Default sort by "Filled At" column (index 1) in descending order
|
],
|
||||||
|
"order": [[3, "desc"]] // Default sort by "Created On" column (index 3) in descending order
|
||||||
|
});
|
||||||
|
|
||||||
|
updateCardColors();
|
||||||
|
});
|
||||||
|
|
||||||
|
document.addEventListener('DOMContentLoaded', function() {
|
||||||
|
document.querySelectorAll('.toggle-switch').forEach(function(switchElement) {
|
||||||
|
switchElement.addEventListener('change', function() {
|
||||||
|
var formId = this.getAttribute('data-form-id');
|
||||||
|
var isResponsive = this.checked ? 1 : 0;
|
||||||
|
|
||||||
|
fetch(`<?php echo base_url('Publish_controller/toggle_responsive/'); ?>${formId}`, {
|
||||||
|
method: 'POST',
|
||||||
|
headers: {
|
||||||
|
'Content-Type': 'application/x-www-form-urlencoded',
|
||||||
|
'X-Requested-With': 'XMLHttpRequest'
|
||||||
|
},
|
||||||
|
body: `is_responsive=${isResponsive}`
|
||||||
|
})
|
||||||
|
.then(response => response.json())
|
||||||
|
.then(data => {
|
||||||
|
if (data.success) {
|
||||||
|
// Optionally, handle success
|
||||||
|
} else {
|
||||||
|
// Optionally, handle failure
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.catch(error => {
|
||||||
|
console.error('Error:', error);
|
||||||
|
});
|
||||||
|
});
|
||||||
});
|
});
|
||||||
|
});
|
||||||
|
function updateCardColors() {
|
||||||
|
const totalForms = document.getElementById('total-forms');
|
||||||
|
const publishedForms = document.getElementById('published-forms');
|
||||||
|
const totalResponses = document.getElementById('total-responses');
|
||||||
|
|
||||||
|
const totalFormsValue = parseInt(totalForms.textContent);
|
||||||
|
const publishedFormsValue = parseInt(publishedForms.textContent);
|
||||||
|
const totalResponsesValue = parseInt(totalResponses.textContent);
|
||||||
|
|
||||||
|
// Update colors based on values
|
||||||
|
if (totalFormsValue) {
|
||||||
|
totalForms.classList.add('blue');
|
||||||
|
} else {
|
||||||
|
totalForms.classList.add('red');
|
||||||
|
}
|
||||||
|
|
||||||
|
if (publishedFormsValue) {
|
||||||
|
publishedForms.classList.add('green');
|
||||||
|
} else {
|
||||||
|
publishedForms.classList.add('red');
|
||||||
|
}
|
||||||
|
|
||||||
|
if (totalResponsesValue) {
|
||||||
|
totalResponses.classList.add('red');
|
||||||
|
} else {
|
||||||
|
totalResponses.classList.add('red');
|
||||||
|
}
|
||||||
|
}
|
||||||
$(document).ready(function() {
|
$(document).ready(function() {
|
||||||
// Fade out flash messages after 2 seconds
|
// Fade out flash messages after 2 seconds
|
||||||
setTimeout(function() {
|
setTimeout(function() {
|
||||||
|
@ -78,7 +139,7 @@ $(document).ready(function() {
|
||||||
});
|
});
|
||||||
|
|
||||||
// Login form validation
|
// Login form validation
|
||||||
$('#login-form').submit(function(e) {
|
$('#login-form').submit(function(e) {
|
||||||
e.preventDefault(); // Prevent default form submission
|
e.preventDefault(); // Prevent default form submission
|
||||||
|
|
||||||
// Clear all previous errors
|
// Clear all previous errors
|
||||||
|
@ -105,35 +166,6 @@ $(document).ready(function() {
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
document.addEventListener('DOMContentLoaded', function() {
|
|
||||||
document.querySelectorAll('.toggle-switch').forEach(function(switchElement) {
|
|
||||||
switchElement.addEventListener('change', function() {
|
|
||||||
var formId = this.getAttribute('data-form-id');
|
|
||||||
var isResponsive = this.checked ? 1 : 0;
|
|
||||||
|
|
||||||
fetch(`<?php echo base_url('Publish_controller/toggle_responsive/'); ?>${formId}`, {
|
|
||||||
method: 'POST',
|
|
||||||
headers: {
|
|
||||||
'Content-Type': 'application/x-www-form-urlencoded',
|
|
||||||
'X-Requested-With': 'XMLHttpRequest'
|
|
||||||
},
|
|
||||||
body: `is_responsive=${isResponsive}`
|
|
||||||
})
|
|
||||||
.then(response => response.json())
|
|
||||||
.then(data => {
|
|
||||||
if (data.success) {
|
|
||||||
// Optionally, handle success
|
|
||||||
} else {
|
|
||||||
// Optionally, handle failure
|
|
||||||
}
|
|
||||||
})
|
|
||||||
.catch(error => {
|
|
||||||
console.error('Error:', error);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</script>
|
</script>
|
||||||
|
</body>
|
||||||
|
</html>
|
|
@ -30,6 +30,86 @@
|
||||||
text-decoration: none !important; /* Ensures no underline on hover */
|
text-decoration: none !important; /* Ensures no underline on hover */
|
||||||
background: none !important; /* Ensures no background color on hover */
|
background: none !important; /* Ensures no background color on hover */
|
||||||
}
|
}
|
||||||
|
.title-column {
|
||||||
|
color: darkblue;
|
||||||
|
}
|
||||||
|
|
||||||
|
.draft-row {
|
||||||
|
background-color: #f0f0f0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.switch {
|
||||||
|
position: relative;
|
||||||
|
display: inline-block;
|
||||||
|
width: 34px;
|
||||||
|
height: 20px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.switch input {
|
||||||
|
opacity: 0;
|
||||||
|
width: 0;
|
||||||
|
height: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.slider {
|
||||||
|
position: absolute;
|
||||||
|
cursor: pointer;
|
||||||
|
top: 0;
|
||||||
|
left: 0;
|
||||||
|
right: 0;
|
||||||
|
bottom: 0;
|
||||||
|
background-color: #ccc;
|
||||||
|
transition: .4s;
|
||||||
|
}
|
||||||
|
|
||||||
|
.slider:before {
|
||||||
|
position: absolute;
|
||||||
|
content: "";
|
||||||
|
height: 14px;
|
||||||
|
width: 14px;
|
||||||
|
left: 3px;
|
||||||
|
bottom: 3px;
|
||||||
|
background-color: white;
|
||||||
|
transition: .4s;
|
||||||
|
}
|
||||||
|
|
||||||
|
input:checked + .slider {
|
||||||
|
background-color: #673AB7;
|
||||||
|
}
|
||||||
|
|
||||||
|
input:checked + .slider:before {
|
||||||
|
transform: translateX(14px);
|
||||||
|
}
|
||||||
|
|
||||||
|
.slider.round {
|
||||||
|
border-radius: 20px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.slider.round:before {
|
||||||
|
border-radius: 50%;
|
||||||
|
}
|
||||||
|
|
||||||
|
.switch .tooltip {
|
||||||
|
visibility: hidden;
|
||||||
|
width: 70px;
|
||||||
|
background-color: #555;
|
||||||
|
color: #fff;
|
||||||
|
text-align: center;
|
||||||
|
border-radius: 5px;
|
||||||
|
padding: 5px;
|
||||||
|
position: absolute;
|
||||||
|
z-index: 1;
|
||||||
|
bottom: 125%;
|
||||||
|
left: 290%;
|
||||||
|
margin-left: -60px;
|
||||||
|
opacity: 0;
|
||||||
|
transition: opacity 0.3s;
|
||||||
|
}
|
||||||
|
|
||||||
|
.switch:hover .tooltip {
|
||||||
|
visibility: visible;
|
||||||
|
opacity: 1;
|
||||||
|
}
|
||||||
</style>
|
</style>
|
||||||
|
|
||||||
<nav class="navbar navbar-inverse" style="background-color: rgb(103, 58, 183);">
|
<nav class="navbar navbar-inverse" style="background-color: rgb(103, 58, 183);">
|
||||||
|
|
|
@ -78,7 +78,7 @@ body {
|
||||||
.btn-success {
|
.btn-success {
|
||||||
margin-top: 20px;
|
margin-top: 20px;
|
||||||
position: relative;
|
position: relative;
|
||||||
left: 240px;
|
left: 247px;
|
||||||
background-color: rgb(103, 58, 183);
|
background-color: rgb(103, 58, 183);
|
||||||
border-color: rgb(103, 58, 183);
|
border-color: rgb(103, 58, 183);
|
||||||
color: white;
|
color: white;
|
||||||
|
|
|
@ -0,0 +1 @@
|
||||||
|
../husky/bin.js
|
|
@ -0,0 +1 @@
|
||||||
|
../lint-staged/bin/lint-staged.js
|
|
@ -0,0 +1 @@
|
||||||
|
../which/bin/node-which
|
|
@ -0,0 +1 @@
|
||||||
|
../pidtree/bin/pidtree.js
|
|
@ -0,0 +1 @@
|
||||||
|
../yaml/bin.mjs
|
|
@ -0,0 +1,665 @@
|
||||||
|
{
|
||||||
|
"name": "google_forms",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"lockfileVersion": 2,
|
||||||
|
"requires": true,
|
||||||
|
"packages": {
|
||||||
|
"node_modules/ansi-escapes": {
|
||||||
|
"version": "7.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-7.0.0.tgz",
|
||||||
|
"integrity": "sha512-GdYO7a61mR0fOlAsvC9/rIHf7L96sBc6dEWzeOu+KAea5bZyQRPIpojrVoI4AXGJS/ycu/fBTdLrUkA4ODrvjw==",
|
||||||
|
"dependencies": {
|
||||||
|
"environment": "^1.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/ansi-regex": {
|
||||||
|
"version": "6.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.0.1.tgz",
|
||||||
|
"integrity": "sha512-n5M855fKb2SsfMIiFFoVrABHJC8QtHwVx+mHWP3QcEqBHYienj5dHSgjbxtC0WEZXYt4wcD6zrQElDPhFuZgfA==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=12"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/chalk/ansi-regex?sponsor=1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/ansi-styles": {
|
||||||
|
"version": "6.2.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz",
|
||||||
|
"integrity": "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=12"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/chalk/ansi-styles?sponsor=1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/braces": {
|
||||||
|
"version": "3.0.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
|
||||||
|
"integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
|
||||||
|
"dependencies": {
|
||||||
|
"fill-range": "^7.1.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/chalk": {
|
||||||
|
"version": "5.3.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/chalk/-/chalk-5.3.0.tgz",
|
||||||
|
"integrity": "sha512-dLitG79d+GV1Nb/VYcCDFivJeK1hiukt9QjRNVOsUtTy1rR1YJsmpGGTZ3qJos+uw7WmWF4wUwBd9jxjocFC2w==",
|
||||||
|
"engines": {
|
||||||
|
"node": "^12.17.0 || ^14.13 || >=16.0.0"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/chalk/chalk?sponsor=1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/cli-cursor": {
|
||||||
|
"version": "5.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/cli-cursor/-/cli-cursor-5.0.0.tgz",
|
||||||
|
"integrity": "sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw==",
|
||||||
|
"dependencies": {
|
||||||
|
"restore-cursor": "^5.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/cli-truncate": {
|
||||||
|
"version": "4.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/cli-truncate/-/cli-truncate-4.0.0.tgz",
|
||||||
|
"integrity": "sha512-nPdaFdQ0h/GEigbPClz11D0v/ZJEwxmeVZGeMo3Z5StPtUTkA9o1lD6QwoirYiSDzbcwn2XcjwmCp68W1IS4TA==",
|
||||||
|
"dependencies": {
|
||||||
|
"slice-ansi": "^5.0.0",
|
||||||
|
"string-width": "^7.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/colorette": {
|
||||||
|
"version": "2.0.20",
|
||||||
|
"resolved": "https://registry.npmjs.org/colorette/-/colorette-2.0.20.tgz",
|
||||||
|
"integrity": "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w=="
|
||||||
|
},
|
||||||
|
"node_modules/commander": {
|
||||||
|
"version": "12.1.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/commander/-/commander-12.1.0.tgz",
|
||||||
|
"integrity": "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/cross-spawn": {
|
||||||
|
"version": "7.0.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz",
|
||||||
|
"integrity": "sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==",
|
||||||
|
"dependencies": {
|
||||||
|
"path-key": "^3.1.0",
|
||||||
|
"shebang-command": "^2.0.0",
|
||||||
|
"which": "^2.0.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/debug": {
|
||||||
|
"version": "4.3.6",
|
||||||
|
"resolved": "https://registry.npmjs.org/debug/-/debug-4.3.6.tgz",
|
||||||
|
"integrity": "sha512-O/09Bd4Z1fBrU4VzkhFqVgpPzaGbw6Sm9FEkBT1A/YBXQFGuuSxa1dN2nxgxS34JmKXqYx8CZAwEVoJFImUXIg==",
|
||||||
|
"dependencies": {
|
||||||
|
"ms": "2.1.2"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=6.0"
|
||||||
|
},
|
||||||
|
"peerDependenciesMeta": {
|
||||||
|
"supports-color": {
|
||||||
|
"optional": true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/emoji-regex": {
|
||||||
|
"version": "10.3.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.3.0.tgz",
|
||||||
|
"integrity": "sha512-QpLs9D9v9kArv4lfDEgg1X/gN5XLnf/A6l9cs8SPZLRZR3ZkY9+kwIQTxm+fsSej5UMYGE8fdoaZVIBlqG0XTw=="
|
||||||
|
},
|
||||||
|
"node_modules/environment": {
|
||||||
|
"version": "1.1.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/environment/-/environment-1.1.0.tgz",
|
||||||
|
"integrity": "sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/eventemitter3": {
|
||||||
|
"version": "5.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.1.tgz",
|
||||||
|
"integrity": "sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA=="
|
||||||
|
},
|
||||||
|
"node_modules/execa": {
|
||||||
|
"version": "8.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/execa/-/execa-8.0.1.tgz",
|
||||||
|
"integrity": "sha512-VyhnebXciFV2DESc+p6B+y0LjSm0krU4OgJN44qFAhBY0TJ+1V61tYD2+wHusZ6F9n5K+vl8k0sTy7PEfV4qpg==",
|
||||||
|
"dependencies": {
|
||||||
|
"cross-spawn": "^7.0.3",
|
||||||
|
"get-stream": "^8.0.1",
|
||||||
|
"human-signals": "^5.0.0",
|
||||||
|
"is-stream": "^3.0.0",
|
||||||
|
"merge-stream": "^2.0.0",
|
||||||
|
"npm-run-path": "^5.1.0",
|
||||||
|
"onetime": "^6.0.0",
|
||||||
|
"signal-exit": "^4.1.0",
|
||||||
|
"strip-final-newline": "^3.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=16.17"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sindresorhus/execa?sponsor=1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/fill-range": {
|
||||||
|
"version": "7.1.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
|
||||||
|
"integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
|
||||||
|
"dependencies": {
|
||||||
|
"to-regex-range": "^5.0.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/get-east-asian-width": {
|
||||||
|
"version": "1.2.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.2.0.tgz",
|
||||||
|
"integrity": "sha512-2nk+7SIVb14QrgXFHcm84tD4bKQz0RxPuMT8Ag5KPOq7J5fEmAg0UbXdTOSHqNuHSU28k55qnceesxXRZGzKWA==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/get-stream": {
|
||||||
|
"version": "8.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/get-stream/-/get-stream-8.0.1.tgz",
|
||||||
|
"integrity": "sha512-VaUJspBffn/LMCJVoMvSAdmscJyS1auj5Zulnn5UoYcY531UWmdwhRWkcGKnGU93m5HSXP9LP2usOryrBtQowA==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=16"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/human-signals": {
|
||||||
|
"version": "5.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/human-signals/-/human-signals-5.0.0.tgz",
|
||||||
|
"integrity": "sha512-AXcZb6vzzrFAUE61HnN4mpLqd/cSIwNQjtNWR0euPm6y0iqx3G4gOXaIDdtdDwZmhwe82LA6+zinmW4UBWVePQ==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=16.17.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/husky": {
|
||||||
|
"version": "9.1.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/husky/-/husky-9.1.3.tgz",
|
||||||
|
"integrity": "sha512-ET3TQmQgdIu0pt+jKkpo5oGyg/4MQZpG6xcam5J5JyNJV+CBT23OBpCF15bKHKycRyMH9k6ONy8g2HdGIsSkMQ==",
|
||||||
|
"dev": true,
|
||||||
|
"bin": {
|
||||||
|
"husky": "bin.js"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/typicode"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/is-fullwidth-code-point": {
|
||||||
|
"version": "4.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-4.0.0.tgz",
|
||||||
|
"integrity": "sha512-O4L094N2/dZ7xqVdrXhh9r1KODPJpFms8B5sGdJLPy664AgvXsreZUyCQQNItZRDlYug4xStLjNp/sz3HvBowQ==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=12"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/is-number": {
|
||||||
|
"version": "7.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
|
||||||
|
"integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=0.12.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/is-stream": {
|
||||||
|
"version": "3.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/is-stream/-/is-stream-3.0.0.tgz",
|
||||||
|
"integrity": "sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA==",
|
||||||
|
"engines": {
|
||||||
|
"node": "^12.20.0 || ^14.13.1 || >=16.0.0"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/isexe": {
|
||||||
|
"version": "2.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
|
||||||
|
"integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="
|
||||||
|
},
|
||||||
|
"node_modules/lilconfig": {
|
||||||
|
"version": "3.1.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-3.1.2.tgz",
|
||||||
|
"integrity": "sha512-eop+wDAvpItUys0FWkHIKeC9ybYrTGbU41U5K7+bttZZeohvnY7M9dZ5kB21GNWiFT2q1OoPTvncPCgSOVO5ow==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=14"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/antonk52"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/lint-staged": {
|
||||||
|
"version": "15.2.7",
|
||||||
|
"resolved": "https://registry.npmjs.org/lint-staged/-/lint-staged-15.2.7.tgz",
|
||||||
|
"integrity": "sha512-+FdVbbCZ+yoh7E/RosSdqKJyUM2OEjTciH0TFNkawKgvFp1zbGlEC39RADg+xKBG1R4mhoH2j85myBQZ5wR+lw==",
|
||||||
|
"dev": true,
|
||||||
|
"dependencies": {
|
||||||
|
"chalk": "~5.3.0",
|
||||||
|
"commander": "~12.1.0",
|
||||||
|
"debug": "~4.3.4",
|
||||||
|
"execa": "~8.0.1",
|
||||||
|
"lilconfig": "~3.1.1",
|
||||||
|
"listr2": "~8.2.1",
|
||||||
|
"micromatch": "~4.0.7",
|
||||||
|
"pidtree": "~0.6.0",
|
||||||
|
"string-argv": "~0.3.2",
|
||||||
|
"yaml": "~2.4.2"
|
||||||
|
},
|
||||||
|
"bin": {
|
||||||
|
"lint-staged": "bin/lint-staged.js"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18.12.0"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://opencollective.com/lint-staged"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/listr2": {
|
||||||
|
"version": "8.2.4",
|
||||||
|
"resolved": "https://registry.npmjs.org/listr2/-/listr2-8.2.4.tgz",
|
||||||
|
"integrity": "sha512-opevsywziHd3zHCVQGAj8zu+Z3yHNkkoYhWIGnq54RrCVwLz0MozotJEDnKsIBLvkfLGN6BLOyAeRrYI0pKA4g==",
|
||||||
|
"dependencies": {
|
||||||
|
"cli-truncate": "^4.0.0",
|
||||||
|
"colorette": "^2.0.20",
|
||||||
|
"eventemitter3": "^5.0.1",
|
||||||
|
"log-update": "^6.1.0",
|
||||||
|
"rfdc": "^1.4.1",
|
||||||
|
"wrap-ansi": "^9.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18.0.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/log-update": {
|
||||||
|
"version": "6.1.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/log-update/-/log-update-6.1.0.tgz",
|
||||||
|
"integrity": "sha512-9ie8ItPR6tjY5uYJh8K/Zrv/RMZ5VOlOWvtZdEHYSTFKZfIBPQa9tOAEeAWhd+AnIneLJ22w5fjOYtoutpWq5w==",
|
||||||
|
"dependencies": {
|
||||||
|
"ansi-escapes": "^7.0.0",
|
||||||
|
"cli-cursor": "^5.0.0",
|
||||||
|
"slice-ansi": "^7.1.0",
|
||||||
|
"strip-ansi": "^7.1.0",
|
||||||
|
"wrap-ansi": "^9.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/log-update/node_modules/is-fullwidth-code-point": {
|
||||||
|
"version": "5.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-5.0.0.tgz",
|
||||||
|
"integrity": "sha512-OVa3u9kkBbw7b8Xw5F9P+D/T9X+Z4+JruYVNapTjPYZYUznQ5YfWeFkOj606XYYW8yugTfC8Pj0hYqvi4ryAhA==",
|
||||||
|
"dependencies": {
|
||||||
|
"get-east-asian-width": "^1.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/log-update/node_modules/slice-ansi": {
|
||||||
|
"version": "7.1.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-7.1.0.tgz",
|
||||||
|
"integrity": "sha512-bSiSngZ/jWeX93BqeIAbImyTbEihizcwNjFoRUIY/T1wWQsfsm2Vw1agPKylXvQTU7iASGdHhyqRlqQzfz+Htg==",
|
||||||
|
"dependencies": {
|
||||||
|
"ansi-styles": "^6.2.1",
|
||||||
|
"is-fullwidth-code-point": "^5.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/chalk/slice-ansi?sponsor=1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/merge-stream": {
|
||||||
|
"version": "2.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz",
|
||||||
|
"integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w=="
|
||||||
|
},
|
||||||
|
"node_modules/micromatch": {
|
||||||
|
"version": "4.0.7",
|
||||||
|
"resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.7.tgz",
|
||||||
|
"integrity": "sha512-LPP/3KorzCwBxfeUuZmaR6bG2kdeHSbe0P2tY3FLRU4vYrjYz5hI4QZwV0njUx3jeuKe67YukQ1LSPZBKDqO/Q==",
|
||||||
|
"dependencies": {
|
||||||
|
"braces": "^3.0.3",
|
||||||
|
"picomatch": "^2.3.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=8.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/mimic-fn": {
|
||||||
|
"version": "4.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-4.0.0.tgz",
|
||||||
|
"integrity": "sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=12"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/mimic-function": {
|
||||||
|
"version": "5.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/mimic-function/-/mimic-function-5.0.1.tgz",
|
||||||
|
"integrity": "sha512-VP79XUPxV2CigYP3jWwAUFSku2aKqBH7uTAapFWCBqutsbmDo96KY5o8uh6U+/YSIn5OxJnXp73beVkpqMIGhA==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/ms": {
|
||||||
|
"version": "2.1.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz",
|
||||||
|
"integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w=="
|
||||||
|
},
|
||||||
|
"node_modules/npm-run-path": {
|
||||||
|
"version": "5.3.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-5.3.0.tgz",
|
||||||
|
"integrity": "sha512-ppwTtiJZq0O/ai0z7yfudtBpWIoxM8yE6nHi1X47eFR2EWORqfbu6CnPlNsjeN683eT0qG6H/Pyf9fCcvjnnnQ==",
|
||||||
|
"dependencies": {
|
||||||
|
"path-key": "^4.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": "^12.20.0 || ^14.13.1 || >=16.0.0"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/npm-run-path/node_modules/path-key": {
|
||||||
|
"version": "4.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/path-key/-/path-key-4.0.0.tgz",
|
||||||
|
"integrity": "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=12"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/onetime": {
|
||||||
|
"version": "6.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/onetime/-/onetime-6.0.0.tgz",
|
||||||
|
"integrity": "sha512-1FlR+gjXK7X+AsAHso35MnyN5KqGwJRi/31ft6x0M194ht7S+rWAvd7PHss9xSKMzE0asv1pyIHaJYq+BbacAQ==",
|
||||||
|
"dependencies": {
|
||||||
|
"mimic-fn": "^4.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=12"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/path-key": {
|
||||||
|
"version": "3.1.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
|
||||||
|
"integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/picomatch": {
|
||||||
|
"version": "2.3.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
|
||||||
|
"integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=8.6"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/jonschlinkert"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/pidtree": {
|
||||||
|
"version": "0.6.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/pidtree/-/pidtree-0.6.0.tgz",
|
||||||
|
"integrity": "sha512-eG2dWTVw5bzqGRztnHExczNxt5VGsE6OwTeCG3fdUf9KBsZzO3R5OIIIzWR+iZA0NtZ+RDVdaoE2dK1cn6jH4g==",
|
||||||
|
"bin": {
|
||||||
|
"pidtree": "bin/pidtree.js"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=0.10"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/restore-cursor": {
|
||||||
|
"version": "5.1.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/restore-cursor/-/restore-cursor-5.1.0.tgz",
|
||||||
|
"integrity": "sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA==",
|
||||||
|
"dependencies": {
|
||||||
|
"onetime": "^7.0.0",
|
||||||
|
"signal-exit": "^4.1.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/restore-cursor/node_modules/onetime": {
|
||||||
|
"version": "7.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/onetime/-/onetime-7.0.0.tgz",
|
||||||
|
"integrity": "sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ==",
|
||||||
|
"dependencies": {
|
||||||
|
"mimic-function": "^5.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/rfdc": {
|
||||||
|
"version": "1.4.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/rfdc/-/rfdc-1.4.1.tgz",
|
||||||
|
"integrity": "sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA=="
|
||||||
|
},
|
||||||
|
"node_modules/shebang-command": {
|
||||||
|
"version": "2.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
|
||||||
|
"integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
|
||||||
|
"dependencies": {
|
||||||
|
"shebang-regex": "^3.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/shebang-regex": {
|
||||||
|
"version": "3.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
|
||||||
|
"integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/signal-exit": {
|
||||||
|
"version": "4.1.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
|
||||||
|
"integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=14"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/isaacs"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/slice-ansi": {
|
||||||
|
"version": "5.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-5.0.0.tgz",
|
||||||
|
"integrity": "sha512-FC+lgizVPfie0kkhqUScwRu1O/lF6NOgJmlCgK+/LYxDCTk8sGelYaHDhFcDN+Sn3Cv+3VSa4Byeo+IMCzpMgQ==",
|
||||||
|
"dependencies": {
|
||||||
|
"ansi-styles": "^6.0.0",
|
||||||
|
"is-fullwidth-code-point": "^4.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=12"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/chalk/slice-ansi?sponsor=1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/string-argv": {
|
||||||
|
"version": "0.3.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/string-argv/-/string-argv-0.3.2.tgz",
|
||||||
|
"integrity": "sha512-aqD2Q0144Z+/RqG52NeHEkZauTAUWJO8c6yTftGJKO3Tja5tUgIfmIl6kExvhtxSDP7fXB6DvzkfMpCd/F3G+Q==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=0.6.19"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/string-width": {
|
||||||
|
"version": "7.2.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz",
|
||||||
|
"integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==",
|
||||||
|
"dependencies": {
|
||||||
|
"emoji-regex": "^10.3.0",
|
||||||
|
"get-east-asian-width": "^1.0.0",
|
||||||
|
"strip-ansi": "^7.1.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/strip-ansi": {
|
||||||
|
"version": "7.1.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz",
|
||||||
|
"integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==",
|
||||||
|
"dependencies": {
|
||||||
|
"ansi-regex": "^6.0.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=12"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/chalk/strip-ansi?sponsor=1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/strip-final-newline": {
|
||||||
|
"version": "3.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-3.0.0.tgz",
|
||||||
|
"integrity": "sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw==",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=12"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/to-regex-range": {
|
||||||
|
"version": "5.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
|
||||||
|
"integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
|
||||||
|
"dependencies": {
|
||||||
|
"is-number": "^7.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=8.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/which": {
|
||||||
|
"version": "2.0.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
|
||||||
|
"integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
|
||||||
|
"dependencies": {
|
||||||
|
"isexe": "^2.0.0"
|
||||||
|
},
|
||||||
|
"bin": {
|
||||||
|
"node-which": "bin/node-which"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/wrap-ansi": {
|
||||||
|
"version": "9.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.0.tgz",
|
||||||
|
"integrity": "sha512-G8ura3S+3Z2G+mkgNRq8dqaFZAuxfsxpBB8OCTGRTCtp+l/v9nbFNmCUP1BZMts3G1142MsZfn6eeUKrr4PD1Q==",
|
||||||
|
"dependencies": {
|
||||||
|
"ansi-styles": "^6.2.1",
|
||||||
|
"string-width": "^7.0.0",
|
||||||
|
"strip-ansi": "^7.1.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/chalk/wrap-ansi?sponsor=1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/yaml": {
|
||||||
|
"version": "2.4.5",
|
||||||
|
"resolved": "https://registry.npmjs.org/yaml/-/yaml-2.4.5.tgz",
|
||||||
|
"integrity": "sha512-aBx2bnqDzVOyNKfsysjA2ms5ZlnjSAW2eG3/L5G/CSujfjLJTJsEw1bGw8kCf04KodQWk1pxlGnZ56CRxiawmg==",
|
||||||
|
"bin": {
|
||||||
|
"yaml": "bin.mjs"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 14"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,262 @@
|
||||||
|
// From https://github.com/sindresorhus/type-fest
|
||||||
|
type Primitive =
|
||||||
|
| null // eslint-disable-line @typescript-eslint/ban-types
|
||||||
|
| undefined
|
||||||
|
| string
|
||||||
|
| number
|
||||||
|
| boolean
|
||||||
|
| symbol
|
||||||
|
| bigint;
|
||||||
|
|
||||||
|
type LiteralUnion<LiteralType, BaseType extends Primitive> =
|
||||||
|
| LiteralType
|
||||||
|
| (BaseType & Record<never, never>);
|
||||||
|
// -
|
||||||
|
|
||||||
|
export type ImageOptions = {
|
||||||
|
/**
|
||||||
|
The width is given as a number followed by a unit, or the word `'auto'`.
|
||||||
|
|
||||||
|
- `N`: N character cells.
|
||||||
|
- `Npx`: N pixels.
|
||||||
|
- `N%`: N percent of the session's width or height.
|
||||||
|
- `auto`: The image's inherent size will be used to determine an appropriate dimension.
|
||||||
|
*/
|
||||||
|
readonly width?: LiteralUnion<'auto', number | string>;
|
||||||
|
|
||||||
|
/**
|
||||||
|
The height is given as a number followed by a unit, or the word `'auto'`.
|
||||||
|
|
||||||
|
- `N`: N character cells.
|
||||||
|
- `Npx`: N pixels.
|
||||||
|
- `N%`: N percent of the session's width or height.
|
||||||
|
- `auto`: The image's inherent size will be used to determine an appropriate dimension.
|
||||||
|
*/
|
||||||
|
readonly height?: LiteralUnion<'auto', number | string>;
|
||||||
|
|
||||||
|
/**
|
||||||
|
@default true
|
||||||
|
*/
|
||||||
|
readonly preserveAspectRatio?: boolean;
|
||||||
|
};
|
||||||
|
|
||||||
|
export type AnnotationOptions = {
|
||||||
|
/**
|
||||||
|
Nonzero number of columns to annotate.
|
||||||
|
|
||||||
|
Default: The remainder of the line.
|
||||||
|
*/
|
||||||
|
readonly length?: number;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Starting X coordinate.
|
||||||
|
|
||||||
|
Must be used with `y` and `length`.
|
||||||
|
|
||||||
|
Default: The cursor position
|
||||||
|
*/
|
||||||
|
readonly x?: number;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Starting Y coordinate.
|
||||||
|
|
||||||
|
Must be used with `x` and `length`.
|
||||||
|
|
||||||
|
Default: Cursor position.
|
||||||
|
*/
|
||||||
|
readonly y?: number;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Create a "hidden" annotation.
|
||||||
|
|
||||||
|
Annotations created this way can be shown using the "Show Annotations" iTerm command.
|
||||||
|
*/
|
||||||
|
readonly isHidden?: boolean;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
Set the absolute position of the cursor. `x0` `y0` is the top left of the screen.
|
||||||
|
*/
|
||||||
|
export function cursorTo(x: number, y?: number): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Set the position of the cursor relative to its current position.
|
||||||
|
*/
|
||||||
|
export function cursorMove(x: number, y?: number): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Move cursor up a specific amount of rows.
|
||||||
|
|
||||||
|
@param count - Count of rows to move up. Default is `1`.
|
||||||
|
*/
|
||||||
|
export function cursorUp(count?: number): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Move cursor down a specific amount of rows.
|
||||||
|
|
||||||
|
@param count - Count of rows to move down. Default is `1`.
|
||||||
|
*/
|
||||||
|
export function cursorDown(count?: number): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Move cursor forward a specific amount of rows.
|
||||||
|
|
||||||
|
@param count - Count of rows to move forward. Default is `1`.
|
||||||
|
*/
|
||||||
|
export function cursorForward(count?: number): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Move cursor backward a specific amount of rows.
|
||||||
|
|
||||||
|
@param count - Count of rows to move backward. Default is `1`.
|
||||||
|
*/
|
||||||
|
export function cursorBackward(count?: number): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Move cursor to the left side.
|
||||||
|
*/
|
||||||
|
export const cursorLeft: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Save cursor position.
|
||||||
|
*/
|
||||||
|
export const cursorSavePosition: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Restore saved cursor position.
|
||||||
|
*/
|
||||||
|
export const cursorRestorePosition: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Get cursor position.
|
||||||
|
*/
|
||||||
|
export const cursorGetPosition: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Move cursor to the next line.
|
||||||
|
*/
|
||||||
|
export const cursorNextLine: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Move cursor to the previous line.
|
||||||
|
*/
|
||||||
|
export const cursorPrevLine: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Hide cursor.
|
||||||
|
*/
|
||||||
|
export const cursorHide: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Show cursor.
|
||||||
|
*/
|
||||||
|
export const cursorShow: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Erase from the current cursor position up the specified amount of rows.
|
||||||
|
|
||||||
|
@param count - Count of rows to erase.
|
||||||
|
*/
|
||||||
|
export function eraseLines(count: number): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Erase from the current cursor position to the end of the current line.
|
||||||
|
*/
|
||||||
|
export const eraseEndLine: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Erase from the current cursor position to the start of the current line.
|
||||||
|
*/
|
||||||
|
export const eraseStartLine: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Erase the entire current line.
|
||||||
|
*/
|
||||||
|
export const eraseLine: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Erase the screen from the current line down to the bottom of the screen.
|
||||||
|
*/
|
||||||
|
export const eraseDown: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Erase the screen from the current line up to the top of the screen.
|
||||||
|
*/
|
||||||
|
export const eraseUp: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Erase the screen and move the cursor the top left position.
|
||||||
|
*/
|
||||||
|
export const eraseScreen: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Scroll display up one line.
|
||||||
|
*/
|
||||||
|
export const scrollUp: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Scroll display down one line.
|
||||||
|
*/
|
||||||
|
export const scrollDown: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Clear the terminal screen. (Viewport)
|
||||||
|
*/
|
||||||
|
export const clearScreen: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Clear the whole terminal, including scrollback buffer. (Not just the visible part of it)
|
||||||
|
*/
|
||||||
|
export const clearTerminal: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Enter the [alternative screen](https://terminalguide.namepad.de/mode/p47/).
|
||||||
|
*/
|
||||||
|
export const enterAlternativeScreen: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Exit the [alternative screen](https://terminalguide.namepad.de/mode/p47/), assuming `enterAlternativeScreen` was called before.
|
||||||
|
*/
|
||||||
|
export const exitAlternativeScreen: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Output a beeping sound.
|
||||||
|
*/
|
||||||
|
export const beep: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Create a clickable link.
|
||||||
|
|
||||||
|
[Supported terminals.](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda) Use [`supports-hyperlinks`](https://github.com/jamestalmage/supports-hyperlinks) to detect link support.
|
||||||
|
*/
|
||||||
|
export function link(text: string, url: string): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Display an image.
|
||||||
|
|
||||||
|
See [term-img](https://github.com/sindresorhus/term-img) for a higher-level module.
|
||||||
|
|
||||||
|
@param data - Image data. Usually read in with `fs.readFile()`.
|
||||||
|
*/
|
||||||
|
export function image(data: Uint8Array, options?: ImageOptions): string;
|
||||||
|
|
||||||
|
export const iTerm: {
|
||||||
|
/**
|
||||||
|
[Inform iTerm2](https://www.iterm2.com/documentation-escape-codes.html) of the current directory to help semantic history and enable [Cmd-clicking relative paths](https://coderwall.com/p/b7e82q/quickly-open-files-in-iterm-with-cmd-click).
|
||||||
|
|
||||||
|
@param cwd - Current directory. Default: `process.cwd()`.
|
||||||
|
*/
|
||||||
|
setCwd(cwd?: string): string,
|
||||||
|
|
||||||
|
/**
|
||||||
|
An annotation looks like this when shown:
|
||||||
|
|
||||||
|
![screenshot of iTerm annotation](https://user-images.githubusercontent.com/924465/64382136-b60ac700-cfe9-11e9-8a35-9682e8dc4b72.png)
|
||||||
|
|
||||||
|
See the [iTerm Proprietary Escape Codes documentation](https://iterm2.com/documentation-escape-codes.html) for more information.
|
||||||
|
|
||||||
|
@param message - The message to display within the annotation. The `|` character is disallowed and will be stripped.
|
||||||
|
@returns An escape code which will create an annotation when printed in iTerm2.
|
||||||
|
*/
|
||||||
|
annotation(message: string, options?: AnnotationOptions): string
|
||||||
|
};
|
|
@ -0,0 +1,163 @@
|
||||||
|
import process from 'node:process';
|
||||||
|
import {isBrowser} from 'environment';
|
||||||
|
|
||||||
|
const ESC = '\u001B[';
|
||||||
|
const OSC = '\u001B]';
|
||||||
|
const BEL = '\u0007';
|
||||||
|
const SEP = ';';
|
||||||
|
|
||||||
|
const isTerminalApp = !isBrowser && process.env.TERM_PROGRAM === 'Apple_Terminal';
|
||||||
|
const isWindows = !isBrowser && process.platform === 'win32';
|
||||||
|
|
||||||
|
const cwdFunction = isBrowser ? () => {
|
||||||
|
throw new Error('`process.cwd()` only works in Node.js, not the browser.');
|
||||||
|
} : process.cwd;
|
||||||
|
|
||||||
|
export const cursorTo = (x, y) => {
|
||||||
|
if (typeof x !== 'number') {
|
||||||
|
throw new TypeError('The `x` argument is required');
|
||||||
|
}
|
||||||
|
|
||||||
|
if (typeof y !== 'number') {
|
||||||
|
return ESC + (x + 1) + 'G';
|
||||||
|
}
|
||||||
|
|
||||||
|
return ESC + (y + 1) + SEP + (x + 1) + 'H';
|
||||||
|
};
|
||||||
|
|
||||||
|
export const cursorMove = (x, y) => {
|
||||||
|
if (typeof x !== 'number') {
|
||||||
|
throw new TypeError('The `x` argument is required');
|
||||||
|
}
|
||||||
|
|
||||||
|
let returnValue = '';
|
||||||
|
|
||||||
|
if (x < 0) {
|
||||||
|
returnValue += ESC + (-x) + 'D';
|
||||||
|
} else if (x > 0) {
|
||||||
|
returnValue += ESC + x + 'C';
|
||||||
|
}
|
||||||
|
|
||||||
|
if (y < 0) {
|
||||||
|
returnValue += ESC + (-y) + 'A';
|
||||||
|
} else if (y > 0) {
|
||||||
|
returnValue += ESC + y + 'B';
|
||||||
|
}
|
||||||
|
|
||||||
|
return returnValue;
|
||||||
|
};
|
||||||
|
|
||||||
|
export const cursorUp = (count = 1) => ESC + count + 'A';
|
||||||
|
export const cursorDown = (count = 1) => ESC + count + 'B';
|
||||||
|
export const cursorForward = (count = 1) => ESC + count + 'C';
|
||||||
|
export const cursorBackward = (count = 1) => ESC + count + 'D';
|
||||||
|
|
||||||
|
export const cursorLeft = ESC + 'G';
|
||||||
|
export const cursorSavePosition = isTerminalApp ? '\u001B7' : ESC + 's';
|
||||||
|
export const cursorRestorePosition = isTerminalApp ? '\u001B8' : ESC + 'u';
|
||||||
|
export const cursorGetPosition = ESC + '6n';
|
||||||
|
export const cursorNextLine = ESC + 'E';
|
||||||
|
export const cursorPrevLine = ESC + 'F';
|
||||||
|
export const cursorHide = ESC + '?25l';
|
||||||
|
export const cursorShow = ESC + '?25h';
|
||||||
|
|
||||||
|
export const eraseLines = count => {
|
||||||
|
let clear = '';
|
||||||
|
|
||||||
|
for (let i = 0; i < count; i++) {
|
||||||
|
clear += eraseLine + (i < count - 1 ? cursorUp() : '');
|
||||||
|
}
|
||||||
|
|
||||||
|
if (count) {
|
||||||
|
clear += cursorLeft;
|
||||||
|
}
|
||||||
|
|
||||||
|
return clear;
|
||||||
|
};
|
||||||
|
|
||||||
|
export const eraseEndLine = ESC + 'K';
|
||||||
|
export const eraseStartLine = ESC + '1K';
|
||||||
|
export const eraseLine = ESC + '2K';
|
||||||
|
export const eraseDown = ESC + 'J';
|
||||||
|
export const eraseUp = ESC + '1J';
|
||||||
|
export const eraseScreen = ESC + '2J';
|
||||||
|
export const scrollUp = ESC + 'S';
|
||||||
|
export const scrollDown = ESC + 'T';
|
||||||
|
|
||||||
|
export const clearScreen = '\u001Bc';
|
||||||
|
|
||||||
|
export const clearTerminal = isWindows
|
||||||
|
? `${eraseScreen}${ESC}0f`
|
||||||
|
// 1. Erases the screen (Only done in case `2` is not supported)
|
||||||
|
// 2. Erases the whole screen including scrollback buffer
|
||||||
|
// 3. Moves cursor to the top-left position
|
||||||
|
// More info: https://www.real-world-systems.com/docs/ANSIcode.html
|
||||||
|
: `${eraseScreen}${ESC}3J${ESC}H`;
|
||||||
|
|
||||||
|
export const enterAlternativeScreen = ESC + '?1049h';
|
||||||
|
export const exitAlternativeScreen = ESC + '?1049l';
|
||||||
|
|
||||||
|
export const beep = BEL;
|
||||||
|
|
||||||
|
export const link = (text, url) => [
|
||||||
|
OSC,
|
||||||
|
'8',
|
||||||
|
SEP,
|
||||||
|
SEP,
|
||||||
|
url,
|
||||||
|
BEL,
|
||||||
|
text,
|
||||||
|
OSC,
|
||||||
|
'8',
|
||||||
|
SEP,
|
||||||
|
SEP,
|
||||||
|
BEL,
|
||||||
|
].join('');
|
||||||
|
|
||||||
|
export const image = (data, options = {}) => {
|
||||||
|
let returnValue = `${OSC}1337;File=inline=1`;
|
||||||
|
|
||||||
|
if (options.width) {
|
||||||
|
returnValue += `;width=${options.width}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (options.height) {
|
||||||
|
returnValue += `;height=${options.height}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (options.preserveAspectRatio === false) {
|
||||||
|
returnValue += ';preserveAspectRatio=0';
|
||||||
|
}
|
||||||
|
|
||||||
|
return returnValue + ':' + Buffer.from(data).toString('base64') + BEL;
|
||||||
|
};
|
||||||
|
|
||||||
|
export const iTerm = {
|
||||||
|
setCwd: (cwd = cwdFunction()) => `${OSC}50;CurrentDir=${cwd}${BEL}`,
|
||||||
|
|
||||||
|
annotation(message, options = {}) {
|
||||||
|
let returnValue = `${OSC}1337;`;
|
||||||
|
|
||||||
|
const hasX = options.x !== undefined;
|
||||||
|
const hasY = options.y !== undefined;
|
||||||
|
if ((hasX || hasY) && !(hasX && hasY && options.length !== undefined)) {
|
||||||
|
throw new Error('`x`, `y` and `length` must be defined when `x` or `y` is defined');
|
||||||
|
}
|
||||||
|
|
||||||
|
message = message.replaceAll('|', '');
|
||||||
|
|
||||||
|
returnValue += options.isHidden ? 'AddHiddenAnnotation=' : 'AddAnnotation=';
|
||||||
|
|
||||||
|
if (options.length > 0) {
|
||||||
|
returnValue += (
|
||||||
|
hasX
|
||||||
|
? [message, options.length, options.x, options.y]
|
||||||
|
: [options.length, message]
|
||||||
|
).join('|');
|
||||||
|
} else {
|
||||||
|
returnValue += message;
|
||||||
|
}
|
||||||
|
|
||||||
|
return returnValue + BEL;
|
||||||
|
},
|
||||||
|
};
|
|
@ -0,0 +1,2 @@
|
||||||
|
export * from './base.js';
|
||||||
|
export * as default from './base.js';
|
|
@ -0,0 +1,2 @@
|
||||||
|
export * from './base.js';
|
||||||
|
export * as default from './base.js';
|
|
@ -0,0 +1,9 @@
|
||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
@ -0,0 +1,70 @@
|
||||||
|
{
|
||||||
|
"name": "ansi-escapes",
|
||||||
|
"version": "7.0.0",
|
||||||
|
"description": "ANSI escape codes for manipulating the terminal",
|
||||||
|
"license": "MIT",
|
||||||
|
"repository": "sindresorhus/ansi-escapes",
|
||||||
|
"funding": "https://github.com/sponsors/sindresorhus",
|
||||||
|
"author": {
|
||||||
|
"name": "Sindre Sorhus",
|
||||||
|
"email": "sindresorhus@gmail.com",
|
||||||
|
"url": "https://sindresorhus.com"
|
||||||
|
},
|
||||||
|
"type": "module",
|
||||||
|
"exports": {
|
||||||
|
"types": "./index.d.ts",
|
||||||
|
"default": "./index.js"
|
||||||
|
},
|
||||||
|
"sideEffects": false,
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"test": "ava && tsd",
|
||||||
|
"//test": "xo && ava && tsd"
|
||||||
|
},
|
||||||
|
"files": [
|
||||||
|
"index.js",
|
||||||
|
"index.d.ts",
|
||||||
|
"base.js",
|
||||||
|
"base.d.ts"
|
||||||
|
],
|
||||||
|
"keywords": [
|
||||||
|
"ansi",
|
||||||
|
"terminal",
|
||||||
|
"console",
|
||||||
|
"cli",
|
||||||
|
"string",
|
||||||
|
"tty",
|
||||||
|
"escape",
|
||||||
|
"escapes",
|
||||||
|
"formatting",
|
||||||
|
"shell",
|
||||||
|
"xterm",
|
||||||
|
"log",
|
||||||
|
"logging",
|
||||||
|
"command-line",
|
||||||
|
"text",
|
||||||
|
"vt100",
|
||||||
|
"sequence",
|
||||||
|
"control",
|
||||||
|
"code",
|
||||||
|
"codes",
|
||||||
|
"cursor",
|
||||||
|
"iterm",
|
||||||
|
"iterm2",
|
||||||
|
"clear",
|
||||||
|
"screen",
|
||||||
|
"erase",
|
||||||
|
"scrollback"
|
||||||
|
],
|
||||||
|
"dependencies": {
|
||||||
|
"environment": "^1.0.0"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@types/node": "20.12.8",
|
||||||
|
"ava": "^6.1.2",
|
||||||
|
"tsd": "0.31.0",
|
||||||
|
"xo": "^0.58.0"
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,261 @@
|
||||||
|
# ansi-escapes
|
||||||
|
|
||||||
|
> [ANSI escape codes](https://www2.ccs.neu.edu/research/gpc/VonaUtils/vona/terminal/vtansi.htm) for manipulating the terminal
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
```sh
|
||||||
|
npm install ansi-escapes
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```js
|
||||||
|
import ansiEscapes from 'ansi-escapes';
|
||||||
|
|
||||||
|
// Moves the cursor two rows up and to the left
|
||||||
|
process.stdout.write(ansiEscapes.cursorUp(2) + ansiEscapes.cursorLeft);
|
||||||
|
//=> '\u001B[2A\u001B[1000D'
|
||||||
|
```
|
||||||
|
|
||||||
|
Or use named exports...
|
||||||
|
|
||||||
|
```js
|
||||||
|
import {cursorUp, cursorLeft} from 'ansi-escapes';
|
||||||
|
|
||||||
|
// etc, as above...
|
||||||
|
```
|
||||||
|
|
||||||
|
**You can also use it in the browser with Xterm.js:**
|
||||||
|
|
||||||
|
```js
|
||||||
|
import ansiEscapes from 'ansi-escapes';
|
||||||
|
import {Terminal} from 'xterm';
|
||||||
|
import 'xterm/css/xterm.css';
|
||||||
|
|
||||||
|
const terminal = new Terminal({…});
|
||||||
|
|
||||||
|
// Moves the cursor two rows up and to the left
|
||||||
|
terminal.write(ansiEscapes.cursorUp(2) + ansiEscapes.cursorLeft);
|
||||||
|
//=> '\u001B[2A\u001B[1000D'
|
||||||
|
```
|
||||||
|
|
||||||
|
## API
|
||||||
|
|
||||||
|
### cursorTo(x, y?)
|
||||||
|
|
||||||
|
Set the absolute position of the cursor. `x0` `y0` is the top left of the screen.
|
||||||
|
|
||||||
|
### cursorMove(x, y?)
|
||||||
|
|
||||||
|
Set the position of the cursor relative to its current position.
|
||||||
|
|
||||||
|
### cursorUp(count)
|
||||||
|
|
||||||
|
Move cursor up a specific amount of rows. Default is `1`.
|
||||||
|
|
||||||
|
### cursorDown(count)
|
||||||
|
|
||||||
|
Move cursor down a specific amount of rows. Default is `1`.
|
||||||
|
|
||||||
|
### cursorForward(count)
|
||||||
|
|
||||||
|
Move cursor forward a specific amount of columns. Default is `1`.
|
||||||
|
|
||||||
|
### cursorBackward(count)
|
||||||
|
|
||||||
|
Move cursor backward a specific amount of columns. Default is `1`.
|
||||||
|
|
||||||
|
### cursorLeft
|
||||||
|
|
||||||
|
Move cursor to the left side.
|
||||||
|
|
||||||
|
### cursorSavePosition
|
||||||
|
|
||||||
|
Save cursor position.
|
||||||
|
|
||||||
|
### cursorRestorePosition
|
||||||
|
|
||||||
|
Restore saved cursor position.
|
||||||
|
|
||||||
|
### cursorGetPosition
|
||||||
|
|
||||||
|
Get cursor position.
|
||||||
|
|
||||||
|
### cursorNextLine
|
||||||
|
|
||||||
|
Move cursor to the next line.
|
||||||
|
|
||||||
|
### cursorPrevLine
|
||||||
|
|
||||||
|
Move cursor to the previous line.
|
||||||
|
|
||||||
|
### cursorHide
|
||||||
|
|
||||||
|
Hide cursor.
|
||||||
|
|
||||||
|
### cursorShow
|
||||||
|
|
||||||
|
Show cursor.
|
||||||
|
|
||||||
|
### eraseLines(count)
|
||||||
|
|
||||||
|
Erase from the current cursor position up the specified amount of rows.
|
||||||
|
|
||||||
|
### eraseEndLine
|
||||||
|
|
||||||
|
Erase from the current cursor position to the end of the current line.
|
||||||
|
|
||||||
|
### eraseStartLine
|
||||||
|
|
||||||
|
Erase from the current cursor position to the start of the current line.
|
||||||
|
|
||||||
|
### eraseLine
|
||||||
|
|
||||||
|
Erase the entire current line.
|
||||||
|
|
||||||
|
### eraseDown
|
||||||
|
|
||||||
|
Erase the screen from the current line down to the bottom of the screen.
|
||||||
|
|
||||||
|
### eraseUp
|
||||||
|
|
||||||
|
Erase the screen from the current line up to the top of the screen.
|
||||||
|
|
||||||
|
### eraseScreen
|
||||||
|
|
||||||
|
Erase the screen and move the cursor the top left position.
|
||||||
|
|
||||||
|
### scrollUp
|
||||||
|
|
||||||
|
Scroll display up one line.
|
||||||
|
|
||||||
|
### scrollDown
|
||||||
|
|
||||||
|
Scroll display down one line.
|
||||||
|
|
||||||
|
### clearScreen
|
||||||
|
|
||||||
|
Clear the terminal screen. (Viewport)
|
||||||
|
|
||||||
|
### clearTerminal
|
||||||
|
|
||||||
|
Clear the whole terminal, including scrollback buffer. (Not just the visible part of it)
|
||||||
|
|
||||||
|
### enterAlternativeScreen
|
||||||
|
|
||||||
|
Enter the [alternative screen](https://terminalguide.namepad.de/mode/p47/).
|
||||||
|
|
||||||
|
### exitAlternativeScreen
|
||||||
|
|
||||||
|
Exit the [alternative screen](https://terminalguide.namepad.de/mode/p47/), assuming `enterAlternativeScreen` was called before.
|
||||||
|
|
||||||
|
### beep
|
||||||
|
|
||||||
|
Output a beeping sound.
|
||||||
|
|
||||||
|
### link(text, url)
|
||||||
|
|
||||||
|
Create a clickable link.
|
||||||
|
|
||||||
|
[Supported terminals.](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda) Use [`supports-hyperlinks`](https://github.com/jamestalmage/supports-hyperlinks) to detect link support.
|
||||||
|
|
||||||
|
### image(filePath, options?)
|
||||||
|
|
||||||
|
Display an image.
|
||||||
|
|
||||||
|
See [term-img](https://github.com/sindresorhus/term-img) for a higher-level module.
|
||||||
|
|
||||||
|
#### input
|
||||||
|
|
||||||
|
Type: `Buffer`
|
||||||
|
|
||||||
|
Buffer of an image. Usually read in with `fs.readFile()`.
|
||||||
|
|
||||||
|
#### options
|
||||||
|
|
||||||
|
Type: `object`
|
||||||
|
|
||||||
|
##### width
|
||||||
|
##### height
|
||||||
|
|
||||||
|
Type: `string | number`
|
||||||
|
|
||||||
|
The width and height are given as a number followed by a unit, or the word "auto".
|
||||||
|
|
||||||
|
- `N`: N character cells.
|
||||||
|
- `Npx`: N pixels.
|
||||||
|
- `N%`: N percent of the session's width or height.
|
||||||
|
- `auto`: The image's inherent size will be used to determine an appropriate dimension.
|
||||||
|
|
||||||
|
##### preserveAspectRatio
|
||||||
|
|
||||||
|
Type: `boolean`\
|
||||||
|
Default: `true`
|
||||||
|
|
||||||
|
### iTerm.setCwd(path?)
|
||||||
|
|
||||||
|
Type: `string`\
|
||||||
|
Default: `process.cwd()`
|
||||||
|
|
||||||
|
[Inform iTerm2](https://www.iterm2.com/documentation-escape-codes.html) of the current directory to help semantic history and enable [Cmd-clicking relative paths](https://coderwall.com/p/b7e82q/quickly-open-files-in-iterm-with-cmd-click).
|
||||||
|
|
||||||
|
### iTerm.annotation(message, options?)
|
||||||
|
|
||||||
|
Creates an escape code to display an "annotation" in iTerm2.
|
||||||
|
|
||||||
|
An annotation looks like this when shown:
|
||||||
|
|
||||||
|
<img src="https://user-images.githubusercontent.com/924465/64382136-b60ac700-cfe9-11e9-8a35-9682e8dc4b72.png" width="500">
|
||||||
|
|
||||||
|
See the [iTerm Proprietary Escape Codes documentation](https://iterm2.com/documentation-escape-codes.html) for more information.
|
||||||
|
|
||||||
|
#### message
|
||||||
|
|
||||||
|
Type: `string`
|
||||||
|
|
||||||
|
The message to display within the annotation.
|
||||||
|
|
||||||
|
The `|` character is disallowed and will be stripped.
|
||||||
|
|
||||||
|
#### options
|
||||||
|
|
||||||
|
Type: `object`
|
||||||
|
|
||||||
|
##### length
|
||||||
|
|
||||||
|
Type: `number`\
|
||||||
|
Default: The remainder of the line
|
||||||
|
|
||||||
|
Nonzero number of columns to annotate.
|
||||||
|
|
||||||
|
##### x
|
||||||
|
|
||||||
|
Type: `number`\
|
||||||
|
Default: Cursor position
|
||||||
|
|
||||||
|
Starting X coordinate.
|
||||||
|
|
||||||
|
Must be used with `y` and `length`.
|
||||||
|
|
||||||
|
##### y
|
||||||
|
|
||||||
|
Type: `number`\
|
||||||
|
Default: Cursor position
|
||||||
|
|
||||||
|
Starting Y coordinate.
|
||||||
|
|
||||||
|
Must be used with `x` and `length`.
|
||||||
|
|
||||||
|
##### isHidden
|
||||||
|
|
||||||
|
Type: `boolean`\
|
||||||
|
Default: `false`
|
||||||
|
|
||||||
|
Create a "hidden" annotation.
|
||||||
|
|
||||||
|
Annotations created this way can be shown using the "Show Annotations" iTerm command.
|
||||||
|
|
||||||
|
## Related
|
||||||
|
|
||||||
|
- [ansi-styles](https://github.com/chalk/ansi-styles) - ANSI escape codes for styling strings in the terminal
|
|
@ -0,0 +1,33 @@
|
||||||
|
export interface Options {
|
||||||
|
/**
|
||||||
|
Match only the first ANSI escape.
|
||||||
|
|
||||||
|
@default false
|
||||||
|
*/
|
||||||
|
readonly onlyFirst: boolean;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Regular expression for matching ANSI escape codes.
|
||||||
|
|
||||||
|
@example
|
||||||
|
```
|
||||||
|
import ansiRegex from 'ansi-regex';
|
||||||
|
|
||||||
|
ansiRegex().test('\u001B[4mcake\u001B[0m');
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
ansiRegex().test('cake');
|
||||||
|
//=> false
|
||||||
|
|
||||||
|
'\u001B[4mcake\u001B[0m'.match(ansiRegex());
|
||||||
|
//=> ['\u001B[4m', '\u001B[0m']
|
||||||
|
|
||||||
|
'\u001B[4mcake\u001B[0m'.match(ansiRegex({onlyFirst: true}));
|
||||||
|
//=> ['\u001B[4m']
|
||||||
|
|
||||||
|
'\u001B]8;;https://github.com\u0007click\u001B]8;;\u0007'.match(ansiRegex());
|
||||||
|
//=> ['\u001B]8;;https://github.com\u0007', '\u001B]8;;\u0007']
|
||||||
|
```
|
||||||
|
*/
|
||||||
|
export default function ansiRegex(options?: Options): RegExp;
|
|
@ -0,0 +1,8 @@
|
||||||
|
export default function ansiRegex({onlyFirst = false} = {}) {
|
||||||
|
const pattern = [
|
||||||
|
'[\\u001B\\u009B][[\\]()#;?]*(?:(?:(?:(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]+)*|[a-zA-Z\\d]+(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]*)*)?\\u0007)',
|
||||||
|
'(?:(?:\\d{1,4}(?:;\\d{0,4})*)?[\\dA-PR-TZcf-ntqry=><~]))'
|
||||||
|
].join('|');
|
||||||
|
|
||||||
|
return new RegExp(pattern, onlyFirst ? undefined : 'g');
|
||||||
|
}
|
|
@ -0,0 +1,9 @@
|
||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
@ -0,0 +1,58 @@
|
||||||
|
{
|
||||||
|
"name": "ansi-regex",
|
||||||
|
"version": "6.0.1",
|
||||||
|
"description": "Regular expression for matching ANSI escape codes",
|
||||||
|
"license": "MIT",
|
||||||
|
"repository": "chalk/ansi-regex",
|
||||||
|
"funding": "https://github.com/chalk/ansi-regex?sponsor=1",
|
||||||
|
"author": {
|
||||||
|
"name": "Sindre Sorhus",
|
||||||
|
"email": "sindresorhus@gmail.com",
|
||||||
|
"url": "https://sindresorhus.com"
|
||||||
|
},
|
||||||
|
"type": "module",
|
||||||
|
"exports": "./index.js",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=12"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"test": "xo && ava && tsd",
|
||||||
|
"view-supported": "node fixtures/view-codes.js"
|
||||||
|
},
|
||||||
|
"files": [
|
||||||
|
"index.js",
|
||||||
|
"index.d.ts"
|
||||||
|
],
|
||||||
|
"keywords": [
|
||||||
|
"ansi",
|
||||||
|
"styles",
|
||||||
|
"color",
|
||||||
|
"colour",
|
||||||
|
"colors",
|
||||||
|
"terminal",
|
||||||
|
"console",
|
||||||
|
"cli",
|
||||||
|
"string",
|
||||||
|
"tty",
|
||||||
|
"escape",
|
||||||
|
"formatting",
|
||||||
|
"rgb",
|
||||||
|
"256",
|
||||||
|
"shell",
|
||||||
|
"xterm",
|
||||||
|
"command-line",
|
||||||
|
"text",
|
||||||
|
"regex",
|
||||||
|
"regexp",
|
||||||
|
"re",
|
||||||
|
"match",
|
||||||
|
"test",
|
||||||
|
"find",
|
||||||
|
"pattern"
|
||||||
|
],
|
||||||
|
"devDependencies": {
|
||||||
|
"ava": "^3.15.0",
|
||||||
|
"tsd": "^0.14.0",
|
||||||
|
"xo": "^0.38.2"
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,72 @@
|
||||||
|
# ansi-regex
|
||||||
|
|
||||||
|
> Regular expression for matching [ANSI escape codes](https://en.wikipedia.org/wiki/ANSI_escape_code)
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
```
|
||||||
|
$ npm install ansi-regex
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```js
|
||||||
|
import ansiRegex from 'ansi-regex';
|
||||||
|
|
||||||
|
ansiRegex().test('\u001B[4mcake\u001B[0m');
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
ansiRegex().test('cake');
|
||||||
|
//=> false
|
||||||
|
|
||||||
|
'\u001B[4mcake\u001B[0m'.match(ansiRegex());
|
||||||
|
//=> ['\u001B[4m', '\u001B[0m']
|
||||||
|
|
||||||
|
'\u001B[4mcake\u001B[0m'.match(ansiRegex({onlyFirst: true}));
|
||||||
|
//=> ['\u001B[4m']
|
||||||
|
|
||||||
|
'\u001B]8;;https://github.com\u0007click\u001B]8;;\u0007'.match(ansiRegex());
|
||||||
|
//=> ['\u001B]8;;https://github.com\u0007', '\u001B]8;;\u0007']
|
||||||
|
```
|
||||||
|
|
||||||
|
## API
|
||||||
|
|
||||||
|
### ansiRegex(options?)
|
||||||
|
|
||||||
|
Returns a regex for matching ANSI escape codes.
|
||||||
|
|
||||||
|
#### options
|
||||||
|
|
||||||
|
Type: `object`
|
||||||
|
|
||||||
|
##### onlyFirst
|
||||||
|
|
||||||
|
Type: `boolean`\
|
||||||
|
Default: `false` *(Matches any ANSI escape codes in a string)*
|
||||||
|
|
||||||
|
Match only the first ANSI escape.
|
||||||
|
|
||||||
|
## FAQ
|
||||||
|
|
||||||
|
### Why do you test for codes not in the ECMA 48 standard?
|
||||||
|
|
||||||
|
Some of the codes we run as a test are codes that we acquired finding various lists of non-standard or manufacturer specific codes. We test for both standard and non-standard codes, as most of them follow the same or similar format and can be safely matched in strings without the risk of removing actual string content. There are a few non-standard control codes that do not follow the traditional format (i.e. they end in numbers) thus forcing us to exclude them from the test because we cannot reliably match them.
|
||||||
|
|
||||||
|
On the historical side, those ECMA standards were established in the early 90's whereas the VT100, for example, was designed in the mid/late 70's. At that point in time, control codes were still pretty ungoverned and engineers used them for a multitude of things, namely to activate hardware ports that may have been proprietary. Somewhere else you see a similar 'anarchy' of codes is in the x86 architecture for processors; there are a ton of "interrupts" that can mean different things on certain brands of processors, most of which have been phased out.
|
||||||
|
|
||||||
|
## Maintainers
|
||||||
|
|
||||||
|
- [Sindre Sorhus](https://github.com/sindresorhus)
|
||||||
|
- [Josh Junon](https://github.com/qix-)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
<div align="center">
|
||||||
|
<b>
|
||||||
|
<a href="https://tidelift.com/subscription/pkg/npm-ansi-regex?utm_source=npm-ansi-regex&utm_medium=referral&utm_campaign=readme">Get professional support for this package with a Tidelift subscription</a>
|
||||||
|
</b>
|
||||||
|
<br>
|
||||||
|
<sub>
|
||||||
|
Tidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.
|
||||||
|
</sub>
|
||||||
|
</div>
|
|
@ -0,0 +1,236 @@
|
||||||
|
export interface CSPair { // eslint-disable-line @typescript-eslint/naming-convention
|
||||||
|
/**
|
||||||
|
The ANSI terminal control sequence for starting this style.
|
||||||
|
*/
|
||||||
|
readonly open: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
The ANSI terminal control sequence for ending this style.
|
||||||
|
*/
|
||||||
|
readonly close: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ColorBase {
|
||||||
|
/**
|
||||||
|
The ANSI terminal control sequence for ending this color.
|
||||||
|
*/
|
||||||
|
readonly close: string;
|
||||||
|
|
||||||
|
ansi(code: number): string;
|
||||||
|
|
||||||
|
ansi256(code: number): string;
|
||||||
|
|
||||||
|
ansi16m(red: number, green: number, blue: number): string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface Modifier {
|
||||||
|
/**
|
||||||
|
Resets the current color chain.
|
||||||
|
*/
|
||||||
|
readonly reset: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Make text bold.
|
||||||
|
*/
|
||||||
|
readonly bold: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Emitting only a small amount of light.
|
||||||
|
*/
|
||||||
|
readonly dim: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Make text italic. (Not widely supported)
|
||||||
|
*/
|
||||||
|
readonly italic: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Make text underline. (Not widely supported)
|
||||||
|
*/
|
||||||
|
readonly underline: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Make text overline.
|
||||||
|
|
||||||
|
Supported on VTE-based terminals, the GNOME terminal, mintty, and Git Bash.
|
||||||
|
*/
|
||||||
|
readonly overline: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Inverse background and foreground colors.
|
||||||
|
*/
|
||||||
|
readonly inverse: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Prints the text, but makes it invisible.
|
||||||
|
*/
|
||||||
|
readonly hidden: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Puts a horizontal line through the center of the text. (Not widely supported)
|
||||||
|
*/
|
||||||
|
readonly strikethrough: CSPair;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ForegroundColor {
|
||||||
|
readonly black: CSPair;
|
||||||
|
readonly red: CSPair;
|
||||||
|
readonly green: CSPair;
|
||||||
|
readonly yellow: CSPair;
|
||||||
|
readonly blue: CSPair;
|
||||||
|
readonly cyan: CSPair;
|
||||||
|
readonly magenta: CSPair;
|
||||||
|
readonly white: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Alias for `blackBright`.
|
||||||
|
*/
|
||||||
|
readonly gray: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Alias for `blackBright`.
|
||||||
|
*/
|
||||||
|
readonly grey: CSPair;
|
||||||
|
|
||||||
|
readonly blackBright: CSPair;
|
||||||
|
readonly redBright: CSPair;
|
||||||
|
readonly greenBright: CSPair;
|
||||||
|
readonly yellowBright: CSPair;
|
||||||
|
readonly blueBright: CSPair;
|
||||||
|
readonly cyanBright: CSPair;
|
||||||
|
readonly magentaBright: CSPair;
|
||||||
|
readonly whiteBright: CSPair;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface BackgroundColor {
|
||||||
|
readonly bgBlack: CSPair;
|
||||||
|
readonly bgRed: CSPair;
|
||||||
|
readonly bgGreen: CSPair;
|
||||||
|
readonly bgYellow: CSPair;
|
||||||
|
readonly bgBlue: CSPair;
|
||||||
|
readonly bgCyan: CSPair;
|
||||||
|
readonly bgMagenta: CSPair;
|
||||||
|
readonly bgWhite: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Alias for `bgBlackBright`.
|
||||||
|
*/
|
||||||
|
readonly bgGray: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Alias for `bgBlackBright`.
|
||||||
|
*/
|
||||||
|
readonly bgGrey: CSPair;
|
||||||
|
|
||||||
|
readonly bgBlackBright: CSPair;
|
||||||
|
readonly bgRedBright: CSPair;
|
||||||
|
readonly bgGreenBright: CSPair;
|
||||||
|
readonly bgYellowBright: CSPair;
|
||||||
|
readonly bgBlueBright: CSPair;
|
||||||
|
readonly bgCyanBright: CSPair;
|
||||||
|
readonly bgMagentaBright: CSPair;
|
||||||
|
readonly bgWhiteBright: CSPair;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ConvertColor {
|
||||||
|
/**
|
||||||
|
Convert from the RGB color space to the ANSI 256 color space.
|
||||||
|
|
||||||
|
@param red - (`0...255`)
|
||||||
|
@param green - (`0...255`)
|
||||||
|
@param blue - (`0...255`)
|
||||||
|
*/
|
||||||
|
rgbToAnsi256(red: number, green: number, blue: number): number;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Convert from the RGB HEX color space to the RGB color space.
|
||||||
|
|
||||||
|
@param hex - A hexadecimal string containing RGB data.
|
||||||
|
*/
|
||||||
|
hexToRgb(hex: string): [red: number, green: number, blue: number];
|
||||||
|
|
||||||
|
/**
|
||||||
|
Convert from the RGB HEX color space to the ANSI 256 color space.
|
||||||
|
|
||||||
|
@param hex - A hexadecimal string containing RGB data.
|
||||||
|
*/
|
||||||
|
hexToAnsi256(hex: string): number;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Convert from the ANSI 256 color space to the ANSI 16 color space.
|
||||||
|
|
||||||
|
@param code - A number representing the ANSI 256 color.
|
||||||
|
*/
|
||||||
|
ansi256ToAnsi(code: number): number;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Convert from the RGB color space to the ANSI 16 color space.
|
||||||
|
|
||||||
|
@param red - (`0...255`)
|
||||||
|
@param green - (`0...255`)
|
||||||
|
@param blue - (`0...255`)
|
||||||
|
*/
|
||||||
|
rgbToAnsi(red: number, green: number, blue: number): number;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Convert from the RGB HEX color space to the ANSI 16 color space.
|
||||||
|
|
||||||
|
@param hex - A hexadecimal string containing RGB data.
|
||||||
|
*/
|
||||||
|
hexToAnsi(hex: string): number;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Basic modifier names.
|
||||||
|
*/
|
||||||
|
export type ModifierName = keyof Modifier;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Basic foreground color names.
|
||||||
|
|
||||||
|
[More colors here.](https://github.com/chalk/chalk/blob/main/readme.md#256-and-truecolor-color-support)
|
||||||
|
*/
|
||||||
|
export type ForegroundColorName = keyof ForegroundColor;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Basic background color names.
|
||||||
|
|
||||||
|
[More colors here.](https://github.com/chalk/chalk/blob/main/readme.md#256-and-truecolor-color-support)
|
||||||
|
*/
|
||||||
|
export type BackgroundColorName = keyof BackgroundColor;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Basic color names. The combination of foreground and background color names.
|
||||||
|
|
||||||
|
[More colors here.](https://github.com/chalk/chalk/blob/main/readme.md#256-and-truecolor-color-support)
|
||||||
|
*/
|
||||||
|
export type ColorName = ForegroundColorName | BackgroundColorName;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Basic modifier names.
|
||||||
|
*/
|
||||||
|
export const modifierNames: readonly ModifierName[];
|
||||||
|
|
||||||
|
/**
|
||||||
|
Basic foreground color names.
|
||||||
|
*/
|
||||||
|
export const foregroundColorNames: readonly ForegroundColorName[];
|
||||||
|
|
||||||
|
/**
|
||||||
|
Basic background color names.
|
||||||
|
*/
|
||||||
|
export const backgroundColorNames: readonly BackgroundColorName[];
|
||||||
|
|
||||||
|
/*
|
||||||
|
Basic color names. The combination of foreground and background color names.
|
||||||
|
*/
|
||||||
|
export const colorNames: readonly ColorName[];
|
||||||
|
|
||||||
|
declare const ansiStyles: {
|
||||||
|
readonly modifier: Modifier;
|
||||||
|
readonly color: ColorBase & ForegroundColor;
|
||||||
|
readonly bgColor: ColorBase & BackgroundColor;
|
||||||
|
readonly codes: ReadonlyMap<number, number>;
|
||||||
|
} & ForegroundColor & BackgroundColor & Modifier & ConvertColor;
|
||||||
|
|
||||||
|
export default ansiStyles;
|
|
@ -0,0 +1,223 @@
|
||||||
|
const ANSI_BACKGROUND_OFFSET = 10;
|
||||||
|
|
||||||
|
const wrapAnsi16 = (offset = 0) => code => `\u001B[${code + offset}m`;
|
||||||
|
|
||||||
|
const wrapAnsi256 = (offset = 0) => code => `\u001B[${38 + offset};5;${code}m`;
|
||||||
|
|
||||||
|
const wrapAnsi16m = (offset = 0) => (red, green, blue) => `\u001B[${38 + offset};2;${red};${green};${blue}m`;
|
||||||
|
|
||||||
|
const styles = {
|
||||||
|
modifier: {
|
||||||
|
reset: [0, 0],
|
||||||
|
// 21 isn't widely supported and 22 does the same thing
|
||||||
|
bold: [1, 22],
|
||||||
|
dim: [2, 22],
|
||||||
|
italic: [3, 23],
|
||||||
|
underline: [4, 24],
|
||||||
|
overline: [53, 55],
|
||||||
|
inverse: [7, 27],
|
||||||
|
hidden: [8, 28],
|
||||||
|
strikethrough: [9, 29],
|
||||||
|
},
|
||||||
|
color: {
|
||||||
|
black: [30, 39],
|
||||||
|
red: [31, 39],
|
||||||
|
green: [32, 39],
|
||||||
|
yellow: [33, 39],
|
||||||
|
blue: [34, 39],
|
||||||
|
magenta: [35, 39],
|
||||||
|
cyan: [36, 39],
|
||||||
|
white: [37, 39],
|
||||||
|
|
||||||
|
// Bright color
|
||||||
|
blackBright: [90, 39],
|
||||||
|
gray: [90, 39], // Alias of `blackBright`
|
||||||
|
grey: [90, 39], // Alias of `blackBright`
|
||||||
|
redBright: [91, 39],
|
||||||
|
greenBright: [92, 39],
|
||||||
|
yellowBright: [93, 39],
|
||||||
|
blueBright: [94, 39],
|
||||||
|
magentaBright: [95, 39],
|
||||||
|
cyanBright: [96, 39],
|
||||||
|
whiteBright: [97, 39],
|
||||||
|
},
|
||||||
|
bgColor: {
|
||||||
|
bgBlack: [40, 49],
|
||||||
|
bgRed: [41, 49],
|
||||||
|
bgGreen: [42, 49],
|
||||||
|
bgYellow: [43, 49],
|
||||||
|
bgBlue: [44, 49],
|
||||||
|
bgMagenta: [45, 49],
|
||||||
|
bgCyan: [46, 49],
|
||||||
|
bgWhite: [47, 49],
|
||||||
|
|
||||||
|
// Bright color
|
||||||
|
bgBlackBright: [100, 49],
|
||||||
|
bgGray: [100, 49], // Alias of `bgBlackBright`
|
||||||
|
bgGrey: [100, 49], // Alias of `bgBlackBright`
|
||||||
|
bgRedBright: [101, 49],
|
||||||
|
bgGreenBright: [102, 49],
|
||||||
|
bgYellowBright: [103, 49],
|
||||||
|
bgBlueBright: [104, 49],
|
||||||
|
bgMagentaBright: [105, 49],
|
||||||
|
bgCyanBright: [106, 49],
|
||||||
|
bgWhiteBright: [107, 49],
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
export const modifierNames = Object.keys(styles.modifier);
|
||||||
|
export const foregroundColorNames = Object.keys(styles.color);
|
||||||
|
export const backgroundColorNames = Object.keys(styles.bgColor);
|
||||||
|
export const colorNames = [...foregroundColorNames, ...backgroundColorNames];
|
||||||
|
|
||||||
|
function assembleStyles() {
|
||||||
|
const codes = new Map();
|
||||||
|
|
||||||
|
for (const [groupName, group] of Object.entries(styles)) {
|
||||||
|
for (const [styleName, style] of Object.entries(group)) {
|
||||||
|
styles[styleName] = {
|
||||||
|
open: `\u001B[${style[0]}m`,
|
||||||
|
close: `\u001B[${style[1]}m`,
|
||||||
|
};
|
||||||
|
|
||||||
|
group[styleName] = styles[styleName];
|
||||||
|
|
||||||
|
codes.set(style[0], style[1]);
|
||||||
|
}
|
||||||
|
|
||||||
|
Object.defineProperty(styles, groupName, {
|
||||||
|
value: group,
|
||||||
|
enumerable: false,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
Object.defineProperty(styles, 'codes', {
|
||||||
|
value: codes,
|
||||||
|
enumerable: false,
|
||||||
|
});
|
||||||
|
|
||||||
|
styles.color.close = '\u001B[39m';
|
||||||
|
styles.bgColor.close = '\u001B[49m';
|
||||||
|
|
||||||
|
styles.color.ansi = wrapAnsi16();
|
||||||
|
styles.color.ansi256 = wrapAnsi256();
|
||||||
|
styles.color.ansi16m = wrapAnsi16m();
|
||||||
|
styles.bgColor.ansi = wrapAnsi16(ANSI_BACKGROUND_OFFSET);
|
||||||
|
styles.bgColor.ansi256 = wrapAnsi256(ANSI_BACKGROUND_OFFSET);
|
||||||
|
styles.bgColor.ansi16m = wrapAnsi16m(ANSI_BACKGROUND_OFFSET);
|
||||||
|
|
||||||
|
// From https://github.com/Qix-/color-convert/blob/3f0e0d4e92e235796ccb17f6e85c72094a651f49/conversions.js
|
||||||
|
Object.defineProperties(styles, {
|
||||||
|
rgbToAnsi256: {
|
||||||
|
value: (red, green, blue) => {
|
||||||
|
// We use the extended greyscale palette here, with the exception of
|
||||||
|
// black and white. normal palette only has 4 greyscale shades.
|
||||||
|
if (red === green && green === blue) {
|
||||||
|
if (red < 8) {
|
||||||
|
return 16;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (red > 248) {
|
||||||
|
return 231;
|
||||||
|
}
|
||||||
|
|
||||||
|
return Math.round(((red - 8) / 247) * 24) + 232;
|
||||||
|
}
|
||||||
|
|
||||||
|
return 16
|
||||||
|
+ (36 * Math.round(red / 255 * 5))
|
||||||
|
+ (6 * Math.round(green / 255 * 5))
|
||||||
|
+ Math.round(blue / 255 * 5);
|
||||||
|
},
|
||||||
|
enumerable: false,
|
||||||
|
},
|
||||||
|
hexToRgb: {
|
||||||
|
value: hex => {
|
||||||
|
const matches = /[a-f\d]{6}|[a-f\d]{3}/i.exec(hex.toString(16));
|
||||||
|
if (!matches) {
|
||||||
|
return [0, 0, 0];
|
||||||
|
}
|
||||||
|
|
||||||
|
let [colorString] = matches;
|
||||||
|
|
||||||
|
if (colorString.length === 3) {
|
||||||
|
colorString = [...colorString].map(character => character + character).join('');
|
||||||
|
}
|
||||||
|
|
||||||
|
const integer = Number.parseInt(colorString, 16);
|
||||||
|
|
||||||
|
return [
|
||||||
|
/* eslint-disable no-bitwise */
|
||||||
|
(integer >> 16) & 0xFF,
|
||||||
|
(integer >> 8) & 0xFF,
|
||||||
|
integer & 0xFF,
|
||||||
|
/* eslint-enable no-bitwise */
|
||||||
|
];
|
||||||
|
},
|
||||||
|
enumerable: false,
|
||||||
|
},
|
||||||
|
hexToAnsi256: {
|
||||||
|
value: hex => styles.rgbToAnsi256(...styles.hexToRgb(hex)),
|
||||||
|
enumerable: false,
|
||||||
|
},
|
||||||
|
ansi256ToAnsi: {
|
||||||
|
value: code => {
|
||||||
|
if (code < 8) {
|
||||||
|
return 30 + code;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (code < 16) {
|
||||||
|
return 90 + (code - 8);
|
||||||
|
}
|
||||||
|
|
||||||
|
let red;
|
||||||
|
let green;
|
||||||
|
let blue;
|
||||||
|
|
||||||
|
if (code >= 232) {
|
||||||
|
red = (((code - 232) * 10) + 8) / 255;
|
||||||
|
green = red;
|
||||||
|
blue = red;
|
||||||
|
} else {
|
||||||
|
code -= 16;
|
||||||
|
|
||||||
|
const remainder = code % 36;
|
||||||
|
|
||||||
|
red = Math.floor(code / 36) / 5;
|
||||||
|
green = Math.floor(remainder / 6) / 5;
|
||||||
|
blue = (remainder % 6) / 5;
|
||||||
|
}
|
||||||
|
|
||||||
|
const value = Math.max(red, green, blue) * 2;
|
||||||
|
|
||||||
|
if (value === 0) {
|
||||||
|
return 30;
|
||||||
|
}
|
||||||
|
|
||||||
|
// eslint-disable-next-line no-bitwise
|
||||||
|
let result = 30 + ((Math.round(blue) << 2) | (Math.round(green) << 1) | Math.round(red));
|
||||||
|
|
||||||
|
if (value === 2) {
|
||||||
|
result += 60;
|
||||||
|
}
|
||||||
|
|
||||||
|
return result;
|
||||||
|
},
|
||||||
|
enumerable: false,
|
||||||
|
},
|
||||||
|
rgbToAnsi: {
|
||||||
|
value: (red, green, blue) => styles.ansi256ToAnsi(styles.rgbToAnsi256(red, green, blue)),
|
||||||
|
enumerable: false,
|
||||||
|
},
|
||||||
|
hexToAnsi: {
|
||||||
|
value: hex => styles.ansi256ToAnsi(styles.hexToAnsi256(hex)),
|
||||||
|
enumerable: false,
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
return styles;
|
||||||
|
}
|
||||||
|
|
||||||
|
const ansiStyles = assembleStyles();
|
||||||
|
|
||||||
|
export default ansiStyles;
|
|
@ -0,0 +1,9 @@
|
||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
@ -0,0 +1,54 @@
|
||||||
|
{
|
||||||
|
"name": "ansi-styles",
|
||||||
|
"version": "6.2.1",
|
||||||
|
"description": "ANSI escape codes for styling strings in the terminal",
|
||||||
|
"license": "MIT",
|
||||||
|
"repository": "chalk/ansi-styles",
|
||||||
|
"funding": "https://github.com/chalk/ansi-styles?sponsor=1",
|
||||||
|
"author": {
|
||||||
|
"name": "Sindre Sorhus",
|
||||||
|
"email": "sindresorhus@gmail.com",
|
||||||
|
"url": "https://sindresorhus.com"
|
||||||
|
},
|
||||||
|
"type": "module",
|
||||||
|
"exports": "./index.js",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=12"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"test": "xo && ava && tsd",
|
||||||
|
"screenshot": "svg-term --command='node screenshot' --out=screenshot.svg --padding=3 --width=55 --height=3 --at=1000 --no-cursor"
|
||||||
|
},
|
||||||
|
"files": [
|
||||||
|
"index.js",
|
||||||
|
"index.d.ts"
|
||||||
|
],
|
||||||
|
"keywords": [
|
||||||
|
"ansi",
|
||||||
|
"styles",
|
||||||
|
"color",
|
||||||
|
"colour",
|
||||||
|
"colors",
|
||||||
|
"terminal",
|
||||||
|
"console",
|
||||||
|
"cli",
|
||||||
|
"string",
|
||||||
|
"tty",
|
||||||
|
"escape",
|
||||||
|
"formatting",
|
||||||
|
"rgb",
|
||||||
|
"256",
|
||||||
|
"shell",
|
||||||
|
"xterm",
|
||||||
|
"log",
|
||||||
|
"logging",
|
||||||
|
"command-line",
|
||||||
|
"text"
|
||||||
|
],
|
||||||
|
"devDependencies": {
|
||||||
|
"ava": "^3.15.0",
|
||||||
|
"svg-term-cli": "^2.1.1",
|
||||||
|
"tsd": "^0.19.0",
|
||||||
|
"xo": "^0.47.0"
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,173 @@
|
||||||
|
# ansi-styles
|
||||||
|
|
||||||
|
> [ANSI escape codes](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors_and_Styles) for styling strings in the terminal
|
||||||
|
|
||||||
|
You probably want the higher-level [chalk](https://github.com/chalk/chalk) module for styling your strings.
|
||||||
|
|
||||||
|
![](screenshot.png)
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
```sh
|
||||||
|
npm install ansi-styles
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```js
|
||||||
|
import styles from 'ansi-styles';
|
||||||
|
|
||||||
|
console.log(`${styles.green.open}Hello world!${styles.green.close}`);
|
||||||
|
|
||||||
|
|
||||||
|
// Color conversion between 256/truecolor
|
||||||
|
// NOTE: When converting from truecolor to 256 colors, the original color
|
||||||
|
// may be degraded to fit the new color palette. This means terminals
|
||||||
|
// that do not support 16 million colors will best-match the
|
||||||
|
// original color.
|
||||||
|
console.log(`${styles.color.ansi(styles.rgbToAnsi(199, 20, 250))}Hello World${styles.color.close}`)
|
||||||
|
console.log(`${styles.color.ansi256(styles.rgbToAnsi256(199, 20, 250))}Hello World${styles.color.close}`)
|
||||||
|
console.log(`${styles.color.ansi16m(...styles.hexToRgb('#abcdef'))}Hello World${styles.color.close}`)
|
||||||
|
```
|
||||||
|
|
||||||
|
## API
|
||||||
|
|
||||||
|
### `open` and `close`
|
||||||
|
|
||||||
|
Each style has an `open` and `close` property.
|
||||||
|
|
||||||
|
### `modifierNames`, `foregroundColorNames`, `backgroundColorNames`, and `colorNames`
|
||||||
|
|
||||||
|
All supported style strings are exposed as an array of strings for convenience. `colorNames` is the combination of `foregroundColorNames` and `backgroundColorNames`.
|
||||||
|
|
||||||
|
This can be useful if you need to validate input:
|
||||||
|
|
||||||
|
```js
|
||||||
|
import {modifierNames, foregroundColorNames} from 'ansi-styles';
|
||||||
|
|
||||||
|
console.log(modifierNames.includes('bold'));
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
console.log(foregroundColorNames.includes('pink'));
|
||||||
|
//=> false
|
||||||
|
```
|
||||||
|
|
||||||
|
## Styles
|
||||||
|
|
||||||
|
### Modifiers
|
||||||
|
|
||||||
|
- `reset`
|
||||||
|
- `bold`
|
||||||
|
- `dim`
|
||||||
|
- `italic` *(Not widely supported)*
|
||||||
|
- `underline`
|
||||||
|
- `overline` *Supported on VTE-based terminals, the GNOME terminal, mintty, and Git Bash.*
|
||||||
|
- `inverse`
|
||||||
|
- `hidden`
|
||||||
|
- `strikethrough` *(Not widely supported)*
|
||||||
|
|
||||||
|
### Colors
|
||||||
|
|
||||||
|
- `black`
|
||||||
|
- `red`
|
||||||
|
- `green`
|
||||||
|
- `yellow`
|
||||||
|
- `blue`
|
||||||
|
- `magenta`
|
||||||
|
- `cyan`
|
||||||
|
- `white`
|
||||||
|
- `blackBright` (alias: `gray`, `grey`)
|
||||||
|
- `redBright`
|
||||||
|
- `greenBright`
|
||||||
|
- `yellowBright`
|
||||||
|
- `blueBright`
|
||||||
|
- `magentaBright`
|
||||||
|
- `cyanBright`
|
||||||
|
- `whiteBright`
|
||||||
|
|
||||||
|
### Background colors
|
||||||
|
|
||||||
|
- `bgBlack`
|
||||||
|
- `bgRed`
|
||||||
|
- `bgGreen`
|
||||||
|
- `bgYellow`
|
||||||
|
- `bgBlue`
|
||||||
|
- `bgMagenta`
|
||||||
|
- `bgCyan`
|
||||||
|
- `bgWhite`
|
||||||
|
- `bgBlackBright` (alias: `bgGray`, `bgGrey`)
|
||||||
|
- `bgRedBright`
|
||||||
|
- `bgGreenBright`
|
||||||
|
- `bgYellowBright`
|
||||||
|
- `bgBlueBright`
|
||||||
|
- `bgMagentaBright`
|
||||||
|
- `bgCyanBright`
|
||||||
|
- `bgWhiteBright`
|
||||||
|
|
||||||
|
## Advanced usage
|
||||||
|
|
||||||
|
By default, you get a map of styles, but the styles are also available as groups. They are non-enumerable so they don't show up unless you access them explicitly. This makes it easier to expose only a subset in a higher-level module.
|
||||||
|
|
||||||
|
- `styles.modifier`
|
||||||
|
- `styles.color`
|
||||||
|
- `styles.bgColor`
|
||||||
|
|
||||||
|
###### Example
|
||||||
|
|
||||||
|
```js
|
||||||
|
import styles from 'ansi-styles';
|
||||||
|
|
||||||
|
console.log(styles.color.green.open);
|
||||||
|
```
|
||||||
|
|
||||||
|
Raw escape codes (i.e. without the CSI escape prefix `\u001B[` and render mode postfix `m`) are available under `styles.codes`, which returns a `Map` with the open codes as keys and close codes as values.
|
||||||
|
|
||||||
|
###### Example
|
||||||
|
|
||||||
|
```js
|
||||||
|
import styles from 'ansi-styles';
|
||||||
|
|
||||||
|
console.log(styles.codes.get(36));
|
||||||
|
//=> 39
|
||||||
|
```
|
||||||
|
|
||||||
|
## 16 / 256 / 16 million (TrueColor) support
|
||||||
|
|
||||||
|
`ansi-styles` allows converting between various color formats and ANSI escapes, with support for 16, 256 and [16 million colors](https://gist.github.com/XVilka/8346728).
|
||||||
|
|
||||||
|
The following color spaces are supported:
|
||||||
|
|
||||||
|
- `rgb`
|
||||||
|
- `hex`
|
||||||
|
- `ansi256`
|
||||||
|
- `ansi`
|
||||||
|
|
||||||
|
To use these, call the associated conversion function with the intended output, for example:
|
||||||
|
|
||||||
|
```js
|
||||||
|
import styles from 'ansi-styles';
|
||||||
|
|
||||||
|
styles.color.ansi(styles.rgbToAnsi(100, 200, 15)); // RGB to 16 color ansi foreground code
|
||||||
|
styles.bgColor.ansi(styles.hexToAnsi('#C0FFEE')); // HEX to 16 color ansi foreground code
|
||||||
|
|
||||||
|
styles.color.ansi256(styles.rgbToAnsi256(100, 200, 15)); // RGB to 256 color ansi foreground code
|
||||||
|
styles.bgColor.ansi256(styles.hexToAnsi256('#C0FFEE')); // HEX to 256 color ansi foreground code
|
||||||
|
|
||||||
|
styles.color.ansi16m(100, 200, 15); // RGB to 16 million color foreground code
|
||||||
|
styles.bgColor.ansi16m(...styles.hexToRgb('#C0FFEE')); // Hex (RGB) to 16 million color foreground code
|
||||||
|
```
|
||||||
|
|
||||||
|
## Related
|
||||||
|
|
||||||
|
- [ansi-escapes](https://github.com/sindresorhus/ansi-escapes) - ANSI escape codes for manipulating the terminal
|
||||||
|
|
||||||
|
## Maintainers
|
||||||
|
|
||||||
|
- [Sindre Sorhus](https://github.com/sindresorhus)
|
||||||
|
- [Josh Junon](https://github.com/qix-)
|
||||||
|
|
||||||
|
## For enterprise
|
||||||
|
|
||||||
|
Available as part of the Tidelift Subscription.
|
||||||
|
|
||||||
|
The maintainers of `ansi-styles` and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. [Learn more.](https://tidelift.com/subscription/pkg/npm-ansi-styles?utm_source=npm-ansi-styles&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)
|
|
@ -0,0 +1,21 @@
|
||||||
|
The MIT License (MIT)
|
||||||
|
|
||||||
|
Copyright (c) 2014-present, Jon Schlinkert.
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in
|
||||||
|
all copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||||||
|
THE SOFTWARE.
|
|
@ -0,0 +1,586 @@
|
||||||
|
# braces [![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=W8YFZ425KND68) [![NPM version](https://img.shields.io/npm/v/braces.svg?style=flat)](https://www.npmjs.com/package/braces) [![NPM monthly downloads](https://img.shields.io/npm/dm/braces.svg?style=flat)](https://npmjs.org/package/braces) [![NPM total downloads](https://img.shields.io/npm/dt/braces.svg?style=flat)](https://npmjs.org/package/braces) [![Linux Build Status](https://img.shields.io/travis/micromatch/braces.svg?style=flat&label=Travis)](https://travis-ci.org/micromatch/braces)
|
||||||
|
|
||||||
|
> Bash-like brace expansion, implemented in JavaScript. Safer than other brace expansion libs, with complete support for the Bash 4.3 braces specification, without sacrificing speed.
|
||||||
|
|
||||||
|
Please consider following this project's author, [Jon Schlinkert](https://github.com/jonschlinkert), and consider starring the project to show your :heart: and support.
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
Install with [npm](https://www.npmjs.com/):
|
||||||
|
|
||||||
|
```sh
|
||||||
|
$ npm install --save braces
|
||||||
|
```
|
||||||
|
|
||||||
|
## v3.0.0 Released!!
|
||||||
|
|
||||||
|
See the [changelog](CHANGELOG.md) for details.
|
||||||
|
|
||||||
|
## Why use braces?
|
||||||
|
|
||||||
|
Brace patterns make globs more powerful by adding the ability to match specific ranges and sequences of characters.
|
||||||
|
|
||||||
|
- **Accurate** - complete support for the [Bash 4.3 Brace Expansion](www.gnu.org/software/bash/) specification (passes all of the Bash braces tests)
|
||||||
|
- **[fast and performant](#benchmarks)** - Starts fast, runs fast and [scales well](#performance) as patterns increase in complexity.
|
||||||
|
- **Organized code base** - The parser and compiler are easy to maintain and update when edge cases crop up.
|
||||||
|
- **Well-tested** - Thousands of test assertions, and passes all of the Bash, minimatch, and [brace-expansion](https://github.com/juliangruber/brace-expansion) unit tests (as of the date this was written).
|
||||||
|
- **Safer** - You shouldn't have to worry about users defining aggressive or malicious brace patterns that can break your application. Braces takes measures to prevent malicious regex that can be used for DDoS attacks (see [catastrophic backtracking](https://www.regular-expressions.info/catastrophic.html)).
|
||||||
|
- [Supports lists](#lists) - (aka "sets") `a/{b,c}/d` => `['a/b/d', 'a/c/d']`
|
||||||
|
- [Supports sequences](#sequences) - (aka "ranges") `{01..03}` => `['01', '02', '03']`
|
||||||
|
- [Supports steps](#steps) - (aka "increments") `{2..10..2}` => `['2', '4', '6', '8', '10']`
|
||||||
|
- [Supports escaping](#escaping) - To prevent evaluation of special characters.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
The main export is a function that takes one or more brace `patterns` and `options`.
|
||||||
|
|
||||||
|
```js
|
||||||
|
const braces = require('braces');
|
||||||
|
// braces(patterns[, options]);
|
||||||
|
|
||||||
|
console.log(braces(['{01..05}', '{a..e}']));
|
||||||
|
//=> ['(0[1-5])', '([a-e])']
|
||||||
|
|
||||||
|
console.log(braces(['{01..05}', '{a..e}'], { expand: true }));
|
||||||
|
//=> ['01', '02', '03', '04', '05', 'a', 'b', 'c', 'd', 'e']
|
||||||
|
```
|
||||||
|
|
||||||
|
### Brace Expansion vs. Compilation
|
||||||
|
|
||||||
|
By default, brace patterns are compiled into strings that are optimized for creating regular expressions and matching.
|
||||||
|
|
||||||
|
**Compiled**
|
||||||
|
|
||||||
|
```js
|
||||||
|
console.log(braces('a/{x,y,z}/b'));
|
||||||
|
//=> ['a/(x|y|z)/b']
|
||||||
|
console.log(braces(['a/{01..20}/b', 'a/{1..5}/b']));
|
||||||
|
//=> [ 'a/(0[1-9]|1[0-9]|20)/b', 'a/([1-5])/b' ]
|
||||||
|
```
|
||||||
|
|
||||||
|
**Expanded**
|
||||||
|
|
||||||
|
Enable brace expansion by setting the `expand` option to true, or by using [braces.expand()](#expand) (returns an array similar to what you'd expect from Bash, or `echo {1..5}`, or [minimatch](https://github.com/isaacs/minimatch)):
|
||||||
|
|
||||||
|
```js
|
||||||
|
console.log(braces('a/{x,y,z}/b', { expand: true }));
|
||||||
|
//=> ['a/x/b', 'a/y/b', 'a/z/b']
|
||||||
|
|
||||||
|
console.log(braces.expand('{01..10}'));
|
||||||
|
//=> ['01','02','03','04','05','06','07','08','09','10']
|
||||||
|
```
|
||||||
|
|
||||||
|
### Lists
|
||||||
|
|
||||||
|
Expand lists (like Bash "sets"):
|
||||||
|
|
||||||
|
```js
|
||||||
|
console.log(braces('a/{foo,bar,baz}/*.js'));
|
||||||
|
//=> ['a/(foo|bar|baz)/*.js']
|
||||||
|
|
||||||
|
console.log(braces.expand('a/{foo,bar,baz}/*.js'));
|
||||||
|
//=> ['a/foo/*.js', 'a/bar/*.js', 'a/baz/*.js']
|
||||||
|
```
|
||||||
|
|
||||||
|
### Sequences
|
||||||
|
|
||||||
|
Expand ranges of characters (like Bash "sequences"):
|
||||||
|
|
||||||
|
```js
|
||||||
|
console.log(braces.expand('{1..3}')); // ['1', '2', '3']
|
||||||
|
console.log(braces.expand('a/{1..3}/b')); // ['a/1/b', 'a/2/b', 'a/3/b']
|
||||||
|
console.log(braces('{a..c}', { expand: true })); // ['a', 'b', 'c']
|
||||||
|
console.log(braces('foo/{a..c}', { expand: true })); // ['foo/a', 'foo/b', 'foo/c']
|
||||||
|
|
||||||
|
// supports zero-padded ranges
|
||||||
|
console.log(braces('a/{01..03}/b')); //=> ['a/(0[1-3])/b']
|
||||||
|
console.log(braces('a/{001..300}/b')); //=> ['a/(0{2}[1-9]|0[1-9][0-9]|[12][0-9]{2}|300)/b']
|
||||||
|
```
|
||||||
|
|
||||||
|
See [fill-range](https://github.com/jonschlinkert/fill-range) for all available range-expansion options.
|
||||||
|
|
||||||
|
### Steppped ranges
|
||||||
|
|
||||||
|
Steps, or increments, may be used with ranges:
|
||||||
|
|
||||||
|
```js
|
||||||
|
console.log(braces.expand('{2..10..2}'));
|
||||||
|
//=> ['2', '4', '6', '8', '10']
|
||||||
|
|
||||||
|
console.log(braces('{2..10..2}'));
|
||||||
|
//=> ['(2|4|6|8|10)']
|
||||||
|
```
|
||||||
|
|
||||||
|
When the [.optimize](#optimize) method is used, or [options.optimize](#optionsoptimize) is set to true, sequences are passed to [to-regex-range](https://github.com/jonschlinkert/to-regex-range) for expansion.
|
||||||
|
|
||||||
|
### Nesting
|
||||||
|
|
||||||
|
Brace patterns may be nested. The results of each expanded string are not sorted, and left to right order is preserved.
|
||||||
|
|
||||||
|
**"Expanded" braces**
|
||||||
|
|
||||||
|
```js
|
||||||
|
console.log(braces.expand('a{b,c,/{x,y}}/e'));
|
||||||
|
//=> ['ab/e', 'ac/e', 'a/x/e', 'a/y/e']
|
||||||
|
|
||||||
|
console.log(braces.expand('a/{x,{1..5},y}/c'));
|
||||||
|
//=> ['a/x/c', 'a/1/c', 'a/2/c', 'a/3/c', 'a/4/c', 'a/5/c', 'a/y/c']
|
||||||
|
```
|
||||||
|
|
||||||
|
**"Optimized" braces**
|
||||||
|
|
||||||
|
```js
|
||||||
|
console.log(braces('a{b,c,/{x,y}}/e'));
|
||||||
|
//=> ['a(b|c|/(x|y))/e']
|
||||||
|
|
||||||
|
console.log(braces('a/{x,{1..5},y}/c'));
|
||||||
|
//=> ['a/(x|([1-5])|y)/c']
|
||||||
|
```
|
||||||
|
|
||||||
|
### Escaping
|
||||||
|
|
||||||
|
**Escaping braces**
|
||||||
|
|
||||||
|
A brace pattern will not be expanded or evaluted if _either the opening or closing brace is escaped_:
|
||||||
|
|
||||||
|
```js
|
||||||
|
console.log(braces.expand('a\\{d,c,b}e'));
|
||||||
|
//=> ['a{d,c,b}e']
|
||||||
|
|
||||||
|
console.log(braces.expand('a{d,c,b\\}e'));
|
||||||
|
//=> ['a{d,c,b}e']
|
||||||
|
```
|
||||||
|
|
||||||
|
**Escaping commas**
|
||||||
|
|
||||||
|
Commas inside braces may also be escaped:
|
||||||
|
|
||||||
|
```js
|
||||||
|
console.log(braces.expand('a{b\\,c}d'));
|
||||||
|
//=> ['a{b,c}d']
|
||||||
|
|
||||||
|
console.log(braces.expand('a{d\\,c,b}e'));
|
||||||
|
//=> ['ad,ce', 'abe']
|
||||||
|
```
|
||||||
|
|
||||||
|
**Single items**
|
||||||
|
|
||||||
|
Following bash conventions, a brace pattern is also not expanded when it contains a single character:
|
||||||
|
|
||||||
|
```js
|
||||||
|
console.log(braces.expand('a{b}c'));
|
||||||
|
//=> ['a{b}c']
|
||||||
|
```
|
||||||
|
|
||||||
|
## Options
|
||||||
|
|
||||||
|
### options.maxLength
|
||||||
|
|
||||||
|
**Type**: `Number`
|
||||||
|
|
||||||
|
**Default**: `10,000`
|
||||||
|
|
||||||
|
**Description**: Limit the length of the input string. Useful when the input string is generated or your application allows users to pass a string, et cetera.
|
||||||
|
|
||||||
|
```js
|
||||||
|
console.log(braces('a/{b,c}/d', { maxLength: 3 })); //=> throws an error
|
||||||
|
```
|
||||||
|
|
||||||
|
### options.expand
|
||||||
|
|
||||||
|
**Type**: `Boolean`
|
||||||
|
|
||||||
|
**Default**: `undefined`
|
||||||
|
|
||||||
|
**Description**: Generate an "expanded" brace pattern (alternatively you can use the `braces.expand()` method, which does the same thing).
|
||||||
|
|
||||||
|
```js
|
||||||
|
console.log(braces('a/{b,c}/d', { expand: true }));
|
||||||
|
//=> [ 'a/b/d', 'a/c/d' ]
|
||||||
|
```
|
||||||
|
|
||||||
|
### options.nodupes
|
||||||
|
|
||||||
|
**Type**: `Boolean`
|
||||||
|
|
||||||
|
**Default**: `undefined`
|
||||||
|
|
||||||
|
**Description**: Remove duplicates from the returned array.
|
||||||
|
|
||||||
|
### options.rangeLimit
|
||||||
|
|
||||||
|
**Type**: `Number`
|
||||||
|
|
||||||
|
**Default**: `1000`
|
||||||
|
|
||||||
|
**Description**: To prevent malicious patterns from being passed by users, an error is thrown when `braces.expand()` is used or `options.expand` is true and the generated range will exceed the `rangeLimit`.
|
||||||
|
|
||||||
|
You can customize `options.rangeLimit` or set it to `Inifinity` to disable this altogether.
|
||||||
|
|
||||||
|
**Examples**
|
||||||
|
|
||||||
|
```js
|
||||||
|
// pattern exceeds the "rangeLimit", so it's optimized automatically
|
||||||
|
console.log(braces.expand('{1..1000}'));
|
||||||
|
//=> ['([1-9]|[1-9][0-9]{1,2}|1000)']
|
||||||
|
|
||||||
|
// pattern does not exceed "rangeLimit", so it's NOT optimized
|
||||||
|
console.log(braces.expand('{1..100}'));
|
||||||
|
//=> ['1', '2', '3', '4', '5', '6', '7', '8', '9', '10', '11', '12', '13', '14', '15', '16', '17', '18', '19', '20', '21', '22', '23', '24', '25', '26', '27', '28', '29', '30', '31', '32', '33', '34', '35', '36', '37', '38', '39', '40', '41', '42', '43', '44', '45', '46', '47', '48', '49', '50', '51', '52', '53', '54', '55', '56', '57', '58', '59', '60', '61', '62', '63', '64', '65', '66', '67', '68', '69', '70', '71', '72', '73', '74', '75', '76', '77', '78', '79', '80', '81', '82', '83', '84', '85', '86', '87', '88', '89', '90', '91', '92', '93', '94', '95', '96', '97', '98', '99', '100']
|
||||||
|
```
|
||||||
|
|
||||||
|
### options.transform
|
||||||
|
|
||||||
|
**Type**: `Function`
|
||||||
|
|
||||||
|
**Default**: `undefined`
|
||||||
|
|
||||||
|
**Description**: Customize range expansion.
|
||||||
|
|
||||||
|
**Example: Transforming non-numeric values**
|
||||||
|
|
||||||
|
```js
|
||||||
|
const alpha = braces.expand('x/{a..e}/y', {
|
||||||
|
transform(value, index) {
|
||||||
|
// When non-numeric values are passed, "value" is a character code.
|
||||||
|
return 'foo/' + String.fromCharCode(value) + '-' + index;
|
||||||
|
},
|
||||||
|
});
|
||||||
|
console.log(alpha);
|
||||||
|
//=> [ 'x/foo/a-0/y', 'x/foo/b-1/y', 'x/foo/c-2/y', 'x/foo/d-3/y', 'x/foo/e-4/y' ]
|
||||||
|
```
|
||||||
|
|
||||||
|
**Example: Transforming numeric values**
|
||||||
|
|
||||||
|
```js
|
||||||
|
const numeric = braces.expand('{1..5}', {
|
||||||
|
transform(value) {
|
||||||
|
// when numeric values are passed, "value" is a number
|
||||||
|
return 'foo/' + value * 2;
|
||||||
|
},
|
||||||
|
});
|
||||||
|
console.log(numeric);
|
||||||
|
//=> [ 'foo/2', 'foo/4', 'foo/6', 'foo/8', 'foo/10' ]
|
||||||
|
```
|
||||||
|
|
||||||
|
### options.quantifiers
|
||||||
|
|
||||||
|
**Type**: `Boolean`
|
||||||
|
|
||||||
|
**Default**: `undefined`
|
||||||
|
|
||||||
|
**Description**: In regular expressions, quanitifiers can be used to specify how many times a token can be repeated. For example, `a{1,3}` will match the letter `a` one to three times.
|
||||||
|
|
||||||
|
Unfortunately, regex quantifiers happen to share the same syntax as [Bash lists](#lists)
|
||||||
|
|
||||||
|
The `quantifiers` option tells braces to detect when [regex quantifiers](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp#quantifiers) are defined in the given pattern, and not to try to expand them as lists.
|
||||||
|
|
||||||
|
**Examples**
|
||||||
|
|
||||||
|
```js
|
||||||
|
const braces = require('braces');
|
||||||
|
console.log(braces('a/b{1,3}/{x,y,z}'));
|
||||||
|
//=> [ 'a/b(1|3)/(x|y|z)' ]
|
||||||
|
console.log(braces('a/b{1,3}/{x,y,z}', { quantifiers: true }));
|
||||||
|
//=> [ 'a/b{1,3}/(x|y|z)' ]
|
||||||
|
console.log(braces('a/b{1,3}/{x,y,z}', { quantifiers: true, expand: true }));
|
||||||
|
//=> [ 'a/b{1,3}/x', 'a/b{1,3}/y', 'a/b{1,3}/z' ]
|
||||||
|
```
|
||||||
|
|
||||||
|
### options.keepEscaping
|
||||||
|
|
||||||
|
**Type**: `Boolean`
|
||||||
|
|
||||||
|
**Default**: `undefined`
|
||||||
|
|
||||||
|
**Description**: Do not strip backslashes that were used for escaping from the result.
|
||||||
|
|
||||||
|
## What is "brace expansion"?
|
||||||
|
|
||||||
|
Brace expansion is a type of parameter expansion that was made popular by unix shells for generating lists of strings, as well as regex-like matching when used alongside wildcards (globs).
|
||||||
|
|
||||||
|
In addition to "expansion", braces are also used for matching. In other words:
|
||||||
|
|
||||||
|
- [brace expansion](#brace-expansion) is for generating new lists
|
||||||
|
- [brace matching](#brace-matching) is for filtering existing lists
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><strong>More about brace expansion</strong> (click to expand)</summary>
|
||||||
|
|
||||||
|
There are two main types of brace expansion:
|
||||||
|
|
||||||
|
1. **lists**: which are defined using comma-separated values inside curly braces: `{a,b,c}`
|
||||||
|
2. **sequences**: which are defined using a starting value and an ending value, separated by two dots: `a{1..3}b`. Optionally, a third argument may be passed to define a "step" or increment to use: `a{1..100..10}b`. These are also sometimes referred to as "ranges".
|
||||||
|
|
||||||
|
Here are some example brace patterns to illustrate how they work:
|
||||||
|
|
||||||
|
**Sets**
|
||||||
|
|
||||||
|
```
|
||||||
|
{a,b,c} => a b c
|
||||||
|
{a,b,c}{1,2} => a1 a2 b1 b2 c1 c2
|
||||||
|
```
|
||||||
|
|
||||||
|
**Sequences**
|
||||||
|
|
||||||
|
```
|
||||||
|
{1..9} => 1 2 3 4 5 6 7 8 9
|
||||||
|
{4..-4} => 4 3 2 1 0 -1 -2 -3 -4
|
||||||
|
{1..20..3} => 1 4 7 10 13 16 19
|
||||||
|
{a..j} => a b c d e f g h i j
|
||||||
|
{j..a} => j i h g f e d c b a
|
||||||
|
{a..z..3} => a d g j m p s v y
|
||||||
|
```
|
||||||
|
|
||||||
|
**Combination**
|
||||||
|
|
||||||
|
Sets and sequences can be mixed together or used along with any other strings.
|
||||||
|
|
||||||
|
```
|
||||||
|
{a,b,c}{1..3} => a1 a2 a3 b1 b2 b3 c1 c2 c3
|
||||||
|
foo/{a,b,c}/bar => foo/a/bar foo/b/bar foo/c/bar
|
||||||
|
```
|
||||||
|
|
||||||
|
The fact that braces can be "expanded" from relatively simple patterns makes them ideal for quickly generating test fixtures, file paths, and similar use cases.
|
||||||
|
|
||||||
|
## Brace matching
|
||||||
|
|
||||||
|
In addition to _expansion_, brace patterns are also useful for performing regular-expression-like matching.
|
||||||
|
|
||||||
|
For example, the pattern `foo/{1..3}/bar` would match any of following strings:
|
||||||
|
|
||||||
|
```
|
||||||
|
foo/1/bar
|
||||||
|
foo/2/bar
|
||||||
|
foo/3/bar
|
||||||
|
```
|
||||||
|
|
||||||
|
But not:
|
||||||
|
|
||||||
|
```
|
||||||
|
baz/1/qux
|
||||||
|
baz/2/qux
|
||||||
|
baz/3/qux
|
||||||
|
```
|
||||||
|
|
||||||
|
Braces can also be combined with [glob patterns](https://github.com/jonschlinkert/micromatch) to perform more advanced wildcard matching. For example, the pattern `*/{1..3}/*` would match any of following strings:
|
||||||
|
|
||||||
|
```
|
||||||
|
foo/1/bar
|
||||||
|
foo/2/bar
|
||||||
|
foo/3/bar
|
||||||
|
baz/1/qux
|
||||||
|
baz/2/qux
|
||||||
|
baz/3/qux
|
||||||
|
```
|
||||||
|
|
||||||
|
## Brace matching pitfalls
|
||||||
|
|
||||||
|
Although brace patterns offer a user-friendly way of matching ranges or sets of strings, there are also some major disadvantages and potential risks you should be aware of.
|
||||||
|
|
||||||
|
### tldr
|
||||||
|
|
||||||
|
**"brace bombs"**
|
||||||
|
|
||||||
|
- brace expansion can eat up a huge amount of processing resources
|
||||||
|
- as brace patterns increase _linearly in size_, the system resources required to expand the pattern increase exponentially
|
||||||
|
- users can accidentally (or intentially) exhaust your system's resources resulting in the equivalent of a DoS attack (bonus: no programming knowledge is required!)
|
||||||
|
|
||||||
|
For a more detailed explanation with examples, see the [geometric complexity](#geometric-complexity) section.
|
||||||
|
|
||||||
|
### The solution
|
||||||
|
|
||||||
|
Jump to the [performance section](#performance) to see how Braces solves this problem in comparison to other libraries.
|
||||||
|
|
||||||
|
### Geometric complexity
|
||||||
|
|
||||||
|
At minimum, brace patterns with sets limited to two elements have quadradic or `O(n^2)` complexity. But the complexity of the algorithm increases exponentially as the number of sets, _and elements per set_, increases, which is `O(n^c)`.
|
||||||
|
|
||||||
|
For example, the following sets demonstrate quadratic (`O(n^2)`) complexity:
|
||||||
|
|
||||||
|
```
|
||||||
|
{1,2}{3,4} => (2X2) => 13 14 23 24
|
||||||
|
{1,2}{3,4}{5,6} => (2X2X2) => 135 136 145 146 235 236 245 246
|
||||||
|
```
|
||||||
|
|
||||||
|
But add an element to a set, and we get a n-fold Cartesian product with `O(n^c)` complexity:
|
||||||
|
|
||||||
|
```
|
||||||
|
{1,2,3}{4,5,6}{7,8,9} => (3X3X3) => 147 148 149 157 158 159 167 168 169 247 248
|
||||||
|
249 257 258 259 267 268 269 347 348 349 357
|
||||||
|
358 359 367 368 369
|
||||||
|
```
|
||||||
|
|
||||||
|
Now, imagine how this complexity grows given that each element is a n-tuple:
|
||||||
|
|
||||||
|
```
|
||||||
|
{1..100}{1..100} => (100X100) => 10,000 elements (38.4 kB)
|
||||||
|
{1..100}{1..100}{1..100} => (100X100X100) => 1,000,000 elements (5.76 MB)
|
||||||
|
```
|
||||||
|
|
||||||
|
Although these examples are clearly contrived, they demonstrate how brace patterns can quickly grow out of control.
|
||||||
|
|
||||||
|
**More information**
|
||||||
|
|
||||||
|
Interested in learning more about brace expansion?
|
||||||
|
|
||||||
|
- [linuxjournal/bash-brace-expansion](http://www.linuxjournal.com/content/bash-brace-expansion)
|
||||||
|
- [rosettacode/Brace_expansion](https://rosettacode.org/wiki/Brace_expansion)
|
||||||
|
- [cartesian product](https://en.wikipedia.org/wiki/Cartesian_product)
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
## Performance
|
||||||
|
|
||||||
|
Braces is not only screaming fast, it's also more accurate the other brace expansion libraries.
|
||||||
|
|
||||||
|
### Better algorithms
|
||||||
|
|
||||||
|
Fortunately there is a solution to the ["brace bomb" problem](#brace-matching-pitfalls): _don't expand brace patterns into an array when they're used for matching_.
|
||||||
|
|
||||||
|
Instead, convert the pattern into an optimized regular expression. This is easier said than done, and braces is the only library that does this currently.
|
||||||
|
|
||||||
|
**The proof is in the numbers**
|
||||||
|
|
||||||
|
Minimatch gets exponentially slower as patterns increase in complexity, braces does not. The following results were generated using `braces()` and `minimatch.braceExpand()`, respectively.
|
||||||
|
|
||||||
|
| **Pattern** | **braces** | **[minimatch][]** |
|
||||||
|
| --------------------------- | ------------------- | ---------------------------- |
|
||||||
|
| `{1..9007199254740991}`[^1] | `298 B` (5ms 459μs) | N/A (freezes) |
|
||||||
|
| `{1..1000000000000000}` | `41 B` (1ms 15μs) | N/A (freezes) |
|
||||||
|
| `{1..100000000000000}` | `40 B` (890μs) | N/A (freezes) |
|
||||||
|
| `{1..10000000000000}` | `39 B` (2ms 49μs) | N/A (freezes) |
|
||||||
|
| `{1..1000000000000}` | `38 B` (608μs) | N/A (freezes) |
|
||||||
|
| `{1..100000000000}` | `37 B` (397μs) | N/A (freezes) |
|
||||||
|
| `{1..10000000000}` | `35 B` (983μs) | N/A (freezes) |
|
||||||
|
| `{1..1000000000}` | `34 B` (798μs) | N/A (freezes) |
|
||||||
|
| `{1..100000000}` | `33 B` (733μs) | N/A (freezes) |
|
||||||
|
| `{1..10000000}` | `32 B` (5ms 632μs) | `78.89 MB` (16s 388ms 569μs) |
|
||||||
|
| `{1..1000000}` | `31 B` (1ms 381μs) | `6.89 MB` (1s 496ms 887μs) |
|
||||||
|
| `{1..100000}` | `30 B` (950μs) | `588.89 kB` (146ms 921μs) |
|
||||||
|
| `{1..10000}` | `29 B` (1ms 114μs) | `48.89 kB` (14ms 187μs) |
|
||||||
|
| `{1..1000}` | `28 B` (760μs) | `3.89 kB` (1ms 453μs) |
|
||||||
|
| `{1..100}` | `22 B` (345μs) | `291 B` (196μs) |
|
||||||
|
| `{1..10}` | `10 B` (533μs) | `20 B` (37μs) |
|
||||||
|
| `{1..3}` | `7 B` (190μs) | `5 B` (27μs) |
|
||||||
|
|
||||||
|
### Faster algorithms
|
||||||
|
|
||||||
|
When you need expansion, braces is still much faster.
|
||||||
|
|
||||||
|
_(the following results were generated using `braces.expand()` and `minimatch.braceExpand()`, respectively)_
|
||||||
|
|
||||||
|
| **Pattern** | **braces** | **[minimatch][]** |
|
||||||
|
| --------------- | --------------------------- | ---------------------------- |
|
||||||
|
| `{1..10000000}` | `78.89 MB` (2s 698ms 642μs) | `78.89 MB` (18s 601ms 974μs) |
|
||||||
|
| `{1..1000000}` | `6.89 MB` (458ms 576μs) | `6.89 MB` (1s 491ms 621μs) |
|
||||||
|
| `{1..100000}` | `588.89 kB` (20ms 728μs) | `588.89 kB` (156ms 919μs) |
|
||||||
|
| `{1..10000}` | `48.89 kB` (2ms 202μs) | `48.89 kB` (13ms 641μs) |
|
||||||
|
| `{1..1000}` | `3.89 kB` (1ms 796μs) | `3.89 kB` (1ms 958μs) |
|
||||||
|
| `{1..100}` | `291 B` (424μs) | `291 B` (211μs) |
|
||||||
|
| `{1..10}` | `20 B` (487μs) | `20 B` (72μs) |
|
||||||
|
| `{1..3}` | `5 B` (166μs) | `5 B` (27μs) |
|
||||||
|
|
||||||
|
If you'd like to run these comparisons yourself, see [test/support/generate.js](test/support/generate.js).
|
||||||
|
|
||||||
|
## Benchmarks
|
||||||
|
|
||||||
|
### Running benchmarks
|
||||||
|
|
||||||
|
Install dev dependencies:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm i -d && npm benchmark
|
||||||
|
```
|
||||||
|
|
||||||
|
### Latest results
|
||||||
|
|
||||||
|
Braces is more accurate, without sacrificing performance.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
● expand - range (expanded)
|
||||||
|
braces x 53,167 ops/sec ±0.12% (102 runs sampled)
|
||||||
|
minimatch x 11,378 ops/sec ±0.10% (102 runs sampled)
|
||||||
|
● expand - range (optimized for regex)
|
||||||
|
braces x 373,442 ops/sec ±0.04% (100 runs sampled)
|
||||||
|
minimatch x 3,262 ops/sec ±0.18% (100 runs sampled)
|
||||||
|
● expand - nested ranges (expanded)
|
||||||
|
braces x 33,921 ops/sec ±0.09% (99 runs sampled)
|
||||||
|
minimatch x 10,855 ops/sec ±0.28% (100 runs sampled)
|
||||||
|
● expand - nested ranges (optimized for regex)
|
||||||
|
braces x 287,479 ops/sec ±0.52% (98 runs sampled)
|
||||||
|
minimatch x 3,219 ops/sec ±0.28% (101 runs sampled)
|
||||||
|
● expand - set (expanded)
|
||||||
|
braces x 238,243 ops/sec ±0.19% (97 runs sampled)
|
||||||
|
minimatch x 538,268 ops/sec ±0.31% (96 runs sampled)
|
||||||
|
● expand - set (optimized for regex)
|
||||||
|
braces x 321,844 ops/sec ±0.10% (97 runs sampled)
|
||||||
|
minimatch x 140,600 ops/sec ±0.15% (100 runs sampled)
|
||||||
|
● expand - nested sets (expanded)
|
||||||
|
braces x 165,371 ops/sec ±0.42% (96 runs sampled)
|
||||||
|
minimatch x 337,720 ops/sec ±0.28% (100 runs sampled)
|
||||||
|
● expand - nested sets (optimized for regex)
|
||||||
|
braces x 242,948 ops/sec ±0.12% (99 runs sampled)
|
||||||
|
minimatch x 87,403 ops/sec ±0.79% (96 runs sampled)
|
||||||
|
```
|
||||||
|
|
||||||
|
## About
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><strong>Contributing</strong></summary>
|
||||||
|
|
||||||
|
Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](../../issues/new).
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><strong>Running Tests</strong></summary>
|
||||||
|
|
||||||
|
Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
$ npm install && npm test
|
||||||
|
```
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><strong>Building docs</strong></summary>
|
||||||
|
|
||||||
|
_(This project's readme.md is generated by [verb](https://github.com/verbose/verb-generate-readme), please don't edit the readme directly. Any changes to the readme must be made in the [.verb.md](.verb.md) readme template.)_
|
||||||
|
|
||||||
|
To generate the readme, run the following command:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
$ npm install -g verbose/verb#dev verb-generate-readme && verb
|
||||||
|
```
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
### Contributors
|
||||||
|
|
||||||
|
| **Commits** | **Contributor** |
|
||||||
|
| ----------- | ------------------------------------------------------------- |
|
||||||
|
| 197 | [jonschlinkert](https://github.com/jonschlinkert) |
|
||||||
|
| 4 | [doowb](https://github.com/doowb) |
|
||||||
|
| 1 | [es128](https://github.com/es128) |
|
||||||
|
| 1 | [eush77](https://github.com/eush77) |
|
||||||
|
| 1 | [hemanth](https://github.com/hemanth) |
|
||||||
|
| 1 | [wtgtybhertgeghgtwtg](https://github.com/wtgtybhertgeghgtwtg) |
|
||||||
|
|
||||||
|
### Author
|
||||||
|
|
||||||
|
**Jon Schlinkert**
|
||||||
|
|
||||||
|
- [GitHub Profile](https://github.com/jonschlinkert)
|
||||||
|
- [Twitter Profile](https://twitter.com/jonschlinkert)
|
||||||
|
- [LinkedIn Profile](https://linkedin.com/in/jonschlinkert)
|
||||||
|
|
||||||
|
### License
|
||||||
|
|
||||||
|
Copyright © 2019, [Jon Schlinkert](https://github.com/jonschlinkert).
|
||||||
|
Released under the [MIT License](LICENSE).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_This file was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme), v0.8.0, on April 08, 2019._
|
|
@ -0,0 +1,170 @@
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
const stringify = require('./lib/stringify');
|
||||||
|
const compile = require('./lib/compile');
|
||||||
|
const expand = require('./lib/expand');
|
||||||
|
const parse = require('./lib/parse');
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Expand the given pattern or create a regex-compatible string.
|
||||||
|
*
|
||||||
|
* ```js
|
||||||
|
* const braces = require('braces');
|
||||||
|
* console.log(braces('{a,b,c}', { compile: true })); //=> ['(a|b|c)']
|
||||||
|
* console.log(braces('{a,b,c}')); //=> ['a', 'b', 'c']
|
||||||
|
* ```
|
||||||
|
* @param {String} `str`
|
||||||
|
* @param {Object} `options`
|
||||||
|
* @return {String}
|
||||||
|
* @api public
|
||||||
|
*/
|
||||||
|
|
||||||
|
const braces = (input, options = {}) => {
|
||||||
|
let output = [];
|
||||||
|
|
||||||
|
if (Array.isArray(input)) {
|
||||||
|
for (const pattern of input) {
|
||||||
|
const result = braces.create(pattern, options);
|
||||||
|
if (Array.isArray(result)) {
|
||||||
|
output.push(...result);
|
||||||
|
} else {
|
||||||
|
output.push(result);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
output = [].concat(braces.create(input, options));
|
||||||
|
}
|
||||||
|
|
||||||
|
if (options && options.expand === true && options.nodupes === true) {
|
||||||
|
output = [...new Set(output)];
|
||||||
|
}
|
||||||
|
return output;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Parse the given `str` with the given `options`.
|
||||||
|
*
|
||||||
|
* ```js
|
||||||
|
* // braces.parse(pattern, [, options]);
|
||||||
|
* const ast = braces.parse('a/{b,c}/d');
|
||||||
|
* console.log(ast);
|
||||||
|
* ```
|
||||||
|
* @param {String} pattern Brace pattern to parse
|
||||||
|
* @param {Object} options
|
||||||
|
* @return {Object} Returns an AST
|
||||||
|
* @api public
|
||||||
|
*/
|
||||||
|
|
||||||
|
braces.parse = (input, options = {}) => parse(input, options);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Creates a braces string from an AST, or an AST node.
|
||||||
|
*
|
||||||
|
* ```js
|
||||||
|
* const braces = require('braces');
|
||||||
|
* let ast = braces.parse('foo/{a,b}/bar');
|
||||||
|
* console.log(stringify(ast.nodes[2])); //=> '{a,b}'
|
||||||
|
* ```
|
||||||
|
* @param {String} `input` Brace pattern or AST.
|
||||||
|
* @param {Object} `options`
|
||||||
|
* @return {Array} Returns an array of expanded values.
|
||||||
|
* @api public
|
||||||
|
*/
|
||||||
|
|
||||||
|
braces.stringify = (input, options = {}) => {
|
||||||
|
if (typeof input === 'string') {
|
||||||
|
return stringify(braces.parse(input, options), options);
|
||||||
|
}
|
||||||
|
return stringify(input, options);
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Compiles a brace pattern into a regex-compatible, optimized string.
|
||||||
|
* This method is called by the main [braces](#braces) function by default.
|
||||||
|
*
|
||||||
|
* ```js
|
||||||
|
* const braces = require('braces');
|
||||||
|
* console.log(braces.compile('a/{b,c}/d'));
|
||||||
|
* //=> ['a/(b|c)/d']
|
||||||
|
* ```
|
||||||
|
* @param {String} `input` Brace pattern or AST.
|
||||||
|
* @param {Object} `options`
|
||||||
|
* @return {Array} Returns an array of expanded values.
|
||||||
|
* @api public
|
||||||
|
*/
|
||||||
|
|
||||||
|
braces.compile = (input, options = {}) => {
|
||||||
|
if (typeof input === 'string') {
|
||||||
|
input = braces.parse(input, options);
|
||||||
|
}
|
||||||
|
return compile(input, options);
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Expands a brace pattern into an array. This method is called by the
|
||||||
|
* main [braces](#braces) function when `options.expand` is true. Before
|
||||||
|
* using this method it's recommended that you read the [performance notes](#performance))
|
||||||
|
* and advantages of using [.compile](#compile) instead.
|
||||||
|
*
|
||||||
|
* ```js
|
||||||
|
* const braces = require('braces');
|
||||||
|
* console.log(braces.expand('a/{b,c}/d'));
|
||||||
|
* //=> ['a/b/d', 'a/c/d'];
|
||||||
|
* ```
|
||||||
|
* @param {String} `pattern` Brace pattern
|
||||||
|
* @param {Object} `options`
|
||||||
|
* @return {Array} Returns an array of expanded values.
|
||||||
|
* @api public
|
||||||
|
*/
|
||||||
|
|
||||||
|
braces.expand = (input, options = {}) => {
|
||||||
|
if (typeof input === 'string') {
|
||||||
|
input = braces.parse(input, options);
|
||||||
|
}
|
||||||
|
|
||||||
|
let result = expand(input, options);
|
||||||
|
|
||||||
|
// filter out empty strings if specified
|
||||||
|
if (options.noempty === true) {
|
||||||
|
result = result.filter(Boolean);
|
||||||
|
}
|
||||||
|
|
||||||
|
// filter out duplicates if specified
|
||||||
|
if (options.nodupes === true) {
|
||||||
|
result = [...new Set(result)];
|
||||||
|
}
|
||||||
|
|
||||||
|
return result;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Processes a brace pattern and returns either an expanded array
|
||||||
|
* (if `options.expand` is true), a highly optimized regex-compatible string.
|
||||||
|
* This method is called by the main [braces](#braces) function.
|
||||||
|
*
|
||||||
|
* ```js
|
||||||
|
* const braces = require('braces');
|
||||||
|
* console.log(braces.create('user-{200..300}/project-{a,b,c}-{1..10}'))
|
||||||
|
* //=> 'user-(20[0-9]|2[1-9][0-9]|300)/project-(a|b|c)-([1-9]|10)'
|
||||||
|
* ```
|
||||||
|
* @param {String} `pattern` Brace pattern
|
||||||
|
* @param {Object} `options`
|
||||||
|
* @return {Array} Returns an array of expanded values.
|
||||||
|
* @api public
|
||||||
|
*/
|
||||||
|
|
||||||
|
braces.create = (input, options = {}) => {
|
||||||
|
if (input === '' || input.length < 3) {
|
||||||
|
return [input];
|
||||||
|
}
|
||||||
|
|
||||||
|
return options.expand !== true
|
||||||
|
? braces.compile(input, options)
|
||||||
|
: braces.expand(input, options);
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Expose "braces"
|
||||||
|
*/
|
||||||
|
|
||||||
|
module.exports = braces;
|
|
@ -0,0 +1,60 @@
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
const fill = require('fill-range');
|
||||||
|
const utils = require('./utils');
|
||||||
|
|
||||||
|
const compile = (ast, options = {}) => {
|
||||||
|
const walk = (node, parent = {}) => {
|
||||||
|
const invalidBlock = utils.isInvalidBrace(parent);
|
||||||
|
const invalidNode = node.invalid === true && options.escapeInvalid === true;
|
||||||
|
const invalid = invalidBlock === true || invalidNode === true;
|
||||||
|
const prefix = options.escapeInvalid === true ? '\\' : '';
|
||||||
|
let output = '';
|
||||||
|
|
||||||
|
if (node.isOpen === true) {
|
||||||
|
return prefix + node.value;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (node.isClose === true) {
|
||||||
|
console.log('node.isClose', prefix, node.value);
|
||||||
|
return prefix + node.value;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (node.type === 'open') {
|
||||||
|
return invalid ? prefix + node.value : '(';
|
||||||
|
}
|
||||||
|
|
||||||
|
if (node.type === 'close') {
|
||||||
|
return invalid ? prefix + node.value : ')';
|
||||||
|
}
|
||||||
|
|
||||||
|
if (node.type === 'comma') {
|
||||||
|
return node.prev.type === 'comma' ? '' : invalid ? node.value : '|';
|
||||||
|
}
|
||||||
|
|
||||||
|
if (node.value) {
|
||||||
|
return node.value;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (node.nodes && node.ranges > 0) {
|
||||||
|
const args = utils.reduce(node.nodes);
|
||||||
|
const range = fill(...args, { ...options, wrap: false, toRegex: true, strictZeros: true });
|
||||||
|
|
||||||
|
if (range.length !== 0) {
|
||||||
|
return args.length > 1 && range.length > 1 ? `(${range})` : range;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (node.nodes) {
|
||||||
|
for (const child of node.nodes) {
|
||||||
|
output += walk(child, node);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return output;
|
||||||
|
};
|
||||||
|
|
||||||
|
return walk(ast);
|
||||||
|
};
|
||||||
|
|
||||||
|
module.exports = compile;
|
|
@ -0,0 +1,57 @@
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
module.exports = {
|
||||||
|
MAX_LENGTH: 10000,
|
||||||
|
|
||||||
|
// Digits
|
||||||
|
CHAR_0: '0', /* 0 */
|
||||||
|
CHAR_9: '9', /* 9 */
|
||||||
|
|
||||||
|
// Alphabet chars.
|
||||||
|
CHAR_UPPERCASE_A: 'A', /* A */
|
||||||
|
CHAR_LOWERCASE_A: 'a', /* a */
|
||||||
|
CHAR_UPPERCASE_Z: 'Z', /* Z */
|
||||||
|
CHAR_LOWERCASE_Z: 'z', /* z */
|
||||||
|
|
||||||
|
CHAR_LEFT_PARENTHESES: '(', /* ( */
|
||||||
|
CHAR_RIGHT_PARENTHESES: ')', /* ) */
|
||||||
|
|
||||||
|
CHAR_ASTERISK: '*', /* * */
|
||||||
|
|
||||||
|
// Non-alphabetic chars.
|
||||||
|
CHAR_AMPERSAND: '&', /* & */
|
||||||
|
CHAR_AT: '@', /* @ */
|
||||||
|
CHAR_BACKSLASH: '\\', /* \ */
|
||||||
|
CHAR_BACKTICK: '`', /* ` */
|
||||||
|
CHAR_CARRIAGE_RETURN: '\r', /* \r */
|
||||||
|
CHAR_CIRCUMFLEX_ACCENT: '^', /* ^ */
|
||||||
|
CHAR_COLON: ':', /* : */
|
||||||
|
CHAR_COMMA: ',', /* , */
|
||||||
|
CHAR_DOLLAR: '$', /* . */
|
||||||
|
CHAR_DOT: '.', /* . */
|
||||||
|
CHAR_DOUBLE_QUOTE: '"', /* " */
|
||||||
|
CHAR_EQUAL: '=', /* = */
|
||||||
|
CHAR_EXCLAMATION_MARK: '!', /* ! */
|
||||||
|
CHAR_FORM_FEED: '\f', /* \f */
|
||||||
|
CHAR_FORWARD_SLASH: '/', /* / */
|
||||||
|
CHAR_HASH: '#', /* # */
|
||||||
|
CHAR_HYPHEN_MINUS: '-', /* - */
|
||||||
|
CHAR_LEFT_ANGLE_BRACKET: '<', /* < */
|
||||||
|
CHAR_LEFT_CURLY_BRACE: '{', /* { */
|
||||||
|
CHAR_LEFT_SQUARE_BRACKET: '[', /* [ */
|
||||||
|
CHAR_LINE_FEED: '\n', /* \n */
|
||||||
|
CHAR_NO_BREAK_SPACE: '\u00A0', /* \u00A0 */
|
||||||
|
CHAR_PERCENT: '%', /* % */
|
||||||
|
CHAR_PLUS: '+', /* + */
|
||||||
|
CHAR_QUESTION_MARK: '?', /* ? */
|
||||||
|
CHAR_RIGHT_ANGLE_BRACKET: '>', /* > */
|
||||||
|
CHAR_RIGHT_CURLY_BRACE: '}', /* } */
|
||||||
|
CHAR_RIGHT_SQUARE_BRACKET: ']', /* ] */
|
||||||
|
CHAR_SEMICOLON: ';', /* ; */
|
||||||
|
CHAR_SINGLE_QUOTE: '\'', /* ' */
|
||||||
|
CHAR_SPACE: ' ', /* */
|
||||||
|
CHAR_TAB: '\t', /* \t */
|
||||||
|
CHAR_UNDERSCORE: '_', /* _ */
|
||||||
|
CHAR_VERTICAL_LINE: '|', /* | */
|
||||||
|
CHAR_ZERO_WIDTH_NOBREAK_SPACE: '\uFEFF' /* \uFEFF */
|
||||||
|
};
|
|
@ -0,0 +1,113 @@
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
const fill = require('fill-range');
|
||||||
|
const stringify = require('./stringify');
|
||||||
|
const utils = require('./utils');
|
||||||
|
|
||||||
|
const append = (queue = '', stash = '', enclose = false) => {
|
||||||
|
const result = [];
|
||||||
|
|
||||||
|
queue = [].concat(queue);
|
||||||
|
stash = [].concat(stash);
|
||||||
|
|
||||||
|
if (!stash.length) return queue;
|
||||||
|
if (!queue.length) {
|
||||||
|
return enclose ? utils.flatten(stash).map(ele => `{${ele}}`) : stash;
|
||||||
|
}
|
||||||
|
|
||||||
|
for (const item of queue) {
|
||||||
|
if (Array.isArray(item)) {
|
||||||
|
for (const value of item) {
|
||||||
|
result.push(append(value, stash, enclose));
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
for (let ele of stash) {
|
||||||
|
if (enclose === true && typeof ele === 'string') ele = `{${ele}}`;
|
||||||
|
result.push(Array.isArray(ele) ? append(item, ele, enclose) : item + ele);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return utils.flatten(result);
|
||||||
|
};
|
||||||
|
|
||||||
|
const expand = (ast, options = {}) => {
|
||||||
|
const rangeLimit = options.rangeLimit === undefined ? 1000 : options.rangeLimit;
|
||||||
|
|
||||||
|
const walk = (node, parent = {}) => {
|
||||||
|
node.queue = [];
|
||||||
|
|
||||||
|
let p = parent;
|
||||||
|
let q = parent.queue;
|
||||||
|
|
||||||
|
while (p.type !== 'brace' && p.type !== 'root' && p.parent) {
|
||||||
|
p = p.parent;
|
||||||
|
q = p.queue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (node.invalid || node.dollar) {
|
||||||
|
q.push(append(q.pop(), stringify(node, options)));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (node.type === 'brace' && node.invalid !== true && node.nodes.length === 2) {
|
||||||
|
q.push(append(q.pop(), ['{}']));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (node.nodes && node.ranges > 0) {
|
||||||
|
const args = utils.reduce(node.nodes);
|
||||||
|
|
||||||
|
if (utils.exceedsLimit(...args, options.step, rangeLimit)) {
|
||||||
|
throw new RangeError('expanded array length exceeds range limit. Use options.rangeLimit to increase or disable the limit.');
|
||||||
|
}
|
||||||
|
|
||||||
|
let range = fill(...args, options);
|
||||||
|
if (range.length === 0) {
|
||||||
|
range = stringify(node, options);
|
||||||
|
}
|
||||||
|
|
||||||
|
q.push(append(q.pop(), range));
|
||||||
|
node.nodes = [];
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
const enclose = utils.encloseBrace(node);
|
||||||
|
let queue = node.queue;
|
||||||
|
let block = node;
|
||||||
|
|
||||||
|
while (block.type !== 'brace' && block.type !== 'root' && block.parent) {
|
||||||
|
block = block.parent;
|
||||||
|
queue = block.queue;
|
||||||
|
}
|
||||||
|
|
||||||
|
for (let i = 0; i < node.nodes.length; i++) {
|
||||||
|
const child = node.nodes[i];
|
||||||
|
|
||||||
|
if (child.type === 'comma' && node.type === 'brace') {
|
||||||
|
if (i === 1) queue.push('');
|
||||||
|
queue.push('');
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (child.type === 'close') {
|
||||||
|
q.push(append(q.pop(), queue, enclose));
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (child.value && child.type !== 'open') {
|
||||||
|
queue.push(append(queue.pop(), child.value));
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (child.nodes) {
|
||||||
|
walk(child, node);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return queue;
|
||||||
|
};
|
||||||
|
|
||||||
|
return utils.flatten(walk(ast));
|
||||||
|
};
|
||||||
|
|
||||||
|
module.exports = expand;
|
|
@ -0,0 +1,331 @@
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
const stringify = require('./stringify');
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constants
|
||||||
|
*/
|
||||||
|
|
||||||
|
const {
|
||||||
|
MAX_LENGTH,
|
||||||
|
CHAR_BACKSLASH, /* \ */
|
||||||
|
CHAR_BACKTICK, /* ` */
|
||||||
|
CHAR_COMMA, /* , */
|
||||||
|
CHAR_DOT, /* . */
|
||||||
|
CHAR_LEFT_PARENTHESES, /* ( */
|
||||||
|
CHAR_RIGHT_PARENTHESES, /* ) */
|
||||||
|
CHAR_LEFT_CURLY_BRACE, /* { */
|
||||||
|
CHAR_RIGHT_CURLY_BRACE, /* } */
|
||||||
|
CHAR_LEFT_SQUARE_BRACKET, /* [ */
|
||||||
|
CHAR_RIGHT_SQUARE_BRACKET, /* ] */
|
||||||
|
CHAR_DOUBLE_QUOTE, /* " */
|
||||||
|
CHAR_SINGLE_QUOTE, /* ' */
|
||||||
|
CHAR_NO_BREAK_SPACE,
|
||||||
|
CHAR_ZERO_WIDTH_NOBREAK_SPACE
|
||||||
|
} = require('./constants');
|
||||||
|
|
||||||
|
/**
|
||||||
|
* parse
|
||||||
|
*/
|
||||||
|
|
||||||
|
const parse = (input, options = {}) => {
|
||||||
|
if (typeof input !== 'string') {
|
||||||
|
throw new TypeError('Expected a string');
|
||||||
|
}
|
||||||
|
|
||||||
|
const opts = options || {};
|
||||||
|
const max = typeof opts.maxLength === 'number' ? Math.min(MAX_LENGTH, opts.maxLength) : MAX_LENGTH;
|
||||||
|
if (input.length > max) {
|
||||||
|
throw new SyntaxError(`Input length (${input.length}), exceeds max characters (${max})`);
|
||||||
|
}
|
||||||
|
|
||||||
|
const ast = { type: 'root', input, nodes: [] };
|
||||||
|
const stack = [ast];
|
||||||
|
let block = ast;
|
||||||
|
let prev = ast;
|
||||||
|
let brackets = 0;
|
||||||
|
const length = input.length;
|
||||||
|
let index = 0;
|
||||||
|
let depth = 0;
|
||||||
|
let value;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Helpers
|
||||||
|
*/
|
||||||
|
|
||||||
|
const advance = () => input[index++];
|
||||||
|
const push = node => {
|
||||||
|
if (node.type === 'text' && prev.type === 'dot') {
|
||||||
|
prev.type = 'text';
|
||||||
|
}
|
||||||
|
|
||||||
|
if (prev && prev.type === 'text' && node.type === 'text') {
|
||||||
|
prev.value += node.value;
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
block.nodes.push(node);
|
||||||
|
node.parent = block;
|
||||||
|
node.prev = prev;
|
||||||
|
prev = node;
|
||||||
|
return node;
|
||||||
|
};
|
||||||
|
|
||||||
|
push({ type: 'bos' });
|
||||||
|
|
||||||
|
while (index < length) {
|
||||||
|
block = stack[stack.length - 1];
|
||||||
|
value = advance();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Invalid chars
|
||||||
|
*/
|
||||||
|
|
||||||
|
if (value === CHAR_ZERO_WIDTH_NOBREAK_SPACE || value === CHAR_NO_BREAK_SPACE) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Escaped chars
|
||||||
|
*/
|
||||||
|
|
||||||
|
if (value === CHAR_BACKSLASH) {
|
||||||
|
push({ type: 'text', value: (options.keepEscaping ? value : '') + advance() });
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Right square bracket (literal): ']'
|
||||||
|
*/
|
||||||
|
|
||||||
|
if (value === CHAR_RIGHT_SQUARE_BRACKET) {
|
||||||
|
push({ type: 'text', value: '\\' + value });
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Left square bracket: '['
|
||||||
|
*/
|
||||||
|
|
||||||
|
if (value === CHAR_LEFT_SQUARE_BRACKET) {
|
||||||
|
brackets++;
|
||||||
|
|
||||||
|
let next;
|
||||||
|
|
||||||
|
while (index < length && (next = advance())) {
|
||||||
|
value += next;
|
||||||
|
|
||||||
|
if (next === CHAR_LEFT_SQUARE_BRACKET) {
|
||||||
|
brackets++;
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (next === CHAR_BACKSLASH) {
|
||||||
|
value += advance();
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (next === CHAR_RIGHT_SQUARE_BRACKET) {
|
||||||
|
brackets--;
|
||||||
|
|
||||||
|
if (brackets === 0) {
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
push({ type: 'text', value });
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Parentheses
|
||||||
|
*/
|
||||||
|
|
||||||
|
if (value === CHAR_LEFT_PARENTHESES) {
|
||||||
|
block = push({ type: 'paren', nodes: [] });
|
||||||
|
stack.push(block);
|
||||||
|
push({ type: 'text', value });
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (value === CHAR_RIGHT_PARENTHESES) {
|
||||||
|
if (block.type !== 'paren') {
|
||||||
|
push({ type: 'text', value });
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
block = stack.pop();
|
||||||
|
push({ type: 'text', value });
|
||||||
|
block = stack[stack.length - 1];
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Quotes: '|"|`
|
||||||
|
*/
|
||||||
|
|
||||||
|
if (value === CHAR_DOUBLE_QUOTE || value === CHAR_SINGLE_QUOTE || value === CHAR_BACKTICK) {
|
||||||
|
const open = value;
|
||||||
|
let next;
|
||||||
|
|
||||||
|
if (options.keepQuotes !== true) {
|
||||||
|
value = '';
|
||||||
|
}
|
||||||
|
|
||||||
|
while (index < length && (next = advance())) {
|
||||||
|
if (next === CHAR_BACKSLASH) {
|
||||||
|
value += next + advance();
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (next === open) {
|
||||||
|
if (options.keepQuotes === true) value += next;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
|
||||||
|
value += next;
|
||||||
|
}
|
||||||
|
|
||||||
|
push({ type: 'text', value });
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Left curly brace: '{'
|
||||||
|
*/
|
||||||
|
|
||||||
|
if (value === CHAR_LEFT_CURLY_BRACE) {
|
||||||
|
depth++;
|
||||||
|
|
||||||
|
const dollar = prev.value && prev.value.slice(-1) === '$' || block.dollar === true;
|
||||||
|
const brace = {
|
||||||
|
type: 'brace',
|
||||||
|
open: true,
|
||||||
|
close: false,
|
||||||
|
dollar,
|
||||||
|
depth,
|
||||||
|
commas: 0,
|
||||||
|
ranges: 0,
|
||||||
|
nodes: []
|
||||||
|
};
|
||||||
|
|
||||||
|
block = push(brace);
|
||||||
|
stack.push(block);
|
||||||
|
push({ type: 'open', value });
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Right curly brace: '}'
|
||||||
|
*/
|
||||||
|
|
||||||
|
if (value === CHAR_RIGHT_CURLY_BRACE) {
|
||||||
|
if (block.type !== 'brace') {
|
||||||
|
push({ type: 'text', value });
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
const type = 'close';
|
||||||
|
block = stack.pop();
|
||||||
|
block.close = true;
|
||||||
|
|
||||||
|
push({ type, value });
|
||||||
|
depth--;
|
||||||
|
|
||||||
|
block = stack[stack.length - 1];
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Comma: ','
|
||||||
|
*/
|
||||||
|
|
||||||
|
if (value === CHAR_COMMA && depth > 0) {
|
||||||
|
if (block.ranges > 0) {
|
||||||
|
block.ranges = 0;
|
||||||
|
const open = block.nodes.shift();
|
||||||
|
block.nodes = [open, { type: 'text', value: stringify(block) }];
|
||||||
|
}
|
||||||
|
|
||||||
|
push({ type: 'comma', value });
|
||||||
|
block.commas++;
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Dot: '.'
|
||||||
|
*/
|
||||||
|
|
||||||
|
if (value === CHAR_DOT && depth > 0 && block.commas === 0) {
|
||||||
|
const siblings = block.nodes;
|
||||||
|
|
||||||
|
if (depth === 0 || siblings.length === 0) {
|
||||||
|
push({ type: 'text', value });
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (prev.type === 'dot') {
|
||||||
|
block.range = [];
|
||||||
|
prev.value += value;
|
||||||
|
prev.type = 'range';
|
||||||
|
|
||||||
|
if (block.nodes.length !== 3 && block.nodes.length !== 5) {
|
||||||
|
block.invalid = true;
|
||||||
|
block.ranges = 0;
|
||||||
|
prev.type = 'text';
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
block.ranges++;
|
||||||
|
block.args = [];
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (prev.type === 'range') {
|
||||||
|
siblings.pop();
|
||||||
|
|
||||||
|
const before = siblings[siblings.length - 1];
|
||||||
|
before.value += prev.value + value;
|
||||||
|
prev = before;
|
||||||
|
block.ranges--;
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
push({ type: 'dot', value });
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Text
|
||||||
|
*/
|
||||||
|
|
||||||
|
push({ type: 'text', value });
|
||||||
|
}
|
||||||
|
|
||||||
|
// Mark imbalanced braces and brackets as invalid
|
||||||
|
do {
|
||||||
|
block = stack.pop();
|
||||||
|
|
||||||
|
if (block.type !== 'root') {
|
||||||
|
block.nodes.forEach(node => {
|
||||||
|
if (!node.nodes) {
|
||||||
|
if (node.type === 'open') node.isOpen = true;
|
||||||
|
if (node.type === 'close') node.isClose = true;
|
||||||
|
if (!node.nodes) node.type = 'text';
|
||||||
|
node.invalid = true;
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// get the location of the block on parent.nodes (block's siblings)
|
||||||
|
const parent = stack[stack.length - 1];
|
||||||
|
const index = parent.nodes.indexOf(block);
|
||||||
|
// replace the (invalid) block with it's nodes
|
||||||
|
parent.nodes.splice(index, 1, ...block.nodes);
|
||||||
|
}
|
||||||
|
} while (stack.length > 0);
|
||||||
|
|
||||||
|
push({ type: 'eos' });
|
||||||
|
return ast;
|
||||||
|
};
|
||||||
|
|
||||||
|
module.exports = parse;
|
|
@ -0,0 +1,32 @@
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
const utils = require('./utils');
|
||||||
|
|
||||||
|
module.exports = (ast, options = {}) => {
|
||||||
|
const stringify = (node, parent = {}) => {
|
||||||
|
const invalidBlock = options.escapeInvalid && utils.isInvalidBrace(parent);
|
||||||
|
const invalidNode = node.invalid === true && options.escapeInvalid === true;
|
||||||
|
let output = '';
|
||||||
|
|
||||||
|
if (node.value) {
|
||||||
|
if ((invalidBlock || invalidNode) && utils.isOpenOrClose(node)) {
|
||||||
|
return '\\' + node.value;
|
||||||
|
}
|
||||||
|
return node.value;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (node.value) {
|
||||||
|
return node.value;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (node.nodes) {
|
||||||
|
for (const child of node.nodes) {
|
||||||
|
output += stringify(child);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return output;
|
||||||
|
};
|
||||||
|
|
||||||
|
return stringify(ast);
|
||||||
|
};
|
||||||
|
|
|
@ -0,0 +1,122 @@
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
exports.isInteger = num => {
|
||||||
|
if (typeof num === 'number') {
|
||||||
|
return Number.isInteger(num);
|
||||||
|
}
|
||||||
|
if (typeof num === 'string' && num.trim() !== '') {
|
||||||
|
return Number.isInteger(Number(num));
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Find a node of the given type
|
||||||
|
*/
|
||||||
|
|
||||||
|
exports.find = (node, type) => node.nodes.find(node => node.type === type);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Find a node of the given type
|
||||||
|
*/
|
||||||
|
|
||||||
|
exports.exceedsLimit = (min, max, step = 1, limit) => {
|
||||||
|
if (limit === false) return false;
|
||||||
|
if (!exports.isInteger(min) || !exports.isInteger(max)) return false;
|
||||||
|
return ((Number(max) - Number(min)) / Number(step)) >= limit;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Escape the given node with '\\' before node.value
|
||||||
|
*/
|
||||||
|
|
||||||
|
exports.escapeNode = (block, n = 0, type) => {
|
||||||
|
const node = block.nodes[n];
|
||||||
|
if (!node) return;
|
||||||
|
|
||||||
|
if ((type && node.type === type) || node.type === 'open' || node.type === 'close') {
|
||||||
|
if (node.escaped !== true) {
|
||||||
|
node.value = '\\' + node.value;
|
||||||
|
node.escaped = true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns true if the given brace node should be enclosed in literal braces
|
||||||
|
*/
|
||||||
|
|
||||||
|
exports.encloseBrace = node => {
|
||||||
|
if (node.type !== 'brace') return false;
|
||||||
|
if ((node.commas >> 0 + node.ranges >> 0) === 0) {
|
||||||
|
node.invalid = true;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns true if a brace node is invalid.
|
||||||
|
*/
|
||||||
|
|
||||||
|
exports.isInvalidBrace = block => {
|
||||||
|
if (block.type !== 'brace') return false;
|
||||||
|
if (block.invalid === true || block.dollar) return true;
|
||||||
|
if ((block.commas >> 0 + block.ranges >> 0) === 0) {
|
||||||
|
block.invalid = true;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
if (block.open !== true || block.close !== true) {
|
||||||
|
block.invalid = true;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns true if a node is an open or close node
|
||||||
|
*/
|
||||||
|
|
||||||
|
exports.isOpenOrClose = node => {
|
||||||
|
if (node.type === 'open' || node.type === 'close') {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return node.open === true || node.close === true;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Reduce an array of text nodes.
|
||||||
|
*/
|
||||||
|
|
||||||
|
exports.reduce = nodes => nodes.reduce((acc, node) => {
|
||||||
|
if (node.type === 'text') acc.push(node.value);
|
||||||
|
if (node.type === 'range') node.type = 'text';
|
||||||
|
return acc;
|
||||||
|
}, []);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Flatten an array
|
||||||
|
*/
|
||||||
|
|
||||||
|
exports.flatten = (...args) => {
|
||||||
|
const result = [];
|
||||||
|
|
||||||
|
const flat = arr => {
|
||||||
|
for (let i = 0; i < arr.length; i++) {
|
||||||
|
const ele = arr[i];
|
||||||
|
|
||||||
|
if (Array.isArray(ele)) {
|
||||||
|
flat(ele);
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (ele !== undefined) {
|
||||||
|
result.push(ele);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
};
|
||||||
|
|
||||||
|
flat(args);
|
||||||
|
return result;
|
||||||
|
};
|
|
@ -0,0 +1,77 @@
|
||||||
|
{
|
||||||
|
"name": "braces",
|
||||||
|
"description": "Bash-like brace expansion, implemented in JavaScript. Safer than other brace expansion libs, with complete support for the Bash 4.3 braces specification, without sacrificing speed.",
|
||||||
|
"version": "3.0.3",
|
||||||
|
"homepage": "https://github.com/micromatch/braces",
|
||||||
|
"author": "Jon Schlinkert (https://github.com/jonschlinkert)",
|
||||||
|
"contributors": [
|
||||||
|
"Brian Woodward (https://twitter.com/doowb)",
|
||||||
|
"Elan Shanker (https://github.com/es128)",
|
||||||
|
"Eugene Sharygin (https://github.com/eush77)",
|
||||||
|
"hemanth.hm (http://h3manth.com)",
|
||||||
|
"Jon Schlinkert (http://twitter.com/jonschlinkert)"
|
||||||
|
],
|
||||||
|
"repository": "micromatch/braces",
|
||||||
|
"bugs": {
|
||||||
|
"url": "https://github.com/micromatch/braces/issues"
|
||||||
|
},
|
||||||
|
"license": "MIT",
|
||||||
|
"files": [
|
||||||
|
"index.js",
|
||||||
|
"lib"
|
||||||
|
],
|
||||||
|
"main": "index.js",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=8"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"test": "mocha",
|
||||||
|
"benchmark": "node benchmark"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"fill-range": "^7.1.1"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"ansi-colors": "^3.2.4",
|
||||||
|
"bash-path": "^2.0.1",
|
||||||
|
"gulp-format-md": "^2.0.0",
|
||||||
|
"mocha": "^6.1.1"
|
||||||
|
},
|
||||||
|
"keywords": [
|
||||||
|
"alpha",
|
||||||
|
"alphabetical",
|
||||||
|
"bash",
|
||||||
|
"brace",
|
||||||
|
"braces",
|
||||||
|
"expand",
|
||||||
|
"expansion",
|
||||||
|
"filepath",
|
||||||
|
"fill",
|
||||||
|
"fs",
|
||||||
|
"glob",
|
||||||
|
"globbing",
|
||||||
|
"letter",
|
||||||
|
"match",
|
||||||
|
"matches",
|
||||||
|
"matching",
|
||||||
|
"number",
|
||||||
|
"numerical",
|
||||||
|
"path",
|
||||||
|
"range",
|
||||||
|
"ranges",
|
||||||
|
"sh"
|
||||||
|
],
|
||||||
|
"verb": {
|
||||||
|
"toc": false,
|
||||||
|
"layout": "default",
|
||||||
|
"tasks": [
|
||||||
|
"readme"
|
||||||
|
],
|
||||||
|
"lint": {
|
||||||
|
"reflinks": true
|
||||||
|
},
|
||||||
|
"plugins": [
|
||||||
|
"gulp-format-md"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,9 @@
|
||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
@ -0,0 +1,83 @@
|
||||||
|
{
|
||||||
|
"name": "chalk",
|
||||||
|
"version": "5.3.0",
|
||||||
|
"description": "Terminal string styling done right",
|
||||||
|
"license": "MIT",
|
||||||
|
"repository": "chalk/chalk",
|
||||||
|
"funding": "https://github.com/chalk/chalk?sponsor=1",
|
||||||
|
"type": "module",
|
||||||
|
"main": "./source/index.js",
|
||||||
|
"exports": "./source/index.js",
|
||||||
|
"imports": {
|
||||||
|
"#ansi-styles": "./source/vendor/ansi-styles/index.js",
|
||||||
|
"#supports-color": {
|
||||||
|
"node": "./source/vendor/supports-color/index.js",
|
||||||
|
"default": "./source/vendor/supports-color/browser.js"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"types": "./source/index.d.ts",
|
||||||
|
"engines": {
|
||||||
|
"node": "^12.17.0 || ^14.13 || >=16.0.0"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"test": "xo && c8 ava && tsd",
|
||||||
|
"bench": "matcha benchmark.js"
|
||||||
|
},
|
||||||
|
"files": [
|
||||||
|
"source",
|
||||||
|
"!source/index.test-d.ts"
|
||||||
|
],
|
||||||
|
"keywords": [
|
||||||
|
"color",
|
||||||
|
"colour",
|
||||||
|
"colors",
|
||||||
|
"terminal",
|
||||||
|
"console",
|
||||||
|
"cli",
|
||||||
|
"string",
|
||||||
|
"ansi",
|
||||||
|
"style",
|
||||||
|
"styles",
|
||||||
|
"tty",
|
||||||
|
"formatting",
|
||||||
|
"rgb",
|
||||||
|
"256",
|
||||||
|
"shell",
|
||||||
|
"xterm",
|
||||||
|
"log",
|
||||||
|
"logging",
|
||||||
|
"command-line",
|
||||||
|
"text"
|
||||||
|
],
|
||||||
|
"devDependencies": {
|
||||||
|
"@types/node": "^16.11.10",
|
||||||
|
"ava": "^3.15.0",
|
||||||
|
"c8": "^7.10.0",
|
||||||
|
"color-convert": "^2.0.1",
|
||||||
|
"execa": "^6.0.0",
|
||||||
|
"log-update": "^5.0.0",
|
||||||
|
"matcha": "^0.7.0",
|
||||||
|
"tsd": "^0.19.0",
|
||||||
|
"xo": "^0.53.0",
|
||||||
|
"yoctodelay": "^2.0.0"
|
||||||
|
},
|
||||||
|
"sideEffects": false,
|
||||||
|
"xo": {
|
||||||
|
"rules": {
|
||||||
|
"unicorn/prefer-string-slice": "off",
|
||||||
|
"@typescript-eslint/consistent-type-imports": "off",
|
||||||
|
"@typescript-eslint/consistent-type-exports": "off",
|
||||||
|
"@typescript-eslint/consistent-type-definitions": "off",
|
||||||
|
"unicorn/expiring-todo-comments": "off"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"c8": {
|
||||||
|
"reporter": [
|
||||||
|
"text",
|
||||||
|
"lcov"
|
||||||
|
],
|
||||||
|
"exclude": [
|
||||||
|
"source/vendor"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,325 @@
|
||||||
|
<h1 align="center">
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
<img width="320" src="media/logo.svg" alt="Chalk">
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
</h1>
|
||||||
|
|
||||||
|
> Terminal string styling done right
|
||||||
|
|
||||||
|
[![Coverage Status](https://codecov.io/gh/chalk/chalk/branch/main/graph/badge.svg)](https://codecov.io/gh/chalk/chalk)
|
||||||
|
[![npm dependents](https://badgen.net/npm/dependents/chalk)](https://www.npmjs.com/package/chalk?activeTab=dependents)
|
||||||
|
[![Downloads](https://badgen.net/npm/dt/chalk)](https://www.npmjs.com/package/chalk)
|
||||||
|
[![run on repl.it](https://img.shields.io/badge/Run_on_Replit-f26207?logo=replit&logoColor=white)](https://repl.it/github/chalk/chalk)
|
||||||
|
|
||||||
|
![](media/screenshot.png)
|
||||||
|
|
||||||
|
<br>
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
<div align="center">
|
||||||
|
<p>
|
||||||
|
<p>
|
||||||
|
<sup>
|
||||||
|
Sindre Sorhus' open source work is supported by the community on <a href="https://github.com/sponsors/sindresorhus">GitHub Sponsors</a>
|
||||||
|
</sup>
|
||||||
|
</p>
|
||||||
|
<sup>Special thanks to:</sup>
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
<a href="https://standardresume.co/tech">
|
||||||
|
<img src="https://sindresorhus.com/assets/thanks/standard-resume-logo.svg" width="160">
|
||||||
|
</a>
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
<a href="https://retool.com/?utm_campaign=sindresorhus">
|
||||||
|
<img src="https://sindresorhus.com/assets/thanks/retool-logo.svg" width="230">
|
||||||
|
</a>
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
<a href="https://strapi.io/?ref=sindresorhus">
|
||||||
|
<div>
|
||||||
|
<img src="https://sindresorhus.com/assets/thanks/strapi-logo-white-bg.png" width="220" alt="Strapi">
|
||||||
|
</div>
|
||||||
|
<b>Strapi is the leading open-source headless CMS.</b>
|
||||||
|
<div>
|
||||||
|
<sup>It’s 100% JavaScript, fully customizable, and developer-first.</sup>
|
||||||
|
</div>
|
||||||
|
</a>
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
<a href="https://www.stackaid.us/?utm_campaign=sindre">
|
||||||
|
<div>
|
||||||
|
<img src="https://sindresorhus.com/assets/thanks/stackaid-logo.png" width="230" alt="StackAid">
|
||||||
|
</div>
|
||||||
|
<b>Fund your open source dependencies</b>
|
||||||
|
</a>
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
<br>
|
||||||
|
|
||||||
|
## Highlights
|
||||||
|
|
||||||
|
- Expressive API
|
||||||
|
- Highly performant
|
||||||
|
- No dependencies
|
||||||
|
- Ability to nest styles
|
||||||
|
- [256/Truecolor color support](#256-and-truecolor-color-support)
|
||||||
|
- Auto-detects color support
|
||||||
|
- Doesn't extend `String.prototype`
|
||||||
|
- Clean and focused
|
||||||
|
- Actively maintained
|
||||||
|
- [Used by ~86,000 packages](https://www.npmjs.com/browse/depended/chalk) as of October 4, 2022
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
```sh
|
||||||
|
npm install chalk
|
||||||
|
```
|
||||||
|
|
||||||
|
**IMPORTANT:** Chalk 5 is ESM. If you want to use Chalk with TypeScript or a build tool, you will probably want to use Chalk 4 for now. [Read more.](https://github.com/chalk/chalk/releases/tag/v5.0.0)
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```js
|
||||||
|
import chalk from 'chalk';
|
||||||
|
|
||||||
|
console.log(chalk.blue('Hello world!'));
|
||||||
|
```
|
||||||
|
|
||||||
|
Chalk comes with an easy to use composable API where you just chain and nest the styles you want.
|
||||||
|
|
||||||
|
```js
|
||||||
|
import chalk from 'chalk';
|
||||||
|
|
||||||
|
const log = console.log;
|
||||||
|
|
||||||
|
// Combine styled and normal strings
|
||||||
|
log(chalk.blue('Hello') + ' World' + chalk.red('!'));
|
||||||
|
|
||||||
|
// Compose multiple styles using the chainable API
|
||||||
|
log(chalk.blue.bgRed.bold('Hello world!'));
|
||||||
|
|
||||||
|
// Pass in multiple arguments
|
||||||
|
log(chalk.blue('Hello', 'World!', 'Foo', 'bar', 'biz', 'baz'));
|
||||||
|
|
||||||
|
// Nest styles
|
||||||
|
log(chalk.red('Hello', chalk.underline.bgBlue('world') + '!'));
|
||||||
|
|
||||||
|
// Nest styles of the same type even (color, underline, background)
|
||||||
|
log(chalk.green(
|
||||||
|
'I am a green line ' +
|
||||||
|
chalk.blue.underline.bold('with a blue substring') +
|
||||||
|
' that becomes green again!'
|
||||||
|
));
|
||||||
|
|
||||||
|
// ES2015 template literal
|
||||||
|
log(`
|
||||||
|
CPU: ${chalk.red('90%')}
|
||||||
|
RAM: ${chalk.green('40%')}
|
||||||
|
DISK: ${chalk.yellow('70%')}
|
||||||
|
`);
|
||||||
|
|
||||||
|
// Use RGB colors in terminal emulators that support it.
|
||||||
|
log(chalk.rgb(123, 45, 67).underline('Underlined reddish color'));
|
||||||
|
log(chalk.hex('#DEADED').bold('Bold gray!'));
|
||||||
|
```
|
||||||
|
|
||||||
|
Easily define your own themes:
|
||||||
|
|
||||||
|
```js
|
||||||
|
import chalk from 'chalk';
|
||||||
|
|
||||||
|
const error = chalk.bold.red;
|
||||||
|
const warning = chalk.hex('#FFA500'); // Orange color
|
||||||
|
|
||||||
|
console.log(error('Error!'));
|
||||||
|
console.log(warning('Warning!'));
|
||||||
|
```
|
||||||
|
|
||||||
|
Take advantage of console.log [string substitution](https://nodejs.org/docs/latest/api/console.html#console_console_log_data_args):
|
||||||
|
|
||||||
|
```js
|
||||||
|
import chalk from 'chalk';
|
||||||
|
|
||||||
|
const name = 'Sindre';
|
||||||
|
console.log(chalk.green('Hello %s'), name);
|
||||||
|
//=> 'Hello Sindre'
|
||||||
|
```
|
||||||
|
|
||||||
|
## API
|
||||||
|
|
||||||
|
### chalk.`<style>[.<style>...](string, [string...])`
|
||||||
|
|
||||||
|
Example: `chalk.red.bold.underline('Hello', 'world');`
|
||||||
|
|
||||||
|
Chain [styles](#styles) and call the last one as a method with a string argument. Order doesn't matter, and later styles take precedent in case of a conflict. This simply means that `chalk.red.yellow.green` is equivalent to `chalk.green`.
|
||||||
|
|
||||||
|
Multiple arguments will be separated by space.
|
||||||
|
|
||||||
|
### chalk.level
|
||||||
|
|
||||||
|
Specifies the level of color support.
|
||||||
|
|
||||||
|
Color support is automatically detected, but you can override it by setting the `level` property. You should however only do this in your own code as it applies globally to all Chalk consumers.
|
||||||
|
|
||||||
|
If you need to change this in a reusable module, create a new instance:
|
||||||
|
|
||||||
|
```js
|
||||||
|
import {Chalk} from 'chalk';
|
||||||
|
|
||||||
|
const customChalk = new Chalk({level: 0});
|
||||||
|
```
|
||||||
|
|
||||||
|
| Level | Description |
|
||||||
|
| :---: | :--- |
|
||||||
|
| `0` | All colors disabled |
|
||||||
|
| `1` | Basic color support (16 colors) |
|
||||||
|
| `2` | 256 color support |
|
||||||
|
| `3` | Truecolor support (16 million colors) |
|
||||||
|
|
||||||
|
### supportsColor
|
||||||
|
|
||||||
|
Detect whether the terminal [supports color](https://github.com/chalk/supports-color). Used internally and handled for you, but exposed for convenience.
|
||||||
|
|
||||||
|
Can be overridden by the user with the flags `--color` and `--no-color`. For situations where using `--color` is not possible, use the environment variable `FORCE_COLOR=1` (level 1), `FORCE_COLOR=2` (level 2), or `FORCE_COLOR=3` (level 3) to forcefully enable color, or `FORCE_COLOR=0` to forcefully disable. The use of `FORCE_COLOR` overrides all other color support checks.
|
||||||
|
|
||||||
|
Explicit 256/Truecolor mode can be enabled using the `--color=256` and `--color=16m` flags, respectively.
|
||||||
|
|
||||||
|
### chalkStderr and supportsColorStderr
|
||||||
|
|
||||||
|
`chalkStderr` contains a separate instance configured with color support detected for `stderr` stream instead of `stdout`. Override rules from `supportsColor` apply to this too. `supportsColorStderr` is exposed for convenience.
|
||||||
|
|
||||||
|
### modifierNames, foregroundColorNames, backgroundColorNames, and colorNames
|
||||||
|
|
||||||
|
All supported style strings are exposed as an array of strings for convenience. `colorNames` is the combination of `foregroundColorNames` and `backgroundColorNames`.
|
||||||
|
|
||||||
|
This can be useful if you wrap Chalk and need to validate input:
|
||||||
|
|
||||||
|
```js
|
||||||
|
import {modifierNames, foregroundColorNames} from 'chalk';
|
||||||
|
|
||||||
|
console.log(modifierNames.includes('bold'));
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
console.log(foregroundColorNames.includes('pink'));
|
||||||
|
//=> false
|
||||||
|
```
|
||||||
|
|
||||||
|
## Styles
|
||||||
|
|
||||||
|
### Modifiers
|
||||||
|
|
||||||
|
- `reset` - Reset the current style.
|
||||||
|
- `bold` - Make the text bold.
|
||||||
|
- `dim` - Make the text have lower opacity.
|
||||||
|
- `italic` - Make the text italic. *(Not widely supported)*
|
||||||
|
- `underline` - Put a horizontal line below the text. *(Not widely supported)*
|
||||||
|
- `overline` - Put a horizontal line above the text. *(Not widely supported)*
|
||||||
|
- `inverse`- Invert background and foreground colors.
|
||||||
|
- `hidden` - Print the text but make it invisible.
|
||||||
|
- `strikethrough` - Puts a horizontal line through the center of the text. *(Not widely supported)*
|
||||||
|
- `visible`- Print the text only when Chalk has a color level above zero. Can be useful for things that are purely cosmetic.
|
||||||
|
|
||||||
|
### Colors
|
||||||
|
|
||||||
|
- `black`
|
||||||
|
- `red`
|
||||||
|
- `green`
|
||||||
|
- `yellow`
|
||||||
|
- `blue`
|
||||||
|
- `magenta`
|
||||||
|
- `cyan`
|
||||||
|
- `white`
|
||||||
|
- `blackBright` (alias: `gray`, `grey`)
|
||||||
|
- `redBright`
|
||||||
|
- `greenBright`
|
||||||
|
- `yellowBright`
|
||||||
|
- `blueBright`
|
||||||
|
- `magentaBright`
|
||||||
|
- `cyanBright`
|
||||||
|
- `whiteBright`
|
||||||
|
|
||||||
|
### Background colors
|
||||||
|
|
||||||
|
- `bgBlack`
|
||||||
|
- `bgRed`
|
||||||
|
- `bgGreen`
|
||||||
|
- `bgYellow`
|
||||||
|
- `bgBlue`
|
||||||
|
- `bgMagenta`
|
||||||
|
- `bgCyan`
|
||||||
|
- `bgWhite`
|
||||||
|
- `bgBlackBright` (alias: `bgGray`, `bgGrey`)
|
||||||
|
- `bgRedBright`
|
||||||
|
- `bgGreenBright`
|
||||||
|
- `bgYellowBright`
|
||||||
|
- `bgBlueBright`
|
||||||
|
- `bgMagentaBright`
|
||||||
|
- `bgCyanBright`
|
||||||
|
- `bgWhiteBright`
|
||||||
|
|
||||||
|
## 256 and Truecolor color support
|
||||||
|
|
||||||
|
Chalk supports 256 colors and [Truecolor](https://github.com/termstandard/colors) (16 million colors) on supported terminal apps.
|
||||||
|
|
||||||
|
Colors are downsampled from 16 million RGB values to an ANSI color format that is supported by the terminal emulator (or by specifying `{level: n}` as a Chalk option). For example, Chalk configured to run at level 1 (basic color support) will downsample an RGB value of #FF0000 (red) to 31 (ANSI escape for red).
|
||||||
|
|
||||||
|
Examples:
|
||||||
|
|
||||||
|
- `chalk.hex('#DEADED').underline('Hello, world!')`
|
||||||
|
- `chalk.rgb(15, 100, 204).inverse('Hello!')`
|
||||||
|
|
||||||
|
Background versions of these models are prefixed with `bg` and the first level of the module capitalized (e.g. `hex` for foreground colors and `bgHex` for background colors).
|
||||||
|
|
||||||
|
- `chalk.bgHex('#DEADED').underline('Hello, world!')`
|
||||||
|
- `chalk.bgRgb(15, 100, 204).inverse('Hello!')`
|
||||||
|
|
||||||
|
The following color models can be used:
|
||||||
|
|
||||||
|
- [`rgb`](https://en.wikipedia.org/wiki/RGB_color_model) - Example: `chalk.rgb(255, 136, 0).bold('Orange!')`
|
||||||
|
- [`hex`](https://en.wikipedia.org/wiki/Web_colors#Hex_triplet) - Example: `chalk.hex('#FF8800').bold('Orange!')`
|
||||||
|
- [`ansi256`](https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit) - Example: `chalk.bgAnsi256(194)('Honeydew, more or less')`
|
||||||
|
|
||||||
|
## Browser support
|
||||||
|
|
||||||
|
Since Chrome 69, ANSI escape codes are natively supported in the developer console.
|
||||||
|
|
||||||
|
## Windows
|
||||||
|
|
||||||
|
If you're on Windows, do yourself a favor and use [Windows Terminal](https://github.com/microsoft/terminal) instead of `cmd.exe`.
|
||||||
|
|
||||||
|
## Origin story
|
||||||
|
|
||||||
|
[colors.js](https://github.com/Marak/colors.js) used to be the most popular string styling module, but it has serious deficiencies like extending `String.prototype` which causes all kinds of [problems](https://github.com/yeoman/yo/issues/68) and the package is unmaintained. Although there are other packages, they either do too much or not enough. Chalk is a clean and focused alternative.
|
||||||
|
|
||||||
|
## Related
|
||||||
|
|
||||||
|
- [chalk-template](https://github.com/chalk/chalk-template) - [Tagged template literals](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals#tagged_templates) support for this module
|
||||||
|
- [chalk-cli](https://github.com/chalk/chalk-cli) - CLI for this module
|
||||||
|
- [ansi-styles](https://github.com/chalk/ansi-styles) - ANSI escape codes for styling strings in the terminal
|
||||||
|
- [supports-color](https://github.com/chalk/supports-color) - Detect whether a terminal supports color
|
||||||
|
- [strip-ansi](https://github.com/chalk/strip-ansi) - Strip ANSI escape codes
|
||||||
|
- [strip-ansi-stream](https://github.com/chalk/strip-ansi-stream) - Strip ANSI escape codes from a stream
|
||||||
|
- [has-ansi](https://github.com/chalk/has-ansi) - Check if a string has ANSI escape codes
|
||||||
|
- [ansi-regex](https://github.com/chalk/ansi-regex) - Regular expression for matching ANSI escape codes
|
||||||
|
- [wrap-ansi](https://github.com/chalk/wrap-ansi) - Wordwrap a string with ANSI escape codes
|
||||||
|
- [slice-ansi](https://github.com/chalk/slice-ansi) - Slice a string with ANSI escape codes
|
||||||
|
- [color-convert](https://github.com/qix-/color-convert) - Converts colors between different models
|
||||||
|
- [chalk-animation](https://github.com/bokub/chalk-animation) - Animate strings in the terminal
|
||||||
|
- [gradient-string](https://github.com/bokub/gradient-string) - Apply color gradients to strings
|
||||||
|
- [chalk-pipe](https://github.com/LitoMore/chalk-pipe) - Create chalk style schemes with simpler style strings
|
||||||
|
- [terminal-link](https://github.com/sindresorhus/terminal-link) - Create clickable links in the terminal
|
||||||
|
|
||||||
|
## Maintainers
|
||||||
|
|
||||||
|
- [Sindre Sorhus](https://github.com/sindresorhus)
|
||||||
|
- [Josh Junon](https://github.com/qix-)
|
|
@ -0,0 +1,320 @@
|
||||||
|
// TODO: Make it this when TS suports that.
|
||||||
|
// import {ModifierName, ForegroundColor, BackgroundColor, ColorName} from '#ansi-styles';
|
||||||
|
// import {ColorInfo, ColorSupportLevel} from '#supports-color';
|
||||||
|
import {ModifierName, ForegroundColorName, BackgroundColorName, ColorName} from './vendor/ansi-styles/index.js';
|
||||||
|
import {ColorInfo, ColorSupportLevel} from './vendor/supports-color/index.js';
|
||||||
|
|
||||||
|
export interface Options {
|
||||||
|
/**
|
||||||
|
Specify the color support for Chalk.
|
||||||
|
|
||||||
|
By default, color support is automatically detected based on the environment.
|
||||||
|
|
||||||
|
Levels:
|
||||||
|
- `0` - All colors disabled.
|
||||||
|
- `1` - Basic 16 colors support.
|
||||||
|
- `2` - ANSI 256 colors support.
|
||||||
|
- `3` - Truecolor 16 million colors support.
|
||||||
|
*/
|
||||||
|
readonly level?: ColorSupportLevel;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Return a new Chalk instance.
|
||||||
|
*/
|
||||||
|
export const Chalk: new (options?: Options) => ChalkInstance; // eslint-disable-line @typescript-eslint/naming-convention
|
||||||
|
|
||||||
|
export interface ChalkInstance {
|
||||||
|
(...text: unknown[]): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
The color support for Chalk.
|
||||||
|
|
||||||
|
By default, color support is automatically detected based on the environment.
|
||||||
|
|
||||||
|
Levels:
|
||||||
|
- `0` - All colors disabled.
|
||||||
|
- `1` - Basic 16 colors support.
|
||||||
|
- `2` - ANSI 256 colors support.
|
||||||
|
- `3` - Truecolor 16 million colors support.
|
||||||
|
*/
|
||||||
|
level: ColorSupportLevel;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Use RGB values to set text color.
|
||||||
|
|
||||||
|
@example
|
||||||
|
```
|
||||||
|
import chalk from 'chalk';
|
||||||
|
|
||||||
|
chalk.rgb(222, 173, 237);
|
||||||
|
```
|
||||||
|
*/
|
||||||
|
rgb: (red: number, green: number, blue: number) => this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Use HEX value to set text color.
|
||||||
|
|
||||||
|
@param color - Hexadecimal value representing the desired color.
|
||||||
|
|
||||||
|
@example
|
||||||
|
```
|
||||||
|
import chalk from 'chalk';
|
||||||
|
|
||||||
|
chalk.hex('#DEADED');
|
||||||
|
```
|
||||||
|
*/
|
||||||
|
hex: (color: string) => this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Use an [8-bit unsigned number](https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit) to set text color.
|
||||||
|
|
||||||
|
@example
|
||||||
|
```
|
||||||
|
import chalk from 'chalk';
|
||||||
|
|
||||||
|
chalk.ansi256(201);
|
||||||
|
```
|
||||||
|
*/
|
||||||
|
ansi256: (index: number) => this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Use RGB values to set background color.
|
||||||
|
|
||||||
|
@example
|
||||||
|
```
|
||||||
|
import chalk from 'chalk';
|
||||||
|
|
||||||
|
chalk.bgRgb(222, 173, 237);
|
||||||
|
```
|
||||||
|
*/
|
||||||
|
bgRgb: (red: number, green: number, blue: number) => this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Use HEX value to set background color.
|
||||||
|
|
||||||
|
@param color - Hexadecimal value representing the desired color.
|
||||||
|
|
||||||
|
@example
|
||||||
|
```
|
||||||
|
import chalk from 'chalk';
|
||||||
|
|
||||||
|
chalk.bgHex('#DEADED');
|
||||||
|
```
|
||||||
|
*/
|
||||||
|
bgHex: (color: string) => this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Use a [8-bit unsigned number](https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit) to set background color.
|
||||||
|
|
||||||
|
@example
|
||||||
|
```
|
||||||
|
import chalk from 'chalk';
|
||||||
|
|
||||||
|
chalk.bgAnsi256(201);
|
||||||
|
```
|
||||||
|
*/
|
||||||
|
bgAnsi256: (index: number) => this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Modifier: Reset the current style.
|
||||||
|
*/
|
||||||
|
readonly reset: this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Modifier: Make the text bold.
|
||||||
|
*/
|
||||||
|
readonly bold: this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Modifier: Make the text have lower opacity.
|
||||||
|
*/
|
||||||
|
readonly dim: this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Modifier: Make the text italic. *(Not widely supported)*
|
||||||
|
*/
|
||||||
|
readonly italic: this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Modifier: Put a horizontal line below the text. *(Not widely supported)*
|
||||||
|
*/
|
||||||
|
readonly underline: this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Modifier: Put a horizontal line above the text. *(Not widely supported)*
|
||||||
|
*/
|
||||||
|
readonly overline: this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Modifier: Invert background and foreground colors.
|
||||||
|
*/
|
||||||
|
readonly inverse: this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Modifier: Print the text but make it invisible.
|
||||||
|
*/
|
||||||
|
readonly hidden: this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Modifier: Puts a horizontal line through the center of the text. *(Not widely supported)*
|
||||||
|
*/
|
||||||
|
readonly strikethrough: this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Modifier: Print the text only when Chalk has a color level above zero.
|
||||||
|
|
||||||
|
Can be useful for things that are purely cosmetic.
|
||||||
|
*/
|
||||||
|
readonly visible: this;
|
||||||
|
|
||||||
|
readonly black: this;
|
||||||
|
readonly red: this;
|
||||||
|
readonly green: this;
|
||||||
|
readonly yellow: this;
|
||||||
|
readonly blue: this;
|
||||||
|
readonly magenta: this;
|
||||||
|
readonly cyan: this;
|
||||||
|
readonly white: this;
|
||||||
|
|
||||||
|
/*
|
||||||
|
Alias for `blackBright`.
|
||||||
|
*/
|
||||||
|
readonly gray: this;
|
||||||
|
|
||||||
|
/*
|
||||||
|
Alias for `blackBright`.
|
||||||
|
*/
|
||||||
|
readonly grey: this;
|
||||||
|
|
||||||
|
readonly blackBright: this;
|
||||||
|
readonly redBright: this;
|
||||||
|
readonly greenBright: this;
|
||||||
|
readonly yellowBright: this;
|
||||||
|
readonly blueBright: this;
|
||||||
|
readonly magentaBright: this;
|
||||||
|
readonly cyanBright: this;
|
||||||
|
readonly whiteBright: this;
|
||||||
|
|
||||||
|
readonly bgBlack: this;
|
||||||
|
readonly bgRed: this;
|
||||||
|
readonly bgGreen: this;
|
||||||
|
readonly bgYellow: this;
|
||||||
|
readonly bgBlue: this;
|
||||||
|
readonly bgMagenta: this;
|
||||||
|
readonly bgCyan: this;
|
||||||
|
readonly bgWhite: this;
|
||||||
|
|
||||||
|
/*
|
||||||
|
Alias for `bgBlackBright`.
|
||||||
|
*/
|
||||||
|
readonly bgGray: this;
|
||||||
|
|
||||||
|
/*
|
||||||
|
Alias for `bgBlackBright`.
|
||||||
|
*/
|
||||||
|
readonly bgGrey: this;
|
||||||
|
|
||||||
|
readonly bgBlackBright: this;
|
||||||
|
readonly bgRedBright: this;
|
||||||
|
readonly bgGreenBright: this;
|
||||||
|
readonly bgYellowBright: this;
|
||||||
|
readonly bgBlueBright: this;
|
||||||
|
readonly bgMagentaBright: this;
|
||||||
|
readonly bgCyanBright: this;
|
||||||
|
readonly bgWhiteBright: this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Main Chalk object that allows to chain styles together.
|
||||||
|
|
||||||
|
Call the last one as a method with a string argument.
|
||||||
|
|
||||||
|
Order doesn't matter, and later styles take precedent in case of a conflict.
|
||||||
|
|
||||||
|
This simply means that `chalk.red.yellow.green` is equivalent to `chalk.green`.
|
||||||
|
*/
|
||||||
|
declare const chalk: ChalkInstance;
|
||||||
|
|
||||||
|
export const supportsColor: ColorInfo;
|
||||||
|
|
||||||
|
export const chalkStderr: typeof chalk;
|
||||||
|
export const supportsColorStderr: typeof supportsColor;
|
||||||
|
|
||||||
|
export {
|
||||||
|
ModifierName, ForegroundColorName, BackgroundColorName, ColorName,
|
||||||
|
modifierNames, foregroundColorNames, backgroundColorNames, colorNames,
|
||||||
|
// } from '#ansi-styles';
|
||||||
|
} from './vendor/ansi-styles/index.js';
|
||||||
|
|
||||||
|
export {
|
||||||
|
ColorInfo,
|
||||||
|
ColorSupport,
|
||||||
|
ColorSupportLevel,
|
||||||
|
// } from '#supports-color';
|
||||||
|
} from './vendor/supports-color/index.js';
|
||||||
|
|
||||||
|
// TODO: Remove these aliases in the next major version
|
||||||
|
/**
|
||||||
|
@deprecated Use `ModifierName` instead.
|
||||||
|
|
||||||
|
Basic modifier names.
|
||||||
|
*/
|
||||||
|
export type Modifiers = ModifierName;
|
||||||
|
|
||||||
|
/**
|
||||||
|
@deprecated Use `ForegroundColorName` instead.
|
||||||
|
|
||||||
|
Basic foreground color names.
|
||||||
|
|
||||||
|
[More colors here.](https://github.com/chalk/chalk/blob/main/readme.md#256-and-truecolor-color-support)
|
||||||
|
*/
|
||||||
|
export type ForegroundColor = ForegroundColorName;
|
||||||
|
|
||||||
|
/**
|
||||||
|
@deprecated Use `BackgroundColorName` instead.
|
||||||
|
|
||||||
|
Basic background color names.
|
||||||
|
|
||||||
|
[More colors here.](https://github.com/chalk/chalk/blob/main/readme.md#256-and-truecolor-color-support)
|
||||||
|
*/
|
||||||
|
export type BackgroundColor = BackgroundColorName;
|
||||||
|
|
||||||
|
/**
|
||||||
|
@deprecated Use `ColorName` instead.
|
||||||
|
|
||||||
|
Basic color names. The combination of foreground and background color names.
|
||||||
|
|
||||||
|
[More colors here.](https://github.com/chalk/chalk/blob/main/readme.md#256-and-truecolor-color-support)
|
||||||
|
*/
|
||||||
|
export type Color = ColorName;
|
||||||
|
|
||||||
|
/**
|
||||||
|
@deprecated Use `modifierNames` instead.
|
||||||
|
|
||||||
|
Basic modifier names.
|
||||||
|
*/
|
||||||
|
export const modifiers: readonly Modifiers[];
|
||||||
|
|
||||||
|
/**
|
||||||
|
@deprecated Use `foregroundColorNames` instead.
|
||||||
|
|
||||||
|
Basic foreground color names.
|
||||||
|
*/
|
||||||
|
export const foregroundColors: readonly ForegroundColor[];
|
||||||
|
|
||||||
|
/**
|
||||||
|
@deprecated Use `backgroundColorNames` instead.
|
||||||
|
|
||||||
|
Basic background color names.
|
||||||
|
*/
|
||||||
|
export const backgroundColors: readonly BackgroundColor[];
|
||||||
|
|
||||||
|
/**
|
||||||
|
@deprecated Use `colorNames` instead.
|
||||||
|
|
||||||
|
Basic color names. The combination of foreground and background color names.
|
||||||
|
*/
|
||||||
|
export const colors: readonly Color[];
|
||||||
|
|
||||||
|
export default chalk;
|
|
@ -0,0 +1,225 @@
|
||||||
|
import ansiStyles from '#ansi-styles';
|
||||||
|
import supportsColor from '#supports-color';
|
||||||
|
import { // eslint-disable-line import/order
|
||||||
|
stringReplaceAll,
|
||||||
|
stringEncaseCRLFWithFirstIndex,
|
||||||
|
} from './utilities.js';
|
||||||
|
|
||||||
|
const {stdout: stdoutColor, stderr: stderrColor} = supportsColor;
|
||||||
|
|
||||||
|
const GENERATOR = Symbol('GENERATOR');
|
||||||
|
const STYLER = Symbol('STYLER');
|
||||||
|
const IS_EMPTY = Symbol('IS_EMPTY');
|
||||||
|
|
||||||
|
// `supportsColor.level` → `ansiStyles.color[name]` mapping
|
||||||
|
const levelMapping = [
|
||||||
|
'ansi',
|
||||||
|
'ansi',
|
||||||
|
'ansi256',
|
||||||
|
'ansi16m',
|
||||||
|
];
|
||||||
|
|
||||||
|
const styles = Object.create(null);
|
||||||
|
|
||||||
|
const applyOptions = (object, options = {}) => {
|
||||||
|
if (options.level && !(Number.isInteger(options.level) && options.level >= 0 && options.level <= 3)) {
|
||||||
|
throw new Error('The `level` option should be an integer from 0 to 3');
|
||||||
|
}
|
||||||
|
|
||||||
|
// Detect level if not set manually
|
||||||
|
const colorLevel = stdoutColor ? stdoutColor.level : 0;
|
||||||
|
object.level = options.level === undefined ? colorLevel : options.level;
|
||||||
|
};
|
||||||
|
|
||||||
|
export class Chalk {
|
||||||
|
constructor(options) {
|
||||||
|
// eslint-disable-next-line no-constructor-return
|
||||||
|
return chalkFactory(options);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const chalkFactory = options => {
|
||||||
|
const chalk = (...strings) => strings.join(' ');
|
||||||
|
applyOptions(chalk, options);
|
||||||
|
|
||||||
|
Object.setPrototypeOf(chalk, createChalk.prototype);
|
||||||
|
|
||||||
|
return chalk;
|
||||||
|
};
|
||||||
|
|
||||||
|
function createChalk(options) {
|
||||||
|
return chalkFactory(options);
|
||||||
|
}
|
||||||
|
|
||||||
|
Object.setPrototypeOf(createChalk.prototype, Function.prototype);
|
||||||
|
|
||||||
|
for (const [styleName, style] of Object.entries(ansiStyles)) {
|
||||||
|
styles[styleName] = {
|
||||||
|
get() {
|
||||||
|
const builder = createBuilder(this, createStyler(style.open, style.close, this[STYLER]), this[IS_EMPTY]);
|
||||||
|
Object.defineProperty(this, styleName, {value: builder});
|
||||||
|
return builder;
|
||||||
|
},
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
styles.visible = {
|
||||||
|
get() {
|
||||||
|
const builder = createBuilder(this, this[STYLER], true);
|
||||||
|
Object.defineProperty(this, 'visible', {value: builder});
|
||||||
|
return builder;
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
const getModelAnsi = (model, level, type, ...arguments_) => {
|
||||||
|
if (model === 'rgb') {
|
||||||
|
if (level === 'ansi16m') {
|
||||||
|
return ansiStyles[type].ansi16m(...arguments_);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (level === 'ansi256') {
|
||||||
|
return ansiStyles[type].ansi256(ansiStyles.rgbToAnsi256(...arguments_));
|
||||||
|
}
|
||||||
|
|
||||||
|
return ansiStyles[type].ansi(ansiStyles.rgbToAnsi(...arguments_));
|
||||||
|
}
|
||||||
|
|
||||||
|
if (model === 'hex') {
|
||||||
|
return getModelAnsi('rgb', level, type, ...ansiStyles.hexToRgb(...arguments_));
|
||||||
|
}
|
||||||
|
|
||||||
|
return ansiStyles[type][model](...arguments_);
|
||||||
|
};
|
||||||
|
|
||||||
|
const usedModels = ['rgb', 'hex', 'ansi256'];
|
||||||
|
|
||||||
|
for (const model of usedModels) {
|
||||||
|
styles[model] = {
|
||||||
|
get() {
|
||||||
|
const {level} = this;
|
||||||
|
return function (...arguments_) {
|
||||||
|
const styler = createStyler(getModelAnsi(model, levelMapping[level], 'color', ...arguments_), ansiStyles.color.close, this[STYLER]);
|
||||||
|
return createBuilder(this, styler, this[IS_EMPTY]);
|
||||||
|
};
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
const bgModel = 'bg' + model[0].toUpperCase() + model.slice(1);
|
||||||
|
styles[bgModel] = {
|
||||||
|
get() {
|
||||||
|
const {level} = this;
|
||||||
|
return function (...arguments_) {
|
||||||
|
const styler = createStyler(getModelAnsi(model, levelMapping[level], 'bgColor', ...arguments_), ansiStyles.bgColor.close, this[STYLER]);
|
||||||
|
return createBuilder(this, styler, this[IS_EMPTY]);
|
||||||
|
};
|
||||||
|
},
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
const proto = Object.defineProperties(() => {}, {
|
||||||
|
...styles,
|
||||||
|
level: {
|
||||||
|
enumerable: true,
|
||||||
|
get() {
|
||||||
|
return this[GENERATOR].level;
|
||||||
|
},
|
||||||
|
set(level) {
|
||||||
|
this[GENERATOR].level = level;
|
||||||
|
},
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
const createStyler = (open, close, parent) => {
|
||||||
|
let openAll;
|
||||||
|
let closeAll;
|
||||||
|
if (parent === undefined) {
|
||||||
|
openAll = open;
|
||||||
|
closeAll = close;
|
||||||
|
} else {
|
||||||
|
openAll = parent.openAll + open;
|
||||||
|
closeAll = close + parent.closeAll;
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
open,
|
||||||
|
close,
|
||||||
|
openAll,
|
||||||
|
closeAll,
|
||||||
|
parent,
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
const createBuilder = (self, _styler, _isEmpty) => {
|
||||||
|
// Single argument is hot path, implicit coercion is faster than anything
|
||||||
|
// eslint-disable-next-line no-implicit-coercion
|
||||||
|
const builder = (...arguments_) => applyStyle(builder, (arguments_.length === 1) ? ('' + arguments_[0]) : arguments_.join(' '));
|
||||||
|
|
||||||
|
// We alter the prototype because we must return a function, but there is
|
||||||
|
// no way to create a function with a different prototype
|
||||||
|
Object.setPrototypeOf(builder, proto);
|
||||||
|
|
||||||
|
builder[GENERATOR] = self;
|
||||||
|
builder[STYLER] = _styler;
|
||||||
|
builder[IS_EMPTY] = _isEmpty;
|
||||||
|
|
||||||
|
return builder;
|
||||||
|
};
|
||||||
|
|
||||||
|
const applyStyle = (self, string) => {
|
||||||
|
if (self.level <= 0 || !string) {
|
||||||
|
return self[IS_EMPTY] ? '' : string;
|
||||||
|
}
|
||||||
|
|
||||||
|
let styler = self[STYLER];
|
||||||
|
|
||||||
|
if (styler === undefined) {
|
||||||
|
return string;
|
||||||
|
}
|
||||||
|
|
||||||
|
const {openAll, closeAll} = styler;
|
||||||
|
if (string.includes('\u001B')) {
|
||||||
|
while (styler !== undefined) {
|
||||||
|
// Replace any instances already present with a re-opening code
|
||||||
|
// otherwise only the part of the string until said closing code
|
||||||
|
// will be colored, and the rest will simply be 'plain'.
|
||||||
|
string = stringReplaceAll(string, styler.close, styler.open);
|
||||||
|
|
||||||
|
styler = styler.parent;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// We can move both next actions out of loop, because remaining actions in loop won't have
|
||||||
|
// any/visible effect on parts we add here. Close the styling before a linebreak and reopen
|
||||||
|
// after next line to fix a bleed issue on macOS: https://github.com/chalk/chalk/pull/92
|
||||||
|
const lfIndex = string.indexOf('\n');
|
||||||
|
if (lfIndex !== -1) {
|
||||||
|
string = stringEncaseCRLFWithFirstIndex(string, closeAll, openAll, lfIndex);
|
||||||
|
}
|
||||||
|
|
||||||
|
return openAll + string + closeAll;
|
||||||
|
};
|
||||||
|
|
||||||
|
Object.defineProperties(createChalk.prototype, styles);
|
||||||
|
|
||||||
|
const chalk = createChalk();
|
||||||
|
export const chalkStderr = createChalk({level: stderrColor ? stderrColor.level : 0});
|
||||||
|
|
||||||
|
export {
|
||||||
|
modifierNames,
|
||||||
|
foregroundColorNames,
|
||||||
|
backgroundColorNames,
|
||||||
|
colorNames,
|
||||||
|
|
||||||
|
// TODO: Remove these aliases in the next major version
|
||||||
|
modifierNames as modifiers,
|
||||||
|
foregroundColorNames as foregroundColors,
|
||||||
|
backgroundColorNames as backgroundColors,
|
||||||
|
colorNames as colors,
|
||||||
|
} from './vendor/ansi-styles/index.js';
|
||||||
|
|
||||||
|
export {
|
||||||
|
stdoutColor as supportsColor,
|
||||||
|
stderrColor as supportsColorStderr,
|
||||||
|
};
|
||||||
|
|
||||||
|
export default chalk;
|
|
@ -0,0 +1,33 @@
|
||||||
|
// TODO: When targeting Node.js 16, use `String.prototype.replaceAll`.
|
||||||
|
export function stringReplaceAll(string, substring, replacer) {
|
||||||
|
let index = string.indexOf(substring);
|
||||||
|
if (index === -1) {
|
||||||
|
return string;
|
||||||
|
}
|
||||||
|
|
||||||
|
const substringLength = substring.length;
|
||||||
|
let endIndex = 0;
|
||||||
|
let returnValue = '';
|
||||||
|
do {
|
||||||
|
returnValue += string.slice(endIndex, index) + substring + replacer;
|
||||||
|
endIndex = index + substringLength;
|
||||||
|
index = string.indexOf(substring, endIndex);
|
||||||
|
} while (index !== -1);
|
||||||
|
|
||||||
|
returnValue += string.slice(endIndex);
|
||||||
|
return returnValue;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function stringEncaseCRLFWithFirstIndex(string, prefix, postfix, index) {
|
||||||
|
let endIndex = 0;
|
||||||
|
let returnValue = '';
|
||||||
|
do {
|
||||||
|
const gotCR = string[index - 1] === '\r';
|
||||||
|
returnValue += string.slice(endIndex, (gotCR ? index - 1 : index)) + prefix + (gotCR ? '\r\n' : '\n') + postfix;
|
||||||
|
endIndex = index + 1;
|
||||||
|
index = string.indexOf('\n', endIndex);
|
||||||
|
} while (index !== -1);
|
||||||
|
|
||||||
|
returnValue += string.slice(endIndex);
|
||||||
|
return returnValue;
|
||||||
|
}
|
|
@ -0,0 +1,236 @@
|
||||||
|
export interface CSPair { // eslint-disable-line @typescript-eslint/naming-convention
|
||||||
|
/**
|
||||||
|
The ANSI terminal control sequence for starting this style.
|
||||||
|
*/
|
||||||
|
readonly open: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
The ANSI terminal control sequence for ending this style.
|
||||||
|
*/
|
||||||
|
readonly close: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ColorBase {
|
||||||
|
/**
|
||||||
|
The ANSI terminal control sequence for ending this color.
|
||||||
|
*/
|
||||||
|
readonly close: string;
|
||||||
|
|
||||||
|
ansi(code: number): string;
|
||||||
|
|
||||||
|
ansi256(code: number): string;
|
||||||
|
|
||||||
|
ansi16m(red: number, green: number, blue: number): string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface Modifier {
|
||||||
|
/**
|
||||||
|
Resets the current color chain.
|
||||||
|
*/
|
||||||
|
readonly reset: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Make text bold.
|
||||||
|
*/
|
||||||
|
readonly bold: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Emitting only a small amount of light.
|
||||||
|
*/
|
||||||
|
readonly dim: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Make text italic. (Not widely supported)
|
||||||
|
*/
|
||||||
|
readonly italic: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Make text underline. (Not widely supported)
|
||||||
|
*/
|
||||||
|
readonly underline: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Make text overline.
|
||||||
|
|
||||||
|
Supported on VTE-based terminals, the GNOME terminal, mintty, and Git Bash.
|
||||||
|
*/
|
||||||
|
readonly overline: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Inverse background and foreground colors.
|
||||||
|
*/
|
||||||
|
readonly inverse: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Prints the text, but makes it invisible.
|
||||||
|
*/
|
||||||
|
readonly hidden: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Puts a horizontal line through the center of the text. (Not widely supported)
|
||||||
|
*/
|
||||||
|
readonly strikethrough: CSPair;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ForegroundColor {
|
||||||
|
readonly black: CSPair;
|
||||||
|
readonly red: CSPair;
|
||||||
|
readonly green: CSPair;
|
||||||
|
readonly yellow: CSPair;
|
||||||
|
readonly blue: CSPair;
|
||||||
|
readonly cyan: CSPair;
|
||||||
|
readonly magenta: CSPair;
|
||||||
|
readonly white: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Alias for `blackBright`.
|
||||||
|
*/
|
||||||
|
readonly gray: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Alias for `blackBright`.
|
||||||
|
*/
|
||||||
|
readonly grey: CSPair;
|
||||||
|
|
||||||
|
readonly blackBright: CSPair;
|
||||||
|
readonly redBright: CSPair;
|
||||||
|
readonly greenBright: CSPair;
|
||||||
|
readonly yellowBright: CSPair;
|
||||||
|
readonly blueBright: CSPair;
|
||||||
|
readonly cyanBright: CSPair;
|
||||||
|
readonly magentaBright: CSPair;
|
||||||
|
readonly whiteBright: CSPair;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface BackgroundColor {
|
||||||
|
readonly bgBlack: CSPair;
|
||||||
|
readonly bgRed: CSPair;
|
||||||
|
readonly bgGreen: CSPair;
|
||||||
|
readonly bgYellow: CSPair;
|
||||||
|
readonly bgBlue: CSPair;
|
||||||
|
readonly bgCyan: CSPair;
|
||||||
|
readonly bgMagenta: CSPair;
|
||||||
|
readonly bgWhite: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Alias for `bgBlackBright`.
|
||||||
|
*/
|
||||||
|
readonly bgGray: CSPair;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Alias for `bgBlackBright`.
|
||||||
|
*/
|
||||||
|
readonly bgGrey: CSPair;
|
||||||
|
|
||||||
|
readonly bgBlackBright: CSPair;
|
||||||
|
readonly bgRedBright: CSPair;
|
||||||
|
readonly bgGreenBright: CSPair;
|
||||||
|
readonly bgYellowBright: CSPair;
|
||||||
|
readonly bgBlueBright: CSPair;
|
||||||
|
readonly bgCyanBright: CSPair;
|
||||||
|
readonly bgMagentaBright: CSPair;
|
||||||
|
readonly bgWhiteBright: CSPair;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ConvertColor {
|
||||||
|
/**
|
||||||
|
Convert from the RGB color space to the ANSI 256 color space.
|
||||||
|
|
||||||
|
@param red - (`0...255`)
|
||||||
|
@param green - (`0...255`)
|
||||||
|
@param blue - (`0...255`)
|
||||||
|
*/
|
||||||
|
rgbToAnsi256(red: number, green: number, blue: number): number;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Convert from the RGB HEX color space to the RGB color space.
|
||||||
|
|
||||||
|
@param hex - A hexadecimal string containing RGB data.
|
||||||
|
*/
|
||||||
|
hexToRgb(hex: string): [red: number, green: number, blue: number];
|
||||||
|
|
||||||
|
/**
|
||||||
|
Convert from the RGB HEX color space to the ANSI 256 color space.
|
||||||
|
|
||||||
|
@param hex - A hexadecimal string containing RGB data.
|
||||||
|
*/
|
||||||
|
hexToAnsi256(hex: string): number;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Convert from the ANSI 256 color space to the ANSI 16 color space.
|
||||||
|
|
||||||
|
@param code - A number representing the ANSI 256 color.
|
||||||
|
*/
|
||||||
|
ansi256ToAnsi(code: number): number;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Convert from the RGB color space to the ANSI 16 color space.
|
||||||
|
|
||||||
|
@param red - (`0...255`)
|
||||||
|
@param green - (`0...255`)
|
||||||
|
@param blue - (`0...255`)
|
||||||
|
*/
|
||||||
|
rgbToAnsi(red: number, green: number, blue: number): number;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Convert from the RGB HEX color space to the ANSI 16 color space.
|
||||||
|
|
||||||
|
@param hex - A hexadecimal string containing RGB data.
|
||||||
|
*/
|
||||||
|
hexToAnsi(hex: string): number;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Basic modifier names.
|
||||||
|
*/
|
||||||
|
export type ModifierName = keyof Modifier;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Basic foreground color names.
|
||||||
|
|
||||||
|
[More colors here.](https://github.com/chalk/chalk/blob/main/readme.md#256-and-truecolor-color-support)
|
||||||
|
*/
|
||||||
|
export type ForegroundColorName = keyof ForegroundColor;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Basic background color names.
|
||||||
|
|
||||||
|
[More colors here.](https://github.com/chalk/chalk/blob/main/readme.md#256-and-truecolor-color-support)
|
||||||
|
*/
|
||||||
|
export type BackgroundColorName = keyof BackgroundColor;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Basic color names. The combination of foreground and background color names.
|
||||||
|
|
||||||
|
[More colors here.](https://github.com/chalk/chalk/blob/main/readme.md#256-and-truecolor-color-support)
|
||||||
|
*/
|
||||||
|
export type ColorName = ForegroundColorName | BackgroundColorName;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Basic modifier names.
|
||||||
|
*/
|
||||||
|
export const modifierNames: readonly ModifierName[];
|
||||||
|
|
||||||
|
/**
|
||||||
|
Basic foreground color names.
|
||||||
|
*/
|
||||||
|
export const foregroundColorNames: readonly ForegroundColorName[];
|
||||||
|
|
||||||
|
/**
|
||||||
|
Basic background color names.
|
||||||
|
*/
|
||||||
|
export const backgroundColorNames: readonly BackgroundColorName[];
|
||||||
|
|
||||||
|
/*
|
||||||
|
Basic color names. The combination of foreground and background color names.
|
||||||
|
*/
|
||||||
|
export const colorNames: readonly ColorName[];
|
||||||
|
|
||||||
|
declare const ansiStyles: {
|
||||||
|
readonly modifier: Modifier;
|
||||||
|
readonly color: ColorBase & ForegroundColor;
|
||||||
|
readonly bgColor: ColorBase & BackgroundColor;
|
||||||
|
readonly codes: ReadonlyMap<number, number>;
|
||||||
|
} & ForegroundColor & BackgroundColor & Modifier & ConvertColor;
|
||||||
|
|
||||||
|
export default ansiStyles;
|
|
@ -0,0 +1,223 @@
|
||||||
|
const ANSI_BACKGROUND_OFFSET = 10;
|
||||||
|
|
||||||
|
const wrapAnsi16 = (offset = 0) => code => `\u001B[${code + offset}m`;
|
||||||
|
|
||||||
|
const wrapAnsi256 = (offset = 0) => code => `\u001B[${38 + offset};5;${code}m`;
|
||||||
|
|
||||||
|
const wrapAnsi16m = (offset = 0) => (red, green, blue) => `\u001B[${38 + offset};2;${red};${green};${blue}m`;
|
||||||
|
|
||||||
|
const styles = {
|
||||||
|
modifier: {
|
||||||
|
reset: [0, 0],
|
||||||
|
// 21 isn't widely supported and 22 does the same thing
|
||||||
|
bold: [1, 22],
|
||||||
|
dim: [2, 22],
|
||||||
|
italic: [3, 23],
|
||||||
|
underline: [4, 24],
|
||||||
|
overline: [53, 55],
|
||||||
|
inverse: [7, 27],
|
||||||
|
hidden: [8, 28],
|
||||||
|
strikethrough: [9, 29],
|
||||||
|
},
|
||||||
|
color: {
|
||||||
|
black: [30, 39],
|
||||||
|
red: [31, 39],
|
||||||
|
green: [32, 39],
|
||||||
|
yellow: [33, 39],
|
||||||
|
blue: [34, 39],
|
||||||
|
magenta: [35, 39],
|
||||||
|
cyan: [36, 39],
|
||||||
|
white: [37, 39],
|
||||||
|
|
||||||
|
// Bright color
|
||||||
|
blackBright: [90, 39],
|
||||||
|
gray: [90, 39], // Alias of `blackBright`
|
||||||
|
grey: [90, 39], // Alias of `blackBright`
|
||||||
|
redBright: [91, 39],
|
||||||
|
greenBright: [92, 39],
|
||||||
|
yellowBright: [93, 39],
|
||||||
|
blueBright: [94, 39],
|
||||||
|
magentaBright: [95, 39],
|
||||||
|
cyanBright: [96, 39],
|
||||||
|
whiteBright: [97, 39],
|
||||||
|
},
|
||||||
|
bgColor: {
|
||||||
|
bgBlack: [40, 49],
|
||||||
|
bgRed: [41, 49],
|
||||||
|
bgGreen: [42, 49],
|
||||||
|
bgYellow: [43, 49],
|
||||||
|
bgBlue: [44, 49],
|
||||||
|
bgMagenta: [45, 49],
|
||||||
|
bgCyan: [46, 49],
|
||||||
|
bgWhite: [47, 49],
|
||||||
|
|
||||||
|
// Bright color
|
||||||
|
bgBlackBright: [100, 49],
|
||||||
|
bgGray: [100, 49], // Alias of `bgBlackBright`
|
||||||
|
bgGrey: [100, 49], // Alias of `bgBlackBright`
|
||||||
|
bgRedBright: [101, 49],
|
||||||
|
bgGreenBright: [102, 49],
|
||||||
|
bgYellowBright: [103, 49],
|
||||||
|
bgBlueBright: [104, 49],
|
||||||
|
bgMagentaBright: [105, 49],
|
||||||
|
bgCyanBright: [106, 49],
|
||||||
|
bgWhiteBright: [107, 49],
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
export const modifierNames = Object.keys(styles.modifier);
|
||||||
|
export const foregroundColorNames = Object.keys(styles.color);
|
||||||
|
export const backgroundColorNames = Object.keys(styles.bgColor);
|
||||||
|
export const colorNames = [...foregroundColorNames, ...backgroundColorNames];
|
||||||
|
|
||||||
|
function assembleStyles() {
|
||||||
|
const codes = new Map();
|
||||||
|
|
||||||
|
for (const [groupName, group] of Object.entries(styles)) {
|
||||||
|
for (const [styleName, style] of Object.entries(group)) {
|
||||||
|
styles[styleName] = {
|
||||||
|
open: `\u001B[${style[0]}m`,
|
||||||
|
close: `\u001B[${style[1]}m`,
|
||||||
|
};
|
||||||
|
|
||||||
|
group[styleName] = styles[styleName];
|
||||||
|
|
||||||
|
codes.set(style[0], style[1]);
|
||||||
|
}
|
||||||
|
|
||||||
|
Object.defineProperty(styles, groupName, {
|
||||||
|
value: group,
|
||||||
|
enumerable: false,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
Object.defineProperty(styles, 'codes', {
|
||||||
|
value: codes,
|
||||||
|
enumerable: false,
|
||||||
|
});
|
||||||
|
|
||||||
|
styles.color.close = '\u001B[39m';
|
||||||
|
styles.bgColor.close = '\u001B[49m';
|
||||||
|
|
||||||
|
styles.color.ansi = wrapAnsi16();
|
||||||
|
styles.color.ansi256 = wrapAnsi256();
|
||||||
|
styles.color.ansi16m = wrapAnsi16m();
|
||||||
|
styles.bgColor.ansi = wrapAnsi16(ANSI_BACKGROUND_OFFSET);
|
||||||
|
styles.bgColor.ansi256 = wrapAnsi256(ANSI_BACKGROUND_OFFSET);
|
||||||
|
styles.bgColor.ansi16m = wrapAnsi16m(ANSI_BACKGROUND_OFFSET);
|
||||||
|
|
||||||
|
// From https://github.com/Qix-/color-convert/blob/3f0e0d4e92e235796ccb17f6e85c72094a651f49/conversions.js
|
||||||
|
Object.defineProperties(styles, {
|
||||||
|
rgbToAnsi256: {
|
||||||
|
value(red, green, blue) {
|
||||||
|
// We use the extended greyscale palette here, with the exception of
|
||||||
|
// black and white. normal palette only has 4 greyscale shades.
|
||||||
|
if (red === green && green === blue) {
|
||||||
|
if (red < 8) {
|
||||||
|
return 16;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (red > 248) {
|
||||||
|
return 231;
|
||||||
|
}
|
||||||
|
|
||||||
|
return Math.round(((red - 8) / 247) * 24) + 232;
|
||||||
|
}
|
||||||
|
|
||||||
|
return 16
|
||||||
|
+ (36 * Math.round(red / 255 * 5))
|
||||||
|
+ (6 * Math.round(green / 255 * 5))
|
||||||
|
+ Math.round(blue / 255 * 5);
|
||||||
|
},
|
||||||
|
enumerable: false,
|
||||||
|
},
|
||||||
|
hexToRgb: {
|
||||||
|
value(hex) {
|
||||||
|
const matches = /[a-f\d]{6}|[a-f\d]{3}/i.exec(hex.toString(16));
|
||||||
|
if (!matches) {
|
||||||
|
return [0, 0, 0];
|
||||||
|
}
|
||||||
|
|
||||||
|
let [colorString] = matches;
|
||||||
|
|
||||||
|
if (colorString.length === 3) {
|
||||||
|
colorString = [...colorString].map(character => character + character).join('');
|
||||||
|
}
|
||||||
|
|
||||||
|
const integer = Number.parseInt(colorString, 16);
|
||||||
|
|
||||||
|
return [
|
||||||
|
/* eslint-disable no-bitwise */
|
||||||
|
(integer >> 16) & 0xFF,
|
||||||
|
(integer >> 8) & 0xFF,
|
||||||
|
integer & 0xFF,
|
||||||
|
/* eslint-enable no-bitwise */
|
||||||
|
];
|
||||||
|
},
|
||||||
|
enumerable: false,
|
||||||
|
},
|
||||||
|
hexToAnsi256: {
|
||||||
|
value: hex => styles.rgbToAnsi256(...styles.hexToRgb(hex)),
|
||||||
|
enumerable: false,
|
||||||
|
},
|
||||||
|
ansi256ToAnsi: {
|
||||||
|
value(code) {
|
||||||
|
if (code < 8) {
|
||||||
|
return 30 + code;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (code < 16) {
|
||||||
|
return 90 + (code - 8);
|
||||||
|
}
|
||||||
|
|
||||||
|
let red;
|
||||||
|
let green;
|
||||||
|
let blue;
|
||||||
|
|
||||||
|
if (code >= 232) {
|
||||||
|
red = (((code - 232) * 10) + 8) / 255;
|
||||||
|
green = red;
|
||||||
|
blue = red;
|
||||||
|
} else {
|
||||||
|
code -= 16;
|
||||||
|
|
||||||
|
const remainder = code % 36;
|
||||||
|
|
||||||
|
red = Math.floor(code / 36) / 5;
|
||||||
|
green = Math.floor(remainder / 6) / 5;
|
||||||
|
blue = (remainder % 6) / 5;
|
||||||
|
}
|
||||||
|
|
||||||
|
const value = Math.max(red, green, blue) * 2;
|
||||||
|
|
||||||
|
if (value === 0) {
|
||||||
|
return 30;
|
||||||
|
}
|
||||||
|
|
||||||
|
// eslint-disable-next-line no-bitwise
|
||||||
|
let result = 30 + ((Math.round(blue) << 2) | (Math.round(green) << 1) | Math.round(red));
|
||||||
|
|
||||||
|
if (value === 2) {
|
||||||
|
result += 60;
|
||||||
|
}
|
||||||
|
|
||||||
|
return result;
|
||||||
|
},
|
||||||
|
enumerable: false,
|
||||||
|
},
|
||||||
|
rgbToAnsi: {
|
||||||
|
value: (red, green, blue) => styles.ansi256ToAnsi(styles.rgbToAnsi256(red, green, blue)),
|
||||||
|
enumerable: false,
|
||||||
|
},
|
||||||
|
hexToAnsi: {
|
||||||
|
value: hex => styles.ansi256ToAnsi(styles.hexToAnsi256(hex)),
|
||||||
|
enumerable: false,
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
return styles;
|
||||||
|
}
|
||||||
|
|
||||||
|
const ansiStyles = assembleStyles();
|
||||||
|
|
||||||
|
export default ansiStyles;
|
|
@ -0,0 +1 @@
|
||||||
|
export {default} from './index.js';
|
|
@ -0,0 +1,30 @@
|
||||||
|
/* eslint-env browser */
|
||||||
|
|
||||||
|
const level = (() => {
|
||||||
|
if (navigator.userAgentData) {
|
||||||
|
const brand = navigator.userAgentData.brands.find(({brand}) => brand === 'Chromium');
|
||||||
|
if (brand && brand.version > 93) {
|
||||||
|
return 3;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (/\b(Chrome|Chromium)\//.test(navigator.userAgent)) {
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
return 0;
|
||||||
|
})();
|
||||||
|
|
||||||
|
const colorSupport = level !== 0 && {
|
||||||
|
level,
|
||||||
|
hasBasic: true,
|
||||||
|
has256: level >= 2,
|
||||||
|
has16m: level >= 3,
|
||||||
|
};
|
||||||
|
|
||||||
|
const supportsColor = {
|
||||||
|
stdout: colorSupport,
|
||||||
|
stderr: colorSupport,
|
||||||
|
};
|
||||||
|
|
||||||
|
export default supportsColor;
|
|
@ -0,0 +1,55 @@
|
||||||
|
import type {WriteStream} from 'node:tty';
|
||||||
|
|
||||||
|
export type Options = {
|
||||||
|
/**
|
||||||
|
Whether `process.argv` should be sniffed for `--color` and `--no-color` flags.
|
||||||
|
|
||||||
|
@default true
|
||||||
|
*/
|
||||||
|
readonly sniffFlags?: boolean;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
Levels:
|
||||||
|
- `0` - All colors disabled.
|
||||||
|
- `1` - Basic 16 colors support.
|
||||||
|
- `2` - ANSI 256 colors support.
|
||||||
|
- `3` - Truecolor 16 million colors support.
|
||||||
|
*/
|
||||||
|
export type ColorSupportLevel = 0 | 1 | 2 | 3;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Detect whether the terminal supports color.
|
||||||
|
*/
|
||||||
|
export type ColorSupport = {
|
||||||
|
/**
|
||||||
|
The color level.
|
||||||
|
*/
|
||||||
|
level: ColorSupportLevel;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Whether basic 16 colors are supported.
|
||||||
|
*/
|
||||||
|
hasBasic: boolean;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Whether ANSI 256 colors are supported.
|
||||||
|
*/
|
||||||
|
has256: boolean;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Whether Truecolor 16 million colors are supported.
|
||||||
|
*/
|
||||||
|
has16m: boolean;
|
||||||
|
};
|
||||||
|
|
||||||
|
export type ColorInfo = ColorSupport | false;
|
||||||
|
|
||||||
|
export function createSupportsColor(stream?: WriteStream, options?: Options): ColorInfo;
|
||||||
|
|
||||||
|
declare const supportsColor: {
|
||||||
|
stdout: ColorInfo;
|
||||||
|
stderr: ColorInfo;
|
||||||
|
};
|
||||||
|
|
||||||
|
export default supportsColor;
|
|
@ -0,0 +1,182 @@
|
||||||
|
import process from 'node:process';
|
||||||
|
import os from 'node:os';
|
||||||
|
import tty from 'node:tty';
|
||||||
|
|
||||||
|
// From: https://github.com/sindresorhus/has-flag/blob/main/index.js
|
||||||
|
/// function hasFlag(flag, argv = globalThis.Deno?.args ?? process.argv) {
|
||||||
|
function hasFlag(flag, argv = globalThis.Deno ? globalThis.Deno.args : process.argv) {
|
||||||
|
const prefix = flag.startsWith('-') ? '' : (flag.length === 1 ? '-' : '--');
|
||||||
|
const position = argv.indexOf(prefix + flag);
|
||||||
|
const terminatorPosition = argv.indexOf('--');
|
||||||
|
return position !== -1 && (terminatorPosition === -1 || position < terminatorPosition);
|
||||||
|
}
|
||||||
|
|
||||||
|
const {env} = process;
|
||||||
|
|
||||||
|
let flagForceColor;
|
||||||
|
if (
|
||||||
|
hasFlag('no-color')
|
||||||
|
|| hasFlag('no-colors')
|
||||||
|
|| hasFlag('color=false')
|
||||||
|
|| hasFlag('color=never')
|
||||||
|
) {
|
||||||
|
flagForceColor = 0;
|
||||||
|
} else if (
|
||||||
|
hasFlag('color')
|
||||||
|
|| hasFlag('colors')
|
||||||
|
|| hasFlag('color=true')
|
||||||
|
|| hasFlag('color=always')
|
||||||
|
) {
|
||||||
|
flagForceColor = 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
function envForceColor() {
|
||||||
|
if ('FORCE_COLOR' in env) {
|
||||||
|
if (env.FORCE_COLOR === 'true') {
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (env.FORCE_COLOR === 'false') {
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
return env.FORCE_COLOR.length === 0 ? 1 : Math.min(Number.parseInt(env.FORCE_COLOR, 10), 3);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function translateLevel(level) {
|
||||||
|
if (level === 0) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
level,
|
||||||
|
hasBasic: true,
|
||||||
|
has256: level >= 2,
|
||||||
|
has16m: level >= 3,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function _supportsColor(haveStream, {streamIsTTY, sniffFlags = true} = {}) {
|
||||||
|
const noFlagForceColor = envForceColor();
|
||||||
|
if (noFlagForceColor !== undefined) {
|
||||||
|
flagForceColor = noFlagForceColor;
|
||||||
|
}
|
||||||
|
|
||||||
|
const forceColor = sniffFlags ? flagForceColor : noFlagForceColor;
|
||||||
|
|
||||||
|
if (forceColor === 0) {
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (sniffFlags) {
|
||||||
|
if (hasFlag('color=16m')
|
||||||
|
|| hasFlag('color=full')
|
||||||
|
|| hasFlag('color=truecolor')) {
|
||||||
|
return 3;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (hasFlag('color=256')) {
|
||||||
|
return 2;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Check for Azure DevOps pipelines.
|
||||||
|
// Has to be above the `!streamIsTTY` check.
|
||||||
|
if ('TF_BUILD' in env && 'AGENT_NAME' in env) {
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (haveStream && !streamIsTTY && forceColor === undefined) {
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
const min = forceColor || 0;
|
||||||
|
|
||||||
|
if (env.TERM === 'dumb') {
|
||||||
|
return min;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (process.platform === 'win32') {
|
||||||
|
// Windows 10 build 10586 is the first Windows release that supports 256 colors.
|
||||||
|
// Windows 10 build 14931 is the first release that supports 16m/TrueColor.
|
||||||
|
const osRelease = os.release().split('.');
|
||||||
|
if (
|
||||||
|
Number(osRelease[0]) >= 10
|
||||||
|
&& Number(osRelease[2]) >= 10_586
|
||||||
|
) {
|
||||||
|
return Number(osRelease[2]) >= 14_931 ? 3 : 2;
|
||||||
|
}
|
||||||
|
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
if ('CI' in env) {
|
||||||
|
if ('GITHUB_ACTIONS' in env || 'GITEA_ACTIONS' in env) {
|
||||||
|
return 3;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (['TRAVIS', 'CIRCLECI', 'APPVEYOR', 'GITLAB_CI', 'BUILDKITE', 'DRONE'].some(sign => sign in env) || env.CI_NAME === 'codeship') {
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
return min;
|
||||||
|
}
|
||||||
|
|
||||||
|
if ('TEAMCITY_VERSION' in env) {
|
||||||
|
return /^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(env.TEAMCITY_VERSION) ? 1 : 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (env.COLORTERM === 'truecolor') {
|
||||||
|
return 3;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (env.TERM === 'xterm-kitty') {
|
||||||
|
return 3;
|
||||||
|
}
|
||||||
|
|
||||||
|
if ('TERM_PROGRAM' in env) {
|
||||||
|
const version = Number.parseInt((env.TERM_PROGRAM_VERSION || '').split('.')[0], 10);
|
||||||
|
|
||||||
|
switch (env.TERM_PROGRAM) {
|
||||||
|
case 'iTerm.app': {
|
||||||
|
return version >= 3 ? 3 : 2;
|
||||||
|
}
|
||||||
|
|
||||||
|
case 'Apple_Terminal': {
|
||||||
|
return 2;
|
||||||
|
}
|
||||||
|
// No default
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (/-256(color)?$/i.test(env.TERM)) {
|
||||||
|
return 2;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(env.TERM)) {
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
if ('COLORTERM' in env) {
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
return min;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function createSupportsColor(stream, options = {}) {
|
||||||
|
const level = _supportsColor(stream, {
|
||||||
|
streamIsTTY: stream && stream.isTTY,
|
||||||
|
...options,
|
||||||
|
});
|
||||||
|
|
||||||
|
return translateLevel(level);
|
||||||
|
}
|
||||||
|
|
||||||
|
const supportsColor = {
|
||||||
|
stdout: createSupportsColor({isTTY: tty.isatty(1)}),
|
||||||
|
stderr: createSupportsColor({isTTY: tty.isatty(2)}),
|
||||||
|
};
|
||||||
|
|
||||||
|
export default supportsColor;
|
|
@ -0,0 +1,47 @@
|
||||||
|
declare const cliCursor: {
|
||||||
|
/**
|
||||||
|
Show cursor.
|
||||||
|
|
||||||
|
@param stream - Default: `process.stderr`.
|
||||||
|
|
||||||
|
@example
|
||||||
|
```
|
||||||
|
import cliCursor from 'cli-cursor';
|
||||||
|
|
||||||
|
cliCursor.show();
|
||||||
|
```
|
||||||
|
*/
|
||||||
|
show(stream?: NodeJS.WritableStream): void;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Hide cursor.
|
||||||
|
|
||||||
|
@param stream - Default: `process.stderr`.
|
||||||
|
|
||||||
|
@example
|
||||||
|
```
|
||||||
|
import cliCursor from 'cli-cursor';
|
||||||
|
|
||||||
|
cliCursor.hide();
|
||||||
|
```
|
||||||
|
*/
|
||||||
|
hide(stream?: NodeJS.WritableStream): void;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Toggle cursor visibility.
|
||||||
|
|
||||||
|
@param force - Is useful to show or hide the cursor based on a boolean.
|
||||||
|
@param stream - Default: `process.stderr`.
|
||||||
|
|
||||||
|
@example
|
||||||
|
```
|
||||||
|
import cliCursor from 'cli-cursor';
|
||||||
|
|
||||||
|
const unicornsAreAwesome = true;
|
||||||
|
cliCursor.toggle(unicornsAreAwesome);
|
||||||
|
```
|
||||||
|
*/
|
||||||
|
toggle(force?: boolean, stream?: NodeJS.WritableStream): void;
|
||||||
|
};
|
||||||
|
|
||||||
|
export default cliCursor;
|
|
@ -0,0 +1,39 @@
|
||||||
|
import process from 'node:process';
|
||||||
|
import restoreCursor from 'restore-cursor';
|
||||||
|
|
||||||
|
let isHidden = false;
|
||||||
|
|
||||||
|
const cliCursor = {};
|
||||||
|
|
||||||
|
cliCursor.show = (writableStream = process.stderr) => {
|
||||||
|
if (!writableStream.isTTY) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
isHidden = false;
|
||||||
|
writableStream.write('\u001B[?25h');
|
||||||
|
};
|
||||||
|
|
||||||
|
cliCursor.hide = (writableStream = process.stderr) => {
|
||||||
|
if (!writableStream.isTTY) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
restoreCursor();
|
||||||
|
isHidden = true;
|
||||||
|
writableStream.write('\u001B[?25l');
|
||||||
|
};
|
||||||
|
|
||||||
|
cliCursor.toggle = (force, writableStream) => {
|
||||||
|
if (force !== undefined) {
|
||||||
|
isHidden = force;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (isHidden) {
|
||||||
|
cliCursor.show(writableStream);
|
||||||
|
} else {
|
||||||
|
cliCursor.hide(writableStream);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
export default cliCursor;
|
|
@ -0,0 +1,9 @@
|
||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
@ -0,0 +1,56 @@
|
||||||
|
{
|
||||||
|
"name": "cli-cursor",
|
||||||
|
"version": "5.0.0",
|
||||||
|
"description": "Toggle the CLI cursor",
|
||||||
|
"license": "MIT",
|
||||||
|
"repository": "sindresorhus/cli-cursor",
|
||||||
|
"funding": "https://github.com/sponsors/sindresorhus",
|
||||||
|
"author": {
|
||||||
|
"name": "Sindre Sorhus",
|
||||||
|
"email": "sindresorhus@gmail.com",
|
||||||
|
"url": "https://sindresorhus.com"
|
||||||
|
},
|
||||||
|
"type": "module",
|
||||||
|
"exports": {
|
||||||
|
"types": "./index.d.ts",
|
||||||
|
"default": "./index.js"
|
||||||
|
},
|
||||||
|
"sideEffects": false,
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"test": "xo && ava && tsc index.d.ts"
|
||||||
|
},
|
||||||
|
"files": [
|
||||||
|
"index.js",
|
||||||
|
"index.d.ts"
|
||||||
|
],
|
||||||
|
"keywords": [
|
||||||
|
"cli",
|
||||||
|
"cursor",
|
||||||
|
"ansi",
|
||||||
|
"toggle",
|
||||||
|
"display",
|
||||||
|
"show",
|
||||||
|
"hide",
|
||||||
|
"term",
|
||||||
|
"terminal",
|
||||||
|
"console",
|
||||||
|
"tty",
|
||||||
|
"shell",
|
||||||
|
"command-line"
|
||||||
|
],
|
||||||
|
"dependencies": {
|
||||||
|
"restore-cursor": "^5.0.0"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@types/node": "^20.14.12",
|
||||||
|
"ava": "^6.1.3",
|
||||||
|
"typescript": "^5.5.4",
|
||||||
|
"xo": "^0.59.2"
|
||||||
|
},
|
||||||
|
"ava": {
|
||||||
|
"workerThreads": false
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,39 @@
|
||||||
|
# cli-cursor
|
||||||
|
|
||||||
|
> Toggle the CLI cursor
|
||||||
|
|
||||||
|
The cursor is [gracefully restored](https://github.com/sindresorhus/restore-cursor) if the process exits.
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
```sh
|
||||||
|
npm install cli-cursor
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```js
|
||||||
|
import cliCursor from 'cli-cursor';
|
||||||
|
|
||||||
|
cliCursor.hide();
|
||||||
|
|
||||||
|
const unicornsAreAwesome = true;
|
||||||
|
cliCursor.toggle(unicornsAreAwesome);
|
||||||
|
```
|
||||||
|
|
||||||
|
## API
|
||||||
|
|
||||||
|
### .show(stream?)
|
||||||
|
|
||||||
|
### .hide(stream?)
|
||||||
|
|
||||||
|
### .toggle(force?, stream?)
|
||||||
|
|
||||||
|
#### force
|
||||||
|
|
||||||
|
Useful for showing or hiding the cursor based on a boolean.
|
||||||
|
|
||||||
|
#### stream
|
||||||
|
|
||||||
|
Type: `stream.Writable`\
|
||||||
|
Default: `process.stderr`
|
|
@ -0,0 +1,116 @@
|
||||||
|
export type Options = {
|
||||||
|
/**
|
||||||
|
The position to truncate the string.
|
||||||
|
|
||||||
|
@default 'end'
|
||||||
|
*/
|
||||||
|
readonly position?: 'start' | 'middle' | 'end';
|
||||||
|
|
||||||
|
/**
|
||||||
|
Add a space between the text and the ellipsis.
|
||||||
|
|
||||||
|
@default false
|
||||||
|
|
||||||
|
@example
|
||||||
|
```
|
||||||
|
import cliTruncate from 'cli-truncate';
|
||||||
|
|
||||||
|
cliTruncate('unicorns', 5, {position: 'end', space: true});
|
||||||
|
//=> 'uni …'
|
||||||
|
|
||||||
|
cliTruncate('unicorns', 5, {position: 'end', space: false});
|
||||||
|
//=> 'unic…'
|
||||||
|
|
||||||
|
cliTruncate('unicorns', 6, {position: 'start', space: true});
|
||||||
|
//=> '… orns'
|
||||||
|
|
||||||
|
cliTruncate('unicorns', 7, {position: 'middle', space: true});
|
||||||
|
//=> 'uni … s'
|
||||||
|
```
|
||||||
|
*/
|
||||||
|
readonly space?: boolean;
|
||||||
|
|
||||||
|
/**
|
||||||
|
Truncate the string from a whitespace if it is within 3 characters from the actual breaking point.
|
||||||
|
|
||||||
|
@default false
|
||||||
|
|
||||||
|
@example
|
||||||
|
```
|
||||||
|
import cliTruncate from 'cli-truncate';
|
||||||
|
|
||||||
|
cliTruncate('unicorns rainbow dragons', 20, {position: 'start', preferTruncationOnSpace: true});
|
||||||
|
//=> '…rainbow dragons'
|
||||||
|
|
||||||
|
cliTruncate('unicorns rainbow dragons', 20, {position: 'middle', preferTruncationOnSpace: true});
|
||||||
|
//=> 'unicorns…dragons'
|
||||||
|
|
||||||
|
cliTruncate('unicorns rainbow dragons', 6, {position: 'end', preferTruncationOnSpace: true});
|
||||||
|
//=> 'unico…'
|
||||||
|
````
|
||||||
|
*/
|
||||||
|
readonly preferTruncationOnSpace?: boolean;
|
||||||
|
|
||||||
|
/**
|
||||||
|
The character to use at the breaking point.
|
||||||
|
|
||||||
|
@default '…'
|
||||||
|
|
||||||
|
@example
|
||||||
|
```
|
||||||
|
import cliTruncate from 'cli-truncate';
|
||||||
|
|
||||||
|
cliTruncate('unicorns', 5, {position: 'end'});
|
||||||
|
//=> 'unic…'
|
||||||
|
|
||||||
|
cliTruncate('unicorns', 5, {position: 'end', truncationCharacter: '.'});
|
||||||
|
//=> 'unic.'
|
||||||
|
|
||||||
|
cliTruncate('unicorns', 5, {position: 'end', truncationCharacter: ''});
|
||||||
|
//=> 'unico'
|
||||||
|
*/
|
||||||
|
readonly truncationCharacter?: string;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
Truncate a string to a specific width in the terminal.
|
||||||
|
|
||||||
|
@param text - The text to truncate.
|
||||||
|
@param columns - The number of columns to occupy in the terminal.
|
||||||
|
|
||||||
|
@example
|
||||||
|
```
|
||||||
|
import cliTruncate from 'cli-truncate';
|
||||||
|
|
||||||
|
cliTruncate('unicorn', 4);
|
||||||
|
//=> 'uni…'
|
||||||
|
|
||||||
|
// Truncate at different positions
|
||||||
|
cliTruncate('unicorn', 4, {position: 'start'});
|
||||||
|
//=> '…orn'
|
||||||
|
|
||||||
|
cliTruncate('unicorn', 4, {position: 'middle'});
|
||||||
|
//=> 'un…n'
|
||||||
|
|
||||||
|
cliTruncate('\u001B[31municorn\u001B[39m', 4);
|
||||||
|
//=> '\u001B[31muni\u001B[39m…'
|
||||||
|
|
||||||
|
// Truncate Unicode surrogate pairs
|
||||||
|
cliTruncate('uni\uD83C\uDE00corn', 5);
|
||||||
|
//=> 'uni\uD83C\uDE00…'
|
||||||
|
|
||||||
|
// Truncate fullwidth characters
|
||||||
|
cliTruncate('안녕하세요', 3);
|
||||||
|
//=> '안…'
|
||||||
|
|
||||||
|
// Truncate the paragraph to the terminal width
|
||||||
|
const paragraph = 'Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa.';
|
||||||
|
cliTruncate(paragraph, process.stdout.columns);
|
||||||
|
//=> 'Lorem ipsum dolor sit amet, consectetuer adipiscing…'
|
||||||
|
```
|
||||||
|
*/
|
||||||
|
export default function cliTruncate(
|
||||||
|
text: string,
|
||||||
|
columns: number,
|
||||||
|
options?: Options
|
||||||
|
): string;
|
|
@ -0,0 +1,99 @@
|
||||||
|
import sliceAnsi from 'slice-ansi';
|
||||||
|
import stringWidth from 'string-width';
|
||||||
|
|
||||||
|
function getIndexOfNearestSpace(string, wantedIndex, shouldSearchRight) {
|
||||||
|
if (string.charAt(wantedIndex) === ' ') {
|
||||||
|
return wantedIndex;
|
||||||
|
}
|
||||||
|
|
||||||
|
const direction = shouldSearchRight ? 1 : -1;
|
||||||
|
|
||||||
|
for (let index = 0; index <= 3; index++) {
|
||||||
|
const finalIndex = wantedIndex + (index * direction);
|
||||||
|
if (string.charAt(finalIndex) === ' ') {
|
||||||
|
return finalIndex;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return wantedIndex;
|
||||||
|
}
|
||||||
|
|
||||||
|
export default function cliTruncate(text, columns, options = {}) {
|
||||||
|
const {
|
||||||
|
position = 'end',
|
||||||
|
space = false,
|
||||||
|
preferTruncationOnSpace = false,
|
||||||
|
} = options;
|
||||||
|
|
||||||
|
let {truncationCharacter = '…'} = options;
|
||||||
|
|
||||||
|
if (typeof text !== 'string') {
|
||||||
|
throw new TypeError(`Expected \`input\` to be a string, got ${typeof text}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (typeof columns !== 'number') {
|
||||||
|
throw new TypeError(`Expected \`columns\` to be a number, got ${typeof columns}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (columns < 1) {
|
||||||
|
return '';
|
||||||
|
}
|
||||||
|
|
||||||
|
if (columns === 1) {
|
||||||
|
return truncationCharacter;
|
||||||
|
}
|
||||||
|
|
||||||
|
const length = stringWidth(text);
|
||||||
|
|
||||||
|
if (length <= columns) {
|
||||||
|
return text;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (position === 'start') {
|
||||||
|
if (preferTruncationOnSpace) {
|
||||||
|
const nearestSpace = getIndexOfNearestSpace(text, length - columns + 1, true);
|
||||||
|
return truncationCharacter + sliceAnsi(text, nearestSpace, length).trim();
|
||||||
|
}
|
||||||
|
|
||||||
|
if (space === true) {
|
||||||
|
truncationCharacter += ' ';
|
||||||
|
}
|
||||||
|
|
||||||
|
return truncationCharacter + sliceAnsi(text, length - columns + stringWidth(truncationCharacter), length);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (position === 'middle') {
|
||||||
|
if (space === true) {
|
||||||
|
truncationCharacter = ` ${truncationCharacter} `;
|
||||||
|
}
|
||||||
|
|
||||||
|
const half = Math.floor(columns / 2);
|
||||||
|
|
||||||
|
if (preferTruncationOnSpace) {
|
||||||
|
const spaceNearFirstBreakPoint = getIndexOfNearestSpace(text, half);
|
||||||
|
const spaceNearSecondBreakPoint = getIndexOfNearestSpace(text, length - (columns - half) + 1, true);
|
||||||
|
return sliceAnsi(text, 0, spaceNearFirstBreakPoint) + truncationCharacter + sliceAnsi(text, spaceNearSecondBreakPoint, length).trim();
|
||||||
|
}
|
||||||
|
|
||||||
|
return (
|
||||||
|
sliceAnsi(text, 0, half)
|
||||||
|
+ truncationCharacter
|
||||||
|
+ sliceAnsi(text, length - (columns - half) + stringWidth(truncationCharacter), length)
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (position === 'end') {
|
||||||
|
if (preferTruncationOnSpace) {
|
||||||
|
const nearestSpace = getIndexOfNearestSpace(text, columns - 1);
|
||||||
|
return sliceAnsi(text, 0, nearestSpace) + truncationCharacter;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (space === true) {
|
||||||
|
truncationCharacter = ` ${truncationCharacter}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
return sliceAnsi(text, 0, columns - stringWidth(truncationCharacter)) + truncationCharacter;
|
||||||
|
}
|
||||||
|
|
||||||
|
throw new Error(`Expected \`options.position\` to be either \`start\`, \`middle\` or \`end\`, got ${position}`);
|
||||||
|
}
|
|
@ -0,0 +1,9 @@
|
||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
@ -0,0 +1,51 @@
|
||||||
|
{
|
||||||
|
"name": "cli-truncate",
|
||||||
|
"version": "4.0.0",
|
||||||
|
"description": "Truncate a string to a specific width in the terminal",
|
||||||
|
"license": "MIT",
|
||||||
|
"repository": "sindresorhus/cli-truncate",
|
||||||
|
"funding": "https://github.com/sponsors/sindresorhus",
|
||||||
|
"author": {
|
||||||
|
"name": "Sindre Sorhus",
|
||||||
|
"email": "sindresorhus@gmail.com",
|
||||||
|
"url": "https://sindresorhus.com"
|
||||||
|
},
|
||||||
|
"type": "module",
|
||||||
|
"exports": {
|
||||||
|
"types": "./index.d.ts",
|
||||||
|
"default": "./index.js"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"test": "xo && ava && tsd"
|
||||||
|
},
|
||||||
|
"files": [
|
||||||
|
"index.js",
|
||||||
|
"index.d.ts"
|
||||||
|
],
|
||||||
|
"keywords": [
|
||||||
|
"truncate",
|
||||||
|
"ellipsis",
|
||||||
|
"text",
|
||||||
|
"limit",
|
||||||
|
"slice",
|
||||||
|
"cli",
|
||||||
|
"terminal",
|
||||||
|
"term",
|
||||||
|
"shell",
|
||||||
|
"width",
|
||||||
|
"ansi",
|
||||||
|
"string"
|
||||||
|
],
|
||||||
|
"dependencies": {
|
||||||
|
"slice-ansi": "^5.0.0",
|
||||||
|
"string-width": "^7.0.0"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"ava": "^5.3.1",
|
||||||
|
"tsd": "^0.29.0",
|
||||||
|
"xo": "^0.56.0"
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,150 @@
|
||||||
|
# cli-truncate
|
||||||
|
|
||||||
|
> Truncate a string to a specific width in the terminal
|
||||||
|
|
||||||
|
Gracefully handles [ANSI escapes](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors_and_Styles). Like a string styled with [`chalk`](https://github.com/chalk/chalk). It also supports Unicode surrogate pairs and fullwidth characters.
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
```sh
|
||||||
|
npm install cli-truncate
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```js
|
||||||
|
import cliTruncate from 'cli-truncate';
|
||||||
|
|
||||||
|
cliTruncate('unicorn', 4);
|
||||||
|
//=> 'uni…'
|
||||||
|
|
||||||
|
// Truncate at different positions
|
||||||
|
cliTruncate('unicorn', 4, {position: 'start'});
|
||||||
|
//=> '…orn'
|
||||||
|
|
||||||
|
cliTruncate('unicorn', 4, {position: 'middle'});
|
||||||
|
//=> 'un…n'
|
||||||
|
|
||||||
|
cliTruncate('unicorns rainbow dragons', 6, {position: 'end'})
|
||||||
|
//=> 'unico…'
|
||||||
|
|
||||||
|
cliTruncate('\u001B[31municorn\u001B[39m', 4);
|
||||||
|
//=> '\u001B[31muni\u001B[39m…'
|
||||||
|
|
||||||
|
// Truncate Unicode surrogate pairs
|
||||||
|
cliTruncate('uni\uD83C\uDE00corn', 5);
|
||||||
|
//=> 'uni\uD83C\uDE00…'
|
||||||
|
|
||||||
|
// Truncate fullwidth characters
|
||||||
|
cliTruncate('안녕하세요', 3);
|
||||||
|
//=> '안…'
|
||||||
|
|
||||||
|
// Truncate the paragraph to the terminal width
|
||||||
|
const paragraph = 'Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa.';
|
||||||
|
cliTruncate(paragraph, process.stdout.columns);
|
||||||
|
//=> 'Lorem ipsum dolor sit amet, consectetuer adipiscing…'
|
||||||
|
```
|
||||||
|
|
||||||
|
## API
|
||||||
|
|
||||||
|
### cliTruncate(text, columns, options?)
|
||||||
|
|
||||||
|
#### text
|
||||||
|
|
||||||
|
Type: `string`
|
||||||
|
|
||||||
|
The text to truncate.
|
||||||
|
|
||||||
|
#### columns
|
||||||
|
|
||||||
|
Type: `number`
|
||||||
|
|
||||||
|
The number of columns to occupy in the terminal.
|
||||||
|
|
||||||
|
#### options
|
||||||
|
|
||||||
|
Type: `object`
|
||||||
|
|
||||||
|
##### position
|
||||||
|
|
||||||
|
Type: `string`\
|
||||||
|
Default: `'end'`\
|
||||||
|
Values: `'start' | 'middle' | 'end'`
|
||||||
|
|
||||||
|
The position to truncate the string.
|
||||||
|
|
||||||
|
##### space
|
||||||
|
|
||||||
|
Type: `boolean`\
|
||||||
|
Default: `false`
|
||||||
|
|
||||||
|
Add a space between the text and the ellipsis.
|
||||||
|
|
||||||
|
```js
|
||||||
|
import cliTruncate from 'cli-truncate';
|
||||||
|
|
||||||
|
cliTruncate('unicorns', 5, {space: false});
|
||||||
|
//=> 'unic…'
|
||||||
|
|
||||||
|
cliTruncate('unicorns', 5, {space: true});
|
||||||
|
//=> 'uni …'
|
||||||
|
|
||||||
|
cliTruncate('unicorns', 6, {position: 'start', space: true});
|
||||||
|
//=> '… orns'
|
||||||
|
|
||||||
|
cliTruncate('unicorns', 7, {position: 'middle', space: true});
|
||||||
|
//=> 'uni … s'
|
||||||
|
```
|
||||||
|
|
||||||
|
##### preferTruncationOnSpace
|
||||||
|
|
||||||
|
Type: `boolean`\
|
||||||
|
Default: `false`
|
||||||
|
|
||||||
|
Truncate the string from a whitespace if it is within 3 characters from the actual breaking point.
|
||||||
|
|
||||||
|
```js
|
||||||
|
import cliTruncate from 'cli-truncate';
|
||||||
|
|
||||||
|
cliTruncate('unicorns rainbow dragons', 20, {position: 'start', preferTruncationOnSpace: true})
|
||||||
|
//=> '…rainbow dragons'
|
||||||
|
|
||||||
|
// without preferTruncationOnSpace
|
||||||
|
cliTruncate('unicorns rainbow dragons', 20, {position: 'start'})
|
||||||
|
//=> '…rns rainbow dragons'
|
||||||
|
|
||||||
|
cliTruncate('unicorns rainbow dragons', 20, {position: 'middle', preferTruncationOnSpace: true})
|
||||||
|
//=> 'unicorns…dragons'
|
||||||
|
|
||||||
|
cliTruncate('unicorns rainbow dragons', 6, {position: 'end', preferTruncationOnSpace: true})
|
||||||
|
//=> 'unico…'
|
||||||
|
|
||||||
|
// preferTruncationOnSpace would have no effect if space isn't found within next 3 indexes
|
||||||
|
cliTruncate('unicorns rainbow dragons', 6, {position: 'middle', preferTruncationOnSpace: true})
|
||||||
|
//=> 'uni…ns'
|
||||||
|
```
|
||||||
|
|
||||||
|
##### truncationCharacter
|
||||||
|
|
||||||
|
Type: `string`\
|
||||||
|
Default: `…`
|
||||||
|
|
||||||
|
The character to use at the breaking point.
|
||||||
|
|
||||||
|
```js
|
||||||
|
import cliTruncate from 'cli-truncate';
|
||||||
|
|
||||||
|
cliTruncate('unicorns', 5, {position: 'end'});
|
||||||
|
//=> 'unic…'
|
||||||
|
|
||||||
|
cliTruncate('unicorns', 5, {position: 'end', truncationCharacter: '.'});
|
||||||
|
//=> 'unic.'
|
||||||
|
|
||||||
|
cliTruncate('unicorns', 5, {position: 'end', truncationCharacter: ''});
|
||||||
|
//=> 'unico'
|
||||||
|
```
|
||||||
|
|
||||||
|
## Related
|
||||||
|
|
||||||
|
- [wrap-ansi](https://github.com/chalk/wrap-ansi) - Wordwrap a string with ANSI escape codes
|
||||||
|
- [slice-ansi](https://github.com/chalk/slice-ansi) - Slice a string with ANSI escape codes
|
|
@ -0,0 +1,7 @@
|
||||||
|
Copyright © Jorge Bucaran <<https://jorgebucaran.com>>
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
@ -0,0 +1,134 @@
|
||||||
|
# 🌈Colorette
|
||||||
|
|
||||||
|
> Easily set your terminal text color & styles.
|
||||||
|
|
||||||
|
- No dependecies
|
||||||
|
- Automatic color support detection
|
||||||
|
- Up to [2x faster](#benchmarks) than alternatives
|
||||||
|
- TypeScript support
|
||||||
|
- [`NO_COLOR`](https://no-color.org) friendly
|
||||||
|
- Node >= `10`
|
||||||
|
|
||||||
|
> [**Upgrading from Colorette `1.x`?**](https://github.com/jorgebucaran/colorette/issues/70)
|
||||||
|
|
||||||
|
## Quickstart
|
||||||
|
|
||||||
|
```js
|
||||||
|
import { blue, bold, underline } from "colorette"
|
||||||
|
|
||||||
|
console.log(
|
||||||
|
blue("I'm blue"),
|
||||||
|
bold(blue("da ba dee")),
|
||||||
|
underline(bold(blue("da ba daa")))
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
Here's an example using [template literals](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals).
|
||||||
|
|
||||||
|
```js
|
||||||
|
console.log(`
|
||||||
|
There's a ${underline(blue("house"))},
|
||||||
|
With a ${bold(blue("window"))},
|
||||||
|
And a ${blue("corvette")}
|
||||||
|
And everything is blue
|
||||||
|
`)
|
||||||
|
```
|
||||||
|
|
||||||
|
You can also nest styles without breaking existing color sequences.
|
||||||
|
|
||||||
|
```js
|
||||||
|
console.log(bold(`I'm ${blue(`da ba ${underline("dee")} da ba`)} daa`))
|
||||||
|
```
|
||||||
|
|
||||||
|
Need to override terminal color detection? You can do that too.
|
||||||
|
|
||||||
|
```js
|
||||||
|
import { createColors } from "colorette"
|
||||||
|
|
||||||
|
const { blue } = createColors({ useColor: false })
|
||||||
|
|
||||||
|
console.log(blue("Blue? Nope, nah"))
|
||||||
|
```
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
```console
|
||||||
|
npm install colorette
|
||||||
|
```
|
||||||
|
|
||||||
|
## API
|
||||||
|
|
||||||
|
### \<color\>()
|
||||||
|
|
||||||
|
> See all [supported colors](#supported-colors).
|
||||||
|
|
||||||
|
```js
|
||||||
|
import { blue } from "colorette"
|
||||||
|
|
||||||
|
blue("I'm blue") //=> \x1b[34mI'm blue\x1b[39m
|
||||||
|
```
|
||||||
|
|
||||||
|
### createColors()
|
||||||
|
|
||||||
|
Override terminal color detection via `createColors({ useColor })`.
|
||||||
|
|
||||||
|
```js
|
||||||
|
import { createColors } from "colorette"
|
||||||
|
|
||||||
|
const { blue } = createColors({ useColor: false })
|
||||||
|
```
|
||||||
|
|
||||||
|
### isColorSupported
|
||||||
|
|
||||||
|
`true` if your terminal supports color, `false` otherwise. Used internally, but exposed for convenience.
|
||||||
|
|
||||||
|
## Environment
|
||||||
|
|
||||||
|
You can override color detection from the CLI by setting the `--no-color` or `--color` flags.
|
||||||
|
|
||||||
|
```console
|
||||||
|
$ ./example.js --no-color | ./consumer.js
|
||||||
|
```
|
||||||
|
|
||||||
|
Or if you can't use CLI flags, by setting the `NO_COLOR=` or `FORCE_COLOR=` environment variables.
|
||||||
|
|
||||||
|
```console
|
||||||
|
$ NO_COLOR= ./example.js | ./consumer.js
|
||||||
|
```
|
||||||
|
|
||||||
|
## Supported colors
|
||||||
|
|
||||||
|
| Colors | Background Colors | Bright Colors | Bright Background Colors | Modifiers |
|
||||||
|
| ------- | ----------------- | ------------- | ------------------------ | ----------------- |
|
||||||
|
| black | bgBlack | blackBright | bgBlackBright | dim |
|
||||||
|
| red | bgRed | redBright | bgRedBright | **bold** |
|
||||||
|
| green | bgGreen | greenBright | bgGreenBright | hidden |
|
||||||
|
| yellow | bgYellow | yellowBright | bgYellowBright | _italic_ |
|
||||||
|
| blue | bgBlue | blueBright | bgBlueBright | <u>underline</u> |
|
||||||
|
| magenta | bgMagenta | magentaBright | bgMagentaBright | ~~strikethrough~~ |
|
||||||
|
| cyan | bgCyan | cyanBright | bgCyanBright | reset |
|
||||||
|
| white | bgWhite | whiteBright | bgWhiteBright | |
|
||||||
|
| gray | | | | |
|
||||||
|
|
||||||
|
## [Benchmarks](https://github.com/jorgebucaran/colorette/actions/workflows/bench.yml)
|
||||||
|
|
||||||
|
```console
|
||||||
|
npm --prefix bench start
|
||||||
|
```
|
||||||
|
|
||||||
|
```diff
|
||||||
|
chalk 1,786,703 ops/sec
|
||||||
|
kleur 1,618,960 ops/sec
|
||||||
|
colors 646,823 ops/sec
|
||||||
|
ansi-colors 786,149 ops/sec
|
||||||
|
picocolors 2,871,758 ops/sec
|
||||||
|
+ colorette 3,002,751 ops/sec
|
||||||
|
```
|
||||||
|
|
||||||
|
## Acknowledgments
|
||||||
|
|
||||||
|
Colorette started out in 2015 by [@jorgebucaran](https://github.com/jorgebucaran) as a lightweight alternative to [Chalk](https://github.com/chalk/chalk) and was introduced originally as [Clor](https://github.com/jorgebucaran/colorette/commit/b01b5b9961ceb7df878583a3002e836fae9e37ce). Our terminal color detection logic borrows heavily from [@sindresorhus](https://github.com/sindresorhus) and [@Qix-](https://github.com/Qix-) work on Chalk. The idea of slicing strings to clear bleeding sequences was adapted from a similar technique used by [@alexeyraspopov](https://github.com/alexeyraspopov) in [picocolors](https://github.com/alexeyraspopov/picocolors). Thank you to all our contributors! <3
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
[MIT](LICENSE.md)
|
|
@ -0,0 +1,218 @@
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
Object.defineProperty(exports, '__esModule', { value: true });
|
||||||
|
|
||||||
|
var tty = require('tty');
|
||||||
|
|
||||||
|
function _interopNamespace(e) {
|
||||||
|
if (e && e.__esModule) return e;
|
||||||
|
var n = Object.create(null);
|
||||||
|
if (e) {
|
||||||
|
Object.keys(e).forEach(function (k) {
|
||||||
|
if (k !== 'default') {
|
||||||
|
var d = Object.getOwnPropertyDescriptor(e, k);
|
||||||
|
Object.defineProperty(n, k, d.get ? d : {
|
||||||
|
enumerable: true,
|
||||||
|
get: function () { return e[k]; }
|
||||||
|
});
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
n["default"] = e;
|
||||||
|
return Object.freeze(n);
|
||||||
|
}
|
||||||
|
|
||||||
|
var tty__namespace = /*#__PURE__*/_interopNamespace(tty);
|
||||||
|
|
||||||
|
const {
|
||||||
|
env = {},
|
||||||
|
argv = [],
|
||||||
|
platform = "",
|
||||||
|
} = typeof process === "undefined" ? {} : process;
|
||||||
|
|
||||||
|
const isDisabled = "NO_COLOR" in env || argv.includes("--no-color");
|
||||||
|
const isForced = "FORCE_COLOR" in env || argv.includes("--color");
|
||||||
|
const isWindows = platform === "win32";
|
||||||
|
const isDumbTerminal = env.TERM === "dumb";
|
||||||
|
|
||||||
|
const isCompatibleTerminal =
|
||||||
|
tty__namespace && tty__namespace.isatty && tty__namespace.isatty(1) && env.TERM && !isDumbTerminal;
|
||||||
|
|
||||||
|
const isCI =
|
||||||
|
"CI" in env &&
|
||||||
|
("GITHUB_ACTIONS" in env || "GITLAB_CI" in env || "CIRCLECI" in env);
|
||||||
|
|
||||||
|
const isColorSupported =
|
||||||
|
!isDisabled &&
|
||||||
|
(isForced || (isWindows && !isDumbTerminal) || isCompatibleTerminal || isCI);
|
||||||
|
|
||||||
|
const replaceClose = (
|
||||||
|
index,
|
||||||
|
string,
|
||||||
|
close,
|
||||||
|
replace,
|
||||||
|
head = string.substring(0, index) + replace,
|
||||||
|
tail = string.substring(index + close.length),
|
||||||
|
next = tail.indexOf(close)
|
||||||
|
) => head + (next < 0 ? tail : replaceClose(next, tail, close, replace));
|
||||||
|
|
||||||
|
const clearBleed = (index, string, open, close, replace) =>
|
||||||
|
index < 0
|
||||||
|
? open + string + close
|
||||||
|
: open + replaceClose(index, string, close, replace) + close;
|
||||||
|
|
||||||
|
const filterEmpty =
|
||||||
|
(open, close, replace = open, at = open.length + 1) =>
|
||||||
|
(string) =>
|
||||||
|
string || !(string === "" || string === undefined)
|
||||||
|
? clearBleed(
|
||||||
|
("" + string).indexOf(close, at),
|
||||||
|
string,
|
||||||
|
open,
|
||||||
|
close,
|
||||||
|
replace
|
||||||
|
)
|
||||||
|
: "";
|
||||||
|
|
||||||
|
const init = (open, close, replace) =>
|
||||||
|
filterEmpty(`\x1b[${open}m`, `\x1b[${close}m`, replace);
|
||||||
|
|
||||||
|
const colors = {
|
||||||
|
reset: init(0, 0),
|
||||||
|
bold: init(1, 22, "\x1b[22m\x1b[1m"),
|
||||||
|
dim: init(2, 22, "\x1b[22m\x1b[2m"),
|
||||||
|
italic: init(3, 23),
|
||||||
|
underline: init(4, 24),
|
||||||
|
inverse: init(7, 27),
|
||||||
|
hidden: init(8, 28),
|
||||||
|
strikethrough: init(9, 29),
|
||||||
|
black: init(30, 39),
|
||||||
|
red: init(31, 39),
|
||||||
|
green: init(32, 39),
|
||||||
|
yellow: init(33, 39),
|
||||||
|
blue: init(34, 39),
|
||||||
|
magenta: init(35, 39),
|
||||||
|
cyan: init(36, 39),
|
||||||
|
white: init(37, 39),
|
||||||
|
gray: init(90, 39),
|
||||||
|
bgBlack: init(40, 49),
|
||||||
|
bgRed: init(41, 49),
|
||||||
|
bgGreen: init(42, 49),
|
||||||
|
bgYellow: init(43, 49),
|
||||||
|
bgBlue: init(44, 49),
|
||||||
|
bgMagenta: init(45, 49),
|
||||||
|
bgCyan: init(46, 49),
|
||||||
|
bgWhite: init(47, 49),
|
||||||
|
blackBright: init(90, 39),
|
||||||
|
redBright: init(91, 39),
|
||||||
|
greenBright: init(92, 39),
|
||||||
|
yellowBright: init(93, 39),
|
||||||
|
blueBright: init(94, 39),
|
||||||
|
magentaBright: init(95, 39),
|
||||||
|
cyanBright: init(96, 39),
|
||||||
|
whiteBright: init(97, 39),
|
||||||
|
bgBlackBright: init(100, 49),
|
||||||
|
bgRedBright: init(101, 49),
|
||||||
|
bgGreenBright: init(102, 49),
|
||||||
|
bgYellowBright: init(103, 49),
|
||||||
|
bgBlueBright: init(104, 49),
|
||||||
|
bgMagentaBright: init(105, 49),
|
||||||
|
bgCyanBright: init(106, 49),
|
||||||
|
bgWhiteBright: init(107, 49),
|
||||||
|
};
|
||||||
|
|
||||||
|
const createColors = ({ useColor = isColorSupported } = {}) =>
|
||||||
|
useColor
|
||||||
|
? colors
|
||||||
|
: Object.keys(colors).reduce(
|
||||||
|
(colors, key) => ({ ...colors, [key]: String }),
|
||||||
|
{}
|
||||||
|
);
|
||||||
|
|
||||||
|
const {
|
||||||
|
reset,
|
||||||
|
bold,
|
||||||
|
dim,
|
||||||
|
italic,
|
||||||
|
underline,
|
||||||
|
inverse,
|
||||||
|
hidden,
|
||||||
|
strikethrough,
|
||||||
|
black,
|
||||||
|
red,
|
||||||
|
green,
|
||||||
|
yellow,
|
||||||
|
blue,
|
||||||
|
magenta,
|
||||||
|
cyan,
|
||||||
|
white,
|
||||||
|
gray,
|
||||||
|
bgBlack,
|
||||||
|
bgRed,
|
||||||
|
bgGreen,
|
||||||
|
bgYellow,
|
||||||
|
bgBlue,
|
||||||
|
bgMagenta,
|
||||||
|
bgCyan,
|
||||||
|
bgWhite,
|
||||||
|
blackBright,
|
||||||
|
redBright,
|
||||||
|
greenBright,
|
||||||
|
yellowBright,
|
||||||
|
blueBright,
|
||||||
|
magentaBright,
|
||||||
|
cyanBright,
|
||||||
|
whiteBright,
|
||||||
|
bgBlackBright,
|
||||||
|
bgRedBright,
|
||||||
|
bgGreenBright,
|
||||||
|
bgYellowBright,
|
||||||
|
bgBlueBright,
|
||||||
|
bgMagentaBright,
|
||||||
|
bgCyanBright,
|
||||||
|
bgWhiteBright,
|
||||||
|
} = createColors();
|
||||||
|
|
||||||
|
exports.bgBlack = bgBlack;
|
||||||
|
exports.bgBlackBright = bgBlackBright;
|
||||||
|
exports.bgBlue = bgBlue;
|
||||||
|
exports.bgBlueBright = bgBlueBright;
|
||||||
|
exports.bgCyan = bgCyan;
|
||||||
|
exports.bgCyanBright = bgCyanBright;
|
||||||
|
exports.bgGreen = bgGreen;
|
||||||
|
exports.bgGreenBright = bgGreenBright;
|
||||||
|
exports.bgMagenta = bgMagenta;
|
||||||
|
exports.bgMagentaBright = bgMagentaBright;
|
||||||
|
exports.bgRed = bgRed;
|
||||||
|
exports.bgRedBright = bgRedBright;
|
||||||
|
exports.bgWhite = bgWhite;
|
||||||
|
exports.bgWhiteBright = bgWhiteBright;
|
||||||
|
exports.bgYellow = bgYellow;
|
||||||
|
exports.bgYellowBright = bgYellowBright;
|
||||||
|
exports.black = black;
|
||||||
|
exports.blackBright = blackBright;
|
||||||
|
exports.blue = blue;
|
||||||
|
exports.blueBright = blueBright;
|
||||||
|
exports.bold = bold;
|
||||||
|
exports.createColors = createColors;
|
||||||
|
exports.cyan = cyan;
|
||||||
|
exports.cyanBright = cyanBright;
|
||||||
|
exports.dim = dim;
|
||||||
|
exports.gray = gray;
|
||||||
|
exports.green = green;
|
||||||
|
exports.greenBright = greenBright;
|
||||||
|
exports.hidden = hidden;
|
||||||
|
exports.inverse = inverse;
|
||||||
|
exports.isColorSupported = isColorSupported;
|
||||||
|
exports.italic = italic;
|
||||||
|
exports.magenta = magenta;
|
||||||
|
exports.magentaBright = magentaBright;
|
||||||
|
exports.red = red;
|
||||||
|
exports.redBright = redBright;
|
||||||
|
exports.reset = reset;
|
||||||
|
exports.strikethrough = strikethrough;
|
||||||
|
exports.underline = underline;
|
||||||
|
exports.white = white;
|
||||||
|
exports.whiteBright = whiteBright;
|
||||||
|
exports.yellow = yellow;
|
||||||
|
exports.yellowBright = yellowBright;
|
|
@ -0,0 +1,93 @@
|
||||||
|
declare module "colorette" {
|
||||||
|
type Color = (text: string | number) => string
|
||||||
|
|
||||||
|
interface Colorette {
|
||||||
|
reset: Color
|
||||||
|
bold: Color
|
||||||
|
dim: Color
|
||||||
|
italic: Color
|
||||||
|
underline: Color
|
||||||
|
inverse: Color
|
||||||
|
hidden: Color
|
||||||
|
strikethrough: Color
|
||||||
|
black: Color
|
||||||
|
red: Color
|
||||||
|
green: Color
|
||||||
|
yellow: Color
|
||||||
|
blue: Color
|
||||||
|
magenta: Color
|
||||||
|
cyan: Color
|
||||||
|
white: Color
|
||||||
|
gray: Color
|
||||||
|
bgBlack: Color
|
||||||
|
bgRed: Color
|
||||||
|
bgGreen: Color
|
||||||
|
bgYellow: Color
|
||||||
|
bgBlue: Color
|
||||||
|
bgMagenta: Color
|
||||||
|
bgCyan: Color
|
||||||
|
bgWhite: Color
|
||||||
|
blackBright: Color
|
||||||
|
redBright: Color
|
||||||
|
greenBright: Color
|
||||||
|
yellowBright: Color
|
||||||
|
blueBright: Color
|
||||||
|
magentaBright: Color
|
||||||
|
cyanBright: Color
|
||||||
|
whiteBright: Color
|
||||||
|
bgBlackBright: Color
|
||||||
|
bgRedBright: Color
|
||||||
|
bgGreenBright: Color
|
||||||
|
bgYellowBright: Color
|
||||||
|
bgBlueBright: Color
|
||||||
|
bgMagentaBright: Color
|
||||||
|
bgCyanBright: Color
|
||||||
|
bgWhiteBright: Color
|
||||||
|
}
|
||||||
|
|
||||||
|
const reset: Color
|
||||||
|
const bold: Color
|
||||||
|
const dim: Color
|
||||||
|
const italic: Color
|
||||||
|
const underline: Color
|
||||||
|
const inverse: Color
|
||||||
|
const hidden: Color
|
||||||
|
const strikethrough: Color
|
||||||
|
const black: Color
|
||||||
|
const red: Color
|
||||||
|
const green: Color
|
||||||
|
const yellow: Color
|
||||||
|
const blue: Color
|
||||||
|
const magenta: Color
|
||||||
|
const cyan: Color
|
||||||
|
const white: Color
|
||||||
|
const gray: Color
|
||||||
|
const bgBlack: Color
|
||||||
|
const bgRed: Color
|
||||||
|
const bgGreen: Color
|
||||||
|
const bgYellow: Color
|
||||||
|
const bgBlue: Color
|
||||||
|
const bgMagenta: Color
|
||||||
|
const bgCyan: Color
|
||||||
|
const bgWhite: Color
|
||||||
|
const blackBright: Color
|
||||||
|
const redBright: Color
|
||||||
|
const greenBright: Color
|
||||||
|
const yellowBright: Color
|
||||||
|
const blueBright: Color
|
||||||
|
const magentaBright: Color
|
||||||
|
const cyanBright: Color
|
||||||
|
const whiteBright: Color
|
||||||
|
const bgBlackBright: Color
|
||||||
|
const bgRedBright: Color
|
||||||
|
const bgGreenBright: Color
|
||||||
|
const bgYellowBright: Color
|
||||||
|
const bgBlueBright: Color
|
||||||
|
const bgMagentaBright: Color
|
||||||
|
const bgCyanBright: Color
|
||||||
|
const bgWhiteBright: Color
|
||||||
|
|
||||||
|
const isColorSupported: boolean
|
||||||
|
|
||||||
|
function createColors(options?: { useColor: boolean }): Colorette
|
||||||
|
}
|
|
@ -0,0 +1,150 @@
|
||||||
|
import * as tty from "tty"
|
||||||
|
|
||||||
|
const {
|
||||||
|
env = {},
|
||||||
|
argv = [],
|
||||||
|
platform = "",
|
||||||
|
} = typeof process === "undefined" ? {} : process
|
||||||
|
|
||||||
|
const isDisabled = "NO_COLOR" in env || argv.includes("--no-color")
|
||||||
|
const isForced = "FORCE_COLOR" in env || argv.includes("--color")
|
||||||
|
const isWindows = platform === "win32"
|
||||||
|
const isDumbTerminal = env.TERM === "dumb"
|
||||||
|
|
||||||
|
const isCompatibleTerminal =
|
||||||
|
tty && tty.isatty && tty.isatty(1) && env.TERM && !isDumbTerminal
|
||||||
|
|
||||||
|
const isCI =
|
||||||
|
"CI" in env &&
|
||||||
|
("GITHUB_ACTIONS" in env || "GITLAB_CI" in env || "CIRCLECI" in env)
|
||||||
|
|
||||||
|
export const isColorSupported =
|
||||||
|
!isDisabled &&
|
||||||
|
(isForced || (isWindows && !isDumbTerminal) || isCompatibleTerminal || isCI)
|
||||||
|
|
||||||
|
const replaceClose = (
|
||||||
|
index,
|
||||||
|
string,
|
||||||
|
close,
|
||||||
|
replace,
|
||||||
|
head = string.substring(0, index) + replace,
|
||||||
|
tail = string.substring(index + close.length),
|
||||||
|
next = tail.indexOf(close)
|
||||||
|
) => head + (next < 0 ? tail : replaceClose(next, tail, close, replace))
|
||||||
|
|
||||||
|
const clearBleed = (index, string, open, close, replace) =>
|
||||||
|
index < 0
|
||||||
|
? open + string + close
|
||||||
|
: open + replaceClose(index, string, close, replace) + close
|
||||||
|
|
||||||
|
const filterEmpty =
|
||||||
|
(open, close, replace = open, at = open.length + 1) =>
|
||||||
|
(string) =>
|
||||||
|
string || !(string === "" || string === undefined)
|
||||||
|
? clearBleed(
|
||||||
|
("" + string).indexOf(close, at),
|
||||||
|
string,
|
||||||
|
open,
|
||||||
|
close,
|
||||||
|
replace
|
||||||
|
)
|
||||||
|
: ""
|
||||||
|
|
||||||
|
const init = (open, close, replace) =>
|
||||||
|
filterEmpty(`\x1b[${open}m`, `\x1b[${close}m`, replace)
|
||||||
|
|
||||||
|
const colors = {
|
||||||
|
reset: init(0, 0),
|
||||||
|
bold: init(1, 22, "\x1b[22m\x1b[1m"),
|
||||||
|
dim: init(2, 22, "\x1b[22m\x1b[2m"),
|
||||||
|
italic: init(3, 23),
|
||||||
|
underline: init(4, 24),
|
||||||
|
inverse: init(7, 27),
|
||||||
|
hidden: init(8, 28),
|
||||||
|
strikethrough: init(9, 29),
|
||||||
|
black: init(30, 39),
|
||||||
|
red: init(31, 39),
|
||||||
|
green: init(32, 39),
|
||||||
|
yellow: init(33, 39),
|
||||||
|
blue: init(34, 39),
|
||||||
|
magenta: init(35, 39),
|
||||||
|
cyan: init(36, 39),
|
||||||
|
white: init(37, 39),
|
||||||
|
gray: init(90, 39),
|
||||||
|
bgBlack: init(40, 49),
|
||||||
|
bgRed: init(41, 49),
|
||||||
|
bgGreen: init(42, 49),
|
||||||
|
bgYellow: init(43, 49),
|
||||||
|
bgBlue: init(44, 49),
|
||||||
|
bgMagenta: init(45, 49),
|
||||||
|
bgCyan: init(46, 49),
|
||||||
|
bgWhite: init(47, 49),
|
||||||
|
blackBright: init(90, 39),
|
||||||
|
redBright: init(91, 39),
|
||||||
|
greenBright: init(92, 39),
|
||||||
|
yellowBright: init(93, 39),
|
||||||
|
blueBright: init(94, 39),
|
||||||
|
magentaBright: init(95, 39),
|
||||||
|
cyanBright: init(96, 39),
|
||||||
|
whiteBright: init(97, 39),
|
||||||
|
bgBlackBright: init(100, 49),
|
||||||
|
bgRedBright: init(101, 49),
|
||||||
|
bgGreenBright: init(102, 49),
|
||||||
|
bgYellowBright: init(103, 49),
|
||||||
|
bgBlueBright: init(104, 49),
|
||||||
|
bgMagentaBright: init(105, 49),
|
||||||
|
bgCyanBright: init(106, 49),
|
||||||
|
bgWhiteBright: init(107, 49),
|
||||||
|
}
|
||||||
|
|
||||||
|
export const createColors = ({ useColor = isColorSupported } = {}) =>
|
||||||
|
useColor
|
||||||
|
? colors
|
||||||
|
: Object.keys(colors).reduce(
|
||||||
|
(colors, key) => ({ ...colors, [key]: String }),
|
||||||
|
{}
|
||||||
|
)
|
||||||
|
|
||||||
|
export const {
|
||||||
|
reset,
|
||||||
|
bold,
|
||||||
|
dim,
|
||||||
|
italic,
|
||||||
|
underline,
|
||||||
|
inverse,
|
||||||
|
hidden,
|
||||||
|
strikethrough,
|
||||||
|
black,
|
||||||
|
red,
|
||||||
|
green,
|
||||||
|
yellow,
|
||||||
|
blue,
|
||||||
|
magenta,
|
||||||
|
cyan,
|
||||||
|
white,
|
||||||
|
gray,
|
||||||
|
bgBlack,
|
||||||
|
bgRed,
|
||||||
|
bgGreen,
|
||||||
|
bgYellow,
|
||||||
|
bgBlue,
|
||||||
|
bgMagenta,
|
||||||
|
bgCyan,
|
||||||
|
bgWhite,
|
||||||
|
blackBright,
|
||||||
|
redBright,
|
||||||
|
greenBright,
|
||||||
|
yellowBright,
|
||||||
|
blueBright,
|
||||||
|
magentaBright,
|
||||||
|
cyanBright,
|
||||||
|
whiteBright,
|
||||||
|
bgBlackBright,
|
||||||
|
bgRedBright,
|
||||||
|
bgGreenBright,
|
||||||
|
bgYellowBright,
|
||||||
|
bgBlueBright,
|
||||||
|
bgMagentaBright,
|
||||||
|
bgCyanBright,
|
||||||
|
bgWhiteBright,
|
||||||
|
} = createColors()
|
|
@ -0,0 +1,40 @@
|
||||||
|
{
|
||||||
|
"name": "colorette",
|
||||||
|
"version": "2.0.20",
|
||||||
|
"type": "module",
|
||||||
|
"main": "index.cjs",
|
||||||
|
"module": "index.js",
|
||||||
|
"types": "index.d.ts",
|
||||||
|
"description": "🌈Easily set your terminal text color & styles.",
|
||||||
|
"repository": "jorgebucaran/colorette",
|
||||||
|
"license": "MIT",
|
||||||
|
"exports": {
|
||||||
|
"./package.json": "./package.json",
|
||||||
|
".": {
|
||||||
|
"require": "./index.cjs",
|
||||||
|
"import": "./index.js",
|
||||||
|
"types": "./index.d.ts"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"files": [
|
||||||
|
"*.*(c)[tj]s*"
|
||||||
|
],
|
||||||
|
"author": "Jorge Bucaran",
|
||||||
|
"keywords": [
|
||||||
|
"terminal",
|
||||||
|
"styles",
|
||||||
|
"color",
|
||||||
|
"ansi"
|
||||||
|
],
|
||||||
|
"scripts": {
|
||||||
|
"test": "c8 twist tests/*.js",
|
||||||
|
"build": "npx rollup --format cjs --input index.js --file index.cjs",
|
||||||
|
"deploy": "npm test && git commit --all --message $tag && git tag --sign $tag --message $tag && git push && git push --tags",
|
||||||
|
"release": "tag=$npm_package_version npm run deploy && npm publish --access public",
|
||||||
|
"prepare": "npm run build"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"c8": "*",
|
||||||
|
"twist": "*"
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,22 @@
|
||||||
|
(The MIT License)
|
||||||
|
|
||||||
|
Copyright (c) 2011 TJ Holowaychuk <tj@vision-media.ca>
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining
|
||||||
|
a copy of this software and associated documentation files (the
|
||||||
|
'Software'), to deal in the Software without restriction, including
|
||||||
|
without limitation the rights to use, copy, modify, merge, publish,
|
||||||
|
distribute, sublicense, and/or sell copies of the Software, and to
|
||||||
|
permit persons to whom the Software is furnished to do so, subject to
|
||||||
|
the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be
|
||||||
|
included in all copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
|
||||||
|
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
||||||
|
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
||||||
|
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
||||||
|
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
||||||
|
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
||||||
|
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
File diff suppressed because it is too large
Load Diff
|
@ -0,0 +1,16 @@
|
||||||
|
import commander from './index.js';
|
||||||
|
|
||||||
|
// wrapper to provide named exports for ESM.
|
||||||
|
export const {
|
||||||
|
program,
|
||||||
|
createCommand,
|
||||||
|
createArgument,
|
||||||
|
createOption,
|
||||||
|
CommanderError,
|
||||||
|
InvalidArgumentError,
|
||||||
|
InvalidOptionArgumentError, // deprecated old name
|
||||||
|
Command,
|
||||||
|
Argument,
|
||||||
|
Option,
|
||||||
|
Help,
|
||||||
|
} = commander;
|
|
@ -0,0 +1,24 @@
|
||||||
|
const { Argument } = require('./lib/argument.js');
|
||||||
|
const { Command } = require('./lib/command.js');
|
||||||
|
const { CommanderError, InvalidArgumentError } = require('./lib/error.js');
|
||||||
|
const { Help } = require('./lib/help.js');
|
||||||
|
const { Option } = require('./lib/option.js');
|
||||||
|
|
||||||
|
exports.program = new Command();
|
||||||
|
|
||||||
|
exports.createCommand = (name) => new Command(name);
|
||||||
|
exports.createOption = (flags, description) => new Option(flags, description);
|
||||||
|
exports.createArgument = (name, description) => new Argument(name, description);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Expose classes
|
||||||
|
*/
|
||||||
|
|
||||||
|
exports.Command = Command;
|
||||||
|
exports.Option = Option;
|
||||||
|
exports.Argument = Argument;
|
||||||
|
exports.Help = Help;
|
||||||
|
|
||||||
|
exports.CommanderError = CommanderError;
|
||||||
|
exports.InvalidArgumentError = InvalidArgumentError;
|
||||||
|
exports.InvalidOptionArgumentError = InvalidArgumentError; // Deprecated
|
|
@ -0,0 +1,149 @@
|
||||||
|
const { InvalidArgumentError } = require('./error.js');
|
||||||
|
|
||||||
|
class Argument {
|
||||||
|
/**
|
||||||
|
* Initialize a new command argument with the given name and description.
|
||||||
|
* The default is that the argument is required, and you can explicitly
|
||||||
|
* indicate this with <> around the name. Put [] around the name for an optional argument.
|
||||||
|
*
|
||||||
|
* @param {string} name
|
||||||
|
* @param {string} [description]
|
||||||
|
*/
|
||||||
|
|
||||||
|
constructor(name, description) {
|
||||||
|
this.description = description || '';
|
||||||
|
this.variadic = false;
|
||||||
|
this.parseArg = undefined;
|
||||||
|
this.defaultValue = undefined;
|
||||||
|
this.defaultValueDescription = undefined;
|
||||||
|
this.argChoices = undefined;
|
||||||
|
|
||||||
|
switch (name[0]) {
|
||||||
|
case '<': // e.g. <required>
|
||||||
|
this.required = true;
|
||||||
|
this._name = name.slice(1, -1);
|
||||||
|
break;
|
||||||
|
case '[': // e.g. [optional]
|
||||||
|
this.required = false;
|
||||||
|
this._name = name.slice(1, -1);
|
||||||
|
break;
|
||||||
|
default:
|
||||||
|
this.required = true;
|
||||||
|
this._name = name;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (this._name.length > 3 && this._name.slice(-3) === '...') {
|
||||||
|
this.variadic = true;
|
||||||
|
this._name = this._name.slice(0, -3);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return argument name.
|
||||||
|
*
|
||||||
|
* @return {string}
|
||||||
|
*/
|
||||||
|
|
||||||
|
name() {
|
||||||
|
return this._name;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @package
|
||||||
|
*/
|
||||||
|
|
||||||
|
_concatValue(value, previous) {
|
||||||
|
if (previous === this.defaultValue || !Array.isArray(previous)) {
|
||||||
|
return [value];
|
||||||
|
}
|
||||||
|
|
||||||
|
return previous.concat(value);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the default value, and optionally supply the description to be displayed in the help.
|
||||||
|
*
|
||||||
|
* @param {*} value
|
||||||
|
* @param {string} [description]
|
||||||
|
* @return {Argument}
|
||||||
|
*/
|
||||||
|
|
||||||
|
default(value, description) {
|
||||||
|
this.defaultValue = value;
|
||||||
|
this.defaultValueDescription = description;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the custom handler for processing CLI command arguments into argument values.
|
||||||
|
*
|
||||||
|
* @param {Function} [fn]
|
||||||
|
* @return {Argument}
|
||||||
|
*/
|
||||||
|
|
||||||
|
argParser(fn) {
|
||||||
|
this.parseArg = fn;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Only allow argument value to be one of choices.
|
||||||
|
*
|
||||||
|
* @param {string[]} values
|
||||||
|
* @return {Argument}
|
||||||
|
*/
|
||||||
|
|
||||||
|
choices(values) {
|
||||||
|
this.argChoices = values.slice();
|
||||||
|
this.parseArg = (arg, previous) => {
|
||||||
|
if (!this.argChoices.includes(arg)) {
|
||||||
|
throw new InvalidArgumentError(
|
||||||
|
`Allowed choices are ${this.argChoices.join(', ')}.`,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
if (this.variadic) {
|
||||||
|
return this._concatValue(arg, previous);
|
||||||
|
}
|
||||||
|
return arg;
|
||||||
|
};
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Make argument required.
|
||||||
|
*
|
||||||
|
* @returns {Argument}
|
||||||
|
*/
|
||||||
|
argRequired() {
|
||||||
|
this.required = true;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Make argument optional.
|
||||||
|
*
|
||||||
|
* @returns {Argument}
|
||||||
|
*/
|
||||||
|
argOptional() {
|
||||||
|
this.required = false;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Takes an argument and returns its human readable equivalent for help usage.
|
||||||
|
*
|
||||||
|
* @param {Argument} arg
|
||||||
|
* @return {string}
|
||||||
|
* @private
|
||||||
|
*/
|
||||||
|
|
||||||
|
function humanReadableArgName(arg) {
|
||||||
|
const nameOutput = arg.name() + (arg.variadic === true ? '...' : '');
|
||||||
|
|
||||||
|
return arg.required ? '<' + nameOutput + '>' : '[' + nameOutput + ']';
|
||||||
|
}
|
||||||
|
|
||||||
|
exports.Argument = Argument;
|
||||||
|
exports.humanReadableArgName = humanReadableArgName;
|
File diff suppressed because it is too large
Load Diff
|
@ -0,0 +1,39 @@
|
||||||
|
/**
|
||||||
|
* CommanderError class
|
||||||
|
*/
|
||||||
|
class CommanderError extends Error {
|
||||||
|
/**
|
||||||
|
* Constructs the CommanderError class
|
||||||
|
* @param {number} exitCode suggested exit code which could be used with process.exit
|
||||||
|
* @param {string} code an id string representing the error
|
||||||
|
* @param {string} message human-readable description of the error
|
||||||
|
*/
|
||||||
|
constructor(exitCode, code, message) {
|
||||||
|
super(message);
|
||||||
|
// properly capture stack trace in Node.js
|
||||||
|
Error.captureStackTrace(this, this.constructor);
|
||||||
|
this.name = this.constructor.name;
|
||||||
|
this.code = code;
|
||||||
|
this.exitCode = exitCode;
|
||||||
|
this.nestedError = undefined;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* InvalidArgumentError class
|
||||||
|
*/
|
||||||
|
class InvalidArgumentError extends CommanderError {
|
||||||
|
/**
|
||||||
|
* Constructs the InvalidArgumentError class
|
||||||
|
* @param {string} [message] explanation of why argument is invalid
|
||||||
|
*/
|
||||||
|
constructor(message) {
|
||||||
|
super(1, 'commander.invalidArgument', message);
|
||||||
|
// properly capture stack trace in Node.js
|
||||||
|
Error.captureStackTrace(this, this.constructor);
|
||||||
|
this.name = this.constructor.name;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
exports.CommanderError = CommanderError;
|
||||||
|
exports.InvalidArgumentError = InvalidArgumentError;
|
|
@ -0,0 +1,520 @@
|
||||||
|
const { humanReadableArgName } = require('./argument.js');
|
||||||
|
|
||||||
|
/**
|
||||||
|
* TypeScript import types for JSDoc, used by Visual Studio Code IntelliSense and `npm run typescript-checkJS`
|
||||||
|
* https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html#import-types
|
||||||
|
* @typedef { import("./argument.js").Argument } Argument
|
||||||
|
* @typedef { import("./command.js").Command } Command
|
||||||
|
* @typedef { import("./option.js").Option } Option
|
||||||
|
*/
|
||||||
|
|
||||||
|
// Although this is a class, methods are static in style to allow override using subclass or just functions.
|
||||||
|
class Help {
|
||||||
|
constructor() {
|
||||||
|
this.helpWidth = undefined;
|
||||||
|
this.sortSubcommands = false;
|
||||||
|
this.sortOptions = false;
|
||||||
|
this.showGlobalOptions = false;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get an array of the visible subcommands. Includes a placeholder for the implicit help command, if there is one.
|
||||||
|
*
|
||||||
|
* @param {Command} cmd
|
||||||
|
* @returns {Command[]}
|
||||||
|
*/
|
||||||
|
|
||||||
|
visibleCommands(cmd) {
|
||||||
|
const visibleCommands = cmd.commands.filter((cmd) => !cmd._hidden);
|
||||||
|
const helpCommand = cmd._getHelpCommand();
|
||||||
|
if (helpCommand && !helpCommand._hidden) {
|
||||||
|
visibleCommands.push(helpCommand);
|
||||||
|
}
|
||||||
|
if (this.sortSubcommands) {
|
||||||
|
visibleCommands.sort((a, b) => {
|
||||||
|
// @ts-ignore: because overloaded return type
|
||||||
|
return a.name().localeCompare(b.name());
|
||||||
|
});
|
||||||
|
}
|
||||||
|
return visibleCommands;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Compare options for sort.
|
||||||
|
*
|
||||||
|
* @param {Option} a
|
||||||
|
* @param {Option} b
|
||||||
|
* @returns {number}
|
||||||
|
*/
|
||||||
|
compareOptions(a, b) {
|
||||||
|
const getSortKey = (option) => {
|
||||||
|
// WYSIWYG for order displayed in help. Short used for comparison if present. No special handling for negated.
|
||||||
|
return option.short
|
||||||
|
? option.short.replace(/^-/, '')
|
||||||
|
: option.long.replace(/^--/, '');
|
||||||
|
};
|
||||||
|
return getSortKey(a).localeCompare(getSortKey(b));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get an array of the visible options. Includes a placeholder for the implicit help option, if there is one.
|
||||||
|
*
|
||||||
|
* @param {Command} cmd
|
||||||
|
* @returns {Option[]}
|
||||||
|
*/
|
||||||
|
|
||||||
|
visibleOptions(cmd) {
|
||||||
|
const visibleOptions = cmd.options.filter((option) => !option.hidden);
|
||||||
|
// Built-in help option.
|
||||||
|
const helpOption = cmd._getHelpOption();
|
||||||
|
if (helpOption && !helpOption.hidden) {
|
||||||
|
// Automatically hide conflicting flags. Bit dubious but a historical behaviour that is convenient for single-command programs.
|
||||||
|
const removeShort = helpOption.short && cmd._findOption(helpOption.short);
|
||||||
|
const removeLong = helpOption.long && cmd._findOption(helpOption.long);
|
||||||
|
if (!removeShort && !removeLong) {
|
||||||
|
visibleOptions.push(helpOption); // no changes needed
|
||||||
|
} else if (helpOption.long && !removeLong) {
|
||||||
|
visibleOptions.push(
|
||||||
|
cmd.createOption(helpOption.long, helpOption.description),
|
||||||
|
);
|
||||||
|
} else if (helpOption.short && !removeShort) {
|
||||||
|
visibleOptions.push(
|
||||||
|
cmd.createOption(helpOption.short, helpOption.description),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (this.sortOptions) {
|
||||||
|
visibleOptions.sort(this.compareOptions);
|
||||||
|
}
|
||||||
|
return visibleOptions;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get an array of the visible global options. (Not including help.)
|
||||||
|
*
|
||||||
|
* @param {Command} cmd
|
||||||
|
* @returns {Option[]}
|
||||||
|
*/
|
||||||
|
|
||||||
|
visibleGlobalOptions(cmd) {
|
||||||
|
if (!this.showGlobalOptions) return [];
|
||||||
|
|
||||||
|
const globalOptions = [];
|
||||||
|
for (
|
||||||
|
let ancestorCmd = cmd.parent;
|
||||||
|
ancestorCmd;
|
||||||
|
ancestorCmd = ancestorCmd.parent
|
||||||
|
) {
|
||||||
|
const visibleOptions = ancestorCmd.options.filter(
|
||||||
|
(option) => !option.hidden,
|
||||||
|
);
|
||||||
|
globalOptions.push(...visibleOptions);
|
||||||
|
}
|
||||||
|
if (this.sortOptions) {
|
||||||
|
globalOptions.sort(this.compareOptions);
|
||||||
|
}
|
||||||
|
return globalOptions;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get an array of the arguments if any have a description.
|
||||||
|
*
|
||||||
|
* @param {Command} cmd
|
||||||
|
* @returns {Argument[]}
|
||||||
|
*/
|
||||||
|
|
||||||
|
visibleArguments(cmd) {
|
||||||
|
// Side effect! Apply the legacy descriptions before the arguments are displayed.
|
||||||
|
if (cmd._argsDescription) {
|
||||||
|
cmd.registeredArguments.forEach((argument) => {
|
||||||
|
argument.description =
|
||||||
|
argument.description || cmd._argsDescription[argument.name()] || '';
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
// If there are any arguments with a description then return all the arguments.
|
||||||
|
if (cmd.registeredArguments.find((argument) => argument.description)) {
|
||||||
|
return cmd.registeredArguments;
|
||||||
|
}
|
||||||
|
return [];
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the command term to show in the list of subcommands.
|
||||||
|
*
|
||||||
|
* @param {Command} cmd
|
||||||
|
* @returns {string}
|
||||||
|
*/
|
||||||
|
|
||||||
|
subcommandTerm(cmd) {
|
||||||
|
// Legacy. Ignores custom usage string, and nested commands.
|
||||||
|
const args = cmd.registeredArguments
|
||||||
|
.map((arg) => humanReadableArgName(arg))
|
||||||
|
.join(' ');
|
||||||
|
return (
|
||||||
|
cmd._name +
|
||||||
|
(cmd._aliases[0] ? '|' + cmd._aliases[0] : '') +
|
||||||
|
(cmd.options.length ? ' [options]' : '') + // simplistic check for non-help option
|
||||||
|
(args ? ' ' + args : '')
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the option term to show in the list of options.
|
||||||
|
*
|
||||||
|
* @param {Option} option
|
||||||
|
* @returns {string}
|
||||||
|
*/
|
||||||
|
|
||||||
|
optionTerm(option) {
|
||||||
|
return option.flags;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the argument term to show in the list of arguments.
|
||||||
|
*
|
||||||
|
* @param {Argument} argument
|
||||||
|
* @returns {string}
|
||||||
|
*/
|
||||||
|
|
||||||
|
argumentTerm(argument) {
|
||||||
|
return argument.name();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the longest command term length.
|
||||||
|
*
|
||||||
|
* @param {Command} cmd
|
||||||
|
* @param {Help} helper
|
||||||
|
* @returns {number}
|
||||||
|
*/
|
||||||
|
|
||||||
|
longestSubcommandTermLength(cmd, helper) {
|
||||||
|
return helper.visibleCommands(cmd).reduce((max, command) => {
|
||||||
|
return Math.max(max, helper.subcommandTerm(command).length);
|
||||||
|
}, 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the longest option term length.
|
||||||
|
*
|
||||||
|
* @param {Command} cmd
|
||||||
|
* @param {Help} helper
|
||||||
|
* @returns {number}
|
||||||
|
*/
|
||||||
|
|
||||||
|
longestOptionTermLength(cmd, helper) {
|
||||||
|
return helper.visibleOptions(cmd).reduce((max, option) => {
|
||||||
|
return Math.max(max, helper.optionTerm(option).length);
|
||||||
|
}, 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the longest global option term length.
|
||||||
|
*
|
||||||
|
* @param {Command} cmd
|
||||||
|
* @param {Help} helper
|
||||||
|
* @returns {number}
|
||||||
|
*/
|
||||||
|
|
||||||
|
longestGlobalOptionTermLength(cmd, helper) {
|
||||||
|
return helper.visibleGlobalOptions(cmd).reduce((max, option) => {
|
||||||
|
return Math.max(max, helper.optionTerm(option).length);
|
||||||
|
}, 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the longest argument term length.
|
||||||
|
*
|
||||||
|
* @param {Command} cmd
|
||||||
|
* @param {Help} helper
|
||||||
|
* @returns {number}
|
||||||
|
*/
|
||||||
|
|
||||||
|
longestArgumentTermLength(cmd, helper) {
|
||||||
|
return helper.visibleArguments(cmd).reduce((max, argument) => {
|
||||||
|
return Math.max(max, helper.argumentTerm(argument).length);
|
||||||
|
}, 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the command usage to be displayed at the top of the built-in help.
|
||||||
|
*
|
||||||
|
* @param {Command} cmd
|
||||||
|
* @returns {string}
|
||||||
|
*/
|
||||||
|
|
||||||
|
commandUsage(cmd) {
|
||||||
|
// Usage
|
||||||
|
let cmdName = cmd._name;
|
||||||
|
if (cmd._aliases[0]) {
|
||||||
|
cmdName = cmdName + '|' + cmd._aliases[0];
|
||||||
|
}
|
||||||
|
let ancestorCmdNames = '';
|
||||||
|
for (
|
||||||
|
let ancestorCmd = cmd.parent;
|
||||||
|
ancestorCmd;
|
||||||
|
ancestorCmd = ancestorCmd.parent
|
||||||
|
) {
|
||||||
|
ancestorCmdNames = ancestorCmd.name() + ' ' + ancestorCmdNames;
|
||||||
|
}
|
||||||
|
return ancestorCmdNames + cmdName + ' ' + cmd.usage();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the description for the command.
|
||||||
|
*
|
||||||
|
* @param {Command} cmd
|
||||||
|
* @returns {string}
|
||||||
|
*/
|
||||||
|
|
||||||
|
commandDescription(cmd) {
|
||||||
|
// @ts-ignore: because overloaded return type
|
||||||
|
return cmd.description();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the subcommand summary to show in the list of subcommands.
|
||||||
|
* (Fallback to description for backwards compatibility.)
|
||||||
|
*
|
||||||
|
* @param {Command} cmd
|
||||||
|
* @returns {string}
|
||||||
|
*/
|
||||||
|
|
||||||
|
subcommandDescription(cmd) {
|
||||||
|
// @ts-ignore: because overloaded return type
|
||||||
|
return cmd.summary() || cmd.description();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the option description to show in the list of options.
|
||||||
|
*
|
||||||
|
* @param {Option} option
|
||||||
|
* @return {string}
|
||||||
|
*/
|
||||||
|
|
||||||
|
optionDescription(option) {
|
||||||
|
const extraInfo = [];
|
||||||
|
|
||||||
|
if (option.argChoices) {
|
||||||
|
extraInfo.push(
|
||||||
|
// use stringify to match the display of the default value
|
||||||
|
`choices: ${option.argChoices.map((choice) => JSON.stringify(choice)).join(', ')}`,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
if (option.defaultValue !== undefined) {
|
||||||
|
// default for boolean and negated more for programmer than end user,
|
||||||
|
// but show true/false for boolean option as may be for hand-rolled env or config processing.
|
||||||
|
const showDefault =
|
||||||
|
option.required ||
|
||||||
|
option.optional ||
|
||||||
|
(option.isBoolean() && typeof option.defaultValue === 'boolean');
|
||||||
|
if (showDefault) {
|
||||||
|
extraInfo.push(
|
||||||
|
`default: ${option.defaultValueDescription || JSON.stringify(option.defaultValue)}`,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// preset for boolean and negated are more for programmer than end user
|
||||||
|
if (option.presetArg !== undefined && option.optional) {
|
||||||
|
extraInfo.push(`preset: ${JSON.stringify(option.presetArg)}`);
|
||||||
|
}
|
||||||
|
if (option.envVar !== undefined) {
|
||||||
|
extraInfo.push(`env: ${option.envVar}`);
|
||||||
|
}
|
||||||
|
if (extraInfo.length > 0) {
|
||||||
|
return `${option.description} (${extraInfo.join(', ')})`;
|
||||||
|
}
|
||||||
|
|
||||||
|
return option.description;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the argument description to show in the list of arguments.
|
||||||
|
*
|
||||||
|
* @param {Argument} argument
|
||||||
|
* @return {string}
|
||||||
|
*/
|
||||||
|
|
||||||
|
argumentDescription(argument) {
|
||||||
|
const extraInfo = [];
|
||||||
|
if (argument.argChoices) {
|
||||||
|
extraInfo.push(
|
||||||
|
// use stringify to match the display of the default value
|
||||||
|
`choices: ${argument.argChoices.map((choice) => JSON.stringify(choice)).join(', ')}`,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
if (argument.defaultValue !== undefined) {
|
||||||
|
extraInfo.push(
|
||||||
|
`default: ${argument.defaultValueDescription || JSON.stringify(argument.defaultValue)}`,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
if (extraInfo.length > 0) {
|
||||||
|
const extraDescripton = `(${extraInfo.join(', ')})`;
|
||||||
|
if (argument.description) {
|
||||||
|
return `${argument.description} ${extraDescripton}`;
|
||||||
|
}
|
||||||
|
return extraDescripton;
|
||||||
|
}
|
||||||
|
return argument.description;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Generate the built-in help text.
|
||||||
|
*
|
||||||
|
* @param {Command} cmd
|
||||||
|
* @param {Help} helper
|
||||||
|
* @returns {string}
|
||||||
|
*/
|
||||||
|
|
||||||
|
formatHelp(cmd, helper) {
|
||||||
|
const termWidth = helper.padWidth(cmd, helper);
|
||||||
|
const helpWidth = helper.helpWidth || 80;
|
||||||
|
const itemIndentWidth = 2;
|
||||||
|
const itemSeparatorWidth = 2; // between term and description
|
||||||
|
function formatItem(term, description) {
|
||||||
|
if (description) {
|
||||||
|
const fullText = `${term.padEnd(termWidth + itemSeparatorWidth)}${description}`;
|
||||||
|
return helper.wrap(
|
||||||
|
fullText,
|
||||||
|
helpWidth - itemIndentWidth,
|
||||||
|
termWidth + itemSeparatorWidth,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return term;
|
||||||
|
}
|
||||||
|
function formatList(textArray) {
|
||||||
|
return textArray.join('\n').replace(/^/gm, ' '.repeat(itemIndentWidth));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Usage
|
||||||
|
let output = [`Usage: ${helper.commandUsage(cmd)}`, ''];
|
||||||
|
|
||||||
|
// Description
|
||||||
|
const commandDescription = helper.commandDescription(cmd);
|
||||||
|
if (commandDescription.length > 0) {
|
||||||
|
output = output.concat([
|
||||||
|
helper.wrap(commandDescription, helpWidth, 0),
|
||||||
|
'',
|
||||||
|
]);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Arguments
|
||||||
|
const argumentList = helper.visibleArguments(cmd).map((argument) => {
|
||||||
|
return formatItem(
|
||||||
|
helper.argumentTerm(argument),
|
||||||
|
helper.argumentDescription(argument),
|
||||||
|
);
|
||||||
|
});
|
||||||
|
if (argumentList.length > 0) {
|
||||||
|
output = output.concat(['Arguments:', formatList(argumentList), '']);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Options
|
||||||
|
const optionList = helper.visibleOptions(cmd).map((option) => {
|
||||||
|
return formatItem(
|
||||||
|
helper.optionTerm(option),
|
||||||
|
helper.optionDescription(option),
|
||||||
|
);
|
||||||
|
});
|
||||||
|
if (optionList.length > 0) {
|
||||||
|
output = output.concat(['Options:', formatList(optionList), '']);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (this.showGlobalOptions) {
|
||||||
|
const globalOptionList = helper
|
||||||
|
.visibleGlobalOptions(cmd)
|
||||||
|
.map((option) => {
|
||||||
|
return formatItem(
|
||||||
|
helper.optionTerm(option),
|
||||||
|
helper.optionDescription(option),
|
||||||
|
);
|
||||||
|
});
|
||||||
|
if (globalOptionList.length > 0) {
|
||||||
|
output = output.concat([
|
||||||
|
'Global Options:',
|
||||||
|
formatList(globalOptionList),
|
||||||
|
'',
|
||||||
|
]);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Commands
|
||||||
|
const commandList = helper.visibleCommands(cmd).map((cmd) => {
|
||||||
|
return formatItem(
|
||||||
|
helper.subcommandTerm(cmd),
|
||||||
|
helper.subcommandDescription(cmd),
|
||||||
|
);
|
||||||
|
});
|
||||||
|
if (commandList.length > 0) {
|
||||||
|
output = output.concat(['Commands:', formatList(commandList), '']);
|
||||||
|
}
|
||||||
|
|
||||||
|
return output.join('\n');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Calculate the pad width from the maximum term length.
|
||||||
|
*
|
||||||
|
* @param {Command} cmd
|
||||||
|
* @param {Help} helper
|
||||||
|
* @returns {number}
|
||||||
|
*/
|
||||||
|
|
||||||
|
padWidth(cmd, helper) {
|
||||||
|
return Math.max(
|
||||||
|
helper.longestOptionTermLength(cmd, helper),
|
||||||
|
helper.longestGlobalOptionTermLength(cmd, helper),
|
||||||
|
helper.longestSubcommandTermLength(cmd, helper),
|
||||||
|
helper.longestArgumentTermLength(cmd, helper),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Wrap the given string to width characters per line, with lines after the first indented.
|
||||||
|
* Do not wrap if insufficient room for wrapping (minColumnWidth), or string is manually formatted.
|
||||||
|
*
|
||||||
|
* @param {string} str
|
||||||
|
* @param {number} width
|
||||||
|
* @param {number} indent
|
||||||
|
* @param {number} [minColumnWidth=40]
|
||||||
|
* @return {string}
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
|
||||||
|
wrap(str, width, indent, minColumnWidth = 40) {
|
||||||
|
// Full \s characters, minus the linefeeds.
|
||||||
|
const indents =
|
||||||
|
' \\f\\t\\v\u00a0\u1680\u2000-\u200a\u202f\u205f\u3000\ufeff';
|
||||||
|
// Detect manually wrapped and indented strings by searching for line break followed by spaces.
|
||||||
|
const manualIndent = new RegExp(`[\\n][${indents}]+`);
|
||||||
|
if (str.match(manualIndent)) return str;
|
||||||
|
// Do not wrap if not enough room for a wrapped column of text (as could end up with a word per line).
|
||||||
|
const columnWidth = width - indent;
|
||||||
|
if (columnWidth < minColumnWidth) return str;
|
||||||
|
|
||||||
|
const leadingStr = str.slice(0, indent);
|
||||||
|
const columnText = str.slice(indent).replace('\r\n', '\n');
|
||||||
|
const indentString = ' '.repeat(indent);
|
||||||
|
const zeroWidthSpace = '\u200B';
|
||||||
|
const breaks = `\\s${zeroWidthSpace}`;
|
||||||
|
// Match line end (so empty lines don't collapse),
|
||||||
|
// or as much text as will fit in column, or excess text up to first break.
|
||||||
|
const regex = new RegExp(
|
||||||
|
`\n|.{1,${columnWidth - 1}}([${breaks}]|$)|[^${breaks}]+?([${breaks}]|$)`,
|
||||||
|
'g',
|
||||||
|
);
|
||||||
|
const lines = columnText.match(regex) || [];
|
||||||
|
return (
|
||||||
|
leadingStr +
|
||||||
|
lines
|
||||||
|
.map((line, i) => {
|
||||||
|
if (line === '\n') return ''; // preserve empty lines
|
||||||
|
return (i > 0 ? indentString : '') + line.trimEnd();
|
||||||
|
})
|
||||||
|
.join('\n')
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
exports.Help = Help;
|
|
@ -0,0 +1,330 @@
|
||||||
|
const { InvalidArgumentError } = require('./error.js');
|
||||||
|
|
||||||
|
class Option {
|
||||||
|
/**
|
||||||
|
* Initialize a new `Option` with the given `flags` and `description`.
|
||||||
|
*
|
||||||
|
* @param {string} flags
|
||||||
|
* @param {string} [description]
|
||||||
|
*/
|
||||||
|
|
||||||
|
constructor(flags, description) {
|
||||||
|
this.flags = flags;
|
||||||
|
this.description = description || '';
|
||||||
|
|
||||||
|
this.required = flags.includes('<'); // A value must be supplied when the option is specified.
|
||||||
|
this.optional = flags.includes('['); // A value is optional when the option is specified.
|
||||||
|
// variadic test ignores <value,...> et al which might be used to describe custom splitting of single argument
|
||||||
|
this.variadic = /\w\.\.\.[>\]]$/.test(flags); // The option can take multiple values.
|
||||||
|
this.mandatory = false; // The option must have a value after parsing, which usually means it must be specified on command line.
|
||||||
|
const optionFlags = splitOptionFlags(flags);
|
||||||
|
this.short = optionFlags.shortFlag;
|
||||||
|
this.long = optionFlags.longFlag;
|
||||||
|
this.negate = false;
|
||||||
|
if (this.long) {
|
||||||
|
this.negate = this.long.startsWith('--no-');
|
||||||
|
}
|
||||||
|
this.defaultValue = undefined;
|
||||||
|
this.defaultValueDescription = undefined;
|
||||||
|
this.presetArg = undefined;
|
||||||
|
this.envVar = undefined;
|
||||||
|
this.parseArg = undefined;
|
||||||
|
this.hidden = false;
|
||||||
|
this.argChoices = undefined;
|
||||||
|
this.conflictsWith = [];
|
||||||
|
this.implied = undefined;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the default value, and optionally supply the description to be displayed in the help.
|
||||||
|
*
|
||||||
|
* @param {*} value
|
||||||
|
* @param {string} [description]
|
||||||
|
* @return {Option}
|
||||||
|
*/
|
||||||
|
|
||||||
|
default(value, description) {
|
||||||
|
this.defaultValue = value;
|
||||||
|
this.defaultValueDescription = description;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Preset to use when option used without option-argument, especially optional but also boolean and negated.
|
||||||
|
* The custom processing (parseArg) is called.
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* new Option('--color').default('GREYSCALE').preset('RGB');
|
||||||
|
* new Option('--donate [amount]').preset('20').argParser(parseFloat);
|
||||||
|
*
|
||||||
|
* @param {*} arg
|
||||||
|
* @return {Option}
|
||||||
|
*/
|
||||||
|
|
||||||
|
preset(arg) {
|
||||||
|
this.presetArg = arg;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add option name(s) that conflict with this option.
|
||||||
|
* An error will be displayed if conflicting options are found during parsing.
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* new Option('--rgb').conflicts('cmyk');
|
||||||
|
* new Option('--js').conflicts(['ts', 'jsx']);
|
||||||
|
*
|
||||||
|
* @param {(string | string[])} names
|
||||||
|
* @return {Option}
|
||||||
|
*/
|
||||||
|
|
||||||
|
conflicts(names) {
|
||||||
|
this.conflictsWith = this.conflictsWith.concat(names);
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specify implied option values for when this option is set and the implied options are not.
|
||||||
|
*
|
||||||
|
* The custom processing (parseArg) is not called on the implied values.
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* program
|
||||||
|
* .addOption(new Option('--log', 'write logging information to file'))
|
||||||
|
* .addOption(new Option('--trace', 'log extra details').implies({ log: 'trace.txt' }));
|
||||||
|
*
|
||||||
|
* @param {object} impliedOptionValues
|
||||||
|
* @return {Option}
|
||||||
|
*/
|
||||||
|
implies(impliedOptionValues) {
|
||||||
|
let newImplied = impliedOptionValues;
|
||||||
|
if (typeof impliedOptionValues === 'string') {
|
||||||
|
// string is not documented, but easy mistake and we can do what user probably intended.
|
||||||
|
newImplied = { [impliedOptionValues]: true };
|
||||||
|
}
|
||||||
|
this.implied = Object.assign(this.implied || {}, newImplied);
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set environment variable to check for option value.
|
||||||
|
*
|
||||||
|
* An environment variable is only used if when processed the current option value is
|
||||||
|
* undefined, or the source of the current value is 'default' or 'config' or 'env'.
|
||||||
|
*
|
||||||
|
* @param {string} name
|
||||||
|
* @return {Option}
|
||||||
|
*/
|
||||||
|
|
||||||
|
env(name) {
|
||||||
|
this.envVar = name;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the custom handler for processing CLI option arguments into option values.
|
||||||
|
*
|
||||||
|
* @param {Function} [fn]
|
||||||
|
* @return {Option}
|
||||||
|
*/
|
||||||
|
|
||||||
|
argParser(fn) {
|
||||||
|
this.parseArg = fn;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Whether the option is mandatory and must have a value after parsing.
|
||||||
|
*
|
||||||
|
* @param {boolean} [mandatory=true]
|
||||||
|
* @return {Option}
|
||||||
|
*/
|
||||||
|
|
||||||
|
makeOptionMandatory(mandatory = true) {
|
||||||
|
this.mandatory = !!mandatory;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Hide option in help.
|
||||||
|
*
|
||||||
|
* @param {boolean} [hide=true]
|
||||||
|
* @return {Option}
|
||||||
|
*/
|
||||||
|
|
||||||
|
hideHelp(hide = true) {
|
||||||
|
this.hidden = !!hide;
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @package
|
||||||
|
*/
|
||||||
|
|
||||||
|
_concatValue(value, previous) {
|
||||||
|
if (previous === this.defaultValue || !Array.isArray(previous)) {
|
||||||
|
return [value];
|
||||||
|
}
|
||||||
|
|
||||||
|
return previous.concat(value);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Only allow option value to be one of choices.
|
||||||
|
*
|
||||||
|
* @param {string[]} values
|
||||||
|
* @return {Option}
|
||||||
|
*/
|
||||||
|
|
||||||
|
choices(values) {
|
||||||
|
this.argChoices = values.slice();
|
||||||
|
this.parseArg = (arg, previous) => {
|
||||||
|
if (!this.argChoices.includes(arg)) {
|
||||||
|
throw new InvalidArgumentError(
|
||||||
|
`Allowed choices are ${this.argChoices.join(', ')}.`,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
if (this.variadic) {
|
||||||
|
return this._concatValue(arg, previous);
|
||||||
|
}
|
||||||
|
return arg;
|
||||||
|
};
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return option name.
|
||||||
|
*
|
||||||
|
* @return {string}
|
||||||
|
*/
|
||||||
|
|
||||||
|
name() {
|
||||||
|
if (this.long) {
|
||||||
|
return this.long.replace(/^--/, '');
|
||||||
|
}
|
||||||
|
return this.short.replace(/^-/, '');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return option name, in a camelcase format that can be used
|
||||||
|
* as a object attribute key.
|
||||||
|
*
|
||||||
|
* @return {string}
|
||||||
|
*/
|
||||||
|
|
||||||
|
attributeName() {
|
||||||
|
return camelcase(this.name().replace(/^no-/, ''));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Check if `arg` matches the short or long flag.
|
||||||
|
*
|
||||||
|
* @param {string} arg
|
||||||
|
* @return {boolean}
|
||||||
|
* @package
|
||||||
|
*/
|
||||||
|
|
||||||
|
is(arg) {
|
||||||
|
return this.short === arg || this.long === arg;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return whether a boolean option.
|
||||||
|
*
|
||||||
|
* Options are one of boolean, negated, required argument, or optional argument.
|
||||||
|
*
|
||||||
|
* @return {boolean}
|
||||||
|
* @package
|
||||||
|
*/
|
||||||
|
|
||||||
|
isBoolean() {
|
||||||
|
return !this.required && !this.optional && !this.negate;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This class is to make it easier to work with dual options, without changing the existing
|
||||||
|
* implementation. We support separate dual options for separate positive and negative options,
|
||||||
|
* like `--build` and `--no-build`, which share a single option value. This works nicely for some
|
||||||
|
* use cases, but is tricky for others where we want separate behaviours despite
|
||||||
|
* the single shared option value.
|
||||||
|
*/
|
||||||
|
class DualOptions {
|
||||||
|
/**
|
||||||
|
* @param {Option[]} options
|
||||||
|
*/
|
||||||
|
constructor(options) {
|
||||||
|
this.positiveOptions = new Map();
|
||||||
|
this.negativeOptions = new Map();
|
||||||
|
this.dualOptions = new Set();
|
||||||
|
options.forEach((option) => {
|
||||||
|
if (option.negate) {
|
||||||
|
this.negativeOptions.set(option.attributeName(), option);
|
||||||
|
} else {
|
||||||
|
this.positiveOptions.set(option.attributeName(), option);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
this.negativeOptions.forEach((value, key) => {
|
||||||
|
if (this.positiveOptions.has(key)) {
|
||||||
|
this.dualOptions.add(key);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Did the value come from the option, and not from possible matching dual option?
|
||||||
|
*
|
||||||
|
* @param {*} value
|
||||||
|
* @param {Option} option
|
||||||
|
* @returns {boolean}
|
||||||
|
*/
|
||||||
|
valueFromOption(value, option) {
|
||||||
|
const optionKey = option.attributeName();
|
||||||
|
if (!this.dualOptions.has(optionKey)) return true;
|
||||||
|
|
||||||
|
// Use the value to deduce if (probably) came from the option.
|
||||||
|
const preset = this.negativeOptions.get(optionKey).presetArg;
|
||||||
|
const negativeValue = preset !== undefined ? preset : false;
|
||||||
|
return option.negate === (negativeValue === value);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Convert string from kebab-case to camelCase.
|
||||||
|
*
|
||||||
|
* @param {string} str
|
||||||
|
* @return {string}
|
||||||
|
* @private
|
||||||
|
*/
|
||||||
|
|
||||||
|
function camelcase(str) {
|
||||||
|
return str.split('-').reduce((str, word) => {
|
||||||
|
return str + word[0].toUpperCase() + word.slice(1);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Split the short and long flag out of something like '-m,--mixed <value>'
|
||||||
|
*
|
||||||
|
* @private
|
||||||
|
*/
|
||||||
|
|
||||||
|
function splitOptionFlags(flags) {
|
||||||
|
let shortFlag;
|
||||||
|
let longFlag;
|
||||||
|
// Use original very loose parsing to maintain backwards compatibility for now,
|
||||||
|
// which allowed for example unintended `-sw, --short-word` [sic].
|
||||||
|
const flagParts = flags.split(/[ |,]+/);
|
||||||
|
if (flagParts.length > 1 && !/^[[<]/.test(flagParts[1]))
|
||||||
|
shortFlag = flagParts.shift();
|
||||||
|
longFlag = flagParts.shift();
|
||||||
|
// Add support for lone short flag without significantly changing parsing!
|
||||||
|
if (!shortFlag && /^-[^-]$/.test(longFlag)) {
|
||||||
|
shortFlag = longFlag;
|
||||||
|
longFlag = undefined;
|
||||||
|
}
|
||||||
|
return { shortFlag, longFlag };
|
||||||
|
}
|
||||||
|
|
||||||
|
exports.Option = Option;
|
||||||
|
exports.DualOptions = DualOptions;
|
|
@ -0,0 +1,101 @@
|
||||||
|
const maxDistance = 3;
|
||||||
|
|
||||||
|
function editDistance(a, b) {
|
||||||
|
// https://en.wikipedia.org/wiki/Damerau–Levenshtein_distance
|
||||||
|
// Calculating optimal string alignment distance, no substring is edited more than once.
|
||||||
|
// (Simple implementation.)
|
||||||
|
|
||||||
|
// Quick early exit, return worst case.
|
||||||
|
if (Math.abs(a.length - b.length) > maxDistance)
|
||||||
|
return Math.max(a.length, b.length);
|
||||||
|
|
||||||
|
// distance between prefix substrings of a and b
|
||||||
|
const d = [];
|
||||||
|
|
||||||
|
// pure deletions turn a into empty string
|
||||||
|
for (let i = 0; i <= a.length; i++) {
|
||||||
|
d[i] = [i];
|
||||||
|
}
|
||||||
|
// pure insertions turn empty string into b
|
||||||
|
for (let j = 0; j <= b.length; j++) {
|
||||||
|
d[0][j] = j;
|
||||||
|
}
|
||||||
|
|
||||||
|
// fill matrix
|
||||||
|
for (let j = 1; j <= b.length; j++) {
|
||||||
|
for (let i = 1; i <= a.length; i++) {
|
||||||
|
let cost = 1;
|
||||||
|
if (a[i - 1] === b[j - 1]) {
|
||||||
|
cost = 0;
|
||||||
|
} else {
|
||||||
|
cost = 1;
|
||||||
|
}
|
||||||
|
d[i][j] = Math.min(
|
||||||
|
d[i - 1][j] + 1, // deletion
|
||||||
|
d[i][j - 1] + 1, // insertion
|
||||||
|
d[i - 1][j - 1] + cost, // substitution
|
||||||
|
);
|
||||||
|
// transposition
|
||||||
|
if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
|
||||||
|
d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return d[a.length][b.length];
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Find close matches, restricted to same number of edits.
|
||||||
|
*
|
||||||
|
* @param {string} word
|
||||||
|
* @param {string[]} candidates
|
||||||
|
* @returns {string}
|
||||||
|
*/
|
||||||
|
|
||||||
|
function suggestSimilar(word, candidates) {
|
||||||
|
if (!candidates || candidates.length === 0) return '';
|
||||||
|
// remove possible duplicates
|
||||||
|
candidates = Array.from(new Set(candidates));
|
||||||
|
|
||||||
|
const searchingOptions = word.startsWith('--');
|
||||||
|
if (searchingOptions) {
|
||||||
|
word = word.slice(2);
|
||||||
|
candidates = candidates.map((candidate) => candidate.slice(2));
|
||||||
|
}
|
||||||
|
|
||||||
|
let similar = [];
|
||||||
|
let bestDistance = maxDistance;
|
||||||
|
const minSimilarity = 0.4;
|
||||||
|
candidates.forEach((candidate) => {
|
||||||
|
if (candidate.length <= 1) return; // no one character guesses
|
||||||
|
|
||||||
|
const distance = editDistance(word, candidate);
|
||||||
|
const length = Math.max(word.length, candidate.length);
|
||||||
|
const similarity = (length - distance) / length;
|
||||||
|
if (similarity > minSimilarity) {
|
||||||
|
if (distance < bestDistance) {
|
||||||
|
// better edit distance, throw away previous worse matches
|
||||||
|
bestDistance = distance;
|
||||||
|
similar = [candidate];
|
||||||
|
} else if (distance === bestDistance) {
|
||||||
|
similar.push(candidate);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
similar.sort((a, b) => a.localeCompare(b));
|
||||||
|
if (searchingOptions) {
|
||||||
|
similar = similar.map((candidate) => `--${candidate}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (similar.length > 1) {
|
||||||
|
return `\n(Did you mean one of ${similar.join(', ')}?)`;
|
||||||
|
}
|
||||||
|
if (similar.length === 1) {
|
||||||
|
return `\n(Did you mean ${similar[0]}?)`;
|
||||||
|
}
|
||||||
|
return '';
|
||||||
|
}
|
||||||
|
|
||||||
|
exports.suggestSimilar = suggestSimilar;
|
|
@ -0,0 +1,16 @@
|
||||||
|
{
|
||||||
|
"versions": [
|
||||||
|
{
|
||||||
|
"version": "*",
|
||||||
|
"target": {
|
||||||
|
"node": "supported"
|
||||||
|
},
|
||||||
|
"response": {
|
||||||
|
"type": "time-permitting"
|
||||||
|
},
|
||||||
|
"backing": {
|
||||||
|
"npm-funding": true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
|
@ -0,0 +1,84 @@
|
||||||
|
{
|
||||||
|
"name": "commander",
|
||||||
|
"version": "12.1.0",
|
||||||
|
"description": "the complete solution for node.js command-line programs",
|
||||||
|
"keywords": [
|
||||||
|
"commander",
|
||||||
|
"command",
|
||||||
|
"option",
|
||||||
|
"parser",
|
||||||
|
"cli",
|
||||||
|
"argument",
|
||||||
|
"args",
|
||||||
|
"argv"
|
||||||
|
],
|
||||||
|
"author": "TJ Holowaychuk <tj@vision-media.ca>",
|
||||||
|
"license": "MIT",
|
||||||
|
"repository": {
|
||||||
|
"type": "git",
|
||||||
|
"url": "git+https://github.com/tj/commander.js.git"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"check": "npm run check:type && npm run check:lint && npm run check:format",
|
||||||
|
"check:format": "prettier --check .",
|
||||||
|
"check:lint": "eslint .",
|
||||||
|
"check:type": "npm run check:type:js && npm run check:type:ts",
|
||||||
|
"check:type:ts": "tsd && tsc -p tsconfig.ts.json",
|
||||||
|
"check:type:js": "tsc -p tsconfig.js.json",
|
||||||
|
"fix": "npm run fix:lint && npm run fix:format",
|
||||||
|
"fix:format": "prettier --write .",
|
||||||
|
"fix:lint": "eslint --fix .",
|
||||||
|
"test": "jest && npm run check:type:ts",
|
||||||
|
"test-all": "jest && npm run test-esm && npm run check",
|
||||||
|
"test-esm": "node ./tests/esm-imports-test.mjs"
|
||||||
|
},
|
||||||
|
"files": [
|
||||||
|
"index.js",
|
||||||
|
"lib/*.js",
|
||||||
|
"esm.mjs",
|
||||||
|
"typings/index.d.ts",
|
||||||
|
"typings/esm.d.mts",
|
||||||
|
"package-support.json"
|
||||||
|
],
|
||||||
|
"type": "commonjs",
|
||||||
|
"main": "./index.js",
|
||||||
|
"exports": {
|
||||||
|
".": {
|
||||||
|
"require": {
|
||||||
|
"types": "./typings/index.d.ts",
|
||||||
|
"default": "./index.js"
|
||||||
|
},
|
||||||
|
"import": {
|
||||||
|
"types": "./typings/esm.d.mts",
|
||||||
|
"default": "./esm.mjs"
|
||||||
|
},
|
||||||
|
"default": "./index.js"
|
||||||
|
},
|
||||||
|
"./esm.mjs": {
|
||||||
|
"types": "./typings/esm.d.mts",
|
||||||
|
"import": "./esm.mjs"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@eslint/js": "^8.56.0",
|
||||||
|
"@types/jest": "^29.2.4",
|
||||||
|
"@types/node": "^20.2.5",
|
||||||
|
"eslint": "^8.30.0",
|
||||||
|
"eslint-config-prettier": "^9.1.0",
|
||||||
|
"eslint-plugin-jest": "^28.3.0",
|
||||||
|
"eslint-plugin-jsdoc": "^48.1.0",
|
||||||
|
"globals": "^13.24.0",
|
||||||
|
"jest": "^29.3.1",
|
||||||
|
"prettier": "^3.2.5",
|
||||||
|
"prettier-plugin-jsdoc": "^1.3.0",
|
||||||
|
"ts-jest": "^29.0.3",
|
||||||
|
"tsd": "^0.31.0",
|
||||||
|
"typescript": "^5.0.4",
|
||||||
|
"typescript-eslint": "^7.0.1"
|
||||||
|
},
|
||||||
|
"types": "typings/index.d.ts",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"support": true
|
||||||
|
}
|
|
@ -0,0 +1,3 @@
|
||||||
|
// Just reexport the types from cjs
|
||||||
|
// This is a bit indirect. There is not an index.js, but TypeScript will look for index.d.ts for types.
|
||||||
|
export * from './index.js';
|
|
@ -0,0 +1,969 @@
|
||||||
|
// Type definitions for commander
|
||||||
|
// Original definitions by: Alan Agius <https://github.com/alan-agius4>, Marcelo Dezem <https://github.com/mdezem>, vvakame <https://github.com/vvakame>, Jules Randolph <https://github.com/sveinburne>
|
||||||
|
|
||||||
|
// Using method rather than property for method-signature-style, to document method overloads separately. Allow either.
|
||||||
|
/* eslint-disable @typescript-eslint/method-signature-style */
|
||||||
|
/* eslint-disable @typescript-eslint/no-explicit-any */
|
||||||
|
|
||||||
|
// This is a trick to encourage editor to suggest the known literals while still
|
||||||
|
// allowing any BaseType value.
|
||||||
|
// References:
|
||||||
|
// - https://github.com/microsoft/TypeScript/issues/29729
|
||||||
|
// - https://github.com/sindresorhus/type-fest/blob/main/source/literal-union.d.ts
|
||||||
|
// - https://github.com/sindresorhus/type-fest/blob/main/source/primitive.d.ts
|
||||||
|
type LiteralUnion<LiteralType, BaseType extends string | number> =
|
||||||
|
| LiteralType
|
||||||
|
| (BaseType & Record<never, never>);
|
||||||
|
|
||||||
|
export class CommanderError extends Error {
|
||||||
|
code: string;
|
||||||
|
exitCode: number;
|
||||||
|
message: string;
|
||||||
|
nestedError?: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructs the CommanderError class
|
||||||
|
* @param exitCode - suggested exit code which could be used with process.exit
|
||||||
|
* @param code - an id string representing the error
|
||||||
|
* @param message - human-readable description of the error
|
||||||
|
*/
|
||||||
|
constructor(exitCode: number, code: string, message: string);
|
||||||
|
}
|
||||||
|
|
||||||
|
export class InvalidArgumentError extends CommanderError {
|
||||||
|
/**
|
||||||
|
* Constructs the InvalidArgumentError class
|
||||||
|
* @param message - explanation of why argument is invalid
|
||||||
|
*/
|
||||||
|
constructor(message: string);
|
||||||
|
}
|
||||||
|
export { InvalidArgumentError as InvalidOptionArgumentError }; // deprecated old name
|
||||||
|
|
||||||
|
export interface ErrorOptions {
|
||||||
|
// optional parameter for error()
|
||||||
|
/** an id string representing the error */
|
||||||
|
code?: string;
|
||||||
|
/** suggested exit code which could be used with process.exit */
|
||||||
|
exitCode?: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
export class Argument {
|
||||||
|
description: string;
|
||||||
|
required: boolean;
|
||||||
|
variadic: boolean;
|
||||||
|
defaultValue?: any;
|
||||||
|
defaultValueDescription?: string;
|
||||||
|
argChoices?: string[];
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Initialize a new command argument with the given name and description.
|
||||||
|
* The default is that the argument is required, and you can explicitly
|
||||||
|
* indicate this with <> around the name. Put [] around the name for an optional argument.
|
||||||
|
*/
|
||||||
|
constructor(arg: string, description?: string);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return argument name.
|
||||||
|
*/
|
||||||
|
name(): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the default value, and optionally supply the description to be displayed in the help.
|
||||||
|
*/
|
||||||
|
default(value: unknown, description?: string): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the custom handler for processing CLI command arguments into argument values.
|
||||||
|
*/
|
||||||
|
argParser<T>(fn: (value: string, previous: T) => T): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Only allow argument value to be one of choices.
|
||||||
|
*/
|
||||||
|
choices(values: readonly string[]): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Make argument required.
|
||||||
|
*/
|
||||||
|
argRequired(): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Make argument optional.
|
||||||
|
*/
|
||||||
|
argOptional(): this;
|
||||||
|
}
|
||||||
|
|
||||||
|
export class Option {
|
||||||
|
flags: string;
|
||||||
|
description: string;
|
||||||
|
|
||||||
|
required: boolean; // A value must be supplied when the option is specified.
|
||||||
|
optional: boolean; // A value is optional when the option is specified.
|
||||||
|
variadic: boolean;
|
||||||
|
mandatory: boolean; // The option must have a value after parsing, which usually means it must be specified on command line.
|
||||||
|
short?: string;
|
||||||
|
long?: string;
|
||||||
|
negate: boolean;
|
||||||
|
defaultValue?: any;
|
||||||
|
defaultValueDescription?: string;
|
||||||
|
presetArg?: unknown;
|
||||||
|
envVar?: string;
|
||||||
|
parseArg?: <T>(value: string, previous: T) => T;
|
||||||
|
hidden: boolean;
|
||||||
|
argChoices?: string[];
|
||||||
|
|
||||||
|
constructor(flags: string, description?: string);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the default value, and optionally supply the description to be displayed in the help.
|
||||||
|
*/
|
||||||
|
default(value: unknown, description?: string): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Preset to use when option used without option-argument, especially optional but also boolean and negated.
|
||||||
|
* The custom processing (parseArg) is called.
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* ```ts
|
||||||
|
* new Option('--color').default('GREYSCALE').preset('RGB');
|
||||||
|
* new Option('--donate [amount]').preset('20').argParser(parseFloat);
|
||||||
|
* ```
|
||||||
|
*/
|
||||||
|
preset(arg: unknown): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add option name(s) that conflict with this option.
|
||||||
|
* An error will be displayed if conflicting options are found during parsing.
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* ```ts
|
||||||
|
* new Option('--rgb').conflicts('cmyk');
|
||||||
|
* new Option('--js').conflicts(['ts', 'jsx']);
|
||||||
|
* ```
|
||||||
|
*/
|
||||||
|
conflicts(names: string | string[]): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Specify implied option values for when this option is set and the implied options are not.
|
||||||
|
*
|
||||||
|
* The custom processing (parseArg) is not called on the implied values.
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* program
|
||||||
|
* .addOption(new Option('--log', 'write logging information to file'))
|
||||||
|
* .addOption(new Option('--trace', 'log extra details').implies({ log: 'trace.txt' }));
|
||||||
|
*/
|
||||||
|
implies(optionValues: OptionValues): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set environment variable to check for option value.
|
||||||
|
*
|
||||||
|
* An environment variables is only used if when processed the current option value is
|
||||||
|
* undefined, or the source of the current value is 'default' or 'config' or 'env'.
|
||||||
|
*/
|
||||||
|
env(name: string): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the custom handler for processing CLI option arguments into option values.
|
||||||
|
*/
|
||||||
|
argParser<T>(fn: (value: string, previous: T) => T): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Whether the option is mandatory and must have a value after parsing.
|
||||||
|
*/
|
||||||
|
makeOptionMandatory(mandatory?: boolean): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Hide option in help.
|
||||||
|
*/
|
||||||
|
hideHelp(hide?: boolean): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Only allow option value to be one of choices.
|
||||||
|
*/
|
||||||
|
choices(values: readonly string[]): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return option name.
|
||||||
|
*/
|
||||||
|
name(): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return option name, in a camelcase format that can be used
|
||||||
|
* as a object attribute key.
|
||||||
|
*/
|
||||||
|
attributeName(): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return whether a boolean option.
|
||||||
|
*
|
||||||
|
* Options are one of boolean, negated, required argument, or optional argument.
|
||||||
|
*/
|
||||||
|
isBoolean(): boolean;
|
||||||
|
}
|
||||||
|
|
||||||
|
export class Help {
|
||||||
|
/** output helpWidth, long lines are wrapped to fit */
|
||||||
|
helpWidth?: number;
|
||||||
|
sortSubcommands: boolean;
|
||||||
|
sortOptions: boolean;
|
||||||
|
showGlobalOptions: boolean;
|
||||||
|
|
||||||
|
constructor();
|
||||||
|
|
||||||
|
/** Get the command term to show in the list of subcommands. */
|
||||||
|
subcommandTerm(cmd: Command): string;
|
||||||
|
/** Get the command summary to show in the list of subcommands. */
|
||||||
|
subcommandDescription(cmd: Command): string;
|
||||||
|
/** Get the option term to show in the list of options. */
|
||||||
|
optionTerm(option: Option): string;
|
||||||
|
/** Get the option description to show in the list of options. */
|
||||||
|
optionDescription(option: Option): string;
|
||||||
|
/** Get the argument term to show in the list of arguments. */
|
||||||
|
argumentTerm(argument: Argument): string;
|
||||||
|
/** Get the argument description to show in the list of arguments. */
|
||||||
|
argumentDescription(argument: Argument): string;
|
||||||
|
|
||||||
|
/** Get the command usage to be displayed at the top of the built-in help. */
|
||||||
|
commandUsage(cmd: Command): string;
|
||||||
|
/** Get the description for the command. */
|
||||||
|
commandDescription(cmd: Command): string;
|
||||||
|
|
||||||
|
/** Get an array of the visible subcommands. Includes a placeholder for the implicit help command, if there is one. */
|
||||||
|
visibleCommands(cmd: Command): Command[];
|
||||||
|
/** Get an array of the visible options. Includes a placeholder for the implicit help option, if there is one. */
|
||||||
|
visibleOptions(cmd: Command): Option[];
|
||||||
|
/** Get an array of the visible global options. (Not including help.) */
|
||||||
|
visibleGlobalOptions(cmd: Command): Option[];
|
||||||
|
/** Get an array of the arguments which have descriptions. */
|
||||||
|
visibleArguments(cmd: Command): Argument[];
|
||||||
|
|
||||||
|
/** Get the longest command term length. */
|
||||||
|
longestSubcommandTermLength(cmd: Command, helper: Help): number;
|
||||||
|
/** Get the longest option term length. */
|
||||||
|
longestOptionTermLength(cmd: Command, helper: Help): number;
|
||||||
|
/** Get the longest global option term length. */
|
||||||
|
longestGlobalOptionTermLength(cmd: Command, helper: Help): number;
|
||||||
|
/** Get the longest argument term length. */
|
||||||
|
longestArgumentTermLength(cmd: Command, helper: Help): number;
|
||||||
|
/** Calculate the pad width from the maximum term length. */
|
||||||
|
padWidth(cmd: Command, helper: Help): number;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Wrap the given string to width characters per line, with lines after the first indented.
|
||||||
|
* Do not wrap if insufficient room for wrapping (minColumnWidth), or string is manually formatted.
|
||||||
|
*/
|
||||||
|
wrap(
|
||||||
|
str: string,
|
||||||
|
width: number,
|
||||||
|
indent: number,
|
||||||
|
minColumnWidth?: number,
|
||||||
|
): string;
|
||||||
|
|
||||||
|
/** Generate the built-in help text. */
|
||||||
|
formatHelp(cmd: Command, helper: Help): string;
|
||||||
|
}
|
||||||
|
export type HelpConfiguration = Partial<Help>;
|
||||||
|
|
||||||
|
export interface ParseOptions {
|
||||||
|
from: 'node' | 'electron' | 'user';
|
||||||
|
}
|
||||||
|
export interface HelpContext {
|
||||||
|
// optional parameter for .help() and .outputHelp()
|
||||||
|
error: boolean;
|
||||||
|
}
|
||||||
|
export interface AddHelpTextContext {
|
||||||
|
// passed to text function used with .addHelpText()
|
||||||
|
error: boolean;
|
||||||
|
command: Command;
|
||||||
|
}
|
||||||
|
export interface OutputConfiguration {
|
||||||
|
writeOut?(str: string): void;
|
||||||
|
writeErr?(str: string): void;
|
||||||
|
getOutHelpWidth?(): number;
|
||||||
|
getErrHelpWidth?(): number;
|
||||||
|
outputError?(str: string, write: (str: string) => void): void;
|
||||||
|
}
|
||||||
|
|
||||||
|
export type AddHelpTextPosition = 'beforeAll' | 'before' | 'after' | 'afterAll';
|
||||||
|
export type HookEvent = 'preSubcommand' | 'preAction' | 'postAction';
|
||||||
|
// The source is a string so author can define their own too.
|
||||||
|
export type OptionValueSource =
|
||||||
|
| LiteralUnion<'default' | 'config' | 'env' | 'cli' | 'implied', string>
|
||||||
|
| undefined;
|
||||||
|
|
||||||
|
export type OptionValues = Record<string, any>;
|
||||||
|
|
||||||
|
export class Command {
|
||||||
|
args: string[];
|
||||||
|
processedArgs: any[];
|
||||||
|
readonly commands: readonly Command[];
|
||||||
|
readonly options: readonly Option[];
|
||||||
|
readonly registeredArguments: readonly Argument[];
|
||||||
|
parent: Command | null;
|
||||||
|
|
||||||
|
constructor(name?: string);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the program version to `str`.
|
||||||
|
*
|
||||||
|
* This method auto-registers the "-V, --version" flag
|
||||||
|
* which will print the version number when passed.
|
||||||
|
*
|
||||||
|
* You can optionally supply the flags and description to override the defaults.
|
||||||
|
*/
|
||||||
|
version(str: string, flags?: string, description?: string): this;
|
||||||
|
/**
|
||||||
|
* Get the program version.
|
||||||
|
*/
|
||||||
|
version(): string | undefined;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Define a command, implemented using an action handler.
|
||||||
|
*
|
||||||
|
* @remarks
|
||||||
|
* The command description is supplied using `.description`, not as a parameter to `.command`.
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* ```ts
|
||||||
|
* program
|
||||||
|
* .command('clone <source> [destination]')
|
||||||
|
* .description('clone a repository into a newly created directory')
|
||||||
|
* .action((source, destination) => {
|
||||||
|
* console.log('clone command called');
|
||||||
|
* });
|
||||||
|
* ```
|
||||||
|
*
|
||||||
|
* @param nameAndArgs - command name and arguments, args are `<required>` or `[optional]` and last may also be `variadic...`
|
||||||
|
* @param opts - configuration options
|
||||||
|
* @returns new command
|
||||||
|
*/
|
||||||
|
command(
|
||||||
|
nameAndArgs: string,
|
||||||
|
opts?: CommandOptions,
|
||||||
|
): ReturnType<this['createCommand']>;
|
||||||
|
/**
|
||||||
|
* Define a command, implemented in a separate executable file.
|
||||||
|
*
|
||||||
|
* @remarks
|
||||||
|
* The command description is supplied as the second parameter to `.command`.
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* ```ts
|
||||||
|
* program
|
||||||
|
* .command('start <service>', 'start named service')
|
||||||
|
* .command('stop [service]', 'stop named service, or all if no name supplied');
|
||||||
|
* ```
|
||||||
|
*
|
||||||
|
* @param nameAndArgs - command name and arguments, args are `<required>` or `[optional]` and last may also be `variadic...`
|
||||||
|
* @param description - description of executable command
|
||||||
|
* @param opts - configuration options
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
command(
|
||||||
|
nameAndArgs: string,
|
||||||
|
description: string,
|
||||||
|
opts?: ExecutableCommandOptions,
|
||||||
|
): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Factory routine to create a new unattached command.
|
||||||
|
*
|
||||||
|
* See .command() for creating an attached subcommand, which uses this routine to
|
||||||
|
* create the command. You can override createCommand to customise subcommands.
|
||||||
|
*/
|
||||||
|
createCommand(name?: string): Command;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add a prepared subcommand.
|
||||||
|
*
|
||||||
|
* See .command() for creating an attached subcommand which inherits settings from its parent.
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
addCommand(cmd: Command, opts?: CommandOptions): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Factory routine to create a new unattached argument.
|
||||||
|
*
|
||||||
|
* See .argument() for creating an attached argument, which uses this routine to
|
||||||
|
* create the argument. You can override createArgument to return a custom argument.
|
||||||
|
*/
|
||||||
|
createArgument(name: string, description?: string): Argument;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Define argument syntax for command.
|
||||||
|
*
|
||||||
|
* The default is that the argument is required, and you can explicitly
|
||||||
|
* indicate this with <> around the name. Put [] around the name for an optional argument.
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* ```
|
||||||
|
* program.argument('<input-file>');
|
||||||
|
* program.argument('[output-file]');
|
||||||
|
* ```
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
argument<T>(
|
||||||
|
flags: string,
|
||||||
|
description: string,
|
||||||
|
fn: (value: string, previous: T) => T,
|
||||||
|
defaultValue?: T,
|
||||||
|
): this;
|
||||||
|
argument(name: string, description?: string, defaultValue?: unknown): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Define argument syntax for command, adding a prepared argument.
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
addArgument(arg: Argument): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Define argument syntax for command, adding multiple at once (without descriptions).
|
||||||
|
*
|
||||||
|
* See also .argument().
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* ```
|
||||||
|
* program.arguments('<cmd> [env]');
|
||||||
|
* ```
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
arguments(names: string): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Customise or override default help command. By default a help command is automatically added if your command has subcommands.
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* ```ts
|
||||||
|
* program.helpCommand('help [cmd]');
|
||||||
|
* program.helpCommand('help [cmd]', 'show help');
|
||||||
|
* program.helpCommand(false); // suppress default help command
|
||||||
|
* program.helpCommand(true); // add help command even if no subcommands
|
||||||
|
* ```
|
||||||
|
*/
|
||||||
|
helpCommand(nameAndArgs: string, description?: string): this;
|
||||||
|
helpCommand(enable: boolean): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add prepared custom help command.
|
||||||
|
*/
|
||||||
|
addHelpCommand(cmd: Command): this;
|
||||||
|
/** @deprecated since v12, instead use helpCommand */
|
||||||
|
addHelpCommand(nameAndArgs: string, description?: string): this;
|
||||||
|
/** @deprecated since v12, instead use helpCommand */
|
||||||
|
addHelpCommand(enable?: boolean): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add hook for life cycle event.
|
||||||
|
*/
|
||||||
|
hook(
|
||||||
|
event: HookEvent,
|
||||||
|
listener: (
|
||||||
|
thisCommand: Command,
|
||||||
|
actionCommand: Command,
|
||||||
|
) => void | Promise<void>,
|
||||||
|
): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Register callback to use as replacement for calling process.exit.
|
||||||
|
*/
|
||||||
|
exitOverride(callback?: (err: CommanderError) => never | void): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Display error message and exit (or call exitOverride).
|
||||||
|
*/
|
||||||
|
error(message: string, errorOptions?: ErrorOptions): never;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* You can customise the help with a subclass of Help by overriding createHelp,
|
||||||
|
* or by overriding Help properties using configureHelp().
|
||||||
|
*/
|
||||||
|
createHelp(): Help;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* You can customise the help by overriding Help properties using configureHelp(),
|
||||||
|
* or with a subclass of Help by overriding createHelp().
|
||||||
|
*/
|
||||||
|
configureHelp(configuration: HelpConfiguration): this;
|
||||||
|
/** Get configuration */
|
||||||
|
configureHelp(): HelpConfiguration;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The default output goes to stdout and stderr. You can customise this for special
|
||||||
|
* applications. You can also customise the display of errors by overriding outputError.
|
||||||
|
*
|
||||||
|
* The configuration properties are all functions:
|
||||||
|
* ```
|
||||||
|
* // functions to change where being written, stdout and stderr
|
||||||
|
* writeOut(str)
|
||||||
|
* writeErr(str)
|
||||||
|
* // matching functions to specify width for wrapping help
|
||||||
|
* getOutHelpWidth()
|
||||||
|
* getErrHelpWidth()
|
||||||
|
* // functions based on what is being written out
|
||||||
|
* outputError(str, write) // used for displaying errors, and not used for displaying help
|
||||||
|
* ```
|
||||||
|
*/
|
||||||
|
configureOutput(configuration: OutputConfiguration): this;
|
||||||
|
/** Get configuration */
|
||||||
|
configureOutput(): OutputConfiguration;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Copy settings that are useful to have in common across root command and subcommands.
|
||||||
|
*
|
||||||
|
* (Used internally when adding a command using `.command()` so subcommands inherit parent settings.)
|
||||||
|
*/
|
||||||
|
copyInheritedSettings(sourceCommand: Command): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Display the help or a custom message after an error occurs.
|
||||||
|
*/
|
||||||
|
showHelpAfterError(displayHelp?: boolean | string): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Display suggestion of similar commands for unknown commands, or options for unknown options.
|
||||||
|
*/
|
||||||
|
showSuggestionAfterError(displaySuggestion?: boolean): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Register callback `fn` for the command.
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* ```
|
||||||
|
* program
|
||||||
|
* .command('serve')
|
||||||
|
* .description('start service')
|
||||||
|
* .action(function() {
|
||||||
|
* // do work here
|
||||||
|
* });
|
||||||
|
* ```
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
action(fn: (...args: any[]) => void | Promise<void>): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Define option with `flags`, `description`, and optional argument parsing function or `defaultValue` or both.
|
||||||
|
*
|
||||||
|
* The `flags` string contains the short and/or long flags, separated by comma, a pipe or space. A required
|
||||||
|
* option-argument is indicated by `<>` and an optional option-argument by `[]`.
|
||||||
|
*
|
||||||
|
* See the README for more details, and see also addOption() and requiredOption().
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
*
|
||||||
|
* ```js
|
||||||
|
* program
|
||||||
|
* .option('-p, --pepper', 'add pepper')
|
||||||
|
* .option('-p, --pizza-type <TYPE>', 'type of pizza') // required option-argument
|
||||||
|
* .option('-c, --cheese [CHEESE]', 'add extra cheese', 'mozzarella') // optional option-argument with default
|
||||||
|
* .option('-t, --tip <VALUE>', 'add tip to purchase cost', parseFloat) // custom parse function
|
||||||
|
* ```
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
option(
|
||||||
|
flags: string,
|
||||||
|
description?: string,
|
||||||
|
defaultValue?: string | boolean | string[],
|
||||||
|
): this;
|
||||||
|
option<T>(
|
||||||
|
flags: string,
|
||||||
|
description: string,
|
||||||
|
parseArg: (value: string, previous: T) => T,
|
||||||
|
defaultValue?: T,
|
||||||
|
): this;
|
||||||
|
/** @deprecated since v7, instead use choices or a custom function */
|
||||||
|
option(
|
||||||
|
flags: string,
|
||||||
|
description: string,
|
||||||
|
regexp: RegExp,
|
||||||
|
defaultValue?: string | boolean | string[],
|
||||||
|
): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Define a required option, which must have a value after parsing. This usually means
|
||||||
|
* the option must be specified on the command line. (Otherwise the same as .option().)
|
||||||
|
*
|
||||||
|
* The `flags` string contains the short and/or long flags, separated by comma, a pipe or space.
|
||||||
|
*/
|
||||||
|
requiredOption(
|
||||||
|
flags: string,
|
||||||
|
description?: string,
|
||||||
|
defaultValue?: string | boolean | string[],
|
||||||
|
): this;
|
||||||
|
requiredOption<T>(
|
||||||
|
flags: string,
|
||||||
|
description: string,
|
||||||
|
parseArg: (value: string, previous: T) => T,
|
||||||
|
defaultValue?: T,
|
||||||
|
): this;
|
||||||
|
/** @deprecated since v7, instead use choices or a custom function */
|
||||||
|
requiredOption(
|
||||||
|
flags: string,
|
||||||
|
description: string,
|
||||||
|
regexp: RegExp,
|
||||||
|
defaultValue?: string | boolean | string[],
|
||||||
|
): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Factory routine to create a new unattached option.
|
||||||
|
*
|
||||||
|
* See .option() for creating an attached option, which uses this routine to
|
||||||
|
* create the option. You can override createOption to return a custom option.
|
||||||
|
*/
|
||||||
|
|
||||||
|
createOption(flags: string, description?: string): Option;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add a prepared Option.
|
||||||
|
*
|
||||||
|
* See .option() and .requiredOption() for creating and attaching an option in a single call.
|
||||||
|
*/
|
||||||
|
addOption(option: Option): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Whether to store option values as properties on command object,
|
||||||
|
* or store separately (specify false). In both cases the option values can be accessed using .opts().
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
storeOptionsAsProperties<T extends OptionValues>(): this & T;
|
||||||
|
storeOptionsAsProperties<T extends OptionValues>(
|
||||||
|
storeAsProperties: true,
|
||||||
|
): this & T;
|
||||||
|
storeOptionsAsProperties(storeAsProperties?: boolean): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Retrieve option value.
|
||||||
|
*/
|
||||||
|
getOptionValue(key: string): any;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Store option value.
|
||||||
|
*/
|
||||||
|
setOptionValue(key: string, value: unknown): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Store option value and where the value came from.
|
||||||
|
*/
|
||||||
|
setOptionValueWithSource(
|
||||||
|
key: string,
|
||||||
|
value: unknown,
|
||||||
|
source: OptionValueSource,
|
||||||
|
): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get source of option value.
|
||||||
|
*/
|
||||||
|
getOptionValueSource(key: string): OptionValueSource | undefined;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get source of option value. See also .optsWithGlobals().
|
||||||
|
*/
|
||||||
|
getOptionValueSourceWithGlobals(key: string): OptionValueSource | undefined;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Alter parsing of short flags with optional values.
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* ```
|
||||||
|
* // for `.option('-f,--flag [value]'):
|
||||||
|
* .combineFlagAndOptionalValue(true) // `-f80` is treated like `--flag=80`, this is the default behaviour
|
||||||
|
* .combineFlagAndOptionalValue(false) // `-fb` is treated like `-f -b`
|
||||||
|
* ```
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
combineFlagAndOptionalValue(combine?: boolean): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Allow unknown options on the command line.
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
allowUnknownOption(allowUnknown?: boolean): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Allow excess command-arguments on the command line. Pass false to make excess arguments an error.
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
allowExcessArguments(allowExcess?: boolean): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Enable positional options. Positional means global options are specified before subcommands which lets
|
||||||
|
* subcommands reuse the same option names, and also enables subcommands to turn on passThroughOptions.
|
||||||
|
*
|
||||||
|
* The default behaviour is non-positional and global options may appear anywhere on the command line.
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
enablePositionalOptions(positional?: boolean): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Pass through options that come after command-arguments rather than treat them as command-options,
|
||||||
|
* so actual command-options come before command-arguments. Turning this on for a subcommand requires
|
||||||
|
* positional options to have been enabled on the program (parent commands).
|
||||||
|
*
|
||||||
|
* The default behaviour is non-positional and options may appear before or after command-arguments.
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
passThroughOptions(passThrough?: boolean): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Parse `argv`, setting options and invoking commands when defined.
|
||||||
|
*
|
||||||
|
* Use parseAsync instead of parse if any of your action handlers are async.
|
||||||
|
*
|
||||||
|
* Call with no parameters to parse `process.argv`. Detects Electron and special node options like `node --eval`. Easy mode!
|
||||||
|
*
|
||||||
|
* Or call with an array of strings to parse, and optionally where the user arguments start by specifying where the arguments are `from`:
|
||||||
|
* - `'node'`: default, `argv[0]` is the application and `argv[1]` is the script being run, with user arguments after that
|
||||||
|
* - `'electron'`: `argv[0]` is the application and `argv[1]` varies depending on whether the electron application is packaged
|
||||||
|
* - `'user'`: just user arguments
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* ```
|
||||||
|
* program.parse(); // parse process.argv and auto-detect electron and special node flags
|
||||||
|
* program.parse(process.argv); // assume argv[0] is app and argv[1] is script
|
||||||
|
* program.parse(my-args, { from: 'user' }); // just user supplied arguments, nothing special about argv[0]
|
||||||
|
* ```
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
parse(argv?: readonly string[], parseOptions?: ParseOptions): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Parse `argv`, setting options and invoking commands when defined.
|
||||||
|
*
|
||||||
|
* Call with no parameters to parse `process.argv`. Detects Electron and special node options like `node --eval`. Easy mode!
|
||||||
|
*
|
||||||
|
* Or call with an array of strings to parse, and optionally where the user arguments start by specifying where the arguments are `from`:
|
||||||
|
* - `'node'`: default, `argv[0]` is the application and `argv[1]` is the script being run, with user arguments after that
|
||||||
|
* - `'electron'`: `argv[0]` is the application and `argv[1]` varies depending on whether the electron application is packaged
|
||||||
|
* - `'user'`: just user arguments
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* ```
|
||||||
|
* await program.parseAsync(); // parse process.argv and auto-detect electron and special node flags
|
||||||
|
* await program.parseAsync(process.argv); // assume argv[0] is app and argv[1] is script
|
||||||
|
* await program.parseAsync(my-args, { from: 'user' }); // just user supplied arguments, nothing special about argv[0]
|
||||||
|
* ```
|
||||||
|
*
|
||||||
|
* @returns Promise
|
||||||
|
*/
|
||||||
|
parseAsync(
|
||||||
|
argv?: readonly string[],
|
||||||
|
parseOptions?: ParseOptions,
|
||||||
|
): Promise<this>;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Parse options from `argv` removing known options,
|
||||||
|
* and return argv split into operands and unknown arguments.
|
||||||
|
*
|
||||||
|
* argv => operands, unknown
|
||||||
|
* --known kkk op => [op], []
|
||||||
|
* op --known kkk => [op], []
|
||||||
|
* sub --unknown uuu op => [sub], [--unknown uuu op]
|
||||||
|
* sub -- --unknown uuu op => [sub --unknown uuu op], []
|
||||||
|
*/
|
||||||
|
parseOptions(argv: string[]): ParseOptionsResult;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return an object containing local option values as key-value pairs
|
||||||
|
*/
|
||||||
|
opts<T extends OptionValues>(): T;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return an object containing merged local and global option values as key-value pairs.
|
||||||
|
*/
|
||||||
|
optsWithGlobals<T extends OptionValues>(): T;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the description.
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
|
||||||
|
description(str: string): this;
|
||||||
|
/** @deprecated since v8, instead use .argument to add command argument with description */
|
||||||
|
description(str: string, argsDescription: Record<string, string>): this;
|
||||||
|
/**
|
||||||
|
* Get the description.
|
||||||
|
*/
|
||||||
|
description(): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the summary. Used when listed as subcommand of parent.
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
|
||||||
|
summary(str: string): this;
|
||||||
|
/**
|
||||||
|
* Get the summary.
|
||||||
|
*/
|
||||||
|
summary(): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set an alias for the command.
|
||||||
|
*
|
||||||
|
* You may call more than once to add multiple aliases. Only the first alias is shown in the auto-generated help.
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
alias(alias: string): this;
|
||||||
|
/**
|
||||||
|
* Get alias for the command.
|
||||||
|
*/
|
||||||
|
alias(): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set aliases for the command.
|
||||||
|
*
|
||||||
|
* Only the first alias is shown in the auto-generated help.
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
aliases(aliases: readonly string[]): this;
|
||||||
|
/**
|
||||||
|
* Get aliases for the command.
|
||||||
|
*/
|
||||||
|
aliases(): string[];
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the command usage.
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
usage(str: string): this;
|
||||||
|
/**
|
||||||
|
* Get the command usage.
|
||||||
|
*/
|
||||||
|
usage(): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the name of the command.
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
name(str: string): this;
|
||||||
|
/**
|
||||||
|
* Get the name of the command.
|
||||||
|
*/
|
||||||
|
name(): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the name of the command from script filename, such as process.argv[1],
|
||||||
|
* or require.main.filename, or __filename.
|
||||||
|
*
|
||||||
|
* (Used internally and public although not documented in README.)
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* ```ts
|
||||||
|
* program.nameFromFilename(require.main.filename);
|
||||||
|
* ```
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
nameFromFilename(filename: string): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set the directory for searching for executable subcommands of this command.
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* ```ts
|
||||||
|
* program.executableDir(__dirname);
|
||||||
|
* // or
|
||||||
|
* program.executableDir('subcommands');
|
||||||
|
* ```
|
||||||
|
*
|
||||||
|
* @returns `this` command for chaining
|
||||||
|
*/
|
||||||
|
executableDir(path: string): this;
|
||||||
|
/**
|
||||||
|
* Get the executable search directory.
|
||||||
|
*/
|
||||||
|
executableDir(): string | null;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Output help information for this command.
|
||||||
|
*
|
||||||
|
* Outputs built-in help, and custom text added using `.addHelpText()`.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
outputHelp(context?: HelpContext): void;
|
||||||
|
/** @deprecated since v7 */
|
||||||
|
outputHelp(cb?: (str: string) => string): void;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return command help documentation.
|
||||||
|
*/
|
||||||
|
helpInformation(context?: HelpContext): string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* You can pass in flags and a description to override the help
|
||||||
|
* flags and help description for your command. Pass in false
|
||||||
|
* to disable the built-in help option.
|
||||||
|
*/
|
||||||
|
helpOption(flags?: string | boolean, description?: string): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Supply your own option to use for the built-in help option.
|
||||||
|
* This is an alternative to using helpOption() to customise the flags and description etc.
|
||||||
|
*/
|
||||||
|
addHelpOption(option: Option): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Output help information and exit.
|
||||||
|
*
|
||||||
|
* Outputs built-in help, and custom text added using `.addHelpText()`.
|
||||||
|
*/
|
||||||
|
help(context?: HelpContext): never;
|
||||||
|
/** @deprecated since v7 */
|
||||||
|
help(cb?: (str: string) => string): never;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add additional text to be displayed with the built-in help.
|
||||||
|
*
|
||||||
|
* Position is 'before' or 'after' to affect just this command,
|
||||||
|
* and 'beforeAll' or 'afterAll' to affect this command and all its subcommands.
|
||||||
|
*/
|
||||||
|
addHelpText(position: AddHelpTextPosition, text: string): this;
|
||||||
|
addHelpText(
|
||||||
|
position: AddHelpTextPosition,
|
||||||
|
text: (context: AddHelpTextContext) => string,
|
||||||
|
): this;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add a listener (callback) for when events occur. (Implemented using EventEmitter.)
|
||||||
|
*/
|
||||||
|
on(event: string | symbol, listener: (...args: any[]) => void): this;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CommandOptions {
|
||||||
|
hidden?: boolean;
|
||||||
|
isDefault?: boolean;
|
||||||
|
/** @deprecated since v7, replaced by hidden */
|
||||||
|
noHelp?: boolean;
|
||||||
|
}
|
||||||
|
export interface ExecutableCommandOptions extends CommandOptions {
|
||||||
|
executableFile?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ParseOptionsResult {
|
||||||
|
operands: string[];
|
||||||
|
unknown: string[];
|
||||||
|
}
|
||||||
|
|
||||||
|
export function createCommand(name?: string): Command;
|
||||||
|
export function createOption(flags: string, description?: string): Option;
|
||||||
|
export function createArgument(name: string, description?: string): Argument;
|
||||||
|
|
||||||
|
export const program: Command;
|
|
@ -0,0 +1,130 @@
|
||||||
|
# Changelog
|
||||||
|
|
||||||
|
All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
|
||||||
|
|
||||||
|
### [7.0.3](https://github.com/moxystudio/node-cross-spawn/compare/v7.0.2...v7.0.3) (2020-05-25)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* detect path key based on correct environment ([#133](https://github.com/moxystudio/node-cross-spawn/issues/133)) ([159e7e9](https://github.com/moxystudio/node-cross-spawn/commit/159e7e9785e57451cba034ae51719f97135074ae))
|
||||||
|
|
||||||
|
### [7.0.2](https://github.com/moxystudio/node-cross-spawn/compare/v7.0.1...v7.0.2) (2020-04-04)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* fix worker threads in Node >=11.10.0 ([#132](https://github.com/moxystudio/node-cross-spawn/issues/132)) ([6c5b4f0](https://github.com/moxystudio/node-cross-spawn/commit/6c5b4f015814a6c4f6b33230dfd1a860aedc0aaf))
|
||||||
|
|
||||||
|
### [7.0.1](https://github.com/moxystudio/node-cross-spawn/compare/v7.0.0...v7.0.1) (2019-10-07)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* **core:** support worker threads ([#127](https://github.com/moxystudio/node-cross-spawn/issues/127)) ([cfd49c9](https://github.com/moxystudio/node-cross-spawn/commit/cfd49c9))
|
||||||
|
|
||||||
|
## [7.0.0](https://github.com/moxystudio/node-cross-spawn/compare/v6.0.5...v7.0.0) (2019-09-03)
|
||||||
|
|
||||||
|
|
||||||
|
### ⚠ BREAKING CHANGES
|
||||||
|
|
||||||
|
* drop support for Node.js < 8
|
||||||
|
|
||||||
|
* drop support for versions below Node.js 8 ([#125](https://github.com/moxystudio/node-cross-spawn/issues/125)) ([16feb53](https://github.com/moxystudio/node-cross-spawn/commit/16feb53))
|
||||||
|
|
||||||
|
<a name="6.0.5"></a>
|
||||||
|
## [6.0.5](https://github.com/moxystudio/node-cross-spawn/compare/v6.0.4...v6.0.5) (2018-03-02)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* avoid using deprecated Buffer constructor ([#94](https://github.com/moxystudio/node-cross-spawn/issues/94)) ([d5770df](https://github.com/moxystudio/node-cross-spawn/commit/d5770df)), closes [/nodejs.org/api/deprecations.html#deprecations_dep0005](https://github.com//nodejs.org/api/deprecations.html/issues/deprecations_dep0005)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="6.0.4"></a>
|
||||||
|
## [6.0.4](https://github.com/moxystudio/node-cross-spawn/compare/v6.0.3...v6.0.4) (2018-01-31)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* fix paths being incorrectly normalized on unix ([06ee3c6](https://github.com/moxystudio/node-cross-spawn/commit/06ee3c6)), closes [#90](https://github.com/moxystudio/node-cross-spawn/issues/90)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="6.0.3"></a>
|
||||||
|
## [6.0.3](https://github.com/moxystudio/node-cross-spawn/compare/v6.0.2...v6.0.3) (2018-01-23)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="6.0.2"></a>
|
||||||
|
## [6.0.2](https://github.com/moxystudio/node-cross-spawn/compare/v6.0.1...v6.0.2) (2018-01-23)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="6.0.1"></a>
|
||||||
|
## [6.0.1](https://github.com/moxystudio/node-cross-spawn/compare/v6.0.0...v6.0.1) (2018-01-23)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="6.0.0"></a>
|
||||||
|
# [6.0.0](https://github.com/moxystudio/node-cross-spawn/compare/5.1.0...6.0.0) (2018-01-23)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* fix certain arguments not being correctly escaped or causing batch syntax error ([900cf10](https://github.com/moxystudio/node-cross-spawn/commit/900cf10)), closes [#82](https://github.com/moxystudio/node-cross-spawn/issues/82) [#51](https://github.com/moxystudio/node-cross-spawn/issues/51)
|
||||||
|
* fix commands as posix relatixe paths not working correctly, e.g.: `./my-command` ([900cf10](https://github.com/moxystudio/node-cross-spawn/commit/900cf10))
|
||||||
|
* fix `options` argument being mutated ([900cf10](https://github.com/moxystudio/node-cross-spawn/commit/900cf10))
|
||||||
|
* fix commands resolution when PATH was actually Path ([900cf10](https://github.com/moxystudio/node-cross-spawn/commit/900cf10))
|
||||||
|
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
* improve compliance with node's ENOENT errors ([900cf10](https://github.com/moxystudio/node-cross-spawn/commit/900cf10))
|
||||||
|
* improve detection of node's shell option support ([900cf10](https://github.com/moxystudio/node-cross-spawn/commit/900cf10))
|
||||||
|
|
||||||
|
|
||||||
|
### Chores
|
||||||
|
|
||||||
|
* upgrade tooling
|
||||||
|
* upgrate project to es6 (node v4)
|
||||||
|
|
||||||
|
|
||||||
|
### BREAKING CHANGES
|
||||||
|
|
||||||
|
* remove support for older nodejs versions, only `node >= 4` is supported
|
||||||
|
|
||||||
|
|
||||||
|
<a name="5.1.0"></a>
|
||||||
|
## [5.1.0](https://github.com/moxystudio/node-cross-spawn/compare/5.0.1...5.1.0) (2017-02-26)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* fix `options.shell` support for NodeJS [v4.8](https://github.com/nodejs/node/blob/master/doc/changelogs/CHANGELOG_V4.md#4.8.0)
|
||||||
|
|
||||||
|
|
||||||
|
<a name="5.0.1"></a>
|
||||||
|
## [5.0.1](https://github.com/moxystudio/node-cross-spawn/compare/5.0.0...5.0.1) (2016-11-04)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* fix `options.shell` support for NodeJS v7
|
||||||
|
|
||||||
|
|
||||||
|
<a name="5.0.0"></a>
|
||||||
|
# [5.0.0](https://github.com/moxystudio/node-cross-spawn/compare/4.0.2...5.0.0) (2016-10-30)
|
||||||
|
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
* add support for `options.shell`
|
||||||
|
* improve parsing of shebangs by using [`shebang-command`](https://github.com/kevva/shebang-command) module
|
||||||
|
|
||||||
|
|
||||||
|
## Chores
|
||||||
|
|
||||||
|
* refactor some code to make it more clear
|
||||||
|
* update README caveats
|
|
@ -0,0 +1,21 @@
|
||||||
|
The MIT License (MIT)
|
||||||
|
|
||||||
|
Copyright (c) 2018 Made With MOXY Lda <hello@moxy.studio>
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in
|
||||||
|
all copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||||||
|
THE SOFTWARE.
|
|
@ -0,0 +1,96 @@
|
||||||
|
# cross-spawn
|
||||||
|
|
||||||
|
[![NPM version][npm-image]][npm-url] [![Downloads][downloads-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Build status][appveyor-image]][appveyor-url] [![Coverage Status][codecov-image]][codecov-url] [![Dependency status][david-dm-image]][david-dm-url] [![Dev Dependency status][david-dm-dev-image]][david-dm-dev-url]
|
||||||
|
|
||||||
|
[npm-url]:https://npmjs.org/package/cross-spawn
|
||||||
|
[downloads-image]:https://img.shields.io/npm/dm/cross-spawn.svg
|
||||||
|
[npm-image]:https://img.shields.io/npm/v/cross-spawn.svg
|
||||||
|
[travis-url]:https://travis-ci.org/moxystudio/node-cross-spawn
|
||||||
|
[travis-image]:https://img.shields.io/travis/moxystudio/node-cross-spawn/master.svg
|
||||||
|
[appveyor-url]:https://ci.appveyor.com/project/satazor/node-cross-spawn
|
||||||
|
[appveyor-image]:https://img.shields.io/appveyor/ci/satazor/node-cross-spawn/master.svg
|
||||||
|
[codecov-url]:https://codecov.io/gh/moxystudio/node-cross-spawn
|
||||||
|
[codecov-image]:https://img.shields.io/codecov/c/github/moxystudio/node-cross-spawn/master.svg
|
||||||
|
[david-dm-url]:https://david-dm.org/moxystudio/node-cross-spawn
|
||||||
|
[david-dm-image]:https://img.shields.io/david/moxystudio/node-cross-spawn.svg
|
||||||
|
[david-dm-dev-url]:https://david-dm.org/moxystudio/node-cross-spawn?type=dev
|
||||||
|
[david-dm-dev-image]:https://img.shields.io/david/dev/moxystudio/node-cross-spawn.svg
|
||||||
|
|
||||||
|
A cross platform solution to node's spawn and spawnSync.
|
||||||
|
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
Node.js version 8 and up:
|
||||||
|
`$ npm install cross-spawn`
|
||||||
|
|
||||||
|
Node.js version 7 and under:
|
||||||
|
`$ npm install cross-spawn@6`
|
||||||
|
|
||||||
|
## Why
|
||||||
|
|
||||||
|
Node has issues when using spawn on Windows:
|
||||||
|
|
||||||
|
- It ignores [PATHEXT](https://github.com/joyent/node/issues/2318)
|
||||||
|
- It does not support [shebangs](https://en.wikipedia.org/wiki/Shebang_(Unix))
|
||||||
|
- Has problems running commands with [spaces](https://github.com/nodejs/node/issues/7367)
|
||||||
|
- Has problems running commands with posix relative paths (e.g.: `./my-folder/my-executable`)
|
||||||
|
- Has an [issue](https://github.com/moxystudio/node-cross-spawn/issues/82) with command shims (files in `node_modules/.bin/`), where arguments with quotes and parenthesis would result in [invalid syntax error](https://github.com/moxystudio/node-cross-spawn/blob/e77b8f22a416db46b6196767bcd35601d7e11d54/test/index.test.js#L149)
|
||||||
|
- No `options.shell` support on node `<v4.8`
|
||||||
|
|
||||||
|
All these issues are handled correctly by `cross-spawn`.
|
||||||
|
There are some known modules, such as [win-spawn](https://github.com/ForbesLindesay/win-spawn), that try to solve this but they are either broken or provide faulty escaping of shell arguments.
|
||||||
|
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
Exactly the same way as node's [`spawn`](https://nodejs.org/api/child_process.html#child_process_child_process_spawn_command_args_options) or [`spawnSync`](https://nodejs.org/api/child_process.html#child_process_child_process_spawnsync_command_args_options), so it's a drop in replacement.
|
||||||
|
|
||||||
|
|
||||||
|
```js
|
||||||
|
const spawn = require('cross-spawn');
|
||||||
|
|
||||||
|
// Spawn NPM asynchronously
|
||||||
|
const child = spawn('npm', ['list', '-g', '-depth', '0'], { stdio: 'inherit' });
|
||||||
|
|
||||||
|
// Spawn NPM synchronously
|
||||||
|
const result = spawn.sync('npm', ['list', '-g', '-depth', '0'], { stdio: 'inherit' });
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
## Caveats
|
||||||
|
|
||||||
|
### Using `options.shell` as an alternative to `cross-spawn`
|
||||||
|
|
||||||
|
Starting from node `v4.8`, `spawn` has a `shell` option that allows you run commands from within a shell. This new option solves
|
||||||
|
the [PATHEXT](https://github.com/joyent/node/issues/2318) issue but:
|
||||||
|
|
||||||
|
- It's not supported in node `<v4.8`
|
||||||
|
- You must manually escape the command and arguments which is very error prone, specially when passing user input
|
||||||
|
- There are a lot of other unresolved issues from the [Why](#why) section that you must take into account
|
||||||
|
|
||||||
|
If you are using the `shell` option to spawn a command in a cross platform way, consider using `cross-spawn` instead. You have been warned.
|
||||||
|
|
||||||
|
### `options.shell` support
|
||||||
|
|
||||||
|
While `cross-spawn` adds support for `options.shell` in node `<v4.8`, all of its enhancements are disabled.
|
||||||
|
|
||||||
|
This mimics the Node.js behavior. More specifically, the command and its arguments will not be automatically escaped nor shebang support will be offered. This is by design because if you are using `options.shell` you are probably targeting a specific platform anyway and you don't want things to get into your way.
|
||||||
|
|
||||||
|
### Shebangs support
|
||||||
|
|
||||||
|
While `cross-spawn` handles shebangs on Windows, its support is limited. More specifically, it just supports `#!/usr/bin/env <program>` where `<program>` must not contain any arguments.
|
||||||
|
If you would like to have the shebang support improved, feel free to contribute via a pull-request.
|
||||||
|
|
||||||
|
Remember to always test your code on Windows!
|
||||||
|
|
||||||
|
|
||||||
|
## Tests
|
||||||
|
|
||||||
|
`$ npm test`
|
||||||
|
`$ npm test -- --watch` during development
|
||||||
|
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
Released under the [MIT License](https://www.opensource.org/licenses/mit-license.php).
|
|
@ -0,0 +1,39 @@
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
const cp = require('child_process');
|
||||||
|
const parse = require('./lib/parse');
|
||||||
|
const enoent = require('./lib/enoent');
|
||||||
|
|
||||||
|
function spawn(command, args, options) {
|
||||||
|
// Parse the arguments
|
||||||
|
const parsed = parse(command, args, options);
|
||||||
|
|
||||||
|
// Spawn the child process
|
||||||
|
const spawned = cp.spawn(parsed.command, parsed.args, parsed.options);
|
||||||
|
|
||||||
|
// Hook into child process "exit" event to emit an error if the command
|
||||||
|
// does not exists, see: https://github.com/IndigoUnited/node-cross-spawn/issues/16
|
||||||
|
enoent.hookChildProcess(spawned, parsed);
|
||||||
|
|
||||||
|
return spawned;
|
||||||
|
}
|
||||||
|
|
||||||
|
function spawnSync(command, args, options) {
|
||||||
|
// Parse the arguments
|
||||||
|
const parsed = parse(command, args, options);
|
||||||
|
|
||||||
|
// Spawn the child process
|
||||||
|
const result = cp.spawnSync(parsed.command, parsed.args, parsed.options);
|
||||||
|
|
||||||
|
// Analyze if the command does not exist, see: https://github.com/IndigoUnited/node-cross-spawn/issues/16
|
||||||
|
result.error = result.error || enoent.verifyENOENTSync(result.status, parsed);
|
||||||
|
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = spawn;
|
||||||
|
module.exports.spawn = spawn;
|
||||||
|
module.exports.sync = spawnSync;
|
||||||
|
|
||||||
|
module.exports._parse = parse;
|
||||||
|
module.exports._enoent = enoent;
|
|
@ -0,0 +1,59 @@
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
const isWin = process.platform === 'win32';
|
||||||
|
|
||||||
|
function notFoundError(original, syscall) {
|
||||||
|
return Object.assign(new Error(`${syscall} ${original.command} ENOENT`), {
|
||||||
|
code: 'ENOENT',
|
||||||
|
errno: 'ENOENT',
|
||||||
|
syscall: `${syscall} ${original.command}`,
|
||||||
|
path: original.command,
|
||||||
|
spawnargs: original.args,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
function hookChildProcess(cp, parsed) {
|
||||||
|
if (!isWin) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
const originalEmit = cp.emit;
|
||||||
|
|
||||||
|
cp.emit = function (name, arg1) {
|
||||||
|
// If emitting "exit" event and exit code is 1, we need to check if
|
||||||
|
// the command exists and emit an "error" instead
|
||||||
|
// See https://github.com/IndigoUnited/node-cross-spawn/issues/16
|
||||||
|
if (name === 'exit') {
|
||||||
|
const err = verifyENOENT(arg1, parsed, 'spawn');
|
||||||
|
|
||||||
|
if (err) {
|
||||||
|
return originalEmit.call(cp, 'error', err);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return originalEmit.apply(cp, arguments); // eslint-disable-line prefer-rest-params
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function verifyENOENT(status, parsed) {
|
||||||
|
if (isWin && status === 1 && !parsed.file) {
|
||||||
|
return notFoundError(parsed.original, 'spawn');
|
||||||
|
}
|
||||||
|
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
function verifyENOENTSync(status, parsed) {
|
||||||
|
if (isWin && status === 1 && !parsed.file) {
|
||||||
|
return notFoundError(parsed.original, 'spawnSync');
|
||||||
|
}
|
||||||
|
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = {
|
||||||
|
hookChildProcess,
|
||||||
|
verifyENOENT,
|
||||||
|
verifyENOENTSync,
|
||||||
|
notFoundError,
|
||||||
|
};
|
|
@ -0,0 +1,91 @@
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
const path = require('path');
|
||||||
|
const resolveCommand = require('./util/resolveCommand');
|
||||||
|
const escape = require('./util/escape');
|
||||||
|
const readShebang = require('./util/readShebang');
|
||||||
|
|
||||||
|
const isWin = process.platform === 'win32';
|
||||||
|
const isExecutableRegExp = /\.(?:com|exe)$/i;
|
||||||
|
const isCmdShimRegExp = /node_modules[\\/].bin[\\/][^\\/]+\.cmd$/i;
|
||||||
|
|
||||||
|
function detectShebang(parsed) {
|
||||||
|
parsed.file = resolveCommand(parsed);
|
||||||
|
|
||||||
|
const shebang = parsed.file && readShebang(parsed.file);
|
||||||
|
|
||||||
|
if (shebang) {
|
||||||
|
parsed.args.unshift(parsed.file);
|
||||||
|
parsed.command = shebang;
|
||||||
|
|
||||||
|
return resolveCommand(parsed);
|
||||||
|
}
|
||||||
|
|
||||||
|
return parsed.file;
|
||||||
|
}
|
||||||
|
|
||||||
|
function parseNonShell(parsed) {
|
||||||
|
if (!isWin) {
|
||||||
|
return parsed;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Detect & add support for shebangs
|
||||||
|
const commandFile = detectShebang(parsed);
|
||||||
|
|
||||||
|
// We don't need a shell if the command filename is an executable
|
||||||
|
const needsShell = !isExecutableRegExp.test(commandFile);
|
||||||
|
|
||||||
|
// If a shell is required, use cmd.exe and take care of escaping everything correctly
|
||||||
|
// Note that `forceShell` is an hidden option used only in tests
|
||||||
|
if (parsed.options.forceShell || needsShell) {
|
||||||
|
// Need to double escape meta chars if the command is a cmd-shim located in `node_modules/.bin/`
|
||||||
|
// The cmd-shim simply calls execute the package bin file with NodeJS, proxying any argument
|
||||||
|
// Because the escape of metachars with ^ gets interpreted when the cmd.exe is first called,
|
||||||
|
// we need to double escape them
|
||||||
|
const needsDoubleEscapeMetaChars = isCmdShimRegExp.test(commandFile);
|
||||||
|
|
||||||
|
// Normalize posix paths into OS compatible paths (e.g.: foo/bar -> foo\bar)
|
||||||
|
// This is necessary otherwise it will always fail with ENOENT in those cases
|
||||||
|
parsed.command = path.normalize(parsed.command);
|
||||||
|
|
||||||
|
// Escape command & arguments
|
||||||
|
parsed.command = escape.command(parsed.command);
|
||||||
|
parsed.args = parsed.args.map((arg) => escape.argument(arg, needsDoubleEscapeMetaChars));
|
||||||
|
|
||||||
|
const shellCommand = [parsed.command].concat(parsed.args).join(' ');
|
||||||
|
|
||||||
|
parsed.args = ['/d', '/s', '/c', `"${shellCommand}"`];
|
||||||
|
parsed.command = process.env.comspec || 'cmd.exe';
|
||||||
|
parsed.options.windowsVerbatimArguments = true; // Tell node's spawn that the arguments are already escaped
|
||||||
|
}
|
||||||
|
|
||||||
|
return parsed;
|
||||||
|
}
|
||||||
|
|
||||||
|
function parse(command, args, options) {
|
||||||
|
// Normalize arguments, similar to nodejs
|
||||||
|
if (args && !Array.isArray(args)) {
|
||||||
|
options = args;
|
||||||
|
args = null;
|
||||||
|
}
|
||||||
|
|
||||||
|
args = args ? args.slice(0) : []; // Clone array to avoid changing the original
|
||||||
|
options = Object.assign({}, options); // Clone object to avoid changing the original
|
||||||
|
|
||||||
|
// Build our parsed object
|
||||||
|
const parsed = {
|
||||||
|
command,
|
||||||
|
args,
|
||||||
|
options,
|
||||||
|
file: undefined,
|
||||||
|
original: {
|
||||||
|
command,
|
||||||
|
args,
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
// Delegate further parsing to shell or non-shell
|
||||||
|
return options.shell ? parsed : parseNonShell(parsed);
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = parse;
|
|
@ -0,0 +1,45 @@
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
// See http://www.robvanderwoude.com/escapechars.php
|
||||||
|
const metaCharsRegExp = /([()\][%!^"`<>&|;, *?])/g;
|
||||||
|
|
||||||
|
function escapeCommand(arg) {
|
||||||
|
// Escape meta chars
|
||||||
|
arg = arg.replace(metaCharsRegExp, '^$1');
|
||||||
|
|
||||||
|
return arg;
|
||||||
|
}
|
||||||
|
|
||||||
|
function escapeArgument(arg, doubleEscapeMetaChars) {
|
||||||
|
// Convert to string
|
||||||
|
arg = `${arg}`;
|
||||||
|
|
||||||
|
// Algorithm below is based on https://qntm.org/cmd
|
||||||
|
|
||||||
|
// Sequence of backslashes followed by a double quote:
|
||||||
|
// double up all the backslashes and escape the double quote
|
||||||
|
arg = arg.replace(/(\\*)"/g, '$1$1\\"');
|
||||||
|
|
||||||
|
// Sequence of backslashes followed by the end of the string
|
||||||
|
// (which will become a double quote later):
|
||||||
|
// double up all the backslashes
|
||||||
|
arg = arg.replace(/(\\*)$/, '$1$1');
|
||||||
|
|
||||||
|
// All other backslashes occur literally
|
||||||
|
|
||||||
|
// Quote the whole thing:
|
||||||
|
arg = `"${arg}"`;
|
||||||
|
|
||||||
|
// Escape meta chars
|
||||||
|
arg = arg.replace(metaCharsRegExp, '^$1');
|
||||||
|
|
||||||
|
// Double escape meta chars if necessary
|
||||||
|
if (doubleEscapeMetaChars) {
|
||||||
|
arg = arg.replace(metaCharsRegExp, '^$1');
|
||||||
|
}
|
||||||
|
|
||||||
|
return arg;
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports.command = escapeCommand;
|
||||||
|
module.exports.argument = escapeArgument;
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue