@node-core/utils 7.2.0 → 7.2.2

package/node_modules/yocto-spinner/readme.md

@@ -0,0 +1,237 @@
+<h1 align="center" title="yocto-spinner">
+	<img src="media/logo.jpg" alt="yocto-spinner logo">
+</h1>
+
+[![Install size](https://packagephobia.com/badge?p=yocto-spinner)](https://packagephobia.com/result?p=yocto-spinner)
+![npm package minzipped size](https://img.shields.io/bundlejs/size/yocto-spinner)
+<!-- [![Downloads](https://img.shields.io/npm/dm/yocto-spinner.svg)](https://npmjs.com/yocto-spinner) -->
+<!-- ![Dependents](https://img.shields.io/librariesio/dependents/npm/yocto-spinner) -->
+
+> Tiny terminal spinner
+
+## Features
+
+- Tiny and fast
+- Customizable text and color options
+- Customizable spinner animations
+- Only one tiny dependency
+- Supports both Unicode and non-Unicode environments
+- Gracefully handles process signals (e.g., `SIGINT`, `SIGTERM`)
+- Can display different status symbols (info, success, warning, error)
+- Works well in CI environments
+
+*Check out [`ora`](https://github.com/sindresorhus/ora) for more features.*
+
+<br>
+<p align="center">
+	<br>
+	<img src="https://raw.githubusercontent.com/sindresorhus/ora/3c63d5e8569d94564b5280525350724817e9ac26/screenshot.svg" width="500">
+	<br>
+</p>
+<br>
+
+## Install
+
+```sh
+npm install yocto-spinner
+```
+
+## Usage
+
+```js
+import yoctoSpinner from 'yocto-spinner';
+
+const spinner = yoctoSpinner({text: 'Loading…'}).start();
+
+setTimeout(() => {
+	spinner.success('Success!');
+}, 2000);
+```
+
+## API
+
+### yoctoSpinner(options?)
+
+Creates a new spinner instance.
+
+#### options
+
+Type: `object`
+
+##### text
+
+Type: `string`\
+Default: `''`
+
+The text to display next to the spinner.
+
+##### spinner
+
+Type: `object`\
+Default: <img src="https://github.com/sindresorhus/ora/blob/main/screenshot-spinner.gif?raw=true" width="14">
+
+Customize the spinner animation with a custom set of frames and interval.
+
+```js
+{
+	frames: ['-', '\\', '|', '/'],
+	interval: 100,
+}
+```
+
+Pass in any spinner from [`cli-spinners`](https://github.com/sindresorhus/cli-spinners).
+
+##### color
+
+Type: `string`\
+Default: `'cyan'`\
+Values: `'black' | 'red' | 'green' | 'yellow' | 'blue' | 'magenta' | 'cyan' | 'white' | 'gray'`
+
+The color of the spinner.
+
+##### stream
+
+Type: `stream.Writable`\
+Default: `process.stderr`
+
+The stream to which the spinner is written.
+
+##### handleSignals
+
+Type: `boolean`\
+Default: `true`
+
+Whether to register `SIGINT` and `SIGTERM` listeners that stop the spinner and explicitly exit the process.
+
+Disable this when the application needs to manage those signals itself.
+
+### Instance methods
+
+#### .start(text?)
+
+Starts the spinner.
+
+Returns the instance.
+
+Optionally, updates the text:
+
+```js
+spinner.start('Loading…');
+```
+
+#### .stop(finalText?)
+
+Stops the spinner.
+
+Returns the instance.
+
+Optionally displays a final message.
+
+```js
+spinner.stop('Stopped.');
+```
+
+#### .success(text?)
+
+Stops the spinner and displays a success symbol with the message.
+
+Returns the instance.
+
+```js
+spinner.success('Success!');
+```
+
+#### .error(text?)
+
+Stops the spinner and displays an error symbol with the message.
+
+Returns the instance.
+
+```js
+spinner.error('Error!');
+```
+
+#### .warning(text?)
+
+Stops the spinner and displays a warning symbol with the message.
+
+Returns the instance.
+
+```js
+spinner.warning('Warning!');
+```
+
+#### .clear()
+
+Clears the spinner.
+
+Returns the instance.
+
+#### .info(text?)
+
+Stops the spinner and displays an info symbol with the message.
+
+Returns the instance.
+
+```js
+spinner.info('Info.');
+```
+
+#### .text <sup>get/set</sup>
+
+Change the text displayed next to the spinner.
+
+```js
+spinner.text = 'New text';
+```
+
+#### .color <sup>get/set</sup>
+
+Change the spinner color.
+
+#### .isSpinning <sup>get</sup>
+
+Returns whether the spinner is currently spinning.
+
+## FAQ
+
+### How do I change the color of the text?
+
+Use [`yoctocolors`](https://github.com/sindresorhus/yoctocolors):
+
+```js
+import yoctoSpinner from 'yocto-spinner';
+import {red} from 'yoctocolors';
+
+const spinner = yoctoSpinner({text: `Loading ${red('unicorns')}`}).start();
+```
+
+### Can I log messages while the spinner is running?
+
+Yes. The spinner clears itself, writes your message, and re-renders below. This works with `console.log()` and `console.error()` while the spinner is running:
+
+```js
+const spinner = yoctoSpinner({text: 'Processing…'}).start();
+
+console.log('Step 1 complete');
+console.error('Step 2 complete');
+
+spinner.success('Done!');
+```
+
+> [!NOTE]
+> Avoid running multiple spinners concurrently.
+
+### Why does the spinner freeze?
+
+JavaScript is single-threaded, so any synchronous operations will block the spinner's animation. To avoid this, prefer using asynchronous operations.
+
+## Comparison with [`ora`](https://github.com/sindresorhus/ora)
+
+Ora offers more options, greater customizability, [promise handling](https://github.com/sindresorhus/ora?tab=readme-ov-file#orapromiseaction-options), and better Unicode detection. It’s a more mature and feature-rich package that handles more edge cases but comes with additional dependencies and a larger size. In contrast, this package is smaller, simpler, and optimized for minimal overhead, making it ideal for lightweight projects where dependency size is important. However, Ora is generally the better choice for most use cases.
+
+## Related
+
+- [ora](https://github.com/sindresorhus/ora) - Comprehensive terminal spinner
+- [yoctocolors](https://github.com/sindresorhus/yoctocolors) - Tiny terminal coloring
+- [nano-spawn](https://github.com/sindresorhus/nano-spawn) - Tiny process execution for humans

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@node-core/utils",
-  "version": "7.2.0",
+  "version": "7.2.2",
   "description": "Utilities for Node.js core collaborators",
   "type": "module",
   "engines": {
@@ -35,24 +35,22 @@
   "bundleDependencies": true,
   "dependencies": {
     "@inquirer/prompts": "^7.4.1",
-    "@listr2/prompt-adapter-enquirer": "^2.0.12",
+    "@listr2/prompt-adapter-inquirer": "^4.2.7",
     "@node-core/caritat": "^1.6.0",
     "@pkgjs/nv": "^0.3.0",
     "branch-diff": "^3.1.1",
-    "chalk": "^6.0.0",
     "changelog-maker": "^4.4.1",
-    "cheerio": "^1.0.0",
     "core-validate-commit": "^6.0.0",
-    "figures": "^6.1.0",
     "ghauth": "^7.0.1",
     "git-secure-tag": "^2.3.1",
+    "htmlparser2": "^12.0.0",
     "js-yaml": "^5.2.1",
-    "listr2": "^9.0.5",
-    "ora": "^9.0.0",
+    "listr2": "^11.1.0",
     "semver": "^7.7.1",
     "smol-toml": "^1.7.0",
     "undici": "^8.3.0",
-    "yargs": "^18.0.0"
+    "yargs": "^18.0.0",
+    "yocto-spinner": "^1.2.2"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.4",

package/node_modules/@listr2/prompt-adapter-enquirer/README.md

@@ -1,15 +0,0 @@
-# @listr2/prompt-adapter-enquirer
-
-[![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)
-
-[![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)
-
-**Create beautiful CLI interfaces via easy and logical to-implement task lists that feel alive and interactive.**
-
----
-
-## Documentation
-
-This is an extension to [`listr2`](https://listr2.kilic.dev/) to create prompts with [`enquirer`](https://github.com/enquirer/enquirer).
-
-**[Read the documentation...](https://listr2.kilic.dev/task/prompts.html#enquirer)**

package/node_modules/@listr2/prompt-adapter-enquirer/dist/index.cjs

@@ -1,127 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  ListrEnquirerPromptAdapter: () => ListrEnquirerPromptAdapter
-});
-module.exports = __toCommonJS(src_exports);
-
-// src/prompt.ts
-var import_listr2 = require("listr2");
-var ListrEnquirerPromptAdapter = class extends import_listr2.ListrPromptAdapter {
-  static {
-    __name(this, "ListrEnquirerPromptAdapter");
-  }
-  error;
-  prompt;
-  /**
-   * Get the current running instance of `enquirer`.
-   */
-  get instance() {
-    return this.prompt;
-  }
-  /**
-   * Create a new prompt with `enquirer`.
-   *
-   * `enquirer` is a peer dependency that must be installed seperately.
-   */
-  async run(options, settings) {
-    if (!Array.isArray(options)) {
-      options = [{ ...options, name: "default" }];
-    } else if (options.length === 1) {
-      options = options.map((option) => {
-        return { ...option, name: "default" };
-      });
-    }
-    options = options.map((option) => {
-      return {
-        onCancel: /* @__PURE__ */ __name(() => {
-          this.error = new import_listr2.PromptError("Cancelled prompt.");
-          return true;
-        }, "onCancel"),
-        ...option,
-        stdout: settings?.stdout ?? this.wrapper.stdout(import_listr2.ListrTaskEventType.PROMPT)
-      };
-    });
-    let enquirer;
-    if (settings?.enquirer) {
-      enquirer = settings.enquirer;
-    } else {
-      try {
-        enquirer = await import("enquirer").then((imported) => imported.default ? new imported.default() : new imported());
-      } catch {
-        this.reportFailed();
-        throw new import_listr2.PromptError("Enquirer is a optional peer dependency that must be installed separately.");
-      }
-    }
-    this.reportStarted();
-    this.task.on(import_listr2.ListrTaskEventType.STATE, (event) => {
-      if (event === import_listr2.ListrTaskState.SKIPPED && this.prompt && !this.error) {
-        this.cancel({ throw: false });
-      }
-    });
-    let response;
-    try {
-      response = await enquirer.once("prompt", (prompt) => this.prompt = prompt).prompt(options);
-    } catch (e) {
-      this.reportFailed();
-      if (this.error) {
-        throw this.error;
-      }
-      throw e;
-    }
-    this.reportCompleted();
-    if (options.length === 1) {
-      return response.default;
-    } else {
-      return response;
-    }
-  }
-  /**
-   * Cancel the ongoing prompt.
-   */
-  cancel(options) {
-    if (!this.prompt || this.error) {
-      return;
-    }
-    if (options?.throw) {
-      this.prompt.cancel();
-    } else {
-      this.prompt.submit();
-    }
-    this.reportFailed();
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ListrEnquirerPromptAdapter
-});

package/node_modules/@listr2/prompt-adapter-enquirer/dist/index.d.cts

@@ -1,152 +0,0 @@
-import Enquirer from 'enquirer';
-import { WriteStream } from 'fs';
-import { Writable } from 'stream';
-import { ListrPromptAdapter, PromptError } from 'listr2';
-
-type Unionize<T extends Record<PropertyKey, unknown>> = {
-    [P in keyof T]: T[P];
-}[keyof T];
-interface EnquirerBasePromptOptions {
-    message: string | (() => string) | (() => Promise<string>);
-    initial?: boolean | number | number[] | string | (() => string) | (() => Promise<string>);
-    required?: boolean;
-    stdin?: NodeJS.ReadStream;
-    stdout?: NodeJS.WriteStream;
-    header?: string;
-    footer?: string;
-    skip?: (value: any) => boolean | Promise<boolean>;
-    format?: (value: any) => any | Promise<any>;
-    result?: (value: any) => any | Promise<any>;
-    validate?: (value: any, state: any) => boolean | Promise<boolean> | string | Promise<string> | Promise<string | boolean>;
-    onSubmit?: (name: any, value: any, prompt: Enquirer.Prompt) => boolean | Promise<boolean>;
-    onCancel?: (name: any, value: any, prompt: Enquirer.Prompt) => boolean | Promise<boolean>;
-}
-interface EnquirerBasePromptOptionsWithName extends EnquirerBasePromptOptions {
-    name: string | (() => string);
-}
-interface EnquirerArrayPromptOptions extends EnquirerBasePromptOptions {
-    choices: string[] | EnquirerBasePromptOptionsWithName[];
-    maxChoices?: number;
-    multiple?: boolean;
-    initial?: number | number[];
-    delay?: number;
-    separator?: boolean;
-    sort?: boolean;
-    linebreak?: boolean;
-    edgeLength?: number;
-    align?: 'left' | 'right';
-    scroll?: boolean;
-    hint?: string;
-}
-interface EnquirerBooleanPromptOptions extends EnquirerBasePromptOptions {
-    initial?: boolean | (() => string) | (() => Promise<string>);
-}
-interface EnquirerStringPromptOptions extends EnquirerBasePromptOptions {
-    initial?: string;
-    multiline?: boolean;
-}
-interface EnquirerScalePromptOptions extends EnquirerArrayPromptOptions {
-    scale: EnquirerStringPromptOptions[];
-    margin?: [number, number, number, number];
-}
-interface EnquirerNumberPromptOptions extends EnquirerBasePromptOptions {
-    min?: number;
-    max?: number;
-    delay?: number;
-    float?: boolean;
-    round?: boolean;
-    major?: number;
-    minor?: number;
-    initial?: number;
-}
-interface EnquirerSnippetPromptOptions extends EnquirerBasePromptOptions {
-    newline?: string;
-    fields: Partial<EnquirerBasePromptOptionsWithName>[];
-    template: string;
-}
-interface EnquirerSortPromptOptions extends EnquirerBasePromptOptions {
-    hint?: string;
-    drag?: boolean;
-    numbered?: boolean;
-}
-interface EnquirerSurveyPromptOptions extends EnquirerArrayPromptOptions {
-    scale: EnquirerBasePromptOptionsWithName[];
-    margin: [number, number, number, number];
-}
-interface EnquirerQuizPromptOptions extends EnquirerArrayPromptOptions {
-    correctChoice: number;
-}
-interface EnquirerTogglePromptOptions extends EnquirerBasePromptOptions {
-    enabled?: string;
-    disabled?: string;
-}
-interface EnquirerPromptCancelOptions {
-    throw?: boolean;
-}
-/** Returns all the prompt options depending on the type selected. */
-type EnquirerPromptOptions<T extends boolean = false> = Unionize<{
-    [K in EnquirerPromptTypes]-?: T extends true ? {
-        type: K;
-    } & EnquirerPromptOptionsType<K> & {
-        name: string | (() => string);
-    } : {
-        type: K;
-    } & EnquirerPromptOptionsType<K>;
-}> | ({
-    type: string;
-} & T extends true ? EnquirerPromptOptionsType<string> & {
-    name: string | (() => string);
-} : EnquirerPromptOptionsType<string>);
-type EnquirerPromptTypes = 'AutoComplete' | 'BasicAuth' | 'Confirm' | 'Editable' | 'Form' | 'Input' | 'Invisible' | 'List' | 'MultiSelect' | 'Numeral' | 'Password' | 'Quiz' | 'Scale' | 'Select' | 'Snippet' | 'Sort' | 'Survey' | 'Text' | 'Toggle';
-type EnquirerPromptOptionsType<T> = T extends keyof EnquirerPromptOptionsMap ? EnquirerPromptOptionsMap[T] : T extends string ? EnquirerBasePromptOptions & Record<PropertyKey, unknown> : any;
-declare class EnquirerPromptOptionsMap implements Record<EnquirerPromptTypes, Record<PropertyKey, any>> {
-    AutoComplete: EnquirerArrayPromptOptions;
-    BasicAuth: EnquirerStringPromptOptions;
-    Confirm: EnquirerBooleanPromptOptions;
-    Editable: EnquirerArrayPromptOptions;
-    Form: EnquirerArrayPromptOptions;
-    Input: EnquirerStringPromptOptions;
-    Invisible: EnquirerStringPromptOptions;
-    List: EnquirerArrayPromptOptions;
-    MultiSelect: EnquirerArrayPromptOptions;
-    Numeral: EnquirerNumberPromptOptions;
-    Password: EnquirerStringPromptOptions;
-    Quiz: EnquirerQuizPromptOptions;
-    Scale: EnquirerScalePromptOptions;
-    Select: EnquirerArrayPromptOptions;
-    Snippet: EnquirerSnippetPromptOptions;
-    Sort: EnquirerSortPromptOptions;
-    Survey: EnquirerSurveyPromptOptions;
-    Text: EnquirerStringPromptOptions;
-    Toggle: EnquirerTogglePromptOptions;
-}
-interface EnquirerPromptSettings {
-    error?: boolean;
-    stdout?: WriteStream | Writable;
-    enquirer?: Enquirer;
-}
-interface EnquirerPromptInstance extends Omit<EnquirerBasePromptOptions, 'onCancel' | 'onSubmit'> {
-    submit: () => void;
-    cancel: (err?: string) => void;
-}
-
-declare class ListrEnquirerPromptAdapter extends ListrPromptAdapter {
-    error: PromptError;
-    private prompt;
-    /**
-     * Get the current running instance of `enquirer`.
-     */
-    get instance(): EnquirerPromptInstance;
-    /**
-     * Create a new prompt with `enquirer`.
-     *
-     * `enquirer` is a peer dependency that must be installed seperately.
-     */
-    run<T = any>(options: EnquirerPromptOptions | EnquirerPromptOptions<true>[], settings?: EnquirerPromptSettings): Promise<T>;
-    /**
-     * Cancel the ongoing prompt.
-     */
-    cancel(options?: EnquirerPromptCancelOptions): void;
-}
-
-export { type EnquirerPromptCancelOptions, type EnquirerPromptInstance, type EnquirerPromptOptions, EnquirerPromptOptionsMap, type EnquirerPromptOptionsType, type EnquirerPromptSettings, type EnquirerPromptTypes, ListrEnquirerPromptAdapter };