@node-core/utils 7.2.0 → 7.2.2

package/node_modules/htmlparser2/node_modules/domutils/dist/traversal.js

@@ -0,0 +1,105 @@
+import { hasChildren, isTag, } from "domhandler";
+/**
+ * Get a node's children.
+ *
+ * @category Traversal
+ * @param element Node to get the children of.
+ * @returns `element`'s children, or an empty array.
+ */
+export function getChildren(element) {
+    return hasChildren(element) ? element.children : [];
+}
+export function getParent(element) {
+    return element.parent || null;
+}
+/**
+ * Gets an elements siblings, including the element itself.
+ *
+ * Attempts to get the children through the element's parent first. If we don't
+ * have a parent (the element is a root node), we walk the element's `prev` &
+ * `next` to get all remaining nodes.
+ *
+ * @category Traversal
+ * @param element Element to get the siblings of.
+ * @returns `element`'s siblings, including `element`.
+ */
+export function getSiblings(element) {
+    const parent = getParent(element);
+    if (parent != null)
+        return getChildren(parent);
+    const siblings = [element];
+    let { prev, next } = element;
+    while (prev != null) {
+        siblings.unshift(prev);
+        ({ prev } = prev);
+    }
+    while (next != null) {
+        siblings.push(next);
+        ({ next } = next);
+    }
+    return siblings;
+}
+/**
+ * Gets an attribute from an element.
+ *
+ * @category Traversal
+ * @param element Element to check.
+ * @param name Attribute name to retrieve.
+ * @returns The element's attribute value, or `undefined`.
+ */
+export function getAttributeValue(element, name) {
+    const { attribs } = element;
+    return attribs?.[name];
+}
+/**
+ * Checks whether an element has an attribute.
+ *
+ * @category Traversal
+ * @param element Element to check.
+ * @param name Attribute name to look for.
+ * @returns Returns whether `element` has the attribute `name`.
+ */
+export function hasAttrib(element, name) {
+    const { attribs } = element;
+    return (attribs != null && Object.hasOwn(attribs, name) && attribs[name] != null);
+}
+/**
+ * Get the tag name of an element.
+ *
+ * @category Traversal
+ * @param element The element to get the name for.
+ * @returns The tag name of `element`.
+ */
+export function getName(element) {
+    return element.name;
+}
+/**
+ * Returns the next element sibling of a node.
+ *
+ * @category Traversal
+ * @param element The element to get the next sibling of.
+ * @returns `element`'s next sibling that is a tag, or `null` if there is no next
+ * sibling.
+ */
+export function nextElementSibling(element) {
+    let { next } = element;
+    while (next !== null && !isTag(next))
+        ({ next } = next);
+    return next;
+}
+/**
+ * Returns the previous element sibling of a node.
+ *
+ * @category Traversal
+ * @param element The element to get the previous sibling of.
+ * @returns `element`'s previous sibling that is a tag, or `null` if there is no
+ * previous sibling.
+ */
+// eslint-disable-next-line unicorn/prevent-abbreviations -- Keep public API name for backwards compatibility.
+export function prevElementSibling(element) {
+    let { prev } = element;
+    while (prev !== null && !isTag(prev))
+        ({ prev } = prev);
+    return prev;
+}
+//# sourceMappingURL=traversal.js.map

package/node_modules/htmlparser2/node_modules/domutils/dist/traversal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traversal.js","sourceRoot":"","sources":["../src/traversal.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,WAAW,EACX,KAAK,GAER,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IACxC,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;AACxD,CAAC;AAUD,MAAM,UAAU,SAAS,CAAC,OAAgB;IACtC,OAAO,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;AAClC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IACxC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;IAE/C,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAC7B,OAAO,IAAI,IAAI,IAAI,EAAE,CAAC;QAClB,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,IAAI,IAAI,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC7B,OAAgB,EAChB,IAAY;IAEZ,MAAM,EAAE,OAAO,EAAE,GAAG,OAEnB,CAAC;IACF,OAAO,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,OAAgB,EAAE,IAAY;IACpD,MAAM,EAAE,OAAO,EAAE,GAAG,OAAsD,CAAC;IAC3E,OAAO,CACH,OAAO,IAAI,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAC3E,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,OAAgB;IACpC,OAAO,OAAO,CAAC,IAAI,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IAC/C,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACvB,OAAO,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,8GAA8G;AAC9G,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IAC/C,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACvB,OAAO,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/node_modules/htmlparser2/node_modules/domutils/package.json

@@ -0,0 +1,69 @@
+{
+    "type": "module",
+    "name": "domutils",
+    "version": "4.0.2",
+    "description": "Utilities for working with htmlparser2's dom",
+    "author": "Felix Boehm <me@feedic.com>",
+    "funding": {
+        "type": "github",
+        "url": "https://github.com/fb55/domutils?sponsor=1"
+    },
+    "license": "BSD-2-Clause",
+    "sideEffects": false,
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "src",
+        "!**/*.spec.ts",
+        "!**/__fixtures__/**"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "build:docs": "typedoc src",
+        "format": "npm run format:es && npm run format:biome",
+        "format:biome": "biome check --write .",
+        "format:es": "npm run lint:es -- --fix",
+        "lint": "npm run lint:es && npm run lint:biome",
+        "lint:biome": "biome check .",
+        "lint:es": "eslint .",
+        "prepublishOnly": "npm run build",
+        "test": "npm run test:vi && npm run lint",
+        "test:vi": "vitest run"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git://github.com/fb55/domutils.git"
+    },
+    "keywords": [
+        "dom",
+        "htmlparser2"
+    ],
+    "dependencies": {
+        "dom-serializer": "^3.0.0",
+        "domelementtype": "^3.0.0",
+        "domhandler": "^6.0.0"
+    },
+    "devDependencies": {
+        "@biomejs/biome": "^2.4.7",
+        "@eslint/compat": "^2.0.3",
+        "@feedic/eslint-config": "^0.3.1",
+        "@types/node": "^25.5.0",
+        "eslint": "^10.0.3",
+        "eslint-config-biome": "^2.1.3",
+        "htmlparser2": "~10.1.0",
+        "typedoc": "^0.28.17",
+        "typescript": "^5.9.3",
+        "typescript-eslint": "^8.57.1",
+        "vitest": "^4.0.18"
+    },
+    "engines": {
+        "node": ">=20.19.0"
+    }
+}

package/node_modules/htmlparser2/node_modules/domutils/readme.md

@@ -0,0 +1,25 @@
+# domutils [![Node.js CI](https://github.com/fb55/domutils/actions/workflows/nodejs-test.yml/badge.svg)](https://github.com/fb55/domutils/actions/workflows/nodejs-test.yml)
+
+Utilities for working with [htmlparser2](https://github.com/fb55/htmlparser2)'s DOM.
+
+All functions are exported as a single module. Look [through the docs](https://domutils.js.org/modules.html) to see what is available.
+
+## Ecosystem
+
+| Name                                                          | Description                                             |
+| ------------------------------------------------------------- | ------------------------------------------------------- |
+| [htmlparser2](https://github.com/fb55/htmlparser2)            | Fast & forgiving HTML/XML parser                        |
+| [domhandler](https://github.com/fb55/domhandler)              | Handler for htmlparser2 that turns documents into a DOM |
+| [domutils](https://github.com/fb55/domutils)                  | Utilities for working with domhandler's DOM             |
+| [css-select](https://github.com/fb55/css-select)              | CSS selector engine, compatible with domhandler's DOM   |
+| [cheerio](https://github.com/cheeriojs/cheerio)               | The jQuery API for domhandler's DOM                     |
+| [dom-serializer](https://github.com/cheeriojs/dom-serializer) | Serializer for domhandler's DOM                         |
+
+---
+
+License: BSD-2-Clause
+
+## Security contact information
+
+To report a security vulnerability, please use the [Tidelift security contact](https://tidelift.com/security).
+Tidelift will coordinate the fix and disclosure.

package/node_modules/htmlparser2/node_modules/domutils/src/__snapshots__/feeds.spec.ts.snap

@@ -0,0 +1,103 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`getFeed > Atom_Example.xml 1`] = `
+{
+  "author": "johndoe@example.com",
+  "description": "A subtitle.",
+  "id": "urn:uuid:60a76c80-d399-11d9-b91C-0003939e0af6",
+  "items": [
+    {
+      "description": "Some content.",
+      "id": "urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a",
+      "link": "http://example.org/2003/12/13/atom03",
+      "media": [],
+      "pubDate": 2003-12-13T18:30:02.000Z,
+      "title": "Atom-Powered Robots Run Amok",
+    },
+    {
+      "media": [],
+    },
+  ],
+  "link": "http://example.org/feed/",
+  "title": "Example Feed",
+  "type": "atom",
+  "updated": 2003-12-13T18:30:02.000Z,
+}
+`;
+
+exports[`getFeed > RDF_Example.xml 1`] = `
+{
+  "id": "",
+  "items": [
+    {
+      "description": "Great test content<br>A link: <a href="http://github.com">Github</a>",
+      "link": "http://somefakesite/path/to/something.html",
+      "media": [],
+      "pubDate": 2011-11-04T16:35:17.000Z,
+      "title": "Fast HTML Parsing",
+    },
+    {
+      "description": "The early bird gets the worm",
+      "link": "http://somefakesite/path/to/something-else.html",
+      "media": [],
+      "pubDate": 2011-11-04T16:34:54.000Z,
+      "title": "This space intentionally left blank",
+    },
+  ],
+  "link": "https://github.com/fb55/htmlparser2/",
+  "title": "A title to parse and remember",
+  "type": "rdf",
+}
+`;
+
+exports[`getFeed > RSS_Example.xml 1`] = `
+{
+  "author": "editor@example.com",
+  "description": "Liftoff to Space Exploration.",
+  "id": "",
+  "items": [
+    {
+      "description": "How do Americans get ready to work with Russians aboard the International Space Station? They take a crash course in culture, language and protocol at Russia's <a href="http://howe.iki.rssi.ru/GCTC/gctc_e.htm">Star City</a>.",
+      "id": "http://liftoff.msfc.nasa.gov/2003/06/03.html#item573",
+      "link": "http://liftoff.msfc.nasa.gov/news/2003/news-starcity.asp",
+      "media": [],
+      "pubDate": 2003-06-03T09:39:21.000Z,
+      "title": "Star City",
+    },
+    {
+      "description": "Sky watchers in Europe, Asia, and parts of Alaska and Canada will experience a <a href="http://science.nasa.gov/headlines/y2003/30may_solareclipse.htm">partial eclipse of the Sun</a> on Saturday, May 31st.",
+      "id": "http://liftoff.msfc.nasa.gov/2003/05/30.html#item572",
+      "media": [],
+      "pubDate": 2003-05-30T11:06:42.000Z,
+    },
+    {
+      "description": "Before man travels to Mars, NASA hopes to design new engines that will let us fly through the Solar System more quickly.  The proposed VASIMR engine would do that.",
+      "id": "http://liftoff.msfc.nasa.gov/2003/05/27.html#item571",
+      "link": "http://liftoff.msfc.nasa.gov/news/2003/news-VASIMR.asp",
+      "media": [],
+      "pubDate": 2003-05-27T08:37:32.000Z,
+      "title": "The Engine That Does More",
+    },
+    {
+      "description": "Compared to earlier spacecraft, the International Space Station has many luxuries, but laundry facilities are not one of them.  Instead, astronauts have other options.",
+      "id": "http://liftoff.msfc.nasa.gov/2003/05/20.html#item570",
+      "link": "http://liftoff.msfc.nasa.gov/news/2003/news-laundry.asp",
+      "media": [
+        {
+          "height": 200,
+          "isDefault": false,
+          "medium": "image",
+          "url": "https://picsum.photos/200",
+          "width": 200,
+        },
+      ],
+      "pubDate": 2003-05-20T08:56:02.000Z,
+      "title": "Astronauts' Dirty Laundry",
+    },
+  ],
+  "link": "http://liftoff.msfc.nasa.gov/",
+  "title": "Liftoff News",
+  "type": "rss",
+  "updated": 2003-06-10T09:41:01.000Z,
+}
+`;

package/node_modules/htmlparser2/node_modules/domutils/src/feeds.ts

@@ -0,0 +1,301 @@
+import type { AnyNode, Element } from "domhandler";
+import { getElementsByTagName } from "./legacy.js";
+import { textContent } from "./stringify.js";
+
+/**
+ * The medium of a media item.
+ *
+ * @category Feeds
+ */
+export type FeedItemMediaMedium =
+    | "image"
+    | "audio"
+    | "video"
+    | "document"
+    | "executable";
+
+/**
+ * The type of a media item.
+ *
+ * @category Feeds
+ */
+export type FeedItemMediaExpression = "sample" | "full" | "nonstop";
+
+/**
+ * A media item of a feed entry.
+ *
+ * @category Feeds
+ */
+export interface FeedItemMedia {
+    medium: FeedItemMediaMedium | undefined;
+    isDefault: boolean;
+    url?: string;
+    fileSize?: number;
+    type?: string;
+    expression?: FeedItemMediaExpression;
+    bitrate?: number;
+    framerate?: number;
+    samplingrate?: number;
+    channels?: number;
+    duration?: number;
+    height?: number;
+    width?: number;
+    lang?: string;
+}
+
+/**
+ * An entry of a feed.
+ *
+ * @category Feeds
+ */
+export interface FeedItem {
+    id?: string;
+    title?: string;
+    link?: string;
+    description?: string;
+    pubDate?: Date;
+    media: FeedItemMedia[];
+}
+
+/**
+ * The root of a feed.
+ *
+ * @category Feeds
+ */
+export interface Feed {
+    type: string;
+    id?: string;
+    title?: string;
+    link?: string;
+    description?: string;
+    updated?: Date;
+    author?: string;
+    items: FeedItem[];
+}
+
+/**
+ * Get the feed object from the root of a DOM tree.
+ *
+ * @category Feeds
+ * @param document The DOM to extract the feed from.
+ * @returns The feed.
+ */
+export function getFeed(document: AnyNode[]): Feed | null {
+    const feedRoot = getOneElement(isValidFeed, document);
+
+    return feedRoot
+        ? feedRoot.name === "feed"
+            ? getAtomFeed(feedRoot)
+            : getRssFeed(feedRoot)
+        : null;
+}
+
+/**
+ * Parse an Atom feed.
+ *
+ * @param feedRoot The root of the feed.
+ * @returns The parsed feed.
+ */
+function getAtomFeed(feedRoot: Element) {
+    const childs = feedRoot.children;
+
+    const feed: Feed = {
+        type: "atom",
+        items: getElementsByTagName("entry", childs).map((item) => {
+            const { children } = item;
+            const entry: FeedItem = { media: getMediaElements(children) };
+
+            addConditionally(entry, "id", "id", children);
+            addConditionally(entry, "title", "title", children);
+
+            const href = getOneElement("link", children)?.attribs["href"];
+            if (href) {
+                entry.link = href;
+            }
+
+            const description =
+                fetch("summary", children) || fetch("content", children);
+            if (description) {
+                entry.description = description;
+            }
+
+            const pubDate = fetch("updated", children);
+            if (pubDate) {
+                entry.pubDate = new Date(pubDate);
+            }
+
+            return entry;
+        }),
+    };
+
+    addConditionally(feed, "id", "id", childs);
+    addConditionally(feed, "title", "title", childs);
+    const href = getOneElement("link", childs)?.attribs["href"];
+    if (href) {
+        feed.link = href;
+    }
+    addConditionally(feed, "description", "subtitle", childs);
+
+    const updated = fetch("updated", childs);
+    if (updated) {
+        feed.updated = new Date(updated);
+    }
+
+    addConditionally(feed, "author", "email", childs, true);
+
+    return feed;
+}
+
+/**
+ * Parse a RSS feed.
+ *
+ * @param feedRoot The root of the feed.
+ * @returns The parsed feed.
+ */
+function getRssFeed(feedRoot: Element) {
+    const childs = getOneElement("channel", feedRoot.children)?.children ?? [];
+
+    const feed: Feed = {
+        type: feedRoot.name.substr(0, 3),
+        id: "",
+        items: getElementsByTagName("item", feedRoot.children).map(
+            (item: Element) => {
+                const { children } = item;
+                const entry: FeedItem = { media: getMediaElements(children) };
+                addConditionally(entry, "id", "guid", children);
+                addConditionally(entry, "title", "title", children);
+                addConditionally(entry, "link", "link", children);
+                addConditionally(entry, "description", "description", children);
+                const pubDate =
+                    fetch("pubDate", children) || fetch("dc:date", children);
+                if (pubDate) entry.pubDate = new Date(pubDate);
+
+                return entry;
+            },
+        ),
+    };
+
+    addConditionally(feed, "title", "title", childs);
+    addConditionally(feed, "link", "link", childs);
+    addConditionally(feed, "description", "description", childs);
+
+    const updated = fetch("lastBuildDate", childs);
+    if (updated) {
+        feed.updated = new Date(updated);
+    }
+
+    addConditionally(feed, "author", "managingEditor", childs, true);
+
+    return feed;
+}
+
+const MEDIA_KEYS_STRING = ["url", "type", "lang"] as const;
+const MEDIA_KEYS_INT = [
+    "fileSize",
+    "bitrate",
+    "framerate",
+    "samplingrate",
+    "channels",
+    "duration",
+    "height",
+    "width",
+] as const;
+
+/**
+ * Get all media elements of a feed item.
+ *
+ * @param where Nodes to search in.
+ * @returns Media elements.
+ */
+function getMediaElements(where: AnyNode[]): FeedItemMedia[] {
+    return getElementsByTagName("media:content", where).map((element) => {
+        const { attribs } = element;
+
+        const media: FeedItemMedia = {
+            medium: attribs["medium"] as unknown as
+                | FeedItemMediaMedium
+                | undefined,
+            isDefault: !!attribs["isDefault"],
+        };
+
+        for (const attrib of MEDIA_KEYS_STRING) {
+            if (attribs[attrib]) {
+                media[attrib] = attribs[attrib];
+            }
+        }
+
+        for (const attrib of MEDIA_KEYS_INT) {
+            if (attribs[attrib]) {
+                media[attrib] = Number.parseInt(attribs[attrib], 10);
+            }
+        }
+
+        if (attribs["expression"]) {
+            media.expression = attribs[
+                "expression"
+            ] as unknown as FeedItemMediaExpression;
+        }
+
+        return media;
+    });
+}
+
+/**
+ * Get one element by tag name.
+ *
+ * @param tagName Tag name to look for
+ * @param node Node to search in
+ * @returns The element or null
+ */
+function getOneElement(
+    tagName: string | ((name: string) => boolean),
+    node: AnyNode[],
+): Element | null {
+    return getElementsByTagName(tagName, node, true, 1)[0];
+}
+
+/**
+ * Get the text content of an element with a certain tag name.
+ *
+ * @param tagName Tag name to look for.
+ * @param where Node to search in.
+ * @param recurse Whether to recurse into child nodes.
+ * @returns The text content of the element.
+ */
+function fetch(
+    tagName: string,
+    where: AnyNode | AnyNode[],
+    recurse = false,
+): string {
+    return textContent(getElementsByTagName(tagName, where, recurse, 1)).trim();
+}
+
+/**
+ * Adds a property to an object if it has a value.
+ *
+ * @param object Object to be extended.
+ * @param property Property name.
+ * @param tagName Tag name that contains the conditionally added property.
+ * @param where Element to search for the property.
+ * @param recurse Whether to recurse into child nodes.
+ */
+function addConditionally<T>(
+    object: T,
+    property: keyof T,
+    tagName: string,
+    where: AnyNode[],
+    recurse = false,
+) {
+    const value = fetch(tagName, where, recurse);
+    if (value) object[property] = value as unknown as T[keyof T];
+}
+
+/**
+ * Checks if an element is a feed root node.
+ *
+ * @param value The name of the element to check.
+ * @returns Whether an element is a feed root node.
+ */
+function isValidFeed(value: string) {
+    return value === "rss" || value === "feed" || value === "rdf:RDF";
+}