@zowe/cli 8.36.1 → 8.37.0

package/node_modules/{domutils/lib/esm → sanitize-html/node_modules/domutils/dist}/stringify.js

@@ -1,6 +1,6 @@
-import { isTag, isCDATA, isText, hasChildren, isComment, } from "domhandler";
 import renderHTML from "dom-serializer";
 import { ElementType } from "domelementtype";
+import { hasChildren, isCDATA, isComment, isTag, isText, } from "domhandler";
 /**
  * @category Stringify
  * @deprecated Use the `dom-serializer` module directly.

package/node_modules/sanitize-html/node_modules/domutils/dist/stringify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringify.js","sourceRoot":"","sources":["../src/stringify.ts"],"names":[],"mappings":"AAAA,OAAO,UAAyC,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAEH,WAAW,EACX,OAAO,EACP,SAAS,EACT,KAAK,EACL,MAAM,GACT,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CACxB,IAAkC,EAClC,OAA8B;IAE9B,OAAO,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CACxB,IAAa,EACb,OAA8B;IAE9B,OAAO,WAAW,CAAC,IAAI,CAAC;QACpB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACnE,CAAC,CAAC,EAAE,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,IAAyB;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,IAAI,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3E,IAAI,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IACnC,OAAO,EAAE,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,IAAyB;IACjD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/D,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,OAAO,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IACnC,OAAO,EAAE,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,IAAyB;IAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7D,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACxE,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IACnC,OAAO,EAAE,CAAC;AACd,CAAC"}

package/node_modules/sanitize-html/node_modules/domutils/dist/traversal.d.ts

@@ -0,0 +1,74 @@
+import { type AnyNode, type ChildNode, type Element, type ParentNode } 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 declare function getChildren(element: AnyNode): ChildNode[];
+/**
+ * Get a node's parent.
+ *
+ * @category Traversal
+ * @param element Node to get the parent of.
+ * @returns `element`'s parent node, or `null` if `element` is a root node.
+ */
+export declare function getParent(element: AnyNode): ParentNode | 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 declare function getSiblings(element: AnyNode): AnyNode[];
+/**
+ * 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 declare function getAttributeValue(element: Element, name: string): string | undefined;
+/**
+ * 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 declare function hasAttrib(element: Element, name: string): boolean;
+/**
+ * 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 declare function getName(element: Element): string;
+/**
+ * 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 declare function nextElementSibling(element: AnyNode): Element | null;
+/**
+ * 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.
+ */
+export declare function prevElementSibling(element: AnyNode): Element | null;
+//# sourceMappingURL=traversal.d.ts.map

package/node_modules/sanitize-html/node_modules/domutils/dist/traversal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traversal.d.ts","sourceRoot":"","sources":["../src/traversal.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,OAAO,EAGZ,KAAK,UAAU,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAAC;AAK/D;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,CAevD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,GACb,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKjE;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAInE;AAED;;;;;;;GAOG;AAEH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAInE"}

package/node_modules/sanitize-html/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/sanitize-html/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/sanitize-html/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/{domutils → sanitize-html/node_modules/domutils}/readme.md

@@ -23,9 +23,3 @@ License: BSD-2-Clause
 
 To report a security vulnerability, please use the [Tidelift security contact](https://tidelift.com/security).
 Tidelift will coordinate the fix and disclosure.
-
-## `domutils` for enterprise
-
-Available as part of the Tidelift Subscription
-
-The maintainers of `domutils` and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. [Learn more.](https://tidelift.com/subscription/pkg/npm-domutils?utm_source=npm-domutils&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)

package/node_modules/sanitize-html/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/sanitize-html/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";
+}