us (similar to applyUndefinedStyles)

applyUndefinedStyles (aliased as us) is a safe wrapper around s() that only applies styling when a StyleOptions object is actually provided. If style is undefined, the original string is returned unchanged — making it ideal for optional styling in components and utilities.

Signature

function applyUndefinedStyles(str: string, style?: StyleOptions): string

Parameters

• str: The string to optionally style.
• style: An optional StyleOptions object. If omitted or undefined, str is returned as-is.

Return Value

The styled string if style was provided, otherwise the original str.

Aliases

Exported as both applyUndefinedStyles and us.

Usage

import { us } from "ts-better-console";

function label(text: string, style?: StyleOptions) {
return us(text, style);
}

// Styled when style is provided
label("OK", { color: "green" });

// Plain string when style is omitted
label("OK");