@node-core/utils 7.2.1 → 7.2.3

package/node_modules/htmlparser2/node_modules/domhandler/dist/node.js

@@ -0,0 +1,359 @@
+import { ElementType, isTag as isTagRaw } from "domelementtype";
+/**
+ * This object will be used as the prototype for Nodes when creating a
+ * DOM-Level-1-compliant structure.
+ */
+export class Node {
+    /** Parent of the node */
+    parent = null;
+    /** Previous sibling */
+    prev = null;
+    /** Next sibling */
+    next = null;
+    /** The start index of the node. Requires `withStartIndices` on the handler to be `true. */
+    startIndex = null;
+    /** The end index of the node. Requires `withEndIndices` on the handler to be `true. */
+    endIndex = null;
+    // Read-write aliases for properties
+    /**
+     * Same as {@link parent}.
+     * [DOM spec](https://dom.spec.whatwg.org)-compatible alias.
+     */
+    get parentNode() {
+        return this.parent;
+    }
+    set parentNode(parent) {
+        this.parent = parent;
+    }
+    /**
+     * Same as {@link prev}.
+     * [DOM spec](https://dom.spec.whatwg.org)-compatible alias.
+     */
+    get previousSibling() {
+        return this.prev;
+    }
+    set previousSibling(previous) {
+        this.prev = previous;
+    }
+    /**
+     * Same as {@link next}.
+     * [DOM spec](https://dom.spec.whatwg.org)-compatible alias.
+     */
+    get nextSibling() {
+        return this.next;
+    }
+    set nextSibling(next) {
+        this.next = next;
+    }
+    /**
+     * Clone this node, and optionally its children.
+     * @param recursive Clone child nodes as well.
+     * @returns A clone of the node.
+     */
+    cloneNode(recursive = false) {
+        return cloneNode(this, recursive);
+    }
+}
+/**
+ * A node that contains some data.
+ */
+export class DataNode extends Node {
+    data;
+    /**
+     * @param data The content of the data node
+     */
+    constructor(data) {
+        super();
+        this.data = data;
+    }
+    /**
+     * Same as {@link data}.
+     * [DOM spec](https://dom.spec.whatwg.org)-compatible alias.
+     */
+    get nodeValue() {
+        return this.data;
+    }
+    set nodeValue(data) {
+        this.data = data;
+    }
+}
+/**
+ * Text within the document.
+ */
+export class Text extends DataNode {
+    type = ElementType.Text;
+    get nodeType() {
+        return 3;
+    }
+}
+/**
+ * Comments within the document.
+ */
+export class Comment extends DataNode {
+    type = ElementType.Comment;
+    get nodeType() {
+        return 8;
+    }
+}
+/**
+ * Processing instructions, including doc types.
+ */
+export class ProcessingInstruction extends DataNode {
+    type = ElementType.Directive;
+    name;
+    constructor(name, data) {
+        super(data);
+        this.name = name;
+    }
+    get nodeType() {
+        return 1;
+    }
+    /** If this is a doctype, the document type name (parse5 only). */
+    "x-name";
+    /** If this is a doctype, the document type public identifier (parse5 only). */
+    "x-publicId";
+    /** If this is a doctype, the document type system identifier (parse5 only). */
+    "x-systemId";
+}
+/**
+ * A node that can have children.
+ */
+export class NodeWithChildren extends Node {
+    children;
+    /**
+     * @param children Children of the node. Only certain node types can have children.
+     */
+    constructor(children) {
+        super();
+        this.children = children;
+    }
+    // Aliases
+    /** First child of the node. */
+    get firstChild() {
+        return this.children[0] ?? null;
+    }
+    /** Last child of the node. */
+    get lastChild() {
+        return this.children.length > 0
+            ? this.children[this.children.length - 1]
+            : null;
+    }
+    /**
+     * Same as {@link children}.
+     * [DOM spec](https://dom.spec.whatwg.org)-compatible alias.
+     */
+    get childNodes() {
+        return this.children;
+    }
+    set childNodes(children) {
+        this.children = children;
+    }
+}
+/**
+ * CDATA nodes.
+ */
+export class CDATA extends NodeWithChildren {
+    type = ElementType.CDATA;
+    get nodeType() {
+        return 4;
+    }
+}
+/**
+ * The root node of the document.
+ */
+export class Document extends NodeWithChildren {
+    type = ElementType.Root;
+    get nodeType() {
+        return 9;
+    }
+}
+/**
+ * An element within the DOM.
+ */
+export class Element extends NodeWithChildren {
+    name;
+    attribs;
+    type;
+    /**
+     * @param name Name of the tag, eg. `div`, `span`.
+     * @param attribs Object mapping attribute names to attribute values.
+     * @param children Children of the node.
+     * @param type Node type used for the new node instance.
+     */
+    constructor(name, attribs, children = [], type = name === "script"
+        ? ElementType.Script
+        : name === "style"
+            ? ElementType.Style
+            : ElementType.Tag) {
+        super(children);
+        this.name = name;
+        this.attribs = attribs;
+        this.type = type;
+    }
+    get nodeType() {
+        return 1;
+    }
+    // DOM Level 1 aliases
+    /**
+     * Same as {@link name}.
+     * [DOM spec](https://dom.spec.whatwg.org)-compatible alias.
+     */
+    get tagName() {
+        return this.name;
+    }
+    set tagName(name) {
+        this.name = name;
+    }
+    get attributes() {
+        return Object.keys(this.attribs).map((name) => ({
+            name,
+            value: this.attribs[name],
+            namespace: this["x-attribsNamespace"]?.[name],
+            prefix: this["x-attribsPrefix"]?.[name],
+        }));
+    }
+    /** Element namespace (parse5 only). */
+    namespace;
+    /** Element attribute namespaces (parse5 only). */
+    "x-attribsNamespace";
+    /** Element attribute namespace-related prefixes (parse5 only). */
+    "x-attribsPrefix";
+}
+/**
+ * Checks if `node` is an element node.
+ * @param node Node to check.
+ * @returns `true` if the node is an element node.
+ */
+export function isTag(node) {
+    return isTagRaw(node);
+}
+/**
+ * Checks if `node` is a CDATA node.
+ * @param node Node to check.
+ * @returns `true` if the node is a CDATA node.
+ */
+export function isCDATA(node) {
+    return node.type === ElementType.CDATA;
+}
+/**
+ * Checks if `node` is a text node.
+ * @param node Node to check.
+ * @returns `true` if the node is a text node.
+ */
+export function isText(node) {
+    return node.type === ElementType.Text;
+}
+/**
+ * Checks if `node` is a comment node.
+ * @param node Node to check.
+ * @returns `true` if the node is a comment node.
+ */
+export function isComment(node) {
+    return node.type === ElementType.Comment;
+}
+/**
+ * Checks if `node` is a directive node.
+ * @param node Node to check.
+ * @returns `true` if the node is a directive node.
+ */
+export function isDirective(node) {
+    return node.type === ElementType.Directive;
+}
+/**
+ * Checks if `node` is a document node.
+ * @param node Node to check.
+ * @returns `true` if the node is a document node.
+ */
+export function isDocument(node) {
+    return node.type === ElementType.Root;
+}
+/**
+ * Checks if `node` has children.
+ * @param node Node to check.
+ * @returns `true` if the node has children.
+ */
+export function hasChildren(node) {
+    return Object.hasOwn(node, "children");
+}
+/**
+ * Clone a node, and optionally its children.
+ * @param node Node to clone.
+ * @param recursive Clone child nodes as well.
+ * @returns A clone of the node.
+ */
+export function cloneNode(node, recursive = false) {
+    let result;
+    if (isText(node)) {
+        result = new Text(node.data);
+    }
+    else if (isComment(node)) {
+        result = new Comment(node.data);
+    }
+    else if (isTag(node)) {
+        const children = recursive ? cloneChildren(node.children) : [];
+        const clone = new Element(node.name, { ...node.attribs }, children);
+        for (const child of children) {
+            child.parent = clone;
+        }
+        if (node.namespace != null) {
+            clone.namespace = node.namespace;
+        }
+        if (node["x-attribsNamespace"]) {
+            clone["x-attribsNamespace"] = { ...node["x-attribsNamespace"] };
+        }
+        if (node["x-attribsPrefix"]) {
+            clone["x-attribsPrefix"] = { ...node["x-attribsPrefix"] };
+        }
+        result = clone;
+    }
+    else if (isCDATA(node)) {
+        const children = recursive ? cloneChildren(node.children) : [];
+        const clone = new CDATA(children);
+        for (const child of children) {
+            child.parent = clone;
+        }
+        result = clone;
+    }
+    else if (isDocument(node)) {
+        const children = recursive ? cloneChildren(node.children) : [];
+        const clone = new Document(children);
+        for (const child of children) {
+            child.parent = clone;
+        }
+        if (node["x-mode"]) {
+            clone["x-mode"] = node["x-mode"];
+        }
+        result = clone;
+    }
+    else if (isDirective(node)) {
+        const instruction = new ProcessingInstruction(node.name, node.data);
+        if (node["x-name"] != null) {
+            instruction["x-name"] = node["x-name"];
+            instruction["x-publicId"] = node["x-publicId"];
+            instruction["x-systemId"] = node["x-systemId"];
+        }
+        result = instruction;
+    }
+    else {
+        throw new Error(`Not implemented yet: ${node.type}`);
+    }
+    result.startIndex = node.startIndex;
+    result.endIndex = node.endIndex;
+    if (node.sourceCodeLocation != null) {
+        result.sourceCodeLocation = node.sourceCodeLocation;
+    }
+    return result;
+}
+/**
+ * Clone a list of child nodes.
+ * @param childs The child nodes to clone.
+ * @returns A list of cloned child nodes.
+ */
+function cloneChildren(childs) {
+    const children = childs.map((child) => cloneNode(child, true));
+    for (let index = 1; index < children.length; index++) {
+        children[index].prev = children[index - 1];
+        children[index - 1].next = children[index];
+    }
+    return children;
+}

package/node_modules/htmlparser2/node_modules/domhandler/package.json

@@ -0,0 +1,65 @@
+{
+    "type": "module",
+    "name": "domhandler",
+    "version": "6.0.1",
+    "description": "Handler for htmlparser2 that turns pages into a dom",
+    "author": "Felix Boehm <me@feedic.com>",
+    "funding": {
+        "type": "github",
+        "url": "https://github.com/fb55/domhandler?sponsor=1"
+    },
+    "license": "BSD-2-Clause",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        }
+    },
+    "sideEffects": false,
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "build:docs": "typedoc --hideGenerator --plugin typedoc-plugin-missing-exports src/index.ts",
+        "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/domhandler.git"
+    },
+    "keywords": [
+        "dom",
+        "htmlparser2"
+    ],
+    "engines": {
+        "node": ">=20.19.0"
+    },
+    "dependencies": {
+        "domelementtype": "^3.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.27.9",
+        "typedoc-plugin-missing-exports": "^3.1.0",
+        "typescript": "^5.8.3",
+        "typescript-eslint": "^8.57.1",
+        "vitest": "^4.0.18"
+    }
+}

package/node_modules/htmlparser2/node_modules/domhandler/readme.md

@@ -0,0 +1,86 @@
+# domhandler [![Node.js CI](https://github.com/fb55/domhandler/actions/workflows/nodejs-test.yml/badge.svg)](https://github.com/fb55/domhandler/actions/workflows/nodejs-test.yml)
+
+The DOM handler creates a tree containing all nodes of a page.
+The tree can be manipulated using the [domutils](https://github.com/fb55/domutils)
+or [cheerio](https://github.com/cheeriojs/cheerio) libraries and
+rendered using [dom-serializer](https://github.com/cheeriojs/dom-serializer) .
+
+## Usage
+
+```javascript
+const handler = new DomHandler([ <func> callback(err, dom), ] [ <obj> options ]);
+// const parser = new Parser(handler[, options]);
+```
+
+Available options are described below.
+
+## Example
+
+```javascript
+const { Parser } = require("htmlparser2");
+const { DomHandler } = require("domhandler");
+const rawHtml =
+    "Xyz <script language= javascript>var foo = '<<bar>>';</script><!--<!-- Waah! -- -->";
+const handler = new DomHandler((error, dom) => {
+    if (error) {
+        // Handle error
+    } else {
+        // Parsing completed, do something
+        console.log(dom);
+    }
+});
+const parser = new Parser(handler);
+parser.write(rawHtml);
+parser.end();
+```
+
+Output:
+
+```javascript
+[
+    {
+        data: "Xyz ",
+        type: "text",
+    },
+    {
+        type: "script",
+        name: "script",
+        attribs: {
+            language: "javascript",
+        },
+        children: [
+            {
+                data: "var foo = '<bar>';<",
+                type: "text",
+            },
+        ],
+    },
+    {
+        data: "<!-- Waah! -- ",
+        type: "comment",
+    },
+];
+```
+
+## Option: `withStartIndices`
+
+Add a `startIndex` property to nodes.
+When the parser is used in a non-streaming fashion, `startIndex` is an integer
+indicating the position of the start of the node in the document.
+The default value is `false`.
+
+## Option: `withEndIndices`
+
+Add an `endIndex` property to nodes.
+When the parser is used in a non-streaming fashion, `endIndex` is an integer
+indicating the position of the end of the node in the document.
+The default value is `false`.
+
+---
+
+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/dist/feeds.d.ts

@@ -0,0 +1,71 @@
+import type { AnyNode } from "domhandler";
+/**
+ * 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 declare function getFeed(document: AnyNode[]): Feed | null;
+//# sourceMappingURL=feeds.d.ts.map

package/node_modules/htmlparser2/node_modules/domutils/dist/feeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feeds.d.ts","sourceRoot":"","sources":["../src/feeds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAW,MAAM,YAAY,CAAC;AAInD;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GACzB,OAAO,GACP,OAAO,GACP,OAAO,GACP,UAAU,GACV,YAAY,CAAC;AAEnB;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAEpE;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,KAAK,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,IAAI;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,GAAG,IAAI,CAQxD"}