html-validate 7.6.0 → 7.7.1

package/dist/cjs/core.d.ts

@@ -1001,739 +1001,773 @@ interface CSSStyleDeclaration {
     [key: string]: string;
 }
 
-interface PermittedGroup {
-    exclude?: string | string[];
-}
-declare type CategoryOrTag = string;
-declare type PropertyExpression = string | [string, any];
-declare type PermittedEntry = CategoryOrTag | PermittedGroup | Array<CategoryOrTag | PermittedGroup>;
-declare type Permitted = PermittedEntry[];
-declare type PermittedOrder = string[];
-declare type RequiredAncestors = string[];
-declare type RequiredContent = string[];
-declare enum TextContent {
-    NONE = "none",
-    DEFAULT = "default",
-    REQUIRED = "required",
-    ACCESSIBLE = "accessible"
-}
 /**
  * @public
  */
-interface MetaAttribute {
-    boolean?: boolean;
-    deprecated?: boolean | string;
-    enum?: Array<string | RegExp>;
-    list?: boolean;
-    omit?: boolean;
-    required?: boolean;
+interface TransformContext {
+    /**
+     * Test if an additional chainable transformer is present.
+     *
+     * Returns true only if there is a transformer configured for the given
+     * filename.
+     *
+     * @param filename - Filename to use to match next transformer.
+     */
+    hasChain(filename: string): boolean;
+    /**
+     * Chain transformations.
+     *
+     * Sometimes multiple transformers must be applied. For instance, a Markdown
+     * file with JSX in a code-block.
+     *
+     * @param source - Source to chain transformations on.
+     * @param filename - Filename to use to match next transformer (unrelated to
+     * filename set in source)
+     */
+    chain(source: Source, filename: string): Iterable<Source>;
 }
-declare type PermittedAttribute = Record<string, MetaAttribute | Array<string | RegExp> | null>;
-interface DeprecatedElement {
-    message?: string;
-    documentation?: string;
-    source?: string;
+
+declare module "estree" {
+    interface TemplateElement {
+        start: number;
+        end: number;
+    }
 }
 /**
  * @public
  */
-interface MetaData {
-    inherit?: string;
-    metadata?: boolean | PropertyExpression;
-    flow?: boolean | PropertyExpression;
-    sectioning?: boolean | PropertyExpression;
-    heading?: boolean | PropertyExpression;
-    phrasing?: boolean | PropertyExpression;
-    embedded?: boolean | PropertyExpression;
-    interactive?: boolean | PropertyExpression;
-    deprecated?: boolean | string | DeprecatedElement;
-    foreign?: boolean;
-    void?: boolean;
-    transparent?: boolean | string[];
-    implicitClosed?: string[];
-    scriptSupporting?: boolean;
-    form?: boolean;
-    labelable?: boolean | PropertyExpression;
-    deprecatedAttributes?: string[];
-    requiredAttributes?: string[];
-    attributes?: PermittedAttribute;
-    permittedContent?: Permitted;
-    permittedDescendants?: Permitted;
-    permittedOrder?: PermittedOrder;
-    permittedParent?: Permitted;
-    requiredAncestors?: RequiredAncestors;
-    requiredContent?: RequiredContent;
-    textContent?: TextContent;
-}
-/**
- * Properties listed here can be used to reverse search elements with the given
- * property enabled. See [[MetaTable.getTagsWithProperty]].
- */
-declare type MetaLookupableProperty = "metadata" | "flow" | "sectioning" | "heading" | "phrasing" | "embedded" | "interactive" | "deprecated" | "foreign" | "void" | "transparent" | "scriptSupporting" | "form" | "labelable";
-/**
- * Properties listed here can be copied (loaded) onto another element using
- * [[HtmlElement.loadMeta]].
- *
- * @public
- */
-declare const MetaCopyableProperty: Array<keyof MetaElement>;
-/**
- * @public
- */
-interface MetaElement extends Omit<MetaData, "deprecatedAttributes" | "requiredAttributes"> {
-    tagName: string;
-    attributes: Record<string, MetaAttribute>;
-}
-interface MetaDataTable {
-    [tagName: string]: MetaData;
-}
-interface ElementTable {
-    [tagName: string]: MetaElement;
-}
-
-declare enum NodeType {
-    ELEMENT_NODE = 1,
-    TEXT_NODE = 3,
-    DOCUMENT_NODE = 9
-}
-
-interface DOMNodeCache {
-}
-
-declare type DOMInternalID = number;
-declare const TEXT_CONTENT: unique symbol;
-declare module "./cache" {
-    interface DOMNodeCache {
-        [TEXT_CONTENT]: string;
-    }
-}
-declare class DOMNode {
-    readonly nodeName: string;
-    readonly nodeType: NodeType;
-    readonly childNodes: DOMNode[];
-    readonly location: Location;
-    readonly unique: DOMInternalID;
-    private cache;
+declare class TemplateExtractor {
+    private ast;
+    private filename;
+    private data;
+    private constructor();
+    static fromFilename(filename: string): TemplateExtractor;
     /**
-     * Set of disabled rules for this node.
+     * Create a new [[TemplateExtractor]] from javascript source code.
      *
-     * Rules disabled by using directives are added here.
-     */
-    private disabledRules;
-    /**
-     * Create a new DOMNode.
+     * `Source` offsets will be relative to the string, i.e. offset 0 is the first
+     * character of the string. If the string is only a subset of a larger string
+     * the offsets must be adjusted manually.
      *
-     * @param nodeType - What node type to create.
-     * @param nodeName - What node name to use. For `HtmlElement` this corresponds
-     * to the tagName but other node types have specific predefined values.
-     * @param location - Source code location of this node.
+     * @param source - Source code.
+     * @param filename - Optional filename to set in the resulting
+     * `Source`. Defauls to `"inline"`.
      */
-    constructor(nodeType: NodeType, nodeName: string | undefined, location: Location);
+    static fromString(source: string, filename?: string): TemplateExtractor;
     /**
-     * Enable cache for this node.
+     * Convenience function to create a [[Source]] instance from an existing file.
      *
-     * Should not be called before the node and all children are fully constructed.
+     * @param filename - Filename with javascript source code. The file must exist
+     * and be readable by the user.
+     * @returns An array of Source's suitable for passing to [[Engine]] linting
+     * functions.
      */
-    cacheEnable(): void;
+    static createSource(filename: string): Source[];
     /**
-     * Fetch cached value from this DOM node.
+     * Extract object properties.
      *
-     * Cache is not enabled until `cacheEnable()` is called by [[Parser]] (when
-     * the element is fully constructed).
+     * Given a key `"template"` this method finds all objects literals with a
+     * `"template"` property and creates a [[Source]] instance with proper offsets
+     * with the value of the property. For instance:
      *
-     * @returns value or `undefined` if the value doesn't exist.
-     */
-    cacheGet<K extends keyof DOMNodeCache>(key: K): DOMNodeCache[K] | undefined;
-    cacheGet(key: string | number | symbol): any | undefined;
-    /**
-     * Store a value in cache.
+     * ```
+     * const myObj = {
+     *   foo: 'bar',
+     * };
+     * ```
      *
-     * @returns the value itself is returned.
-     */
-    cacheSet<K extends keyof DOMNodeCache>(key: K, value: DOMNodeCache[K]): DOMNodeCache[K];
-    cacheSet<T>(key: string | number | symbol, value: T): T;
-    /**
-     * Remove a value by key from cache.
+     * The above snippet would yield a `Source` with the content `bar`.
      *
-     * @returns `true` if the entry existed and has been removed.
-     */
-    cacheRemove<K extends keyof DOMNodeCache>(key: K): boolean;
-    cacheRemove(key: string | number | symbol): boolean;
-    /**
-     * Check if key exists in cache.
-     */
-    cacheExists<K extends keyof DOMNodeCache>(key: K): boolean;
-    cacheExists(key: string | number | symbol): boolean;
-    /**
-     * Get the text (recursive) from all child nodes.
-     */
-    get textContent(): string;
-    append(node: DOMNode): void;
-    isRootElement(): boolean;
-    /**
-     * Tests if two nodes are the same (references the same object).
-     */
-    isSameNode(otherNode: DOMNode): boolean;
-    /**
-     * Returns a DOMNode representing the first direct child node or `null` if the
-     * node has no children.
      */
-    get firstChild(): DOMNode;
-    /**
-     * Returns a DOMNode representing the last direct child node or `null` if the
-     * node has no children.
-     */
-    get lastChild(): DOMNode;
-    /**
-     * Disable a rule for this node.
-     */
-    disableRule(ruleId: string): void;
-    /**
-     * Disables multiple rules.
-     */
-    disableRules(rules: string[]): void;
-    /**
-     * Enable a previously disabled rule for this node.
-     */
-    enableRule(ruleId: string): void;
-    /**
-     * Enables multiple rules.
-     */
-    enableRules(rules: string[]): void;
-    /**
-     * Test if a rule is enabled for this node.
-     */
-    ruleEnabled(ruleId: string): boolean;
-    generateSelector(): string | null;
-}
-
-declare class DOMTokenList extends Array<string> {
-    readonly value: string;
-    private readonly locations;
-    constructor(value: string | DynamicValue | null, location: Location | null);
-    item(n: number): string | undefined;
-    location(n: number): Location | undefined;
-    contains(token: string): boolean;
-    iterator(): Generator<{
-        index: number;
-        item: string;
-        location: Location;
-    }>;
+    extractObjectProperty(key: string): Source[];
 }
 
 /**
  * @public
  */
-declare enum NodeClosed {
-    Open = 0,
-    EndTag = 1,
-    VoidOmitted = 2,
-    VoidSelfClosed = 3,
-    ImplicitClosed = 4
+declare type Transformer = (this: TransformContext, source: Source) => Iterable<Source>;
+
+interface SchemaValidationPatch {
+    properties?: Record<string, unknown>;
+    definitions?: Record<string, unknown>;
 }
 /**
  * @public
  */
-declare class HtmlElement extends DOMNode {
-    readonly tagName: string;
-    readonly parent: HtmlElement | null;
-    readonly voidElement: boolean;
-    readonly depth: number;
-    closed: NodeClosed;
-    protected readonly attr: {
-        [key: string]: Attribute[];
-    };
-    private metaElement;
-    private annotation;
-    constructor(tagName: string | undefined, parent: HtmlElement | null, closed: NodeClosed, meta: MetaElement | null, location: Location);
+interface Plugin {
     /**
-     * @internal
+     * Name of the plugin.
+     *
+     * If specified this is the name used when referring to the plugin. Default is
+     * to use the name/path the user used when loading the plugin. To be less
+     * confusing for users you should use the same name as your package.
+     *
+     * The name must be a valid package name according to NPM (basically lowercase
+     * characters, must not begin with dot, slash or non-url safe characters).
+     *
+     * Hint: import and use the name from `package.json`.
      */
-    static rootNode(location: Location): HtmlElement;
+    name?: string | null;
     /**
-     * @internal
+     * Initialization callback.
      *
-     * @param namespace - If given it is appended to the tagName.
+     * Called once per plugin during initialization.
      */
-    static fromTokens(startToken: TagOpenToken, endToken: TagCloseToken, parent: HtmlElement | null, metaTable: MetaTable | null, namespace?: string): HtmlElement;
+    init?: () => void | null;
     /**
-     * Returns annotated name if set or defaults to `<tagName>`.
+     * Setup callback.
      *
-     * E.g. `my-annotation` or `<div>`.
+     * Called once per source after engine is initialized.
+     *
+     * @param source - The source about to be validated. Readonly.
+     * @param eventhandler - Eventhandler from parser. Can be used to listen for
+     * parser events.
      */
-    get annotatedName(): string;
+    setup?: (source: Source, eventhandler: EventHandler) => void | null;
     /**
-     * Get list of IDs referenced by `aria-labelledby`.
+     * Configuration presets.
      *
-     * If the attribute is unset or empty this getter returns null.
-     * If the attribute is dynamic the original {@link DynamicValue} is returned.
+     * Each key should be the unprefixed name which a configuration later can
+     * access using `${plugin}:${key}`, e.g. if a plugin named "my-plugin" exposes
+     * a preset named "foobar" it can be accessed using:
      *
-     * @public
+     * "extends": ["my-plugin:foobar"]
      */
-    get ariaLabelledby(): string[] | DynamicValue | null;
+    configs?: Record<string, ConfigData | null> | null;
     /**
-     * Similar to childNodes but only elements.
+     * List of new rules present.
      */
-    get childElements(): HtmlElement[];
+    rules?: Record<string, RuleConstructor<any, any> | null> | null;
+    /**
+     * Transformer available in this plugin.
+     *
+     * Can be given either as a single unnamed transformer or an object with
+     * multiple named.
+     *
+     * Unnamed transformers use the plugin name similar to how a standalone
+     * transformer would work:
+     *
+     * ```
+     * "transform": {
+     *   "^.*\\.foo$": "my-plugin"
+     * }
+     * ```
+     *
+     * For named transformers each key should be the unprefixed name which a
+     * configuration later can access using `${plugin}:${key}`, e.g. if a plugin
+     * named "my-plugin" exposes a transformer named "foobar" it can be accessed
+     * using:
+     *
+     * ```
+     * "transform": {
+     *   "^.*\\.foo$": "my-plugin:foobar"
+     * }
+     * ```
+     */
+    transformer?: Transformer | Record<string, Transformer | null> | null;
+    /**
+     * Extend metadata validation schema.
+     */
+    elementSchema?: SchemaValidationPatch | null;
+}
+
+/**
+ * @public
+ */
+declare class MetaTable {
+    readonly elements: ElementTable;
+    private schema;
     /**
-     * Find the first ancestor matching a selector.
-     *
-     * Implementation of DOM specification of Element.closest(selectors).
+     * @internal
      */
-    closest(selectors: string): HtmlElement | null;
+    constructor();
     /**
-     * Generate a DOM selector for this element. The returned selector will be
-     * unique inside the current document.
+     * @internal
      */
-    generateSelector(): string | null;
+    init(): void;
     /**
-     * Tests if this element has given tagname.
+     * Extend validation schema.
      *
-     * If passing "*" this test will pass if any tagname is set.
+     * @internal
      */
-    is(tagName: string): boolean;
+    extendValidationSchema(patch: SchemaValidationPatch): void;
     /**
-     * Load new element metadata onto this element.
-     *
-     * Do note that semantics such as `void` cannot be changed (as the element has
-     * already been created). In addition the element will still "be" the same
-     * element, i.e. even if loading meta for a `<p>` tag upon a `<div>` tag it
-     * will still be a `<div>` as far as the rest of the validator is concerned.
-     *
-     * In fact only certain properties will be copied onto the element:
-     *
-     * - content categories (flow, phrasing, etc)
-     * - required attributes
-     * - attribute allowed values
-     * - permitted/required elements
-     *
-     * Properties *not* loaded:
-     *
-     * - inherit
-     * - deprecated
-     * - foreign
-     * - void
-     * - implicitClosed
-     * - scriptSupporting
-     * - deprecatedAttributes
+     * Load metadata table from object.
      *
-     * Changes to element metadata will only be visible after `element:ready` (and
-     * the subsequent `dom:ready` event).
+     * @internal
+     * @param obj - Object with metadata to load
+     * @param filename - Optional filename used when presenting validation error
      */
-    loadMeta(meta: MetaElement): void;
+    loadFromObject(obj: unknown, filename?: string | null): void;
     /**
-     * Match this element against given selectors. Returns true if any selector
-     * matches.
+     * Load metadata table from filename
      *
-     * Implementation of DOM specification of Element.matches(selectors).
-     */
-    matches(selector: string): boolean;
-    get meta(): MetaElement | null;
-    /**
-     * Set annotation for this element.
+     * @internal
+     * @param filename - Filename to load
      */
-    setAnnotation(text: string): void;
+    loadFromFile(filename: string): void;
     /**
-     * Set attribute. Stores all attributes set even with the same name.
+     * Get [[MetaElement]] for the given tag. If no specific metadata is present
+     * the global metadata is returned or null if no global is present.
      *
-     * @param key - Attribute name
-     * @param value - Attribute value. Use `null` if no value is present.
-     * @param keyLocation - Location of the attribute name.
-     * @param valueLocation - Location of the attribute value (excluding quotation)
-     * @param originalAttribute - If attribute is an alias for another attribute
-     * (dynamic attributes) set this to the original attribute name.
-     */
-    setAttribute(key: string, value: string | DynamicValue | null, keyLocation: Location, valueLocation: Location | null, originalAttribute?: string): void;
-    /**
-     * Get a list of all attributes on this node.
+     * @public
+     * @returns A shallow copy of metadata.
      */
-    get attributes(): Attribute[];
-    hasAttribute(key: string): boolean;
+    getMetaFor(tagName: string): MetaElement | null;
     /**
-     * Get attribute.
-     *
-     * By default only the first attribute is returned but if the code needs to
-     * handle duplicate attributes the `all` parameter can be set to get all
-     * attributes with given key.
-     *
-     * This usually only happens when code contains duplicate attributes (which
-     * `no-dup-attr` will complain about) or when a static attribute is combined
-     * with a dynamic, consider:
-     *
-     * <p class="foo" dynamic-class="bar">
+     * Find all tags which has enabled given property.
      *
-     * @param key - Attribute name
-     * @param all - Return single or all attributes.
+     * @public
      */
-    getAttribute(key: string): Attribute | null;
-    getAttribute(key: string, all: true): Attribute[];
+    getTagsWithProperty(propName: MetaLookupableProperty): string[];
     /**
-     * Get attribute value.
-     *
-     * Returns the attribute value if present.
-     *
-     * - Missing attributes return `null`.
-     * - Boolean attributes return `null`.
-     * - `DynamicValue` returns attribute expression.
+     * Find tag matching tagName or inheriting from it.
      *
-     * @param key - Attribute name
-     * @returns Attribute value or null.
+     * @public
      */
-    getAttributeValue(key: string): string | null;
+    getTagsDerivedFrom(tagName: string): string[];
+    private addEntry;
     /**
-     * Add text as a child node to this element.
-     *
-     * @param text - Text to add.
-     * @param location - Source code location of this text.
+     * Construct a new AJV schema validator.
      */
-    appendText(text: string | DynamicValue, location: Location): void;
+    private getSchemaValidator;
     /**
-     * Return a list of all known classes on the element. Dynamic values are
-     * ignored.
+     * @public
      */
-    get classList(): DOMTokenList;
+    getJSONSchema(): SchemaObject;
     /**
-     * Get element ID if present.
+     * Finds the global element definition and merges each known element with the
+     * global, e.g. to assign global attributes.
      */
-    get id(): string | null;
-    get style(): CSSStyleDeclaration;
+    private resolveGlobal;
+    private mergeElement;
     /**
-     * Returns the first child element or null if there are no child elements.
+     * @internal
      */
-    get firstElementChild(): HtmlElement | null;
+    resolve(node: HtmlElement): void;
+}
+
+declare enum NodeType {
+    ELEMENT_NODE = 1,
+    TEXT_NODE = 3,
+    DOCUMENT_NODE = 9
+}
+
+interface DOMNodeCache {
+}
+
+declare type DOMInternalID = number;
+declare const TEXT_CONTENT: unique symbol;
+declare module "./cache" {
+    interface DOMNodeCache {
+        [TEXT_CONTENT]: string;
+    }
+}
+declare class DOMNode {
+    readonly nodeName: string;
+    readonly nodeType: NodeType;
+    readonly childNodes: DOMNode[];
+    readonly location: Location;
+    readonly unique: DOMInternalID;
+    private cache;
     /**
-     * Returns the last child element or null if there are no child elements.
+     * Set of disabled rules for this node.
+     *
+     * Rules disabled by using directives are added here.
      */
-    get lastElementChild(): HtmlElement | null;
-    get siblings(): HtmlElement[];
-    get previousSibling(): HtmlElement | null;
-    get nextSibling(): HtmlElement | null;
-    getElementsByTagName(tagName: string): HtmlElement[];
-    querySelector(selector: string): HtmlElement;
-    querySelectorAll(selector: string): HtmlElement[];
-    private querySelectorImpl;
+    private disabledRules;
     /**
-     * Visit all nodes from this node and down. Depth first.
+     * Create a new DOMNode.
      *
-     * @internal
+     * @param nodeType - What node type to create.
+     * @param nodeName - What node name to use. For `HtmlElement` this corresponds
+     * to the tagName but other node types have specific predefined values.
+     * @param location - Source code location of this node.
      */
-    visitDepthFirst(callback: (node: HtmlElement) => void): void;
+    constructor(nodeType: NodeType, nodeName: string | undefined, location: Location);
     /**
-     * Evaluates callbackk on all descendants, returning true if any are true.
+     * Enable cache for this node.
      *
-     * @internal
+     * Should not be called before the node and all children are fully constructed.
      */
-    someChildren(callback: (node: HtmlElement) => boolean): boolean;
+    cacheEnable(): void;
     /**
-     * Evaluates callbackk on all descendants, returning true if all are true.
+     * Fetch cached value from this DOM node.
      *
-     * @internal
+     * Cache is not enabled until `cacheEnable()` is called by [[Parser]] (when
+     * the element is fully constructed).
+     *
+     * @returns value or `undefined` if the value doesn't exist.
      */
-    everyChildren(callback: (node: HtmlElement) => boolean): boolean;
+    cacheGet<K extends keyof DOMNodeCache>(key: K): DOMNodeCache[K] | undefined;
+    cacheGet(key: string | number | symbol): any | undefined;
     /**
-     * Visit all nodes from this node and down. Breadth first.
+     * Store a value in cache.
      *
-     * The first node for which the callback evaluates to true is returned.
+     * @returns the value itself is returned.
+     */
+    cacheSet<K extends keyof DOMNodeCache>(key: K, value: DOMNodeCache[K]): DOMNodeCache[K];
+    cacheSet<T>(key: string | number | symbol, value: T): T;
+    /**
+     * Remove a value by key from cache.
      *
-     * @internal
+     * @returns `true` if the entry existed and has been removed.
      */
-    find(callback: (node: HtmlElement) => boolean): HtmlElement | null;
-}
-
-declare class DOMTree {
-    readonly root: HtmlElement;
-    private active;
-    doctype: string | null;
-    constructor(location: Location);
-    pushActive(node: HtmlElement): void;
-    popActive(): void;
-    getActive(): HtmlElement;
+    cacheRemove<K extends keyof DOMNodeCache>(key: K): boolean;
+    cacheRemove(key: string | number | symbol): boolean;
     /**
-     * Resolve dynamic meta expressions.
+     * Check if key exists in cache.
      */
-    resolveMeta(table: MetaTable): void;
-    getElementsByTagName(tagName: string): HtmlElement[];
-    visitDepthFirst(callback: (node: HtmlElement) => void): void;
-    find(callback: (node: HtmlElement) => boolean): HtmlElement | null;
-    querySelector(selector: string): HtmlElement;
-    querySelectorAll(selector: string): HtmlElement[];
-}
-
-/**
- * Represents a text in the HTML document.
- *
- * Text nodes are appended as children of `HtmlElement` and cannot have childen
- * of its own.
- *
- * @public
- */
-declare class TextNode extends DOMNode {
-    private readonly text;
+    cacheExists<K extends keyof DOMNodeCache>(key: K): boolean;
+    cacheExists(key: string | number | symbol): boolean;
+    /**
+     * Get the text (recursive) from all child nodes.
+     */
+    get textContent(): string;
+    append(node: DOMNode): void;
+    isRootElement(): boolean;
+    /**
+     * Tests if two nodes are the same (references the same object).
+     */
+    isSameNode(otherNode: DOMNode): boolean;
+    /**
+     * Returns a DOMNode representing the first direct child node or `null` if the
+     * node has no children.
+     */
+    get firstChild(): DOMNode;
     /**
-     * @param text - Text to add. When a `DynamicValue` is used the expression is
-     * used as "text".
-     * @param location - Source code location of this node.
+     * Returns a DOMNode representing the last direct child node or `null` if the
+     * node has no children.
      */
-    constructor(text: string | DynamicValue, location: Location);
+    get lastChild(): DOMNode;
     /**
-     * Get the text from node.
+     * Disable a rule for this node.
      */
-    get textContent(): string;
+    disableRule(ruleId: string): void;
     /**
-     * Flag set to true if the attribute value is static.
+     * Disables multiple rules.
      */
-    get isStatic(): boolean;
+    disableRules(rules: string[]): void;
     /**
-     * Flag set to true if the attribute value is dynamic.
+     * Enable a previously disabled rule for this node.
      */
-    get isDynamic(): boolean;
-}
-
-/**
- * @public
- */
-interface TransformContext {
+    enableRule(ruleId: string): void;
     /**
-     * Test if an additional chainable transformer is present.
-     *
-     * Returns true only if there is a transformer configured for the given
-     * filename.
-     *
-     * @param filename - Filename to use to match next transformer.
+     * Enables multiple rules.
      */
-    hasChain(filename: string): boolean;
+    enableRules(rules: string[]): void;
     /**
-     * Chain transformations.
-     *
-     * Sometimes multiple transformers must be applied. For instance, a Markdown
-     * file with JSX in a code-block.
-     *
-     * @param source - Source to chain transformations on.
-     * @param filename - Filename to use to match next transformer (unrelated to
-     * filename set in source)
+     * Test if a rule is enabled for this node.
      */
-    chain(source: Source, filename: string): Iterable<Source>;
+    ruleEnabled(ruleId: string): boolean;
+    generateSelector(): string | null;
 }
 
-declare module "estree" {
-    interface TemplateElement {
-        start: number;
-        end: number;
-    }
+declare class DOMTokenList extends Array<string> {
+    readonly value: string;
+    private readonly locations;
+    constructor(value: string | DynamicValue | null, location: Location | null);
+    item(n: number): string | undefined;
+    location(n: number): Location | undefined;
+    contains(token: string): boolean;
+    iterator(): Generator<{
+        index: number;
+        item: string;
+        location: Location;
+    }>;
 }
+
 /**
  * @public
  */
-declare class TemplateExtractor {
-    private ast;
-    private filename;
-    private data;
-    private constructor();
-    static fromFilename(filename: string): TemplateExtractor;
+declare enum NodeClosed {
+    Open = 0,
+    EndTag = 1,
+    VoidOmitted = 2,
+    VoidSelfClosed = 3,
+    ImplicitClosed = 4
+}
+/**
+ * @public
+ */
+declare class HtmlElement extends DOMNode {
+    readonly tagName: string;
+    readonly parent: HtmlElement | null;
+    readonly voidElement: boolean;
+    readonly depth: number;
+    closed: NodeClosed;
+    protected readonly attr: {
+        [key: string]: Attribute[];
+    };
+    private metaElement;
+    private annotation;
+    constructor(tagName: string | undefined, parent: HtmlElement | null, closed: NodeClosed, meta: MetaElement | null, location: Location);
     /**
-     * Create a new [[TemplateExtractor]] from javascript source code.
-     *
-     * `Source` offsets will be relative to the string, i.e. offset 0 is the first
-     * character of the string. If the string is only a subset of a larger string
-     * the offsets must be adjusted manually.
+     * @internal
+     */
+    static rootNode(location: Location): HtmlElement;
+    /**
+     * @internal
      *
-     * @param source - Source code.
-     * @param filename - Optional filename to set in the resulting
-     * `Source`. Defauls to `"inline"`.
+     * @param namespace - If given it is appended to the tagName.
      */
-    static fromString(source: string, filename?: string): TemplateExtractor;
+    static fromTokens(startToken: TagOpenToken, endToken: TagCloseToken, parent: HtmlElement | null, metaTable: MetaTable | null, namespace?: string): HtmlElement;
     /**
-     * Convenience function to create a [[Source]] instance from an existing file.
+     * Returns annotated name if set or defaults to `<tagName>`.
      *
-     * @param filename - Filename with javascript source code. The file must exist
-     * and be readable by the user.
-     * @returns An array of Source's suitable for passing to [[Engine]] linting
-     * functions.
+     * E.g. `my-annotation` or `<div>`.
      */
-    static createSource(filename: string): Source[];
+    get annotatedName(): string;
     /**
-     * Extract object properties.
+     * Get list of IDs referenced by `aria-labelledby`.
      *
-     * Given a key `"template"` this method finds all objects literals with a
-     * `"template"` property and creates a [[Source]] instance with proper offsets
-     * with the value of the property. For instance:
+     * If the attribute is unset or empty this getter returns null.
+     * If the attribute is dynamic the original {@link DynamicValue} is returned.
      *
-     * ```
-     * const myObj = {
-     *   foo: 'bar',
-     * };
-     * ```
+     * @public
+     */
+    get ariaLabelledby(): string[] | DynamicValue | null;
+    /**
+     * Similar to childNodes but only elements.
+     */
+    get childElements(): HtmlElement[];
+    /**
+     * Find the first ancestor matching a selector.
      *
-     * The above snippet would yield a `Source` with the content `bar`.
+     * Implementation of DOM specification of Element.closest(selectors).
+     */
+    closest(selectors: string): HtmlElement | null;
+    /**
+     * Generate a DOM selector for this element. The returned selector will be
+     * unique inside the current document.
+     */
+    generateSelector(): string | null;
+    /**
+     * Tests if this element has given tagname.
      *
+     * If passing "*" this test will pass if any tagname is set.
      */
-    extractObjectProperty(key: string): Source[];
-}
-
-/**
- * @public
- */
-declare type Transformer = (this: TransformContext, source: Source) => Iterable<Source>;
-
-interface SchemaValidationPatch {
-    properties?: Record<string, unknown>;
-    definitions?: Record<string, unknown>;
-}
-/**
- * @public
- */
-interface Plugin {
+    is(tagName: string): boolean;
     /**
-     * Name of the plugin.
+     * Load new element metadata onto this element.
      *
-     * If specified this is the name used when referring to the plugin. Default is
-     * to use the name/path the user used when loading the plugin. To be less
-     * confusing for users you should use the same name as your package.
+     * Do note that semantics such as `void` cannot be changed (as the element has
+     * already been created). In addition the element will still "be" the same
+     * element, i.e. even if loading meta for a `<p>` tag upon a `<div>` tag it
+     * will still be a `<div>` as far as the rest of the validator is concerned.
      *
-     * The name must be a valid package name according to NPM (basically lowercase
-     * characters, must not begin with dot, slash or non-url safe characters).
+     * In fact only certain properties will be copied onto the element:
      *
-     * Hint: import and use the name from `package.json`.
+     * - content categories (flow, phrasing, etc)
+     * - required attributes
+     * - attribute allowed values
+     * - permitted/required elements
+     *
+     * Properties *not* loaded:
+     *
+     * - inherit
+     * - deprecated
+     * - foreign
+     * - void
+     * - implicitClosed
+     * - scriptSupporting
+     * - deprecatedAttributes
+     *
+     * Changes to element metadata will only be visible after `element:ready` (and
+     * the subsequent `dom:ready` event).
      */
-    name?: string | null;
+    loadMeta(meta: MetaElement): void;
     /**
-     * Initialization callback.
+     * Match this element against given selectors. Returns true if any selector
+     * matches.
      *
-     * Called once per plugin during initialization.
+     * Implementation of DOM specification of Element.matches(selectors).
      */
-    init?: () => void | null;
+    matches(selector: string): boolean;
+    get meta(): MetaElement | null;
     /**
-     * Setup callback.
-     *
-     * Called once per source after engine is initialized.
-     *
-     * @param source - The source about to be validated. Readonly.
-     * @param eventhandler - Eventhandler from parser. Can be used to listen for
-     * parser events.
+     * Set annotation for this element.
      */
-    setup?: (source: Source, eventhandler: EventHandler) => void | null;
+    setAnnotation(text: string): void;
     /**
-     * Configuration presets.
-     *
-     * Each key should be the unprefixed name which a configuration later can
-     * access using `${plugin}:${key}`, e.g. if a plugin named "my-plugin" exposes
-     * a preset named "foobar" it can be accessed using:
+     * Set attribute. Stores all attributes set even with the same name.
      *
-     * "extends": ["my-plugin:foobar"]
+     * @param key - Attribute name
+     * @param value - Attribute value. Use `null` if no value is present.
+     * @param keyLocation - Location of the attribute name.
+     * @param valueLocation - Location of the attribute value (excluding quotation)
+     * @param originalAttribute - If attribute is an alias for another attribute
+     * (dynamic attributes) set this to the original attribute name.
      */
-    configs?: Record<string, ConfigData | null> | null;
+    setAttribute(key: string, value: string | DynamicValue | null, keyLocation: Location, valueLocation: Location | null, originalAttribute?: string): void;
     /**
-     * List of new rules present.
+     * Get a list of all attributes on this node.
      */
-    rules?: Record<string, RuleConstructor<any, any> | null> | null;
+    get attributes(): Attribute[];
+    hasAttribute(key: string): boolean;
+    /**
+     * Get attribute.
+     *
+     * By default only the first attribute is returned but if the code needs to
+     * handle duplicate attributes the `all` parameter can be set to get all
+     * attributes with given key.
+     *
+     * This usually only happens when code contains duplicate attributes (which
+     * `no-dup-attr` will complain about) or when a static attribute is combined
+     * with a dynamic, consider:
+     *
+     * <p class="foo" dynamic-class="bar">
+     *
+     * @param key - Attribute name
+     * @param all - Return single or all attributes.
+     */
+    getAttribute(key: string): Attribute | null;
+    getAttribute(key: string, all: true): Attribute[];
     /**
-     * Transformer available in this plugin.
-     *
-     * Can be given either as a single unnamed transformer or an object with
-     * multiple named.
+     * Get attribute value.
      *
-     * Unnamed transformers use the plugin name similar to how a standalone
-     * transformer would work:
+     * Returns the attribute value if present.
      *
-     * ```
-     * "transform": {
-     *   "^.*\\.foo$": "my-plugin"
-     * }
-     * ```
+     * - Missing attributes return `null`.
+     * - Boolean attributes return `null`.
+     * - `DynamicValue` returns attribute expression.
      *
-     * For named transformers each key should be the unprefixed name which a
-     * configuration later can access using `${plugin}:${key}`, e.g. if a plugin
-     * named "my-plugin" exposes a transformer named "foobar" it can be accessed
-     * using:
+     * @param key - Attribute name
+     * @returns Attribute value or null.
+     */
+    getAttributeValue(key: string): string | null;
+    /**
+     * Add text as a child node to this element.
      *
-     * ```
-     * "transform": {
-     *   "^.*\\.foo$": "my-plugin:foobar"
-     * }
-     * ```
+     * @param text - Text to add.
+     * @param location - Source code location of this text.
      */
-    transformer?: Transformer | Record<string, Transformer | null> | null;
+    appendText(text: string | DynamicValue, location: Location): void;
     /**
-     * Extend metadata validation schema.
+     * Return a list of all known classes on the element. Dynamic values are
+     * ignored.
      */
-    elementSchema?: SchemaValidationPatch | null;
-}
-
-/**
- * @public
- */
-declare class MetaTable {
-    readonly elements: ElementTable;
-    private schema;
+    get classList(): DOMTokenList;
     /**
-     * @internal
+     * Get element ID if present.
      */
-    constructor();
+    get id(): string | null;
+    get style(): CSSStyleDeclaration;
     /**
-     * @internal
+     * Returns the first child element or null if there are no child elements.
      */
-    init(): void;
+    get firstElementChild(): HtmlElement | null;
     /**
-     * Extend validation schema.
-     *
-     * @internal
+     * Returns the last child element or null if there are no child elements.
      */
-    extendValidationSchema(patch: SchemaValidationPatch): void;
+    get lastElementChild(): HtmlElement | null;
+    get siblings(): HtmlElement[];
+    get previousSibling(): HtmlElement | null;
+    get nextSibling(): HtmlElement | null;
+    getElementsByTagName(tagName: string): HtmlElement[];
+    querySelector(selector: string): HtmlElement;
+    querySelectorAll(selector: string): HtmlElement[];
+    private querySelectorImpl;
     /**
-     * Load metadata table from object.
+     * Visit all nodes from this node and down. Depth first.
      *
      * @internal
-     * @param obj - Object with metadata to load
-     * @param filename - Optional filename used when presenting validation error
      */
-    loadFromObject(obj: unknown, filename?: string | null): void;
+    visitDepthFirst(callback: (node: HtmlElement) => void): void;
     /**
-     * Load metadata table from filename
+     * Evaluates callbackk on all descendants, returning true if any are true.
      *
      * @internal
-     * @param filename - Filename to load
      */
-    loadFromFile(filename: string): void;
+    someChildren(callback: (node: HtmlElement) => boolean): boolean;
     /**
-     * Get [[MetaElement]] for the given tag. If no specific metadata is present
-     * the global metadata is returned or null if no global is present.
+     * Evaluates callbackk on all descendants, returning true if all are true.
      *
-     * @public
-     * @returns A shallow copy of metadata.
+     * @internal
      */
-    getMetaFor(tagName: string): MetaElement | null;
+    everyChildren(callback: (node: HtmlElement) => boolean): boolean;
     /**
-     * Find all tags which has enabled given property.
+     * Visit all nodes from this node and down. Breadth first.
      *
-     * @public
+     * The first node for which the callback evaluates to true is returned.
+     *
+     * @internal
      */
-    getTagsWithProperty(propName: MetaLookupableProperty): string[];
+    find(callback: (node: HtmlElement) => boolean): HtmlElement | null;
+}
+
+declare class DOMTree {
+    readonly root: HtmlElement;
+    private active;
+    doctype: string | null;
+    constructor(location: Location);
+    pushActive(node: HtmlElement): void;
+    popActive(): void;
+    getActive(): HtmlElement;
     /**
-     * Find tag matching tagName or inheriting from it.
-     *
-     * @public
+     * Resolve dynamic meta expressions.
      */
-    getTagsDerivedFrom(tagName: string): string[];
-    private addEntry;
+    resolveMeta(table: MetaTable): void;
+    getElementsByTagName(tagName: string): HtmlElement[];
+    visitDepthFirst(callback: (node: HtmlElement) => void): void;
+    find(callback: (node: HtmlElement) => boolean): HtmlElement | null;
+    querySelector(selector: string): HtmlElement;
+    querySelectorAll(selector: string): HtmlElement[];
+}
+
+/**
+ * Represents a text in the HTML document.
+ *
+ * Text nodes are appended as children of `HtmlElement` and cannot have childen
+ * of its own.
+ *
+ * @public
+ */
+declare class TextNode extends DOMNode {
+    private readonly text;
     /**
-     * Construct a new AJV schema validator.
+     * @param text - Text to add. When a `DynamicValue` is used the expression is
+     * used as "text".
+     * @param location - Source code location of this node.
      */
-    private getSchemaValidator;
+    constructor(text: string | DynamicValue, location: Location);
     /**
-     * @public
+     * Get the text from node.
      */
-    getJSONSchema(): SchemaObject;
+    get textContent(): string;
     /**
-     * Finds the global element definition and merges each known element with the
-     * global, e.g. to assign global attributes.
+     * Flag set to true if the attribute value is static.
      */
-    private resolveGlobal;
-    private mergeElement;
+    get isStatic(): boolean;
     /**
-     * @internal
+     * Flag set to true if the attribute value is dynamic.
      */
-    resolve(node: HtmlElement): void;
+    get isDynamic(): boolean;
+}
+
+interface PermittedGroup {
+    exclude?: string | string[];
+}
+declare type CategoryOrTag = string;
+declare type PropertyExpression = string | [string, any];
+declare type PermittedEntry = CategoryOrTag | PermittedGroup | Array<CategoryOrTag | PermittedGroup>;
+declare type Permitted = PermittedEntry[];
+declare type PermittedOrder = string[];
+declare type RequiredAncestors = string[];
+declare type RequiredContent = string[];
+declare enum TextContent {
+    NONE = "none",
+    DEFAULT = "default",
+    REQUIRED = "required",
+    ACCESSIBLE = "accessible"
+}
+/**
+ * Callback for the `allowed` property of `MetaAttribute`. It takes a node and
+ * should return `null` if there is no errors and a string with an error
+ * description if there is an error.
+ *
+ * @public
+ */
+declare type MetaAttributeAllowedCallback = (node: HtmlElement) => string | null | undefined;
+/**
+ * @public
+ */
+interface MetaAttribute {
+    allowed?: MetaAttributeAllowedCallback;
+    boolean?: boolean;
+    deprecated?: boolean | string;
+    enum?: Array<string | RegExp>;
+    list?: boolean;
+    omit?: boolean;
+    required?: boolean;
+}
+declare type PermittedAttribute = Record<string, MetaAttribute | Array<string | RegExp> | null>;
+interface DeprecatedElement {
+    message?: string;
+    documentation?: string;
+    source?: string;
+}
+/**
+ * @public
+ */
+interface MetaData {
+    inherit?: string;
+    metadata?: boolean | PropertyExpression;
+    flow?: boolean | PropertyExpression;
+    sectioning?: boolean | PropertyExpression;
+    heading?: boolean | PropertyExpression;
+    phrasing?: boolean | PropertyExpression;
+    embedded?: boolean | PropertyExpression;
+    interactive?: boolean | PropertyExpression;
+    deprecated?: boolean | string | DeprecatedElement;
+    foreign?: boolean;
+    void?: boolean;
+    transparent?: boolean | string[];
+    implicitClosed?: string[];
+    scriptSupporting?: boolean;
+    form?: boolean;
+    labelable?: boolean | PropertyExpression;
+    deprecatedAttributes?: string[];
+    requiredAttributes?: string[];
+    attributes?: PermittedAttribute;
+    permittedContent?: Permitted;
+    permittedDescendants?: Permitted;
+    permittedOrder?: PermittedOrder;
+    permittedParent?: Permitted;
+    requiredAncestors?: RequiredAncestors;
+    requiredContent?: RequiredContent;
+    textContent?: TextContent | `${TextContent}`;
+}
+/**
+ * Properties listed here can be used to reverse search elements with the given
+ * property enabled. See [[MetaTable.getTagsWithProperty]].
+ */
+declare type MetaLookupableProperty = "metadata" | "flow" | "sectioning" | "heading" | "phrasing" | "embedded" | "interactive" | "deprecated" | "foreign" | "void" | "transparent" | "scriptSupporting" | "form" | "labelable";
+/**
+ * Properties listed here can be copied (loaded) onto another element using
+ * [[HtmlElement.loadMeta]].
+ *
+ * @public
+ */
+declare const MetaCopyableProperty: Array<keyof MetaElement>;
+/**
+ * @public
+ */
+interface MetaElement extends Omit<MetaData, "deprecatedAttributes" | "requiredAttributes"> {
+    tagName: string;
+    attributes: Record<string, MetaAttribute>;
+    textContent?: TextContent;
 }
+interface MetaDataTable {
+    [tagName: string]: MetaData;
+}
+interface ElementTable {
+    [tagName: string]: MetaElement;
+}
+
+/**
+ * Helper function to assist IDE with completion and type-checking.
+ *
+ * @public
+ */
+declare function defineMetadata(metatable: MetaDataTable): MetaDataTable;
+
+/**
+ * Helpers when writing element metadata.
+ *
+ * @public
+ */
+interface MetadataHelper {
+    /** Returns an error if another attribute is omitted, i.e. it requires another attribute to be present to pass. */
+    allowedIfAttributeIsPresent(...attr: string[]): MetaAttributeAllowedCallback;
+    /** Returns an error if another attribute is present, i.e. it requires another attribute to be omitted to pass. */
+    allowedIfAttributeIsAbsent(...attr: string[]): MetaAttributeAllowedCallback;
+    /** Returns an error if another attribute does not have one of the listed values */
+    allowedIfAttributeHasValue(attr: string, value: string[], options?: {
+        defaultValue?: string | null;
+    }): MetaAttributeAllowedCallback;
+}
+declare const metadataHelper: MetadataHelper;
 
 /**
  * @public
@@ -2396,4 +2430,4 @@ declare type Formatter = (results: Result[]) => string;
  */
 declare function getFormatter(name: string): Formatter | null;
 
-export { TagCloseEvent as $, AttributeData as A, TemplateExtractor as B, Config as C, DynamicValue as D, EventDump as E, Plugin as F, Parser as G, HtmlValidate as H, ruleExists as I, EventHandler as J, EventCallback as K, Location as L, MetaData as M, NodeClosed as N, Event as O, ProcessElementContext as P, ConfigReadyEvent as Q, Rule as R, Severity as S, TextNode as T, UserError as U, SourceReadyEvent as V, WrappedError as W, TokenEvent as X, TagStartEvent as Y, TagOpenEvent as Z, TagEndEvent as _, ConfigData as a, TagReadyEvent as a0, ElementReadyEvent as a1, AttributeEvent as a2, WhitespaceEvent as a3, ConditionalEvent as a4, DirectiveEvent as a5, DoctypeEvent as a6, DOMLoadEvent as a7, DOMReadyEvent as a8, TriggerEventMap as a9, ListenEventMap as aa, FileSystemConfigLoader as ab, Formatter as ac, getFormatter as ad, compatibilityCheck as ae, CompatibilityOptions as af, ConfigError as b, ConfigLoader as c, StaticConfigLoader as d, HtmlElement as e, CSSStyleDeclaration as f, TokenDump as g, SchemaValidationError as h, NestedError as i, MetaDataTable as j, MetaElement as k, MetaTable as l, MetaCopyableProperty as m, RuleDocumentation as n, classifyNodeText as o, presets as p, TextClassification as q, Source as r, Report as s, Reporter as t, Message as u, version as v, Result as w, DeferredMessage as x, TransformContext as y, Transformer as z };
+export { TokenEvent as $, AttributeData as A, Result as B, Config as C, DynamicValue as D, EventDump as E, DeferredMessage as F, TransformContext as G, HtmlValidate as H, Transformer as I, TemplateExtractor as J, Plugin as K, Location as L, MetaData as M, NodeClosed as N, Parser as O, ProcessElementContext as P, ruleExists as Q, Rule as R, Severity as S, TextNode as T, UserError as U, EventHandler as V, WrappedError as W, EventCallback as X, Event as Y, ConfigReadyEvent as Z, SourceReadyEvent as _, ConfigData as a, TagStartEvent as a0, TagOpenEvent as a1, TagEndEvent as a2, TagCloseEvent as a3, TagReadyEvent as a4, ElementReadyEvent as a5, AttributeEvent as a6, WhitespaceEvent as a7, ConditionalEvent as a8, DirectiveEvent as a9, DoctypeEvent as aa, DOMLoadEvent as ab, DOMReadyEvent as ac, TriggerEventMap as ad, ListenEventMap as ae, FileSystemConfigLoader as af, Formatter as ag, getFormatter as ah, compatibilityCheck as ai, CompatibilityOptions as aj, ConfigError as b, ConfigLoader as c, StaticConfigLoader as d, HtmlElement as e, CSSStyleDeclaration as f, TokenDump as g, SchemaValidationError as h, NestedError as i, MetaDataTable as j, MetaElement as k, MetaAttribute as l, MetaAttributeAllowedCallback as m, MetaTable as n, MetaCopyableProperty as o, presets as p, defineMetadata as q, metadataHelper as r, RuleDocumentation as s, classifyNodeText as t, TextClassification as u, version as v, Source as w, Report as x, Reporter as y, Message as z };