@node-core/utils 7.2.0 → 7.2.2

package/node_modules/ansi-escapes/package.json

@@ -0,0 +1,70 @@
+{
+	"name": "ansi-escapes",
+	"version": "7.3.0",
+	"description": "ANSI escape codes for manipulating the terminal",
+	"license": "MIT",
+	"repository": "sindresorhus/ansi-escapes",
+	"funding": "https://github.com/sponsors/sindresorhus",
+	"author": {
+		"name": "Sindre Sorhus",
+		"email": "sindresorhus@gmail.com",
+		"url": "https://sindresorhus.com"
+	},
+	"type": "module",
+	"exports": {
+		"types": "./index.d.ts",
+		"default": "./index.js"
+	},
+	"sideEffects": false,
+	"engines": {
+		"node": ">=18"
+	},
+	"scripts": {
+		"test": "ava && tsd",
+		"//test": "xo && ava && tsd"
+	},
+	"files": [
+		"index.js",
+		"index.d.ts",
+		"base.js",
+		"base.d.ts"
+	],
+	"keywords": [
+		"ansi",
+		"terminal",
+		"console",
+		"cli",
+		"string",
+		"tty",
+		"escape",
+		"escapes",
+		"formatting",
+		"shell",
+		"xterm",
+		"log",
+		"logging",
+		"command-line",
+		"text",
+		"vt100",
+		"sequence",
+		"control",
+		"code",
+		"codes",
+		"cursor",
+		"iterm",
+		"iterm2",
+		"clear",
+		"screen",
+		"erase",
+		"scrollback"
+	],
+	"dependencies": {
+		"environment": "^1.0.0"
+	},
+	"devDependencies": {
+		"@types/node": "20.12.8",
+		"ava": "^6.1.2",
+		"tsd": "0.31.0",
+		"xo": "^0.58.0"
+	}
+}

package/node_modules/ansi-escapes/readme.md

@@ -0,0 +1,296 @@
+# ansi-escapes
+
+> [ANSI escape codes](https://www2.ccs.neu.edu/research/gpc/VonaUtils/vona/terminal/vtansi.htm) for manipulating the terminal
+
+## Install
+
+```sh
+npm install ansi-escapes
+```
+
+## Usage
+
+```js
+import ansiEscapes from 'ansi-escapes';
+
+// Moves the cursor two rows up and to the left
+process.stdout.write(ansiEscapes.cursorUp(2) + ansiEscapes.cursorLeft);
+//=> '\u001B[2A\u001B[1000D'
+```
+
+Or use named exports...
+
+```js
+import {cursorUp, cursorLeft} from 'ansi-escapes';
+
+// etc, as above...
+```
+
+**You can also use it in the browser with Xterm.js:**
+
+```js
+import ansiEscapes from 'ansi-escapes';
+import {Terminal} from 'xterm';
+import 'xterm/css/xterm.css';
+
+const terminal = new Terminal({…});
+
+// Moves the cursor two rows up and to the left
+terminal.write(ansiEscapes.cursorUp(2) + ansiEscapes.cursorLeft);
+//=> '\u001B[2A\u001B[1000D'
+```
+
+## API
+
+### cursorTo(x, y?)
+
+Set the absolute position of the cursor. `x0` `y0` is the top left of the screen.
+
+### cursorMove(x, y?)
+
+Set the position of the cursor relative to its current position.
+
+### cursorUp(count)
+
+Move cursor up a specific amount of rows. Default is `1`.
+
+### cursorDown(count)
+
+Move cursor down a specific amount of rows. Default is `1`.
+
+### cursorForward(count)
+
+Move cursor forward a specific amount of columns. Default is `1`.
+
+### cursorBackward(count)
+
+Move cursor backward a specific amount of columns. Default is `1`.
+
+### cursorLeft
+
+Move cursor to the left side.
+
+### cursorSavePosition
+
+Save cursor position.
+
+### cursorRestorePosition
+
+Restore saved cursor position.
+
+### cursorGetPosition
+
+Get cursor position.
+
+### cursorNextLine
+
+Move cursor to the next line.
+
+### cursorPrevLine
+
+Move cursor to the previous line.
+
+### cursorHide
+
+Hide cursor.
+
+### cursorShow
+
+Show cursor.
+
+### eraseLines(count)
+
+Erase from the current cursor position up the specified amount of rows.
+
+### eraseEndLine
+
+Erase from the current cursor position to the end of the current line.
+
+### eraseStartLine
+
+Erase from the current cursor position to the start of the current line.
+
+### eraseLine
+
+Erase the entire current line.
+
+### eraseDown
+
+Erase the screen from the current line down to the bottom of the screen.
+
+### eraseUp
+
+Erase the screen from the current line up to the top of the screen.
+
+### eraseScreen
+
+Erase the screen and move the cursor the top left position.
+
+### scrollUp
+
+Scroll display up one line.
+
+### scrollDown
+
+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.
+
+> [!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
+
+Clear the whole terminal, including scrollback buffer. (Not just the visible part of it)
+
+### enterAlternativeScreen
+
+Enter the [alternative screen](https://terminalguide.namepad.de/mode/p47/).
+
+### exitAlternativeScreen
+
+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.
+
+### link(text, url)
+
+Create a clickable link.
+
+[Supported terminals.](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda) Use [`supports-hyperlinks`](https://github.com/jamestalmage/supports-hyperlinks) to detect link support.
+
+### image(filePath, options?)
+
+Display an image.
+
+See [term-img](https://github.com/sindresorhus/term-img) for a higher-level module.
+
+#### input
+
+Type: `Buffer`
+
+Buffer of an image. Usually read in with `fs.readFile()`.
+
+#### options
+
+Type: `object`
+
+##### width
+##### height
+
+Type: `string | number`
+
+The width and height are given as a number followed by a unit, or the word "auto".
+
+- `N`: N character cells.
+- `Npx`: N pixels.
+- `N%`: N percent of the session's width or height.
+- `auto`: The image's inherent size will be used to determine an appropriate dimension.
+
+##### preserveAspectRatio
+
+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`\
+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.
+
+An annotation looks like this when shown:
+
+<img src="https://user-images.githubusercontent.com/924465/64382136-b60ac700-cfe9-11e9-8a35-9682e8dc4b72.png" width="500">
+
+See the [iTerm Proprietary Escape Codes documentation](https://iterm2.com/documentation-escape-codes.html) for more information.
+
+#### message
+
+Type: `string`
+
+The message to display within the annotation.
+
+The `|` character is disallowed and will be stripped.
+
+#### options
+
+Type: `object`
+
+##### length
+
+Type: `number`\
+Default: The remainder of the line
+
+Nonzero number of columns to annotate.
+
+##### x
+
+Type: `number`\
+Default: Cursor position
+
+Starting X coordinate.
+
+Must be used with `y` and `length`.
+
+##### y
+
+Type: `number`\
+Default: Cursor position
+
+Starting Y coordinate.
+
+Must be used with `x` and `length`.
+
+##### isHidden
+
+Type: `boolean`\
+Default: `false`
+
+Create a "hidden" annotation.
+
+Annotations created this way can be shown using the "Show Annotations" iTerm command.
+
+## Related
+
+- [ansi-styles](https://github.com/chalk/ansi-styles) - ANSI escape codes for styling strings in the terminal

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}`);
 }