Wrap ANSI

import wrapAnsi from 'wrap-ansi';

import wrapAnsi, { type Options } from 'wrap-ansi';

const wrapAnsi = require('wrap-ansi');

import chalk from 'chalk';
import wrapAnsi from 'wrap-ansi';

const input = 'The quick brown ' + chalk.red('fox jumped over ') +
	'the lazy ' + chalk.green('dog and then ran away with the unicorn.');

console.log(wrapAnsi(input, 20));
// Output: properly wrapped text with preserved ANSI styling

/**
 * Wrap words to the specified column width.
 * @param string - A string with ANSI escape codes, like one styled by chalk. Newline characters will be normalized to \n.
 * @param columns - The number of columns to wrap the text to.
 * @param options - Optional configuration object for wrapping behavior.
 * @returns String with proper line wrapping and preserved ANSI styling.
 */
export default function wrapAnsi(string: string, columns: number, options?: Options): string;

import wrapAnsi from 'wrap-ansi';
import chalk from 'chalk';

// Basic wrapping
const text = 'This is a long line that needs to be wrapped at a specific width.';
const wrapped = wrapAnsi(text, 20);
console.log(wrapped);

// Wrapping with ANSI colors
const coloredText = chalk.blue('Hello ') + chalk.red('colorful ') + chalk.green('world!');
const wrappedColored = wrapAnsi(coloredText, 10);
console.log(wrappedColored);

// Hard wrap mode - breaks long words
const longWord = 'supercalifragilisticexpialidocious';
const hardWrapped = wrapAnsi(longWord, 10, { hard: true });
console.log(hardWrapped);

// Disable word wrapping - fill columns completely
const noWordWrap = wrapAnsi('word1 word2 word3', 8, { wordWrap: false });
console.log(noWordWrap);

// Preserve whitespace
const preserveWhitespace = wrapAnsi('  spaced  text  ', 10, { trim: false });
console.log(preserveWhitespace);

interface Options {
	/**
	 * By default the wrap is soft, meaning long words may extend past the column width. 
	 * Setting this to true will make it hard wrap at the column width.
	 * @default false
	 */
	readonly hard?: boolean;

	/**
	 * By default, an attempt is made to split words at spaces, ensuring that they don't extend past the configured columns. 
	 * If wordWrap is false, each column will instead be completely filled splitting words as necessary.
	 * @default true
	 */
	readonly wordWrap?: boolean;

	/**
	 * Whitespace on all lines is removed by default. Set this option to false if you don't want to trim.
	 * @default true
	 */
	readonly trim?: boolean;
}