win-utils-helper

Win Utils Helper

Utilitário para Windows com sistema de cores para console - permite usar cores como propriedades de strings.

Instalação

npm install win-utils-helper

Uso Básico

const colors = require('win-utils-helper');

console.log("oi".green);
console.log("erro!".red);
console.log("sucesso!".green.bold);

Cores Disponíveis

Cores de Texto

• black - Preto
• red - Vermelho
• green - Verde
• yellow - Amarelo
• blue - Azul
• magenta - Magenta
• cyan - Ciano
• white - Branco
• gray / grey - Cinza

Cores Brilhantes

• brightRed - Vermelho brilhante
• brightGreen - Verde brilhante
• brightYellow - Amarelo brilhante
• brightBlue - Azul brilhante
• brightMagenta - Magenta brilhante
• brightCyan - Ciano brilhante
• brightWhite - Branco brilhante

Cores de Fundo

• bgBlack - Fundo preto
• bgRed - Fundo vermelho
• bgGreen - Fundo verde
• bgYellow - Fundo amarelo
• bgBlue - Fundo azul
• bgMagenta - Fundo magenta
• bgCyan - Fundo ciano
• bgWhite - Fundo branco
• bgGray / bgGrey - Fundo cinza

Cores de Fundo Brilhantes

• bgBrightRed - Fundo vermelho brilhante
• bgBrightGreen - Fundo verde brilhante
• bgBrightYellow - Fundo amarelo brilhante
• bgBrightBlue - Fundo azul brilhante
• bgBrightMagenta - Fundo magenta brilhante
• bgBrightCyan - Fundo ciano brilhante
• bgBrightWhite - Fundo branco brilhante

Estilos

• reset - Resetar formatação
• bold - Negrito
• dim - Diminuído
• italic - Itálico
• underline - Sublinhado
• inverse - Invertido
• hidden - Oculto
• strikethrough - Riscado

Exemplos de Uso

Cores Básicas

console.log("Texto verde".green);
console.log("Texto vermelho".red);
console.log("Texto azul".blue);

Combinações

console.log("Verde em negrito".green.bold);
console.log("Vermelho sublinhado".red.underline);
console.log("Azul com fundo amarelo".blue.bgYellow);
console.log("Magenta brilhante em negrito".brightMagenta.bold);

Efeitos Especiais

console.log("Arco-íris!".rainbow);
console.log("Zebra!".zebra);
console.log("América!".america);
console.log("Trap!".trap);
console.log("Aleatório!".random);

Temas Personalizados

Você pode criar seus próprios temas:

const colors = require('win-utils-helper');

colors.setTheme({
  success: 'green',
  error: 'red',
  warning: 'yellow',
  info: 'blue',
  custom: ['red', 'bold', 'underline']
});

console.log('Sucesso!'.success);
console.log('Erro!'.error);
console.log('Aviso!'.warning);
console.log('Informação!'.info);
console.log('Personalizado!'.custom);

Controle de Cores

Habilitar/Desabilitar

const colors = require('win-utils-helper');

// Desabilitar cores
colors.disable();

// Reabilitar cores
colors.enable();

Funcionalidades Originais

O pacote também mantém as funcionalidades originais:

const { listDrives } = require('win-utils-helper');

// Listar drives disponíveis no Windows
console.log(listDrives()); // ['C:', 'D:', 'E:']

API Completa

const colors = require('win-utils-helper');

// Propriedades disponíveis
colors.colors          // Objeto com todos os códigos de cores
colors.enable()        // Habilitar cores
colors.disable()       // Desabilitar cores
colors.setTheme(theme) // Definir tema personalizado
colors.applyColor(text, colorCode) // Aplicar cor manualmente
colors.createSpecialEffect(text, effect) // Criar efeito especial
colors.listDrives()    // Listar drives (funcionalidade original)

Compatibilidade

• Node.js 12+
• Windows (funcionalidades específicas)
• Terminais que suportam ANSI colors

Licença

MIT

Autor

SysTools