@node-core/utils 7.2.1 → 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.1",
+  "version": "7.2.2",
   "description": "Utilities for Node.js core collaborators",
   "type": "module",
   "engines": {
@@ -40,17 +40,17 @@
     "@pkgjs/nv": "^0.3.0",
     "branch-diff": "^3.1.1",
     "changelog-maker": "^4.4.1",
-    "cheerio": "^1.0.0",
     "core-validate-commit": "^6.0.0",
     "ghauth": "^7.0.1",
     "git-secure-tag": "^2.3.1",
+    "htmlparser2": "^12.0.0",
     "js-yaml": "^5.2.1",
     "listr2": "^11.1.0",
-    "ora": "^9.0.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/boolbase/README.md

@@ -1,10 +0,0 @@
-#boolbase
-This very simple module provides two basic functions, one that always returns true (`trueFunc`) and one that always returns false (`falseFunc`).
-
-###WTF?
-
-By having only a single instance of these functions around, it's possible to do some nice optimizations. Eg. [`CSSselect`](https://github.com/fb55/CSSselect) uses these functions to determine whether a selector won't match any elements. If that's the case, the DOM doesn't even have to be touched.
-
-###And why is this a separate module?
-
-I'm trying to modularize `CSSselect` and most modules depend on these functions. IMHO, having a separate module is the easiest solution to this problem.

package/node_modules/boolbase/index.js

@@ -1,8 +0,0 @@
-module.exports = {
-	trueFunc: function trueFunc(){
-		return true;
-	},
-	falseFunc: function falseFunc(){
-		return false;
-	}
-};

package/node_modules/boolbase/package.json

@@ -1,23 +0,0 @@
-{
-  "name": "boolbase",
-  "version": "1.0.0",
-  "description": "two functions: One that returns true, one that returns false",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/fb55/boolbase"
-  },
-  "keywords": [
-    "boolean",
-    "function"
-  ],
-  "author": "Felix Boehm <me@feedic.com>",
-  "license": "ISC",
-  "bugs": {
-    "url": "https://github.com/fb55/boolbase/issues"
-  },
-  "homepage": "https://github.com/fb55/boolbase"
-}

package/node_modules/cheerio/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2022 The Cheerio contributors
-
-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/cheerio/Readme.md

@@ -1,229 +0,0 @@
-<h1 align="center">cheerio</h1>
-
-<h5 align="center">The fast, flexible, and elegant library for parsing and manipulating HTML and XML.</h5>
-
-<div align="center">
-  <a href="https://github.com/cheeriojs/cheerio/actions/workflows/ci.yml">
-    <img src="https://github.com/cheeriojs/cheerio/actions/workflows/ci.yml/badge.svg" alt="Build Status">
-  </a>
-  <a href="https://coveralls.io/github/cheeriojs/cheerio">
-    <img src="https://img.shields.io/coveralls/github/cheeriojs/cheerio/main" alt="Coverage">
-  </a>
-  <a href="#backers">
-    <img src="https://img.shields.io/opencollective/backers/cheerio" alt="OpenCollective backers">
-  </a>
-  <a href="#sponsors">
-    <img src="https://img.shields.io/opencollective/sponsors/cheerio" alt="OpenCollective sponsors">
-  </a>
-</div>
-
-<br>
-
-[中文文档 (Chinese Readme)](https://github.com/cheeriojs/cheerio/wiki/Chinese-README)
-
-```js
-import * as cheerio from 'cheerio';
-const $ = cheerio.load('<h2 class="title">Hello world</h2>');
-
-$('h2.title').text('Hello there!');
-$('h2').addClass('welcome');
-
-$.html();
-//=> <html><head></head><body><h2 class="title welcome">Hello there!</h2></body></html>
-```
-
-## Installation
-
-Install Cheerio using a package manager like npm, yarn, or bun.
-
-```bash
-npm install cheerio
-# or
-bun add cheerio
-```
-
-## Features
-
-**&#10084; Proven syntax:** Cheerio implements a subset of core jQuery. Cheerio
-removes all the DOM inconsistencies and browser cruft from the jQuery library,
-revealing its truly gorgeous API.
-
-**&#991; Blazingly fast:** Cheerio works with a very simple, consistent DOM
-model. As a result parsing, manipulating, and rendering are incredibly
-efficient.
-
-**&#10049; Incredibly flexible:** Cheerio wraps around
-[parse5](https://github.com/inikulin/parse5) for parsing HTML and can optionally
-use the forgiving [htmlparser2](https://github.com/fb55/htmlparser2/). Cheerio
-can parse nearly any HTML or XML document. Cheerio works in both browser and
-server environments.
-
-## API
-
-### Loading
-
-First you need to load in the HTML. This step in jQuery is implicit, since
-jQuery operates on the one, baked-in DOM. With Cheerio, we need to pass in the
-HTML document.
-
-```js
-// ESM or TypeScript:
-import * as cheerio from 'cheerio';
-
-// In other environments:
-const cheerio = require('cheerio');
-
-const $ = cheerio.load('<ul id="fruits">...</ul>');
-
-$.html();
-//=> <html><head></head><body><ul id="fruits">...</ul></body></html>
-```
-
-### Selectors
-
-Once you've loaded the HTML, you can use jQuery-style selectors to find elements
-within the document.
-
-#### \$( selector, [context], [root] )
-
-`selector` searches within the `context` scope which searches within the `root`
-scope. `selector` and `context` can be a string expression, DOM Element, array
-of DOM elements, or cheerio object. `root`, if provided, is typically the HTML
-document string.
-
-This selector method is the starting point for traversing and manipulating the
-document. Like in jQuery, it's the primary method for selecting elements in the
-document.
-
-```js
-$('.apple', '#fruits').text();
-//=> Apple
-
-$('ul .pear').attr('class');
-//=> pear
-
-$('li[class=orange]').html();
-//=> Orange
-```
-
-### Rendering
-
-When you're ready to render the document, you can call the `html` method on the
-"root" selection:
-
-```js
-$.root().html();
-//=>  <html>
-//      <head></head>
-//      <body>
-//        <ul id="fruits">
-//          <li class="apple">Apple</li>
-//          <li class="orange">Orange</li>
-//          <li class="pear">Pear</li>
-//        </ul>
-//      </body>
-//    </html>
-```
-
-If you want to render the
-[`outerHTML`](https://developer.mozilla.org/en-US/docs/Web/API/Element/outerHTML)
-of a selection, you can use the `outerHTML` prop:
-
-```js
-$('.pear').prop('outerHTML');
-//=> <li class="pear">Pear</li>
-```
-
-You may also render the text content of a Cheerio object using the `text`
-method:
-
-```js
-const $ = cheerio.load('This is <em>content</em>.');
-$('body').text();
-//=> This is content.
-```
-
-### The "DOM Node" object
-
-Cheerio collections are made up of objects that bear some resemblance to
-[browser-based DOM nodes](https://developer.mozilla.org/en-US/docs/Web/API/Node).
-You can expect them to define the following properties:
-
-- `tagName`
-- `parentNode`
-- `previousSibling`
-- `nextSibling`
-- `nodeValue`
-- `firstChild`
-- `childNodes`
-- `lastChild`
-
-## Screencasts
-
-[https://vimeo.com/31950192](https://vimeo.com/31950192)
-
-> This video tutorial is a follow-up to Nettut's "How to Scrape Web Pages with
-> Node.js and jQuery", using cheerio instead of JSDOM + jQuery. This video shows
-> how easy it is to use cheerio and how much faster cheerio is than JSDOM +
-> jQuery.
-
-## Cheerio in the real world
-
-Are you using cheerio in production? Add it to the
-[wiki](https://github.com/cheeriojs/cheerio/wiki/Cheerio-in-Production)!
-
-## Sponsors
-
-Does your company use Cheerio in production? Please consider
-[sponsoring this project](https://github.com/cheeriojs/cheerio?sponsor=1)! Your
-help will allow maintainers to dedicate more time and resources to its
-development and support.
-
-**Headlining Sponsors**
-
-<!-- BEGIN SPONSORS: headliner -->
-
-<a href="https://tidelift.com/subscription/pkg/npm-cheerio" target="_blank" rel="noopener noreferrer">
-            <img height="128px" width="128px" src="https://humble.imgix.net/https%3A%2F%2Fgithub.com%2Ftidelift.png?ixlib=js-3.8.0&w=128&h=128&fit=fillmax&fill=solid&s=0713e6ee5c7ab01e7559df695c1e8cd9" title="Tidelift" alt="Tidelift"></img>
-          </a>
-<a href="https://github.com/" target="_blank" rel="noopener noreferrer">
-            <img height="128px" width="128px" src="https://humble.imgix.net/https%3A%2F%2Fgithub.com%2Fgithub.png?ixlib=js-3.8.0&w=128&h=128&fit=fillmax&fill=solid&s=a1e87ca289de84eb32ea85432cf8ad11" title="Github" alt="Github"></img>
-          </a>
-<a href="https://www.airbnb.com/" target="_blank" rel="noopener noreferrer">
-            <img height="128px" width="128px" src="https://humble.imgix.net/https%3A%2F%2Fgithub.com%2Fairbnb.png?ixlib=js-3.8.0&w=128&h=128&fit=fillmax&fill=solid&s=384cad45e10faea516202ad10801f895" title="AirBnB" alt="AirBnB"></img>
-          </a>
-<a href="https://hasdata.com" target="_blank" rel="noopener noreferrer">
-            <img height="128px" width="128px" src="https://humble.imgix.net/https%3A%2F%2Fhasdata.com%2Ffavicon.svg?ixlib=js-3.8.0&w=128&h=128&fit=fillmax&fill=solid&s=21933842d61dec74a961fc57754e58cb" title="HasData" alt="HasData"></img>
-          </a>
-
-<!-- END SPONSORS -->
-
-**Other Sponsors**
-
-<!-- BEGIN SPONSORS: sponsor -->
-
-<a href="https://onlinecasinosspelen.com" target="_blank" rel="noopener noreferrer">
-            <img height="64px" width="64px" src="https://humble.imgix.net/https%3A%2F%2Fimages.opencollective.com%2Fonlinecasinosspelen%2F99ac6a2%2Flogo.png?ixlib=js-3.8.0&w=64&h=64&fit=fillmax&fill=solid&s=8ec1ec058845b823858f22205485be02" title="OnlineCasinosSpelen" alt="OnlineCasinosSpelen"></img>
-          </a>
-<a href="https://Nieuwe-Casinos.net" target="_blank" rel="noopener noreferrer">
-            <img height="64px" width="64px" src="https://humble.imgix.net/https%3A%2F%2Fimages.opencollective.com%2Fnieuwecasinos%2Fc67d423%2Flogo.png?ixlib=js-3.8.0&w=64&h=64&fit=fillmax&fill=solid&s=ed55d86b80b1aa8cf89b033020521945" title="Nieuwe-Casinos.net" alt="Nieuwe-Casinos.net"></img>
-          </a>
-
-<!-- END SPONSORS -->
-
-## Backers
-
-[Become a backer](https://github.com/cheeriojs/cheerio?sponsor=1) to show your
-support for Cheerio and help us maintain and improve this open source project.
-
-<!-- BEGIN SPONSORS: backer -->
-
-<a href="https://kafidoff.com" target="_blank" rel="noopener noreferrer">
-            <img height="64px" width="64px" src="https://humble.imgix.net/https%3A%2F%2Fimages.opencollective.com%2Fkafidoff-vasy%2Fd7ff85c%2Favatar.png?ixlib=js-3.8.0&w=64&h=64&fit=fillmax&fill=solid&s=a41c66c2f9b1d3a7a241e425e7aa2d09" title="Vasy Kafidoff" alt="Vasy Kafidoff"></img>
-          </a>
-
-<!-- END SPONSORS -->
-
-## License
-
-MIT