clearStyle

The clearStyle function appends targeted ANSI reset escape codes to the end of a string based on the provided ClearStyleOptions. Instead of a blanket \x1b[0m reset, it uses precise codes: DEFAULT_COLOR (\x1b[39m) for foreground color, DEFAULT_BACKGROUND (\x1b[49m) for background color, and NORMAL_INTENSITY (\x1b[22m) for bold/dim styles. Falls back to a full \x1b[0m reset only when called with no options. This is useful when working with the endless option in s().

Signature

function clearStyle(str: string, options?: ClearStyleOptions): string

Parameters

• str: The string to append the reset codes to.
• options (optional): A ClearStyleOptions object controlling which attributes to reset:
  • color: reset foreground color with DEFAULT_COLOR (\x1b[39m)
  • backgroundColor: reset background color with DEFAULT_BACKGROUND (\x1b[49m)
  • style: reset individual styles; bold/dim use NORMAL_INTENSITY (\x1b[22m)

Return Value

Returns the original string with the appropriate targeted reset escape codes appended. When no options are provided, falls back to a full \x1b[0m reset.

Usage

import { s, clearStyle, cs } from "ts-better-console";


const styled = s("Red text", { color: "red", endless: true });
const result = clearStyle(cs([styled, "normal text"], false), { color: true });

console.log(result);