@node-core/utils 7.2.0 → 7.2.1

package/lib/ci/build-types/test_build.js

@@ -1,4 +1,4 @@
-import chalk from 'chalk';
+import { styleText } from 'node:util';
 
 import { shortSha } from '../../utils.js';
 import {
@@ -119,11 +119,11 @@ export class TestBuild extends Job {
       cli.table('Built On', failure.builtOn);
     }
     if (!reason.includes('\n') && reason.length < 40) {
-      cli.table('Reason', chalk.red(reason));
+      cli.table('Reason', styleText('red', reason));
     } else {
       cli.table('Reason', '');
       const lines = reason.split('\n');
-      cli.log(`  ${chalk.red(lines[0])}`);
+      cli.log(`  ${styleText('red', lines[0])}`);
       for (let i = 1; i < lines.length; ++i) {
         cli.log(`  ${lines[i]}`);
       }

package/lib/ci/failure_aggregator.js

@@ -1,4 +1,4 @@
-import chalk from 'chalk';
+import { styleText } from 'node:util';
 
 import { getMachineUrl, parsePRFromURL } from '../links.js';
 import CIFailureParser from './ci_failure_parser.js';
@@ -140,7 +140,7 @@ export class FailureAggregator {
           cli.table('First CI', `${prs[0].upstream}`);
         }
         cli.table('Last CI', `${prs[prs.length - 1].upstream}`);
-        cli.log('\n' + chalk.bold('Example: ') + `${failures[0].url}\n`);
+        cli.log('\n' + styleText('bold', 'Example: ') + `${failures[0].url}\n`);
         const example = failures[0].reason;
         cli.log(example.length > 512 ? example.slice(0, 512) + '...' : example);
         cli.separator();

package/lib/ci/run_ci.js

@@ -73,9 +73,10 @@ export class RunPRJob {
   }
 
   async start() {
-    const { cli, request, certifySafe, checkForDuplicates } = this;
+    const { cli, request, checkForDuplicates } = this;
+    const certifySafe = await this.certifySafe;
 
-    if (!(await certifySafe)) {
+    if (!certifySafe) {
       cli.error('Refusing to run CI on potentially unsafe PR');
       return false;
     }

package/lib/cli.js

@@ -1,5 +1,5 @@
 import ora from 'ora';
-import chalk from 'chalk';
+import { styleText } from 'node:util';
 import * as inquirer from '@inquirer/prompts';
 
 import { warning, error, info, success } from './figures.js';
@@ -22,7 +22,7 @@ const QUESTION_TYPE = {
 const formatter = new Intl.ListFormat('en', { type: 'disjunction' });
 
 function head(text, length = 11) {
-  return chalk.bold(text.padEnd(length));
+  return styleText('bold', text.padEnd(length));
 }
 
 export default class CLI {
@@ -180,9 +180,9 @@ export default class CLI {
     const rest = (length - text.length - 2);
     const half = sep.repeat(Math.abs(Math.floor(rest / 2)));
     if (rest % 2 === 0) {
-      this.log(`${half} ${chalk.bold(text)} ${half}`);
+      this.log(`${half} ${styleText('bold', text)} ${half}`);
     } else {
-      this.log(`${half} ${chalk.bold(text)} ${sep}${half}`);
+      this.log(`${half} ${styleText('bold', text)} ${sep}${half}`);
     }
   }
 
@@ -193,7 +193,7 @@ export default class CLI {
 
   warn(text, options = {}) {
     const prefix = options.newline ? this.eolIndent : this.figureIndent;
-    this.log(prefix + chalk.bold(`${warning}  ${text}`));
+    this.log(prefix + styleText('bold', `${warning}  ${text}`));
   }
 
   info(text, options = {}) {
@@ -210,7 +210,7 @@ export default class CLI {
         this.log(JSON.stringify(obj.data, null, 2));
       }
     } else {
-      this.log(prefix + chalk.bold(`${error}  ${obj}`));
+      this.log(prefix + styleText('bold', `${error}  ${obj}`));
     }
   }
 

package/lib/figures.js

@@ -1,7 +1,7 @@
-import chalk from 'chalk';
-import figures from 'figures';
+import { figures } from 'listr2';
+import { styleText } from 'node:util';
 
-export const warning = chalk.yellow(figures.warning);
-export const error = chalk.red(figures.cross);
-export const info = chalk.blue(figures.info);
-export const success = chalk.green(figures.tick);
+export const warning = styleText('yellow', figures.warning);
+export const error = styleText('red', figures.cross);
+export const info = styleText('blue', figures.info);
+export const success = styleText('green', figures.tick);

package/lib/update-v8/backport.js

@@ -3,8 +3,8 @@ import {
   promises as fs
 } from 'node:fs';
 
-import { confirm } from '@inquirer/prompts';
-import { ListrEnquirerPromptAdapter } from '@listr2/prompt-adapter-enquirer';
+import { confirm, input } from '@inquirer/prompts';
+import { ListrInquirerPromptAdapter } from '@listr2/prompt-adapter-inquirer';
 
 import { shortSha } from '../utils.js';
 
@@ -263,8 +263,7 @@ async function applyPatch(ctx, task, patch, method = 'apply') {
     );
   } catch {
     patch.hadConflicts = true;
-    return task.prompt(ListrEnquirerPromptAdapter).run({
-      type: 'input',
+    return task.prompt(ListrInquirerPromptAdapter).run(input, {
       message: "Resolve merge conflicts and enter 'RESOLVED'",
       validate: value => value.toUpperCase() === 'RESOLVED'
     });

package/lib/verbosity.js

@@ -1,6 +1,4 @@
-import util from 'node:util';
-
-import chalk from 'chalk';
+import { format, styleText } from 'node:util';
 
 const VERBOSITY = {
   NONE: 0,
@@ -25,5 +23,5 @@ export function setVerbosityFromEnv() {
 
 export function debuglog(...args) {
   // Prepend a line break in case it's logged while the spinner is running
-  console.error(chalk.green(util.format('\n[DEBUG]', ...args)));
+  console.error('\n' + styleText('green', format('[DEBUG]', ...args)));
 }

package/node_modules/@listr2/{prompt-adapter-enquirer → prompt-adapter-inquirer}/README.md

@@ -1,6 +1,6 @@
-# @listr2/prompt-adapter-enquirer
+# @listr2/prompt-adapter-inquirer
 
-[![Pipeline](https://gitlab.kilic.dev/libraries/listr2/badges/master/pipeline.svg?style=flat-square&ignore_skipped=true)](https://gitlab.kilic.dev/libraries/listr2/-/commits/master) [![Version](https://img.shields.io/npm/v/%40listr2/prompt-adapter-enquirer.svg?style=flat-square&logo=npm)](https://www.npmjs.com/package/%40listr2/prompt-adapter-enquirer?activeTab=versions) [![Downloads](https://img.shields.io/npm/dm/%40listr2/prompt-adapter-enquirer.svg?style=flat-square&logo=npm)](https://www.npmjs.com/package/%40listr2/prompt-adapter-enquirer) [![Size](https://img.shields.io/bundlephobia/min/%40listr2/prompt-adapter-enquirer?style=flat-square&logo=npm)](https://www.npmjs.com/package/%40listr2/prompt-adapter-enquirer) [![Dependencies](https://img.shields.io/librariesio/release/npm/%40listr2/prompt-adapter-enquirer?style=flat-square&logo=npm)](https://www.npmjs.com/package/%40listr2/prompt-adapter-enquirer?activeTab=dependencies)
+[![Pipeline](https://gitlab.kilic.dev/libraries/listr2/badges/master/pipeline.svg?style=flat-square&ignore_skipped=true)](https://gitlab.kilic.dev/libraries/listr2/-/commits/master) [![Version](https://img.shields.io/npm/v/%40listr2/prompt-adapter-inquirer.svg?style=flat-square&logo=npm)](https://www.npmjs.com/package/%40listr2/prompt-adapter-inquirer?activeTab=versions) [![Downloads](https://img.shields.io/npm/dm/%40listr2/prompt-adapter-inquirer.svg?style=flat-square&logo=npm)](https://www.npmjs.com/package/%40listr2/prompt-adapter-inquirer) [![Size](https://img.shields.io/bundlephobia/min/%40listr2/prompt-adapter-inquirer?style=flat-square&logo=npm)](https://www.npmjs.com/package/%40listr2/prompt-adapter-inquirer) [![Dependencies](https://img.shields.io/librariesio/release/npm/%40listr2/prompt-adapter-inquirer?style=flat-square&logo=npm)](https://www.npmjs.com/package/%40listr2/prompt-adapter-inquirer?activeTab=dependencies)
 
 [![github sponsors](https://img.shields.io/github/sponsors/cenk1cenk2?style=flat-square&logo=github)](https://github.com/sponsors/cenk1cenk2) [![opencollective](https://img.shields.io/opencollective/sponsors/listr2?label=open%20collective&logo=opencollective)](https://opencollective.com/listr2)
 
@@ -10,6 +10,6 @@
 
 ## Documentation
 
-This is an extension to [`listr2`](https://listr2.kilic.dev/) to create prompts with [`enquirer`](https://github.com/enquirer/enquirer).
+This is an extension to [`listr2`](https://listr2.kilic.dev/) to create prompts with [`@inquirer/prompts`](https://github.com/SBoudrias/Inquirer.js/blob/master/packages/prompts/README.md).
 
-**[Read the documentation...](https://listr2.kilic.dev/task/prompts.html#enquirer)**
+**[Read the documentation...](https://listr2.kilic.dev/task/prompts.html#inquirer)**

package/node_modules/@listr2/prompt-adapter-inquirer/dist/index.d.mts

@@ -0,0 +1,21 @@
+import { ListrPromptAdapter } from "listr2";
+import { Prompt } from "@inquirer/type";
+//#region src/prompt.d.ts
+declare class ListrInquirerPromptAdapter extends ListrPromptAdapter {
+  private prompt;
+  private signal;
+  /**
+   * Get the current running instance of `inquirer`.
+   */
+  get instance(): Promise<any>;
+  /**
+   * Create a new prompt with `inquirer`.
+   */
+  run<T extends Prompt<any, any> = Prompt<any, any>>(prompt: T, ...[config, context]: Parameters<T>): Promise<ReturnType<T>>;
+  /**
+   * Cancel the ongoing prompt.
+   */
+  cancel(): void;
+}
+//#endregion
+export { ListrInquirerPromptAdapter };

package/node_modules/@listr2/prompt-adapter-inquirer/dist/index.mjs

@@ -0,0 +1,46 @@
+import { ListrPromptAdapter, ListrTaskEventType, ListrTaskState } from "listr2";
+
+//#region src/prompt.ts
+var ListrInquirerPromptAdapter = class extends ListrPromptAdapter {
+	prompt;
+	signal = new AbortController();
+	/**
+	* Get the current running instance of `inquirer`.
+	*/
+	get instance() {
+		return this.prompt;
+	}
+	/**
+	* Create a new prompt with `inquirer`.
+	*/
+	async run(prompt, ...[config, context]) {
+		context ??= {};
+		context.output ??= this.wrapper.stdout(ListrTaskEventType.PROMPT);
+		context.signal ??= this.signal.signal;
+		this.reportStarted();
+		this.task.on(ListrTaskEventType.STATE, (event) => {
+			if (event === ListrTaskState.SKIPPED && this.prompt) this.cancel();
+		});
+		this.prompt = prompt(config, context);
+		let result;
+		try {
+			result = await this.prompt;
+			this.reportCompleted();
+		} catch (e) {
+			this.reportFailed();
+			throw e;
+		}
+		return result;
+	}
+	/**
+	* Cancel the ongoing prompt.
+	*/
+	cancel() {
+		if (!this.prompt) return;
+		this.reportFailed();
+		this.signal.abort("Prompt was cancelled");
+	}
+};
+
+//#endregion
+export { ListrInquirerPromptAdapter };

package/node_modules/@listr2/prompt-adapter-inquirer/node_modules/@inquirer/type/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2025 Simon Boudrias
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

package/node_modules/@listr2/prompt-adapter-inquirer/node_modules/@inquirer/type/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './inquirer.ts';
+export * from './utils.ts';

package/node_modules/@listr2/prompt-adapter-inquirer/node_modules/@inquirer/type/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./inquirer.js";
+export * from "./utils.js";

package/node_modules/@listr2/prompt-adapter-inquirer/node_modules/@inquirer/type/dist/inquirer.d.ts

@@ -0,0 +1,35 @@
+import { Duplex } from 'node:stream';
+/**
+ * `InquirerReadline` is a re-implementation of `readline.Interface` from Node.js.
+ * We're reimplementing it because of 3 reasons:
+ * 1. The `readline.Interface` API is not complete; it's missing for example `clearLine`.
+ * 2. The input/output streams are not generics, meaning they're inexact.
+ * 3. Since ReadLine isn't built-in Typescript Global NodeJS type, it'd force us to ship `@types/node` as a dependency to all users.
+ */
+export type InquirerReadline = {
+    output: Duplex & {
+        mute: () => void;
+        unmute: () => void;
+    };
+    input: NodeJS.ReadableStream;
+    clearLine: (dir: 0 | 1 | -1) => void;
+    getCursorPos: () => {
+        rows: number;
+        cols: number;
+    };
+    setPrompt: (prompt: string) => void;
+    line: string;
+    write: (data: string) => void;
+    on: (event: string, listener: (...args: unknown[]) => void) => void;
+    removeListener: (event: string, listener: (...args: unknown[]) => void) => void;
+    pause: () => void;
+    resume: () => void;
+    close: () => void;
+};
+export type Context = {
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+    clearPromptOnDone?: boolean;
+    signal?: AbortSignal;
+};
+export type Prompt<Value, Config> = (config: Config, context?: Context) => Promise<Value>;

package/node_modules/@listr2/prompt-adapter-inquirer/node_modules/@inquirer/type/dist/inquirer.js

@@ -0,0 +1 @@
+export {};

package/node_modules/@listr2/prompt-adapter-inquirer/node_modules/@inquirer/type/dist/utils.d.ts

@@ -0,0 +1,34 @@
+type Key = string | number | symbol;
+/**
+ * Recursively expand intersections and mapped types for better IDE display,
+ * while preserving functions, arrays, primitives, and types with a string
+ * index signature (e.g. `Record<string, ...>`) as-is.
+ */
+export type Prettify<T> = T extends (...args: never[]) => unknown ? T : T extends ReadonlyArray<unknown> ? T : T extends string | number | boolean | symbol | bigint | null | undefined ? T : T extends object ? string extends keyof T ? T : {
+    [K in keyof T]: Prettify<T[K]>;
+} & {} : T;
+export type PartialDeep<T> = T extends object ? {
+    [P in keyof T]?: PartialDeep<T[P]>;
+} : T;
+export type LiteralUnion<T extends F, F = string> = T | (F & {});
+export type KeyUnion<T> = LiteralUnion<Extract<keyof T, string>>;
+export type DistributiveMerge<A, B> = A extends any ? Prettify<Omit<A, keyof B> & B> : never;
+export type UnionToIntersection<T> = (T extends any ? (input: T) => void : never) extends (input: infer Intersection) => void ? Intersection : never;
+/**
+ * @hidden
+ */
+type __Pick<O extends object, K extends keyof O> = {
+    [P in K]: O[P];
+} & {};
+/**
+ * @hidden
+ */
+export type _Pick<O extends object, K extends Key> = __Pick<O, keyof O & K>;
+/**
+ * Extract out of `O` the fields of key `K`
+ * @param O to extract from
+ * @param K to chose fields
+ * @returns [[Object]]
+ */
+export type Pick<O extends object, K extends Key> = O extends unknown ? _Pick<O, K> : never;
+export {};

package/node_modules/@listr2/prompt-adapter-inquirer/node_modules/@inquirer/type/dist/utils.js

@@ -0,0 +1,2 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+export {};

package/node_modules/@listr2/prompt-adapter-inquirer/node_modules/@inquirer/type/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@inquirer/type",
+  "version": "4.1.0",
+  "description": "Inquirer core TS types",
+  "keywords": [
+    "answer",
+    "answers",
+    "ask",
+    "base",
+    "cli",
+    "command",
+    "command-line",
+    "confirm",
+    "enquirer",
+    "generate",
+    "generator",
+    "hyper",
+    "input",
+    "inquire",
+    "inquirer",
+    "interface",
+    "iterm",
+    "javascript",
+    "menu",
+    "node",
+    "nodejs",
+    "prompt",
+    "promptly",
+    "prompts",
+    "question",
+    "readline",
+    "scaffold",
+    "scaffolder",
+    "scaffolding",
+    "stdin",
+    "stdout",
+    "terminal",
+    "tty",
+    "types",
+    "typescript",
+    "ui",
+    "yeoman",
+    "yo",
+    "zsh"
+  ],
+  "license": "MIT",
+  "author": "Simon Boudrias <admin@simonboudrias.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SBoudrias/Inquirer.js.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "tsc": "tsc"
+  },
+  "devDependencies": {
+    "@repo/tsconfig": "0.0.0",
+    "typescript": "^6.0.2"
+  },
+  "peerDependencies": {
+    "@types/node": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "@types/node": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=23.5.0 || ^22.13.0 || ^20.17.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "gitHead": "51ac389603405e8f9f315ce49416153d95c5fefe"
+}

package/node_modules/@listr2/{prompt-adapter-enquirer → prompt-adapter-inquirer}/package.json

@@ -1,22 +1,22 @@
 {
-  "name": "@listr2/prompt-adapter-enquirer",
-  "version": "2.0.16",
-  "description": "Listr2 prompt adapter for enquirer.",
+  "name": "@listr2/prompt-adapter-inquirer",
+  "version": "4.2.7",
+  "description": "Listr2 prompt adapter for inquirer.",
   "license": "MIT",
   "repository": "https://github.com/listr2/listr2",
   "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "exports": {
     ".": {
       "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
       },
       "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
       }
     },
     "./package.json": "./package.json"
@@ -30,16 +30,16 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.13.0"
   },
   "scripts": {
-    "build": "tsup-node",
-    "dev:start": "tsup-node --watch",
+    "build": "tsdown",
+    "dev:start": "tsdown --watch",
     "format": "prettier --log-level warn --write src/ tests/ && pnpm run lint --fix",
-    "lint": "eslint --ext .ts,.js,.tsx,.jsx src/ tests/",
-    "test": "NO_COLOR=1 TS_NODE_PROJECT=tests/tsconfig.json NODE_OPTIONS='--no-warnings --experimental-specifier-resolution=node --experimental-vm-modules' jest --config tests/jest.config.ts",
+    "lint": "eslint src/ tests/",
+    "test": "NODE_OPTIONS='--no-warnings --experimental-vm-modules' jest --config tests/jest.config.ts",
     "test:cov": "pnpm run test --coverage",
-    "test:dev": "NODE_OPTIONS='--no-warnings --experimental-specifier-resolution=node --experimental-vm-modules --inspect=0.0.0.0:9229' pnpm run test --verbose --watchAll"
+    "test:dev": "NODE_OPTIONS='--no-warnings --experimental-vm-modules --inspect=0.0.0.0:9229' pnpm run test --verbose --watchAll"
   },
   "lint-staged": {
     "{src,tests}/**/*.{ts,js,tsx,jsx,spec.ts}": [
@@ -69,12 +69,17 @@
     "wait",
     "idle"
   ],
-  "dependencies": {},
+  "dependencies": {
+    "@inquirer/type": "^4.0.7"
+  },
   "devDependencies": {
-    "listr2": "8.3.3",
-    "enquirer": "^2.4.1"
+    "@inquirer/core": "^12.0.0",
+    "@inquirer/input": "^5.1.2",
+    "@inquirer/prompts": "^8.5.2",
+    "listr2": "11.1.0"
   },
   "peerDependencies": {
-    "enquirer": ">= 2.3.0 < 3"
+    "@inquirer/prompts": ">= 3 < 9",
+    "listr2": "11.1.0"
   }
 }

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;