@umijs/utils 3.5.17 → 4.0.0-beta.1

package/compiled/cheerio/domhandler/lib/node.d.ts

@@ -0,0 +1,169 @@
+import { ElementType } from '../../domelementtype';
+/**
+ * This object will be used as the prototype for Nodes when creating a
+ * DOM-Level-1-compliant structure.
+ */
+export declare class Node {
+    type: ElementType;
+    /** Parent of the node */
+    parent: NodeWithChildren | null;
+    /** Previous sibling */
+    prev: Node | null;
+    /** Next sibling */
+    next: Node | null;
+    /** The start index of the node. Requires `withStartIndices` on the handler to be `true. */
+    startIndex: number | null;
+    /** The end index of the node. Requires `withEndIndices` on the handler to be `true. */
+    endIndex: number | null;
+    /**
+     *
+     * @param type The type of the node.
+     */
+    constructor(type: ElementType);
+    get nodeType(): number;
+    get parentNode(): NodeWithChildren | null;
+    set parentNode(parent: NodeWithChildren | null);
+    get previousSibling(): Node | null;
+    set previousSibling(prev: Node | null);
+    get nextSibling(): Node | null;
+    set nextSibling(next: Node | null);
+    /**
+     * Clone this node, and optionally its children.
+     *
+     * @param recursive Clone child nodes as well.
+     * @returns A clone of the node.
+     */
+    cloneNode<T extends Node>(this: T, recursive?: boolean): T;
+}
+/**
+ * A node that contains some data.
+ */
+export declare class DataNode extends Node {
+    data: string;
+    /**
+     * @param type The type of the node
+     * @param data The content of the data node
+     */
+    constructor(type: ElementType.Comment | ElementType.Text | ElementType.Directive, data: string);
+    get nodeValue(): string;
+    set nodeValue(data: string);
+}
+/**
+ * Text within the document.
+ */
+export declare class Text extends DataNode {
+    constructor(data: string);
+}
+/**
+ * Comments within the document.
+ */
+export declare class Comment extends DataNode {
+    constructor(data: string);
+}
+/**
+ * Processing instructions, including doc types.
+ */
+export declare class ProcessingInstruction extends DataNode {
+    name: string;
+    constructor(name: string, data: string);
+    "x-name"?: string;
+    "x-publicId"?: string;
+    "x-systemId"?: string;
+}
+/**
+ * A `Node` that can have children.
+ */
+export declare class NodeWithChildren extends Node {
+    children: Node[];
+    /**
+     * @param type Type of the node.
+     * @param children Children of the node. Only certain node types can have children.
+     */
+    constructor(type: ElementType.Root | ElementType.CDATA | ElementType.Script | ElementType.Style | ElementType.Tag, children: Node[]);
+    get firstChild(): Node | null;
+    get lastChild(): Node | null;
+    get childNodes(): Node[];
+    set childNodes(children: Node[]);
+}
+/**
+ * The root node of the document.
+ */
+export declare class Document extends NodeWithChildren {
+    constructor(children: Node[]);
+    "x-mode"?: "no-quirks" | "quirks" | "limited-quirks";
+}
+/**
+ * The description of an individual attribute.
+ */
+interface Attribute {
+    name: string;
+    value: string;
+    namespace?: string;
+    prefix?: string;
+}
+/**
+ * An element within the DOM.
+ */
+export declare class Element extends NodeWithChildren {
+    name: string;
+    attribs: {
+        [name: string]: string;
+    };
+    /**
+     * @param name Name of the tag, eg. `div`, `span`.
+     * @param attribs Object mapping attribute names to attribute values.
+     * @param children Children of the node.
+     */
+    constructor(name: string, attribs: {
+        [name: string]: string;
+    }, children?: Node[], type?: ElementType.Tag | ElementType.Script | ElementType.Style);
+    get tagName(): string;
+    set tagName(name: string);
+    get attributes(): Attribute[];
+    "x-attribsNamespace"?: Record<string, string>;
+    "x-attribsPrefix"?: Record<string, string>;
+}
+/**
+ * @param node Node to check.
+ * @returns `true` if the node is a `Element`, `false` otherwise.
+ */
+export declare function isTag(node: Node): node is Element;
+/**
+ * @param node Node to check.
+ * @returns `true` if the node has the type `CDATA`, `false` otherwise.
+ */
+export declare function isCDATA(node: Node): node is NodeWithChildren;
+/**
+ * @param node Node to check.
+ * @returns `true` if the node has the type `Text`, `false` otherwise.
+ */
+export declare function isText(node: Node): node is Text;
+/**
+ * @param node Node to check.
+ * @returns `true` if the node has the type `Comment`, `false` otherwise.
+ */
+export declare function isComment(node: Node): node is DataNode;
+/**
+ * @param node Node to check.
+ * @returns `true` if the node has the type `ProcessingInstruction`, `false` otherwise.
+ */
+export declare function isDirective(node: Node): node is ProcessingInstruction;
+/**
+ * @param node Node to check.
+ * @returns `true` if the node has the type `ProcessingInstruction`, `false` otherwise.
+ */
+export declare function isDocument(node: Node): node is Document;
+/**
+ * @param node Node to check.
+ * @returns `true` if the node is a `NodeWithChildren` (has children), `false` otherwise.
+ */
+export declare function hasChildren(node: Node): node is NodeWithChildren;
+/**
+ * Clone a node, and optionally its children.
+ *
+ * @param recursive Clone child nodes as well.
+ * @returns A clone of the node.
+ */
+export declare function cloneNode<T extends Node>(node: T, recursive?: boolean): T;
+export {};
+//# sourceMappingURL=node.d.ts.map

package/compiled/cheerio/htmlparser2/lib/Parser.d.ts

@@ -0,0 +1,159 @@
+import Tokenizer from './Tokenizer';
+export interface ParserOptions {
+    /**
+     * Indicates whether special tags (`<script>`, `<style>`, and `<title>`) should get special treatment
+     * and if "empty" tags (eg. `<br>`) can have children.  If `false`, the content of special tags
+     * will be text only. For feeds and other XML content (documents that don't consist of HTML),
+     * set this to `true`.
+     *
+     * @default false
+     */
+    xmlMode?: boolean;
+    /**
+     * Decode entities within the document.
+     *
+     * @default true
+     */
+    decodeEntities?: boolean;
+    /**
+     * If set to true, all tags will be lowercased.
+     *
+     * @default !xmlMode
+     */
+    lowerCaseTags?: boolean;
+    /**
+     * If set to `true`, all attribute names will be lowercased. This has noticeable impact on speed.
+     *
+     * @default !xmlMode
+     */
+    lowerCaseAttributeNames?: boolean;
+    /**
+     * If set to true, CDATA sections will be recognized as text even if the xmlMode option is not enabled.
+     * NOTE: If xmlMode is set to `true` then CDATA sections will always be recognized as text.
+     *
+     * @default xmlMode
+     */
+    recognizeCDATA?: boolean;
+    /**
+     * If set to `true`, self-closing tags will trigger the onclosetag event even if xmlMode is not set to `true`.
+     * NOTE: If xmlMode is set to `true` then self-closing tags will always be recognized.
+     *
+     * @default xmlMode
+     */
+    recognizeSelfClosing?: boolean;
+    /**
+     * Allows the default tokenizer to be overwritten.
+     */
+    Tokenizer?: typeof Tokenizer;
+}
+export interface Handler {
+    onparserinit(parser: Parser): void;
+    /**
+     * Resets the handler back to starting state
+     */
+    onreset(): void;
+    /**
+     * Signals the handler that parsing is done
+     */
+    onend(): void;
+    onerror(error: Error): void;
+    onclosetag(name: string): void;
+    onopentagname(name: string): void;
+    /**
+     *
+     * @param name Name of the attribute
+     * @param value Value of the attribute.
+     * @param quote Quotes used around the attribute. `null` if the attribute has no quotes around the value, `undefined` if the attribute has no value.
+     */
+    onattribute(name: string, value: string, quote?: string | undefined | null): void;
+    onopentag(name: string, attribs: {
+        [s: string]: string;
+    }): void;
+    ontext(data: string): void;
+    oncomment(data: string): void;
+    oncdatastart(): void;
+    oncdataend(): void;
+    oncommentend(): void;
+    onprocessinginstruction(name: string, data: string): void;
+}
+export declare class Parser {
+    /** The start index of the last event. */
+    startIndex: number;
+    /** The end index of the last event. */
+    endIndex: number | null;
+    private tagname;
+    private attribname;
+    private attribvalue;
+    private attribs;
+    private stack;
+    private readonly foreignContext;
+    private readonly cbs;
+    private readonly options;
+    private readonly lowerCaseTagNames;
+    private readonly lowerCaseAttributeNames;
+    private readonly tokenizer;
+    constructor(cbs: Partial<Handler> | null, options?: ParserOptions);
+    private updatePosition;
+    ontext(data: string): void;
+    onopentagname(name: string): void;
+    onopentagend(): void;
+    onclosetag(name: string): void;
+    onselfclosingtag(): void;
+    private closeCurrentTag;
+    onattribname(name: string): void;
+    onattribdata(value: string): void;
+    onattribend(quote: string | undefined | null): void;
+    private getInstructionName;
+    ondeclaration(value: string): void;
+    onprocessinginstruction(value: string): void;
+    oncomment(value: string): void;
+    oncdata(value: string): void;
+    onerror(err: Error): void;
+    onend(): void;
+    /**
+     * Resets the parser to a blank state, ready to parse a new HTML document
+     */
+    reset(): void;
+    /**
+     * Resets the parser, then parses a complete document and
+     * pushes it to the handler.
+     *
+     * @param data Document to parse.
+     */
+    parseComplete(data: string): void;
+    /**
+     * Parses a chunk of data and calls the corresponding callbacks.
+     *
+     * @param chunk Chunk to parse.
+     */
+    write(chunk: string): void;
+    /**
+     * Parses the end of the buffer and clears the stack, calls onend.
+     *
+     * @param chunk Optional final chunk to parse.
+     */
+    end(chunk?: string): void;
+    /**
+     * Pauses parsing. The parser won't emit events until `resume` is called.
+     */
+    pause(): void;
+    /**
+     * Resumes parsing after `pause` was called.
+     */
+    resume(): void;
+    /**
+     * Alias of `write`, for backwards compatibility.
+     *
+     * @param chunk Chunk to parse.
+     * @deprecated
+     */
+    parseChunk(chunk: string): void;
+    /**
+     * Alias of `end`, for backwards compatibility.
+     *
+     * @param chunk Optional final chunk to parse.
+     * @deprecated
+     */
+    done(chunk?: string): void;
+}
+//# sourceMappingURL=Parser.d.ts.map

package/compiled/cheerio/htmlparser2/lib/Tokenizer.d.ts

@@ -0,0 +1,182 @@
+/** All the states the tokenizer can be in. */
+declare const enum State {
+    Text = 1,
+    BeforeTagName = 2,
+    InTagName = 3,
+    InSelfClosingTag = 4,
+    BeforeClosingTagName = 5,
+    InClosingTagName = 6,
+    AfterClosingTagName = 7,
+    BeforeAttributeName = 8,
+    InAttributeName = 9,
+    AfterAttributeName = 10,
+    BeforeAttributeValue = 11,
+    InAttributeValueDq = 12,
+    InAttributeValueSq = 13,
+    InAttributeValueNq = 14,
+    BeforeDeclaration = 15,
+    InDeclaration = 16,
+    InProcessingInstruction = 17,
+    BeforeComment = 18,
+    InComment = 19,
+    InSpecialComment = 20,
+    AfterComment1 = 21,
+    AfterComment2 = 22,
+    BeforeCdata1 = 23,
+    BeforeCdata2 = 24,
+    BeforeCdata3 = 25,
+    BeforeCdata4 = 26,
+    BeforeCdata5 = 27,
+    BeforeCdata6 = 28,
+    InCdata = 29,
+    AfterCdata1 = 30,
+    AfterCdata2 = 31,
+    BeforeSpecialS = 32,
+    BeforeSpecialSEnd = 33,
+    BeforeScript1 = 34,
+    BeforeScript2 = 35,
+    BeforeScript3 = 36,
+    BeforeScript4 = 37,
+    BeforeScript5 = 38,
+    AfterScript1 = 39,
+    AfterScript2 = 40,
+    AfterScript3 = 41,
+    AfterScript4 = 42,
+    AfterScript5 = 43,
+    BeforeStyle1 = 44,
+    BeforeStyle2 = 45,
+    BeforeStyle3 = 46,
+    BeforeStyle4 = 47,
+    AfterStyle1 = 48,
+    AfterStyle2 = 49,
+    AfterStyle3 = 50,
+    AfterStyle4 = 51,
+    BeforeSpecialT = 52,
+    BeforeSpecialTEnd = 53,
+    BeforeTitle1 = 54,
+    BeforeTitle2 = 55,
+    BeforeTitle3 = 56,
+    BeforeTitle4 = 57,
+    AfterTitle1 = 58,
+    AfterTitle2 = 59,
+    AfterTitle3 = 60,
+    AfterTitle4 = 61,
+    BeforeEntity = 62,
+    BeforeNumericEntity = 63,
+    InNamedEntity = 64,
+    InNumericEntity = 65,
+    InHexEntity = 66
+}
+export interface Callbacks {
+    onattribdata(value: string): void;
+    onattribend(quote: string | undefined | null): void;
+    onattribname(name: string): void;
+    oncdata(data: string): void;
+    onclosetag(name: string): void;
+    oncomment(data: string): void;
+    ondeclaration(content: string): void;
+    onend(): void;
+    onerror(error: Error, state?: State): void;
+    onopentagend(): void;
+    onopentagname(name: string): void;
+    onprocessinginstruction(instruction: string): void;
+    onselfclosingtag(): void;
+    ontext(value: string): void;
+}
+export default class Tokenizer {
+    /** The current state the tokenizer is in. */
+    _state: State;
+    /** The read buffer. */
+    private buffer;
+    /** The beginning of the section that is currently being read. */
+    sectionStart: number;
+    /** The index within the buffer that we are currently looking at. */
+    _index: number;
+    /**
+     * Data that has already been processed will be removed from the buffer occasionally.
+     * `_bufferOffset` keeps track of how many characters have been removed, to make sure position information is accurate.
+     */
+    private bufferOffset;
+    /** Some behavior, eg. when decoding entities, is done while we are in another state. This keeps track of the other state type. */
+    private baseState;
+    /** For special parsing behavior inside of script and style tags. */
+    private special;
+    /** Indicates whether the tokenizer has been paused. */
+    private running;
+    /** Indicates whether the tokenizer has finished running / `.end` has been called. */
+    private ended;
+    private readonly cbs;
+    private readonly xmlMode;
+    private readonly decodeEntities;
+    constructor(options: {
+        xmlMode?: boolean;
+        decodeEntities?: boolean;
+    } | null, cbs: Callbacks);
+    reset(): void;
+    write(chunk: string): void;
+    end(chunk?: string): void;
+    pause(): void;
+    resume(): void;
+    /**
+     * The current index within all of the written data.
+     */
+    getAbsoluteIndex(): number;
+    private stateText;
+    /**
+     * HTML only allows ASCII alpha characters (a-z and A-Z) at the beginning of a tag name.
+     *
+     * XML allows a lot more characters here (@see https://www.w3.org/TR/REC-xml/#NT-NameStartChar).
+     * We allow anything that wouldn't end the tag.
+     */
+    private isTagStartChar;
+    private stateBeforeTagName;
+    private stateInTagName;
+    private stateBeforeClosingTagName;
+    private stateInClosingTagName;
+    private stateAfterClosingTagName;
+    private stateBeforeAttributeName;
+    private stateInSelfClosingTag;
+    private stateInAttributeName;
+    private stateAfterAttributeName;
+    private stateBeforeAttributeValue;
+    private handleInAttributeValue;
+    private stateInAttributeValueDoubleQuotes;
+    private stateInAttributeValueSingleQuotes;
+    private stateInAttributeValueNoQuotes;
+    private stateBeforeDeclaration;
+    private stateInDeclaration;
+    private stateInProcessingInstruction;
+    private stateBeforeComment;
+    private stateInComment;
+    private stateInSpecialComment;
+    private stateAfterComment1;
+    private stateAfterComment2;
+    private stateBeforeCdata6;
+    private stateInCdata;
+    private stateAfterCdata1;
+    private stateAfterCdata2;
+    private stateBeforeSpecialS;
+    private stateBeforeSpecialSEnd;
+    private stateBeforeSpecialLast;
+    private stateAfterSpecialLast;
+    private parseFixedEntity;
+    private parseLegacyEntity;
+    private stateInNamedEntity;
+    private decodeNumericEntity;
+    private stateInNumericEntity;
+    private stateInHexEntity;
+    private cleanup;
+    /**
+     * Iterates through the buffer, calling the function corresponding to the current state.
+     *
+     * States that are more likely to be hit are higher up, as a performance improvement.
+     */
+    private parse;
+    private finish;
+    private handleTrailingData;
+    private getSection;
+    private emitToken;
+    private emitPartial;
+}
+export {};
+//# sourceMappingURL=Tokenizer.d.ts.map

package/compiled/cheerio/htmlparser2/lib/index.d.ts

@@ -0,0 +1,39 @@
+import { Parser, ParserOptions } from './Parser';
+export { Parser, ParserOptions };
+import { DomHandler, DomHandlerOptions, Node, Element, Document } from '../../domhandler';
+export { DomHandler, DomHandlerOptions };
+declare type Options = ParserOptions & DomHandlerOptions;
+/**
+ * Parses the data, returns the resulting document.
+ *
+ * @param data The data that should be parsed.
+ * @param options Optional options for the parser and DOM builder.
+ */
+export declare function parseDocument(data: string, options?: Options): Document;
+/**
+ * Parses data, returns an array of the root nodes.
+ *
+ * Note that the root nodes still have a `Document` node as their parent.
+ * Use `parseDocument` to get the `Document` node instead.
+ *
+ * @param data The data that should be parsed.
+ * @param options Optional options for the parser and DOM builder.
+ * @deprecated Use `parseDocument` instead.
+ */
+export declare function parseDOM(data: string, options?: Options): Node[];
+/**
+ * Creates a parser instance, with an attached DOM handler.
+ *
+ * @param cb A callback that will be called once parsing has been completed.
+ * @param options Optional options for the parser and DOM builder.
+ * @param elementCb An optional callback that will be called every time a tag has been completed inside of the DOM.
+ */
+export declare function createDomStream(cb: (error: Error | null, dom: Node[]) => void, options?: Options, elementCb?: (element: Element) => void): Parser;
+export { default as Tokenizer, Callbacks as TokenizerCallbacks, } from "./Tokenizer";
+import * as ElementType from '../../domelementtype';
+export { ElementType };
+export * from "./FeedHandler";
+export * as DomUtils from "domutils";
+export { DomHandler as DefaultHandler };
+export { FeedHandler as RssHandler } from "./FeedHandler";
+//# sourceMappingURL=index.d.ts.map