@node-core/utils 7.1.0 → 7.2.1

package/node_modules/js-yaml/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js-yaml",
-  "version": "5.2.3",
+  "version": "5.4.1",
   "description": "YAML 1.2 parser and serializer",
   "keywords": [
     "yaml",
@@ -54,18 +54,18 @@
     "lint": "eslint .",
     "lint-fix": "eslint . --fix",
     "type-check": "tsc --noEmit",
-    "test": "npm run lint && npm run build && npm run type-check && npm run test:examples && npm run spec:get && node --test 'test/core/**/*.test.mjs' 'test/spec/*.test.mjs'",
-    "test:examples": "node --test 'examples/*.mjs'",
+    "test": "npm run lint && npm run build && npm run type-check && npm run spec:get && node --test 'test/core/**/*.test.mjs' 'test/spec/*.test.mjs'",
     "test:spec": "npm run build && npm run spec:get && node test/spec/spec.test.mjs",
     "spec:get": "node support/get-yaml-test-suite.mjs",
     "spec:update": "node support/get-yaml-test-suite.mjs update",
     "coverage": "npm run build && npm run spec:get && c8 --include 'dist/js-yaml.mjs' --include 'src/**' -r text -r html -r lcov node --test 'test/core/**/*.test.mjs' 'test/spec/*.test.mjs'",
     "build": "node support/build-dist.mjs",
-    "build:demo": "npm run lint && node support/build_demo.mjs",
-    "gh-demo": "npm run build:demo && gh-pages -d demo -f",
+    "demo": "npm run lint && node support/build_demo.mjs && npm run doc",
+    "doc": "typedoc",
+    "demo:publish": "npm run demo && gh-pages -d demo -f",
     "benchmark:deps": "npm install --prefix benchmark/extra/",
-    "prepack": "npm test && npm run build && npm run build:demo",
-    "postpublish": "npm run gh-demo"
+    "prepack": "npm test && npm run build && npm run demo",
+    "postpublish": "npm run demo:publish"
   },
   "dependencies": {
     "argparse": "^2.0.1"
@@ -82,6 +82,7 @@
     "neostandard": "^0.13.0",
     "rollup": "^4.62.2",
     "rollup-plugin-dts": "^6.4.1",
+    "typedoc": "^0.28.19",
     "typescript": "^6.0.3",
     "vite": "^8.1.2",
     "vite-plugin-node-polyfills": "^0.28.0",

package/node_modules/listr2/dist/{index.d.cts → index.d.mts}

@@ -1,11 +1,10 @@
+import { InspectColor } from "node:util";
 import { Writable } from "stream";
-import * as colorette0 from "colorette";
-
 //#region src/constants/ansi-escape-codes.constants.d.ts
 /**
  * Indicates an UNICODE characters is coming up.
  */
-declare const ANSI_ESCAPE = "\u001B[";
+declare const ANSI_ESCAPE = "[";
 /**
  * Generic ANSI escape characters for terminal based operations.
  */
@@ -22,7 +21,7 @@ declare enum ListrEnvironmentVariables {
   FORCE_UNICODE = "LISTR_FORCE_UNICODE",
   FORCE_TTY = "LISTR_FORCE_TTY",
   DISABLE_COLOR = "NO_COLOR",
-  FORCE_COLOR = "FORCE_COLOR",
+  FORCE_COLOR = "FORCE_COLOR"
 }
 //#endregion
 //#region src/constants/listr-error.constants.d.ts
@@ -39,7 +38,7 @@ declare enum ListrErrorTypes {
   /** Task has failed. */
   HAS_FAILED = "HAS_FAILED",
   /** Task has failed, but exitOnError is set to false, so will ignore this error. */
-  HAS_FAILED_WITHOUT_ERROR = "HAS_FAILED_WITHOUT_ERROR",
+  HAS_FAILED_WITHOUT_ERROR = "HAS_FAILED_WITHOUT_ERROR"
 }
 //#endregion
 //#region src/constants/listr-events.constants.d.ts
@@ -52,14 +51,14 @@ declare enum ListrErrorTypes {
  */
 declare enum ListrEventType {
   /** Indicates that underlying renderer should refresh the current render. */
-  SHOULD_REFRESH_RENDER = "SHOUD_REFRESH_RENDER",
+  SHOULD_REFRESH_RENDER = "SHOUD_REFRESH_RENDER"
 }
 //#endregion
 //#region src/constants/listr-renderer.constants.d.ts
 declare enum ListrRendererSelection {
   PRIMARY = "PRIMARY",
   SECONDARY = "SECONDARY",
-  SILENT = "SILENT",
+  SILENT = "SILENT"
 }
 //#endregion
 //#region src/constants/listr-task-events.constants.d.ts
@@ -85,6 +84,8 @@ declare enum ListrTaskEventType {
   PROMPT = "PROMPT",
   /** The current Task is now dumping output. */
   OUTPUT = "OUTPUT",
+  /** The current Task has reset its streamed output. */
+  OUTPUT_RESET = "OUTPUT_RESET",
   /**
    * The current Task is now dumping a message.
    *
@@ -92,7 +93,7 @@ declare enum ListrTaskEventType {
    */
   MESSAGE = "MESSAGE",
   /** The current Task is closed and no further action in expected. */
-  CLOSED = "CLOSED",
+  CLOSED = "CLOSED"
 }
 //#endregion
 //#region src/constants/listr-task-state.constants.d.ts
@@ -126,16 +127,18 @@ declare enum ListrTaskState {
   PROMPT_COMPLETED = "PROMPT_COMPLETED",
   /** Task has failed to process the prompt. */
   PROMPT_FAILED = "PROMPT_FAILED",
+  /** Task has been cancelled by an interruption before it could finish. */
+  CANCELLED = "CANCELLED"
 }
 //#endregion
 //#region src/interfaces/data.interface.d.ts
-interface ObserverLike<T$1> {
-  next: (value: T$1) => void;
+interface ObserverLike<T> {
+  next: (value: T) => void;
   complete: () => void;
   error: (err: unknown) => void;
 }
-interface ObservableLike<T$1 = any> {
-  subscribe: (observer: ObserverLike<T$1>) => unknown;
+interface ObservableLike<T = any> {
+  subscribe: (observer: ObserverLike<T>) => unknown;
 }
 interface ReadableLike {
   readable: boolean;
@@ -154,19 +157,20 @@ declare class BaseEventMap {
 /**
  * Parameters for the given event in the {@link EventMap}.
  */
-type EventData<Event extends string, Map$1 extends Record<string, unknown>> = Event extends keyof Map$1 ? Map$1[Event] : never;
+type EventData<Event extends string, Map extends Record<string, unknown>> = Event extends keyof Map ? Map[Event] : never;
 /**
  * An event map of given events that defined the parameters and return types for firing a certain event.
  */
 type EventMap<Events extends string> = Partial<Record<Events, unknown>>;
 //#endregion
 //#region src/lib/event-manager.d.ts
-declare class EventManager<Event extends string = string, Map$1 extends Partial<Record<Event, unknown>> = Partial<Record<Event, any>>> {
+declare class EventManager<Event extends string = string, Map extends Partial<Record<Event, unknown>> = Partial<Record<Event, any>>> {
   private readonly emitter;
-  emit<E extends Event = Event>(dispatch: E, args?: EventData<E, Map$1>): void;
-  on<E extends Event = Event>(dispatch: E, handler: (data: EventData<E, Map$1>) => void): void;
-  once<E extends Event = Event>(dispatch: E, handler: (data: EventData<E, Map$1>) => void): void;
-  off<E extends Event = Event>(dispatch: E, handler?: (data: EventData<E, Map$1>) => void): void;
+  constructor();
+  emit<E extends Event = Event>(dispatch: E, args?: EventData<E, Map>): void;
+  on<E extends Event = Event>(dispatch: E, handler: (data: EventData<E, Map>) => void): void;
+  once<E extends Event = Event>(dispatch: E, handler: (data: EventData<E, Map>) => void): void;
+  off<E extends Event = Event>(dispatch: E, handler?: (data: EventData<E, Map>) => void): void;
   complete(): void;
 }
 //#endregion
@@ -175,7 +179,7 @@ declare class EventManager<Event extends string = string, Map$1 extends Partial<
  * Tests to see if the object is an RxJS {@link Observable}
  * @param obj the object to test
  */
-declare function isObservable<T$1>(obj: any): obj is ObservableLike<T$1>;
+declare function isObservable<T>(obj: any): obj is ObservableLike<T>;
 //#endregion
 //#region src/utils/environment/is-readable.d.ts
 /**
@@ -192,11 +196,9 @@ declare function cleanseAnsi(chunk: string): string;
 //#endregion
 //#region src/utils/format/color.d.ts
 /**
- * Creates color palette through underlying dependency of `colorette`.
- *
- * @see {@link https://www.npmjs.com/package/colorette}
+ * Color palette.
  */
-declare const color: colorette0.Colorette;
+declare const color: Record<InspectColor, (text: string | number) => string>;
 //#endregion
 //#region src/utils/format/indent.d.ts
 declare function indent(string: string, count: number): string;
@@ -204,6 +206,7 @@ declare function indent(string: string, count: number): string;
 //#region src/utils/format/figures.d.ts
 declare const FIGURES_MAIN: {
   warning: string;
+  info: string;
   cross: string;
   arrowDown: string;
   tick: string;
@@ -213,6 +216,7 @@ declare const FIGURES_MAIN: {
   arrowLeft: string;
   squareSmallFilled: string;
   pointerSmall: string;
+  circleSlash: string;
 };
 type Figures = typeof FIGURES_MAIN;
 declare const figures: Figures;
@@ -339,6 +343,7 @@ declare enum ListrLogLevels {
   RETRY = "RETRY",
   PROMPT = "PROMPT",
   PAUSED = "PAUSED",
+  CANCELLED = "CANCELLED"
 }
 declare const LISTR_LOGGER_STYLE: ListrLoggerStyleMap<ListrLogLevels>;
 declare const LISTR_LOGGER_STDERR_LEVELS: ListrLogLevels[];
@@ -474,13 +479,7 @@ declare function getRenderer<Renderer extends ListrRendererValue, FallbackRender
  * If the value itself is a function it will evaluate it with the passed in arguments,
  * elsewise it will directly return itself.
  */
-declare function assertFunctionOrSelf<T$1>(functionOrSelf: T$1, ...args: T$1 extends ((...args: any[]) => any) ? Parameters<T$1> : never): T$1 extends ((...args: any[]) => any) ? ReturnType<T$1> : T$1;
-//#endregion
-//#region src/utils/clone.d.ts
-/**
- * Deep clones a object in the easiest manner.
- */
-declare function cloneObject<T$1 extends Record<PropertyKey, any>>(obj: T$1): T$1;
+declare function assertFunctionOrSelf<T>(functionOrSelf: T, ...args: T extends ((...args: any[]) => any) ? Parameters<T> : never): T extends ((...args: any[]) => any) ? ReturnType<T> : T;
 //#endregion
 //#region src/utils/concurrency.d.ts
 declare class Concurrency {
@@ -520,9 +519,21 @@ declare class TaskWrapper<Ctx, Renderer extends ListrRendererFactory, FallbackRe
    *
    * @see {@link https://listr2.kilic.dev/task/output.html}
    */
-  set output(output: string | any[]);
+  set output(output: string | any[] | null);
   /** Send an output to the output channel as prompt. */
   private set promptOutput(value);
+  /**
+   * The `AbortSignal` for the current run, aborted when the run is interrupted (e.g. `SIGINT`).
+   * Wire it into your own async work (`fetch`, child processes, timers) to cancel cooperatively.
+   *
+   * @see {@link https://listr2.kilic.dev/task/rollback.html}
+   */
+  get signal(): AbortSignal;
+  /**
+   * Interrupt the whole run programmatically, as if it received a `SIGINT`.
+   * The other in-flight tasks roll back or are marked as cancelled, then the process exits with `127`.
+   */
+  cancel(): void;
   /**
    * Creates a new set of Listr subtasks.
    *
@@ -610,7 +621,8 @@ declare class Task<Ctx, Renderer extends ListrRendererFactory = ListrRendererFac
   private taskFn;
   /** Marks the task as closed. This is different from finalized since this is not really related to task itself. */
   private closed;
-  constructor(listr: Listr<Ctx, Renderer, FallbackRenderer>, task: ListrTask<Ctx, Renderer, FallbackRenderer>, options: ListrOptions, rendererOptions: ListrGetRendererOptions<Renderer> | ListrGetRendererOptions<FallbackRenderer>, /** Per-task options for the current renderer of the task. */
+  constructor(listr: Listr<Ctx, Renderer, FallbackRenderer>, task: ListrTask<Ctx, Renderer, FallbackRenderer>, options: ListrOptions, rendererOptions: ListrGetRendererOptions<Renderer> | ListrGetRendererOptions<FallbackRenderer>,
+  /** Per-task options for the current renderer of the task. */
   rendererTaskOptions: ListrGetRendererTaskOptions<Renderer> | ListrGetRendererTaskOptions<FallbackRenderer>);
   /**
    * Update the current state of the Task and emit the neccassary events.
@@ -620,6 +632,10 @@ declare class Task<Ctx, Renderer extends ListrRendererFactory = ListrRendererFac
    * Update the current output of the Task and emit the neccassary events.
    */
   set output$(data: string);
+  /**
+   * Reset the current output of the Task and emit the neccassary events.
+   */
+  set outputReset$(data: null);
   /**
    * Update the current prompt output of the Task and emit the neccassary events.
    */
@@ -654,6 +670,8 @@ declare class Task<Ctx, Renderer extends ListrRendererFactory = ListrRendererFac
   isCompleted(): boolean;
   /** Returns whether this task has been failed. */
   hasFailed(): boolean;
+  /** Returns whether this task has been cancelled by an interruption. */
+  isCancelled(): boolean;
   /** Returns whether this task has an active rollback task going on. */
   isRollingBack(): boolean;
   /** Returns whether the rollback action was successful. */
@@ -677,6 +695,7 @@ declare class Task<Ctx, Renderer extends ListrRendererFactory = ListrRendererFac
   /** Run the current task. */
   run(context: Ctx, wrapper: TaskWrapper<Ctx, Renderer, FallbackRenderer>): Promise<void>;
   private close;
+  private whenInterrupted;
 }
 //#endregion
 //#region src/lib/listr-event-manager.d.ts
@@ -699,6 +718,7 @@ declare enum ListrDefaultRendererLogLevels {
   FAILED_WITH_FAILED_SUBTASKS = "FAILED_WITH_SUBTASKS",
   WAITING = "WAITING",
   PAUSED = "PAUSED",
+  CANCELLED = "CANCELLED"
 }
 declare const LISTR_DEFAULT_RENDERER_STYLE: ListrLoggerStyleMap<ListrDefaultRendererLogLevels>;
 //#endregion
@@ -732,6 +752,7 @@ declare class DefaultRenderer implements ListrRenderer {
   protected format(message: string, icon: string, level: number): string[];
   protected shouldOutputToOutputBar(task: ListrDefaultRendererTask): boolean;
   protected shouldOutputToBottomBar(task: ListrDefaultRendererTask): boolean;
+  private readonly refresh;
   private renderer;
   private renderOutputBar;
   private renderBottomBar;
@@ -1010,12 +1031,12 @@ declare class TestRenderer implements ListrRenderer {
 }
 //#endregion
 //#region src/renderer/test/serializer.interface.d.ts
-interface TestRendererSerializerOutput<T$1 extends ListrTaskEventType> {
-  event: T$1;
-  data: ListrTaskEventMap[T$1];
+interface TestRendererSerializerOutput<T extends ListrTaskEventType> {
+  event: T;
+  data: ListrTaskEventMap[T];
   task?: Partial<Record<TestRendererSerializerTaskKeys, unknown>>;
 }
-type TestRendererSerializerTaskKeys = Extract<keyof ListrRendererTask<typeof TestRenderer>, 'hasSubtasks' | 'hasFinalized' | 'isPending' | 'isStarted' | 'isSkipped' | 'isCompleted' | 'hasFailed' | 'isRollingBack' | 'hasRolledBack' | 'isRetrying' | 'hasReset' | 'isEnabled' | 'hasTitle' | 'isPrompt' | 'isPaused' | 'title' | 'path'>;
+type TestRendererSerializerTaskKeys = Extract<keyof ListrRendererTask<typeof TestRenderer>, 'hasSubtasks' | 'hasFinalized' | 'isPending' | 'isStarted' | 'isSkipped' | 'isCompleted' | 'hasFailed' | 'isCancelled' | 'isRollingBack' | 'hasRolledBack' | 'isRetrying' | 'hasReset' | 'isEnabled' | 'hasTitle' | 'isPrompt' | 'isPaused' | 'title' | 'path'>;
 //#endregion
 //#region src/renderer/test/renderer.interface.d.ts
 type ListrTestRendererTask = ListrRendererTask<typeof TestRenderer>;
@@ -1137,48 +1158,48 @@ type ListrRendererValue = ListrSilentRendererValue | ListrDefaultRendererValue |
 /**
  * Returns the class type from friendly names of the renderers.
  */
-type ListrGetRendererClassFromValue<T$1 extends ListrRendererValue> = T$1 extends ListrDefaultRendererValue ? ListrDefaultRenderer : T$1 extends ListrSimpleRendererValue ? ListrSimpleRenderer : T$1 extends ListrVerboseRendererValue ? ListrVerboseRenderer : T$1 extends ListrTestRendererValue ? ListrTestRenderer : T$1 extends ListrSilentRenderer ? ListrSilentRenderer : T$1 extends ListrRendererFactory ? T$1 : never;
+type ListrGetRendererClassFromValue<T extends ListrRendererValue> = T extends ListrDefaultRendererValue ? ListrDefaultRenderer : T extends ListrSimpleRendererValue ? ListrSimpleRenderer : T extends ListrVerboseRendererValue ? ListrVerboseRenderer : T extends ListrTestRendererValue ? ListrTestRenderer : T extends ListrSilentRenderer ? ListrSilentRenderer : T extends ListrRendererFactory ? T : never;
 /**
  * Returns the friendly names from the type of renderer classes.
  */
-type ListrGetRendererValueFromClass<T$1 extends ListrRendererFactory> = T$1 extends DefaultRenderer ? ListrDefaultRendererValue : T$1 extends SimpleRenderer ? ListrSimpleRendererValue : T$1 extends VerboseRenderer ? ListrVerboseRendererValue : T$1 extends TestRenderer ? ListrTestRendererValue : T$1 extends SilentRenderer ? ListrSilentRenderer : T$1 extends ListrRendererFactory ? T$1 : never;
+type ListrGetRendererValueFromClass<T extends ListrRendererFactory> = T extends DefaultRenderer ? ListrDefaultRendererValue : T extends SimpleRenderer ? ListrSimpleRendererValue : T extends VerboseRenderer ? ListrVerboseRendererValue : T extends TestRenderer ? ListrTestRendererValue : T extends SilentRenderer ? ListrSilentRenderer : T extends ListrRendererFactory ? T : never;
 /**
  * Returns renderer global options depending on the renderer type.
  */
-type ListrGetRendererOptions<T$1 extends ListrRendererValue> = T$1 extends ListrRendererValue ? ListrGetRendererClassFromValue<T$1>['rendererOptions'] : never;
+type ListrGetRendererOptions<T extends ListrRendererValue> = T extends ListrRendererValue ? ListrGetRendererClassFromValue<T>['rendererOptions'] : never;
 /**
  * Returns renderer per-task options depending on the renderer type.
  */
-type ListrGetRendererTaskOptions<T$1 extends ListrRendererValue> = T$1 extends ListrRendererValue ? ListrGetRendererClassFromValue<T$1>['rendererTaskOptions'] : never;
+type ListrGetRendererTaskOptions<T extends ListrRendererValue> = T extends ListrRendererValue ? ListrGetRendererClassFromValue<T>['rendererTaskOptions'] : never;
 /** Selection and options of the primary preferred renderer. */
-interface ListrPrimaryRendererSelection<T$1 extends ListrRendererValue> extends ListrPrimaryRendererOptions<T$1> {
+interface ListrPrimaryRendererSelection<T extends ListrRendererValue> extends ListrPrimaryRendererOptions<T> {
   /** Default renderer preferred. */
-  renderer?: T$1;
+  renderer?: T;
 }
 /** Options of the primary preferred renderer. */
-interface ListrPrimaryRendererOptions<T$1 extends ListrRendererValue> {
+interface ListrPrimaryRendererOptions<T extends ListrRendererValue> {
   /** Renderer options depending on the current renderer. */
-  rendererOptions?: ListrGetRendererOptions<T$1>;
+  rendererOptions?: ListrGetRendererOptions<T>;
 }
 /** Task options of the primary preferred renderer. */
-interface ListrPrimaryRendererTaskOptions<T$1 extends ListrRendererValue> {
+interface ListrPrimaryRendererTaskOptions<T extends ListrRendererValue> {
   /** Renderer options depending on the current renderer. */
-  rendererOptions?: ListrGetRendererTaskOptions<T$1>;
+  rendererOptions?: ListrGetRendererTaskOptions<T>;
 }
 /** Selection and options of the preferred fallback renderer. */
-interface ListrSecondaryRendererSelection<T$1 extends ListrRendererValue> extends ListrSecondaryRendererOptions<T$1> {
+interface ListrSecondaryRendererSelection<T extends ListrRendererValue> extends ListrSecondaryRendererOptions<T> {
   /** Fallback renderer preferred. */
-  fallbackRenderer?: T$1;
+  fallbackRenderer?: T;
 }
 /** Options of the fallback renderer. */
-interface ListrSecondaryRendererOptions<T$1 extends ListrRendererValue> {
+interface ListrSecondaryRendererOptions<T extends ListrRendererValue> {
   /** Renderer options depending on the fallback renderer. */
-  fallbackRendererOptions?: ListrGetRendererOptions<T$1>;
+  fallbackRendererOptions?: ListrGetRendererOptions<T>;
 }
 /** Task options of the fallback renderer. */
-interface ListrSecondaryRendererTaskOptions<T$1 extends ListrRendererValue> {
+interface ListrSecondaryRendererTaskOptions<T extends ListrRendererValue> {
   /** Renderer options depending on the fallback renderer. */
-  fallbackRendererOptions?: ListrGetRendererTaskOptions<T$1>;
+  fallbackRendererOptions?: ListrGetRendererTaskOptions<T>;
 }
 /** Renderer options for the parent Listr class, including setup for selecting default and fallback renderers.  */
 type ListrRendererOptions<Renderer extends ListrRendererValue, FallbackRenderer extends ListrRendererValue> = ListrPrimaryRendererSelection<Renderer> & ListrSecondaryRendererSelection<FallbackRenderer>;
@@ -1209,7 +1230,7 @@ interface SupportedRenderer<Renderer extends ListrRendererFactory> {
   options?: ListrGetRendererOptions<Renderer>;
   selection: ListrRendererSelection;
 }
-type ListrRendererCacheMap<T$1> = Map<Task<any, any, any>['id'], T$1>;
+type ListrRendererCacheMap<T> = Map<Task<any, any, any>['id'], T>;
 //#endregion
 //#region src/interfaces/listr.interface.d.ts
 /** Listr context. */
@@ -1259,14 +1280,13 @@ interface ListrOptions<Ctx = ListrContext> {
   /**
    * Collects errors inside the `Listr.errors`.
    *
-   * - `false` will collect no errors.
-   * - `minimal` will only collect the error message and the location.
-   * - `full` will clone the current context and task in to the error instance.
+   * - `false` will collect no errors, leaving `Listr.errors` as `null`.
+   * - `true` will collect the error message, the type and the location of the failed task.
    *
    * @defaultValue `false`
    * @see {@link https://listr2.kilic.dev/task/error-handling.html#collected-errors}
    */
-  collectErrors?: false | 'minimal' | 'full';
+  collectErrors?: boolean;
   /**
    * Listr will track SIGINIT signal to update the renderer one last time before failing, therefore it needs to
    * register exit listeners.
@@ -1321,7 +1341,6 @@ declare class ListrError<Ctx extends ListrContext = ListrContext> extends Error
   type: ListrErrorTypes;
   task: Task<Ctx, ListrRendererFactory, ListrRendererFactory>;
   path: string[];
-  ctx: Ctx;
   constructor(error: Error, type: ListrErrorTypes, task: Task<Ctx, ListrRendererFactory, ListrRendererFactory>);
 }
 //#endregion
@@ -1464,6 +1483,7 @@ declare class ListrTaskEventMap extends BaseEventMap implements EventMap<ListrTa
   [ListrTaskEventType.SUBTASK]: Task<any, any, any>[];
   [ListrTaskEventType.TITLE]: string;
   [ListrTaskEventType.OUTPUT]: string;
+  [ListrTaskEventType.OUTPUT_RESET]: never;
   [ListrTaskEventType.MESSAGE]: ListrTaskMessage;
   [ListrTaskEventType.PROMPT]: string;
   [ListrTaskEventType.CLOSED]: never;
@@ -1488,7 +1508,7 @@ declare class Listr<Ctx = ListrContext, Renderer extends ListrRendererValue = Li
   options?: ListrBaseClassOptions<Ctx, Renderer, FallbackRenderer>;
   parentTask?: Task<any, ListrGetRendererClassFromValue<Renderer>, ListrGetRendererClassFromValue<FallbackRenderer>>;
   tasks: Task<Ctx, ListrGetRendererClassFromValue<Renderer>, ListrGetRendererClassFromValue<FallbackRenderer>>[];
-  errors: ListrError<Ctx>[];
+  errors: ListrError<Ctx>[] | null;
   ctx: Ctx;
   events: ListrEventManager;
   path: string[];
@@ -1496,8 +1516,11 @@ declare class Listr<Ctx = ListrContext, Renderer extends ListrRendererValue = Li
   rendererClassOptions: ListrGetRendererOptions<ListrGetRendererClassFromValue<Renderer> | ListrGetRendererClassFromValue<FallbackRenderer>>;
   rendererSelection: ListrRendererSelection;
   boundSignalHandler: () => void;
+  signal: AbortSignal;
   private concurrency;
   private renderer;
+  private abortController;
+  private startedTasks;
   constructor(task: ListrTask<Ctx, ListrGetRendererClassFromValue<Renderer>, ListrGetRendererClassFromValue<FallbackRenderer>> | ListrTask<Ctx, ListrGetRendererClassFromValue<Renderer>, ListrGetRendererClassFromValue<FallbackRenderer>>[], options?: ListrBaseClassOptions<Ctx, Renderer, FallbackRenderer>, parentTask?: Task<any, ListrGetRendererClassFromValue<Renderer>, ListrGetRendererClassFromValue<FallbackRenderer>>);
   /**
    * Whether this is the root task.
@@ -1519,10 +1542,17 @@ declare class Listr<Ctx = ListrContext, Renderer extends ListrRendererValue = Li
    * @see {@link https://listr2.kilic.dev/listr/listr.html#run-the-generated-task-list}
    */
   run(context?: Ctx): Promise<Ctx>;
+  /**
+   * Interrupt the running task list programmatically, as if it received a `SIGINT`.
+   *
+   * In-flight tasks roll back or are marked as cancelled and the process exits with `127`.
+   */
+  cancel(): void;
   private generate;
   private runTask;
   private signalHandler;
   private removeSignalHandler;
+  private cancelUnfinishedTasks;
 }
 //#endregion
-export { ANSI_ESCAPE, ANSI_ESCAPE_CODES, BaseEventMap, Concurrency, DefaultRenderer, EventData, EventManager, EventMap, Figures, LISTR_DEFAULT_RENDERER_STYLE, LISTR_LOGGER_STDERR_LEVELS, LISTR_LOGGER_STYLE, Listr, ListrBaseClassOptions, ListrContext, ListrDefaultRenderer, ListrDefaultRendererCache, ListrDefaultRendererLogLevels, ListrDefaultRendererOptions, ListrDefaultRendererOptionsStyle, ListrDefaultRendererOutputBuffer, ListrDefaultRendererTask, ListrDefaultRendererTaskOptions, ListrDefaultRendererValue, ListrEnvironmentVariables, ListrError, ListrErrorTypes, ListrEventManager, ListrEventMap, ListrEventType, ListrGetRendererClassFromValue, ListrGetRendererOptions, ListrGetRendererTaskOptions, ListrGetRendererValueFromClass, ListrLogLevels, ListrLogger, ListrLoggerOptions, ListrLoggerStyleMap, ListrOptions, ListrPrimaryRendererOptions, ListrPrimaryRendererSelection, ListrPrimaryRendererTaskOptions, ListrPrimaryRendererValue, ListrPromptAdapter, ListrRenderer, ListrRendererCacheMap, ListrRendererError, ListrRendererFactory, ListrRendererOptions, ListrRendererSelection, ListrRendererTask, ListrRendererValue, ListrSecondaryRendererOptions, ListrSecondaryRendererSelection, ListrSecondaryRendererTaskOptions, ListrSecondaryRendererValue, ListrSilentRenderer, ListrSilentRendererOptions, ListrSilentRendererTask, ListrSilentRendererTaskOptions, ListrSilentRendererValue, ListrSimpleRenderer, ListrSimpleRendererCache, ListrSimpleRendererOptions, ListrSimpleRendererTask, ListrSimpleRendererTaskOptions, ListrSimpleRendererValue, ListrSubClassOptions, ListrTask, ListrTaskEventManager, ListrTaskEventMap, ListrTaskEventType, ListrTaskFn, ListrTaskMessage, type Task as ListrTaskObject, ListrTaskPrompt, ListrTaskResult, ListrTaskRetry, ListrTaskState, type TaskWrapper as ListrTaskWrapper, ListrTestRenderer, ListrTestRendererOptions, ListrTestRendererTask, ListrTestRendererTaskOptions, ListrTestRendererValue, ListrVerboseRenderer, ListrVerboseRendererCache, ListrVerboseRendererOptions, ListrVerboseRendererTask, ListrVerboseRendererTaskOptions, ListrVerboseRendererValue, LoggerField, LoggerFieldFn, LoggerFieldOptions, LoggerFormat, LoggerFormatOptions, ObservableLike, PRESET_TIMER, PRESET_TIMESTAMP, PresetTimer, PresetTimestamp, ProcessOutput, ProcessOutputBuffer, ProcessOutputBufferEntry, ProcessOutputBufferOptions, ProcessOutputOptions, ProcessOutputRendererOptions, ProcessOutputStream, ProcessOutputStreamMap, PromptError, ReadableLike, RendererLoggerOptions, RendererPresetTimer, RendererPresetTimestamp, SilentRenderer, SimpleRenderer, Spinner, SupportedRenderer, TestRenderer, TestRendererSerializer, TestRendererSerializerOutput, TestRendererSerializerTaskKeys, VerboseRenderer, assertFunctionOrSelf, cleanseAnsi, cloneObject, color, createWritable, delay, figures, getRenderer, getRendererClass, indent, isObservable, isReadable, isUnicodeSupported, parseTimer, parseTimestamp, splat };
+export { ANSI_ESCAPE, ANSI_ESCAPE_CODES, BaseEventMap, Concurrency, DefaultRenderer, EventData, EventManager, EventMap, Figures, LISTR_DEFAULT_RENDERER_STYLE, LISTR_LOGGER_STDERR_LEVELS, LISTR_LOGGER_STYLE, Listr, type ListrBaseClassOptions, type ListrContext, ListrDefaultRenderer, type ListrDefaultRendererCache, ListrDefaultRendererLogLevels, type ListrDefaultRendererOptions, type ListrDefaultRendererOptionsStyle, type ListrDefaultRendererOutputBuffer, type ListrDefaultRendererTask, type ListrDefaultRendererTaskOptions, ListrDefaultRendererValue, ListrEnvironmentVariables, ListrError, ListrErrorTypes, ListrEventManager, ListrEventMap, ListrEventType, ListrGetRendererClassFromValue, ListrGetRendererOptions, ListrGetRendererTaskOptions, ListrGetRendererValueFromClass, ListrLogLevels, ListrLogger, type ListrLoggerOptions, type ListrLoggerStyleMap, type ListrOptions, ListrPrimaryRendererOptions, ListrPrimaryRendererSelection, ListrPrimaryRendererTaskOptions, ListrPrimaryRendererValue, ListrPromptAdapter, ListrRenderer, ListrRendererCacheMap, ListrRendererError, ListrRendererFactory, ListrRendererOptions, ListrRendererSelection, type ListrRendererTask, ListrRendererValue, ListrSecondaryRendererOptions, ListrSecondaryRendererSelection, ListrSecondaryRendererTaskOptions, ListrSecondaryRendererValue, ListrSilentRenderer, type ListrSilentRendererOptions, type ListrSilentRendererTask, type ListrSilentRendererTaskOptions, ListrSilentRendererValue, ListrSimpleRenderer, type ListrSimpleRendererCache, type ListrSimpleRendererOptions, type ListrSimpleRendererTask, type ListrSimpleRendererTaskOptions, ListrSimpleRendererValue, type ListrSubClassOptions, type ListrTask, ListrTaskEventManager, ListrTaskEventMap, ListrTaskEventType, type ListrTaskFn, type ListrTaskMessage, type Task as ListrTaskObject, type ListrTaskPrompt, type ListrTaskResult, type ListrTaskRetry, ListrTaskState, type TaskWrapper as ListrTaskWrapper, ListrTestRenderer, type ListrTestRendererOptions, type ListrTestRendererTask, type ListrTestRendererTaskOptions, ListrTestRendererValue, ListrVerboseRenderer, type ListrVerboseRendererCache, type ListrVerboseRendererOptions, type ListrVerboseRendererTask, type ListrVerboseRendererTaskOptions, ListrVerboseRendererValue, type LoggerField, type LoggerFieldFn, type LoggerFieldOptions, type LoggerFormat, type LoggerFormatOptions, type ObservableLike, PRESET_TIMER, PRESET_TIMESTAMP, type PresetTimer, type PresetTimestamp, ProcessOutput, ProcessOutputBuffer, type ProcessOutputBufferEntry, type ProcessOutputBufferOptions, type ProcessOutputOptions, type ProcessOutputRendererOptions, ProcessOutputStream, type ProcessOutputStreamMap, PromptError, type ReadableLike, type RendererLoggerOptions, type RendererPresetTimer, type RendererPresetTimestamp, SilentRenderer, SimpleRenderer, Spinner, SupportedRenderer, TestRenderer, TestRendererSerializer, type TestRendererSerializerOutput, type TestRendererSerializerTaskKeys, VerboseRenderer, assertFunctionOrSelf, cleanseAnsi, color, createWritable, delay, figures, getRenderer, getRendererClass, indent, isObservable, isReadable, isUnicodeSupported, parseTimer, parseTimestamp, splat };