@node-core/utils 7.1.0 → 7.2.1

package/node_modules/{log-update/node_modules/ansi-escapes → ansi-escapes}/base.d.ts

@@ -200,7 +200,21 @@ Scroll display down one line.
 export const scrollDown: string;
 
 /**
-Clear the terminal screen. (Viewport)
+Clear only the visible terminal screen (viewport) without affecting scrollback buffer or terminal state.
+
+This is a safer alternative to `clearScreen` that works consistently across terminals.
+*/
+export const clearViewport: string;
+
+/**
+Clear the terminal screen.
+
+⚠️ **Warning:** Uses RIS (Reset to Initial State) which may also:
+- Clear scrollback buffer in some terminals (xterm.js, VTE)
+- Reset terminal modes and state
+- Not behave consistently across different terminals
+
+Consider using `clearViewport` for safer viewport-only clearing.
 */
 export const clearScreen: string;
 
@@ -219,6 +233,21 @@ Exit the [alternative screen](https://terminalguide.namepad.de/mode/p47/), assum
 */
 export const exitAlternativeScreen: string;
 
+/**
+Begin [synchronized output](https://contour-terminal.org/vt-extensions/synchronized-output/) to reduce flicker during renders.
+*/
+export const beginSynchronizedOutput: string;
+
+/**
+End [synchronized output](https://contour-terminal.org/vt-extensions/synchronized-output/).
+*/
+export const endSynchronizedOutput: string;
+
+/**
+Wrap output in [synchronized output](https://contour-terminal.org/vt-extensions/synchronized-output/) sequences to reduce flicker during renders.
+*/
+export function synchronizedOutput(text: string): string;
+
 /**
 Output a beeping sound.
 */
@@ -246,7 +275,7 @@ export const iTerm: {
 
 	@param cwd - Current directory. Default: `process.cwd()`.
 	*/
-	setCwd(cwd?: string): string,
+	setCwd(cwd?: string): string;
 
 	/**
 	An annotation looks like this when shown:
@@ -258,5 +287,21 @@ export const iTerm: {
 	@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
+	annotation(message: string, options?: AnnotationOptions): string;
+};
+
+export const ConEmu: {
+	/**
+	[Inform ConEmu](https://conemu.github.io/en/AnsiEscapeCodes.html#ConEmu_specific_OSC) about shell current working directory.
+
+	@param cwd - Current directory. Default: `process.cwd()`.
+	*/
+	setCwd(cwd?: string): string;
 };
+
+/**
+Set the current working directory for both iTerm2 and ConEmu.
+
+@param cwd - Current directory. Default: `process.cwd()`.
+*/
+export function setCwd(cwd?: string): string;

package/node_modules/{log-update/node_modules/ansi-escapes → ansi-escapes}/base.js

@@ -1,4 +1,5 @@
 import process from 'node:process';
+import os from 'node:os';
 import {isBrowser} from 'environment';
 
 const ESC = '\u001B[';
@@ -8,11 +9,23 @@ const SEP = ';';
 
 const isTerminalApp = !isBrowser && process.env.TERM_PROGRAM === 'Apple_Terminal';
 const isWindows = !isBrowser && process.platform === 'win32';
+const isTmux = !isBrowser && (process.env.TERM?.startsWith('screen') || process.env.TERM?.startsWith('tmux') || process.env.TMUX !== undefined);
 
 const cwdFunction = isBrowser ? () => {
 	throw new Error('`process.cwd()` only works in Node.js, not the browser.');
 } : process.cwd;
 
+const wrapOsc = sequence => {
+	if (isTmux) {
+		// Tmux requires OSC sequences to be wrapped with DCS tmux; <sequence> ST
+		// and all ESCs in <sequence> to be replaced with ESC ESC.
+		// It only accepts ESC backslash for ST.
+		return '\u001BPtmux;' + sequence.replaceAll('\u001B', '\u001B\u001B') + '\u001B\\';
+	}
+
+	return sequence;
+};
+
 export const cursorTo = (x, y) => {
 	if (typeof x !== 'number') {
 		throw new TypeError('The `x` argument is required');
@@ -86,33 +99,50 @@ export const scrollDown = ESC + 'T';
 
 export const clearScreen = '\u001Bc';
 
-export const clearTerminal = isWindows
+export const clearViewport = `${eraseScreen}${ESC}H`;
+
+const isOldWindows = () => {
+	if (isBrowser || !isWindows) {
+		return false;
+	}
+
+	const parts = os.release().split('.');
+	const major = Number(parts[0]);
+	const build = Number(parts[2] ?? 0);
+
+	if (major < 10) {
+		return true;
+	}
+
+	if (major === 10 && build < 10_586) {
+		return true;
+	}
+
+	return false;
+};
+
+export const clearTerminal = isOldWindows()
 	? `${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`;
+	: `${eraseScreen}${ESC}3J${ESC}H`;
 
 export const enterAlternativeScreen = ESC + '?1049h';
 export const exitAlternativeScreen = ESC + '?1049l';
 
+export const beginSynchronizedOutput = ESC + '?2026h';
+export const endSynchronizedOutput = ESC + '?2026l';
+export const synchronizedOutput = text => beginSynchronizedOutput + text + endSynchronizedOutput;
+
 export const beep = BEL;
 
-export const link = (text, url) => [
-	OSC,
-	'8',
-	SEP,
-	SEP,
-	url,
-	BEL,
-	text,
-	OSC,
-	'8',
-	SEP,
-	SEP,
-	BEL,
-].join('');
+export const link = (text, url) => {
+	const openLink = wrapOsc(`${OSC}8${SEP}${SEP}${url}${BEL}`);
+	const closeLink = wrapOsc(`${OSC}8${SEP}${SEP}${BEL}`);
+	return openLink + text + closeLink;
+};
 
 export const image = (data, options = {}) => {
 	let returnValue = `${OSC}1337;File=inline=1`;
@@ -129,11 +159,14 @@ export const image = (data, options = {}) => {
 		returnValue += ';preserveAspectRatio=0';
 	}
 
-	return returnValue + ':' + Buffer.from(data).toString('base64') + BEL;
+	const imageBuffer = Buffer.from(data);
+
+	// `size` is optional in the spec, but xterm.js requires it.
+	return wrapOsc(returnValue + `;size=${imageBuffer.byteLength}` + ':' + imageBuffer.toString('base64') + BEL);
 };
 
 export const iTerm = {
-	setCwd: (cwd = cwdFunction()) => `${OSC}50;CurrentDir=${cwd}${BEL}`,
+	setCwd: (cwd = cwdFunction()) => wrapOsc(`${OSC}50;CurrentDir=${cwd}${BEL}`),
 
 	annotation(message, options = {}) {
 		let returnValue = `${OSC}1337;`;
@@ -158,6 +191,12 @@ export const iTerm = {
 			returnValue += message;
 		}
 
-		return returnValue + BEL;
+		return wrapOsc(returnValue + BEL);
 	},
 };
+
+export const ConEmu = {
+	setCwd: (cwd = cwdFunction()) => wrapOsc(`${OSC}9;9;${cwd}${BEL}`),
+};
+
+export const setCwd = (cwd = cwdFunction()) => iTerm.setCwd(cwd) + ConEmu.setCwd(cwd);

package/node_modules/{log-update/node_modules/ansi-escapes → ansi-escapes}/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ansi-escapes",
-	"version": "7.0.0",
+	"version": "7.3.0",
 	"description": "ANSI escape codes for manipulating the terminal",
 	"license": "MIT",
 	"repository": "sindresorhus/ansi-escapes",

package/node_modules/{log-update/node_modules/ansi-escapes → ansi-escapes}/readme.md

@@ -134,9 +134,18 @@ Scroll display up one line.
 
 Scroll display down one line.
 
+### clearViewport
+
+Clear only the visible terminal screen (viewport) without affecting scrollback buffer or terminal state.
+
+This is a safer alternative to `clearScreen` that works consistently across terminals.
+
 ### clearScreen
 
-Clear the terminal screen. (Viewport)
+Clear the terminal screen.
+
+> [!WARNING]
+> This uses RIS (Reset to Initial State) which may also clear scrollback buffer in some terminals (xterm.js, VTE) and reset terminal modes. Consider using `clearViewport()` for safer viewport-only clearing.
 
 ### clearTerminal
 
@@ -150,6 +159,18 @@ Enter the [alternative screen](https://terminalguide.namepad.de/mode/p47/).
 
 Exit the [alternative screen](https://terminalguide.namepad.de/mode/p47/), assuming `enterAlternativeScreen` was called before.
 
+### beginSynchronizedOutput
+
+Begin [synchronized output](https://contour-terminal.org/vt-extensions/synchronized-output/) to reduce flicker during renders.
+
+### endSynchronizedOutput
+
+End [synchronized output](https://contour-terminal.org/vt-extensions/synchronized-output/).
+
+### synchronizedOutput(text)
+
+Wrap output in [synchronized output](https://contour-terminal.org/vt-extensions/synchronized-output/) sequences to reduce flicker during renders.
+
 ### beep
 
 Output a beeping sound.
@@ -193,6 +214,13 @@ The width and height are given as a number followed by a unit, or the word "auto
 Type: `boolean`\
 Default: `true`
 
+### setCwd(path?)
+
+Type: `string`\
+Default: `process.cwd()`
+
+Set the current working directory for both iTerm2 and ConEmu.
+
 ### iTerm.setCwd(path?)
 
 Type: `string`\
@@ -200,6 +228,13 @@ 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).
 
+### ConEmu.setCwd(path?)
+
+Type: `string`\
+Default: `process.cwd()`
+
+[Inform ConEmu](https://conemu.github.io/en/AnsiEscapeCodes.html#ConEmu_specific_OSC) about shell current working directory.
+
 ### iTerm.annotation(message, options?)
 
 Creates an escape code to display an "annotation" in iTerm2.

package/node_modules/ansi-regex/index.js

@@ -1,10 +1,15 @@
 export default function ansiRegex({onlyFirst = false} = {}) {
 	// Valid string terminator sequences are BEL, ESC\, and 0x9c
 	const ST = '(?:\\u0007|\\u001B\\u005C|\\u009C)';
-	const pattern = [
-		`[\\u001B\\u009B][[\\]()#;?]*(?:(?:(?:(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]+)*|[a-zA-Z\\d]+(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]*)*)?${ST})`,
-		'(?:(?:\\d{1,4}(?:;\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]))',
-	].join('|');
+
+	// OSC sequences only: ESC ] ... ST
+	// The payload stops at the first terminator character rather than scanning ahead for one, so an unterminated `ESC ]` cannot rescan the rest of the input. Terminals likewise abort a control string on an unexpected ESC.
+	const osc = `(?:\\u001B\\][^\\u0007\\u001B\\u009C]*${ST})`;
+
+	// CSI and related: ESC/C1, optional intermediates, optional params (supports ; and :) then final byte
+	const csi = '[\\u001B\\u009B][[\\]()#;?]*(?:\\d{1,4}(?:[;:]\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]';
+
+	const pattern = `${osc}|${csi}`;
 
 	return new RegExp(pattern, onlyFirst ? undefined : 'g');
 }

package/node_modules/ansi-regex/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ansi-regex",
-	"version": "6.1.0",
+	"version": "6.3.0",
 	"description": "Regular expression for matching ANSI escape codes",
 	"license": "MIT",
 	"repository": "chalk/ansi-regex",

package/node_modules/ansi-regex/readme.md

@@ -46,6 +46,12 @@ Default: `false` *(Matches any ANSI escape codes in a string)*
 
 Match only the first ANSI escape.
 
+## Important
+
+If you run the regex against untrusted user input in a server context, you should [give it a timeout](https://github.com/sindresorhus/super-regex).
+
+**I do not consider [ReDoS](https://blog.yossarian.net/2022/12/28/ReDoS-vulnerabilities-and-misaligned-incentives) a valid vulnerability for this package.**
+
 ## FAQ
 
 ### Why do you test for codes not in the ECMA 48 standard?

package/node_modules/ansi-styles/index.d.ts

@@ -1,4 +1,4 @@
-export interface CSPair { // eslint-disable-line @typescript-eslint/naming-convention
+export type CSPair = { // eslint-disable-line @typescript-eslint/naming-convention
 	/**
 	The ANSI terminal control sequence for starting this style.
 	*/
@@ -8,9 +8,9 @@ export interface CSPair { // eslint-disable-line @typescript-eslint/naming-conve
 	The ANSI terminal control sequence for ending this style.
 	*/
 	readonly close: string;
-}
+};
 
-export interface ColorBase {
+export type ColorBase = {
 	/**
 	The ANSI terminal control sequence for ending this color.
 	*/
@@ -21,9 +21,9 @@ export interface ColorBase {
 	ansi256(code: number): string;
 
 	ansi16m(red: number, green: number, blue: number): string;
-}
+};
 
-export interface Modifier {
+export type Modifier = {
 	/**
 	Resets the current color chain.
 	*/
@@ -70,9 +70,9 @@ export interface Modifier {
 	Puts a horizontal line through the center of the text. (Not widely supported)
 	*/
 	readonly strikethrough: CSPair;
-}
+};
 
-export interface ForegroundColor {
+export type ForegroundColor = {
 	readonly black: CSPair;
 	readonly red: CSPair;
 	readonly green: CSPair;
@@ -100,9 +100,9 @@ export interface ForegroundColor {
 	readonly cyanBright: CSPair;
 	readonly magentaBright: CSPair;
 	readonly whiteBright: CSPair;
-}
+};
 
-export interface BackgroundColor {
+export type BackgroundColor = {
 	readonly bgBlack: CSPair;
 	readonly bgRed: CSPair;
 	readonly bgGreen: CSPair;
@@ -130,9 +130,9 @@ export interface BackgroundColor {
 	readonly bgCyanBright: CSPair;
 	readonly bgMagentaBright: CSPair;
 	readonly bgWhiteBright: CSPair;
-}
+};
 
-export interface ConvertColor {
+export type ConvertColor = {
 	/**
 	Convert from the RGB color space to the ANSI 256 color space.
 
@@ -178,7 +178,7 @@ export interface ConvertColor {
 	@param hex - A hexadecimal string containing RGB data.
 	*/
 	hexToAnsi(hex: string): number;
-}
+};
 
 /**
 Basic modifier names.

package/node_modules/ansi-styles/index.js

@@ -109,7 +109,7 @@ function assembleStyles() {
 	// From https://github.com/Qix-/color-convert/blob/3f0e0d4e92e235796ccb17f6e85c72094a651f49/conversions.js
 	Object.defineProperties(styles, {
 		rgbToAnsi256: {
-			value: (red, green, blue) => {
+			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) {
@@ -132,7 +132,7 @@ function assembleStyles() {
 			enumerable: false,
 		},
 		hexToRgb: {
-			value: hex => {
+			value(hex) {
 				const matches = /[a-f\d]{6}|[a-f\d]{3}/i.exec(hex.toString(16));
 				if (!matches) {
 					return [0, 0, 0];
@@ -161,7 +161,7 @@ function assembleStyles() {
 			enumerable: false,
 		},
 		ansi256ToAnsi: {
-			value: code => {
+			value(code) {
 				if (code < 8) {
 					return 30 + code;
 				}

package/node_modules/ansi-styles/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ansi-styles",
-	"version": "6.2.1",
+	"version": "6.2.3",
 	"description": "ANSI escape codes for styling strings in the terminal",
 	"license": "MIT",
 	"repository": "chalk/ansi-styles",
@@ -46,9 +46,9 @@
 		"text"
 	],
 	"devDependencies": {
-		"ava": "^3.15.0",
+		"ava": "^6.1.3",
 		"svg-term-cli": "^2.1.1",
-		"tsd": "^0.19.0",
-		"xo": "^0.47.0"
+		"tsd": "^0.31.1",
+		"xo": "^0.58.0"
 	}
 }

package/node_modules/cli-truncate/index.d.ts

@@ -76,7 +76,7 @@ export type Options = {
 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.
+@param columns - The finite number of columns to occupy in the terminal.
 
 @example
 ```
@@ -107,12 +107,12 @@ 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);
+cliTruncate(paragraph, process.stdout.columns ?? 80);
 //=> 'Lorem ipsum dolor sit amet, consectetuer adipiscing…'
 ```
 */
 export default function cliTruncate(
 	text: string,
 	columns: number,
-	options?: Options
+	options?: Options,
 ): string;

package/node_modules/cli-truncate/index.js

@@ -1,6 +1,8 @@
 import sliceAnsi from 'slice-ansi';
 import stringWidth from 'string-width';
 
+const validPositions = new Set(['start', 'middle', 'end']);
+
 function getIndexOfNearestSpace(string, wantedIndex, shouldSearchRight) {
 	if (string.charAt(wantedIndex) === ' ') {
 		return wantedIndex;
@@ -18,6 +20,28 @@ function getIndexOfNearestSpace(string, wantedIndex, shouldSearchRight) {
 	return wantedIndex;
 }
 
+function validateInput(text, columns, position, truncationCharacter) {
+	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 (!Number.isFinite(columns)) {
+		throw new TypeError(`Expected \`columns\` to be a finite number, got ${columns}`);
+	}
+
+	if (!validPositions.has(position)) {
+		throw new TypeError(`Expected \`options.position\` to be either \`start\`, \`middle\` or \`end\`, got ${position}`);
+	}
+
+	if (typeof truncationCharacter !== 'string') {
+		throw new TypeError(`Expected \`options.truncationCharacter\` to be a string, got ${typeof truncationCharacter}`);
+	}
+}
+
 export default function cliTruncate(text, columns, options = {}) {
 	const {
 		position = 'end',
@@ -27,13 +51,7 @@ export default function cliTruncate(text, columns, 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}`);
-	}
+	validateInput(text, columns, position, truncationCharacter);
 
 	if (columns < 1) {
 		return '';
@@ -116,7 +134,7 @@ export default function cliTruncate(text, columns, options = {}) {
 
 	if (position === 'start') {
 		if (preferTruncationOnSpace) {
-			const nearestSpace = getIndexOfNearestSpace(text, length - columns + 1, true);
+			const nearestSpace = getIndexOfNearestSpace(text, length - columns + stringWidth(truncationCharacter), true);
 			const right = sliceAnsi(text, nearestSpace, length).trim();
 			return prependWithInheritedStyleFromStart(truncationCharacter, right);
 		}
@@ -132,26 +150,36 @@ export default function cliTruncate(text, columns, options = {}) {
 	if (position === 'middle') {
 		if (space) {
 			truncationCharacter = ` ${truncationCharacter} `;
+
+			// Drop the padding spaces if the padded character does not fit, so the
+			// truncation character itself never exceeds the budget.
+			if (stringWidth(truncationCharacter) >= columns) {
+				truncationCharacter = truncationCharacter.trim();
+			}
 		}
 
-		const half = Math.floor(columns / 2);
+		const truncationWidth = stringWidth(truncationCharacter);
+		// Reserve room for the truncation character before splitting the budget
+		// between the two sides, otherwise small budgets overflow (e.g. a width of
+		// 4 was returned for `columns: 2`).
+		const half = Math.min(Math.floor(columns / 2), Math.max(0, columns - truncationWidth));
 
 		if (preferTruncationOnSpace) {
 			const spaceNearFirstBreakPoint = getIndexOfNearestSpace(text, half);
-			const spaceNearSecondBreakPoint = getIndexOfNearestSpace(text, length - (columns - half) + 1, true);
+			const spaceNearSecondBreakPoint = getIndexOfNearestSpace(text, length - (columns - half) + truncationWidth, 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)
+			+ sliceAnsi(text, length - (columns - half) + truncationWidth, length)
 		);
 	}
 
 	if (position === 'end') {
 		if (preferTruncationOnSpace) {
-			const nearestSpace = getIndexOfNearestSpace(text, columns - 1);
+			const nearestSpace = getIndexOfNearestSpace(text, columns - stringWidth(truncationCharacter));
 			const left = sliceAnsi(text, 0, nearestSpace);
 			return appendWithInheritedStyleFromEnd(left, truncationCharacter);
 		}
@@ -163,6 +191,4 @@ export default function cliTruncate(text, columns, options = {}) {
 		const left = sliceAnsi(text, 0, columns - stringWidth(truncationCharacter));
 		return appendWithInheritedStyleFromEnd(left, truncationCharacter);
 	}
-
-	throw new Error(`Expected \`options.position\` to be either \`start\`, \`middle\` or \`end\`, got ${position}`);
 }