html-validate 7.15.0 → 7.15.1

package/dist/es/test-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-utils.js","sources":["../../../src/transform/test-utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAqDA;;;;;;;AAOG;SACa,aAAa,CAC5B,EAAe,EACf,QAAgB,EAChB,KAA8D,EAAA;IAE9D,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAChD,IAAA,MAAM,MAAM,GAAW;QACtB,QAAQ;AACR,QAAA,IAAI,EAAE,CAAC;AACP,QAAA,MAAM,EAAE,CAAC;AACT,QAAA,MAAM,EAAE,CAAC;QACT,IAAI;KACJ,CAAC;IACF,OAAO,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;AAOG;SACa,eAAe,CAC9B,EAAe,EACf,IAAY,EACZ,KAA8D,EAAA;AAE9D,IAAA,MAAM,MAAM,GAAW;AACtB,QAAA,QAAQ,EAAE,QAAQ;AAClB,QAAA,IAAI,EAAE,CAAC;AACP,QAAA,MAAM,EAAE,CAAC;AACT,QAAA,MAAM,EAAE,CAAC;QACT,IAAI;KACJ,CAAC;IACF,OAAO,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;AAOG;SACa,eAAe,CAC9B,EAAe,EACf,MAAc,EACd,KAA8D,EAAA;IAE9D,MAAM,YAAY,GAAG,CAAC,MAAc,KAAuB,CAAC,MAAM,CAAC,CAAC;AACpE,IAAA,MAAM,OAAO,GAAqB;AACjC,QAAA,QAAQ,6BAA6B,MAAM,IAAI;QAC/C,KAAK,EAAE,KAAK,IAAI,YAAY;KAC5B,CAAC;AACF,IAAA,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAC7C;;;;"}
+{"version":3,"file":"test-utils.js","sources":["../../../src/transform/test-utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAQA;;;;;;;AAOG;SACa,aAAa,CAC5B,EAAe,EACf,QAAgB,EAChB,KAA8D,EAAA;IAE9D,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAChD,IAAA,MAAM,MAAM,GAAW;QACtB,QAAQ;AACR,QAAA,IAAI,EAAE,CAAC;AACP,QAAA,MAAM,EAAE,CAAC;AACT,QAAA,MAAM,EAAE,CAAC;QACT,IAAI;KACJ,CAAC;IACF,OAAO,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;AAOG;SACa,eAAe,CAC9B,EAAe,EACf,IAAY,EACZ,KAA8D,EAAA;AAE9D,IAAA,MAAM,MAAM,GAAW;AACtB,QAAA,QAAQ,EAAE,QAAQ;AAClB,QAAA,IAAI,EAAE,CAAC;AACP,QAAA,MAAM,EAAE,CAAC;AACT,QAAA,MAAM,EAAE,CAAC;QACT,IAAI;KACJ,CAAC;IACF,OAAO,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;AAOG;SACa,eAAe,CAC9B,EAAe,EACf,MAAc,EACd,KAA8D,EAAA;IAE9D,MAAM,YAAY,GAAG,CAAC,MAAc,KAAuB,CAAC,MAAM,CAAC,CAAC;AACpE,IAAA,MAAM,OAAO,GAAqB;AACjC,QAAA,QAAQ,6BAA6B,MAAM,IAAI;QAC/C,KAAK,EAAE,KAAK,IAAI,YAAY;KAC5B,CAAC;AACF,IAAA,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAC7C;;;;"}

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.34.4"
+    }
+  ]
+}

package/dist/types/browser.d.ts

@@ -206,7 +206,15 @@ export declare class Config {
     private loadPlugins;
     private loadConfigurations;
     private extendMeta;
-    /* Excluded from this release type: resolve */
+    /**
+     * Resolve all configuration and return a [[ResolvedConfig]] instance.
+     *
+     * A resolved configuration will merge all extended configs and load all
+     * plugins and transformers, and normalize the rest of the configuration.
+     *
+     * @public
+     */
+    resolve(): ResolvedConfig;
     /* Excluded from this release type: resolveData */
     private precompileTransformers;
     /**
@@ -523,6 +531,8 @@ export declare class DOMNode {
     isRootElement(): boolean;
     /**
      * Tests if two nodes are the same (references the same object).
+     *
+     * @since v4.11.0
      */
     isSameNode(otherNode: DOMNode): boolean;
     /**
@@ -1274,9 +1284,27 @@ export declare class MetaTable {
     private schema;
     /* Excluded from this release type: __constructor */
     /* Excluded from this release type: init */
-    /* Excluded from this release type: extendValidationSchema */
-    /* Excluded from this release type: loadFromObject */
-    /* Excluded from this release type: loadFromFile */
+    /**
+     * Extend validation schema.
+     *
+     * @public
+     */
+    extendValidationSchema(patch: SchemaValidationPatch): void;
+    /**
+     * Load metadata table from object.
+     *
+     * @public
+     * @param obj - Object with metadata to load
+     * @param filename - Optional filename used when presenting validation error
+     */
+    loadFromObject(obj: unknown, filename?: string | null): void;
+    /**
+     * Load metadata table from filename
+     *
+     * @public
+     * @param filename - Filename to load
+     */
+    loadFromFile(filename: string): void;
     /**
      * Get [[MetaElement]] for the given tag. If no specific metadata is present
      * the global metadata is returned or null if no global is present.
@@ -1346,7 +1374,102 @@ export declare enum NodeType {
 
 /* Excluded from this release type: ParseEndEvent */
 
-/* Excluded from this release type: Parser */
+/**
+ * Parse HTML document into a DOM tree.
+ *
+ * @public
+ */
+export declare class Parser {
+    private readonly event;
+    private readonly metaTable;
+    private currentNamespace;
+    private dom;
+    /**
+     * Create a new parser instance.
+     *
+     * @public
+     * @param config - Configuration
+     */
+    constructor(config: ResolvedConfig);
+    /**
+     * Parse HTML markup.
+     *
+     * @public
+     * @param source - HTML markup.
+     * @returns DOM tree representing the HTML markup.
+     */
+    parseHtml(source: string | Source): HtmlElement;
+    /**
+     * Detect optional end tag.
+     *
+     * Some tags have optional end tags (e.g. <ul><li>foo<li>bar</ul> is
+     * valid). The parser handles this by checking if the element on top of the
+     * stack when is allowed to omit.
+     */
+    private closeOptional;
+    /* Excluded from this release type: consume */
+    /* Excluded from this release type: consumeTag */
+    /* Excluded from this release type: closeElement */
+    private processElement;
+    /* Excluded from this release type: discardForeignBody */
+    /* Excluded from this release type: consumeAttribute */
+    /**
+     * Takes attribute key token an returns location.
+     */
+    private getAttributeKeyLocation;
+    /**
+     * Take attribute value token and return a new location referring to only the
+     * value.
+     *
+     * foo="bar"    foo='bar'    foo=bar    foo      foo=""
+     *      ^^^          ^^^         ^^^    (null)   (null)
+     */
+    private getAttributeValueLocation;
+    /**
+     * Take attribute key and value token an returns a new location referring to
+     * an aggregate location covering key, quotes if present and value.
+     */
+    private getAttributeLocation;
+    /* Excluded from this release type: consumeDirective */
+    /* Excluded from this release type: consumeConditional */
+    /* Excluded from this release type: consumeComment */
+    /* Excluded from this release type: consumeDoctype */
+    /* Excluded from this release type: consumeUntil */
+    /* Excluded from this release type: consumeUntilMatchingTag */
+    private next;
+    /**
+     * Listen on events.
+     *
+     * @public
+     * @param event - Event name.
+     * @param listener - Event callback.
+     * @returns A function to unregister the listener.
+     */
+    on<K extends keyof ListenEventMap>(event: K, listener: (event: string, data: ListenEventMap[K]) => void): () => void;
+    on(event: string, listener: EventCallback): () => void;
+    /**
+     * Listen on single event. The listener is automatically unregistered once the
+     * event has been received.
+     *
+     * @public
+     * @param event - Event name.
+     * @param listener - Event callback.
+     * @returns A function to unregister the listener.
+     */
+    once<K extends keyof ListenEventMap>(event: K, listener: (event: string, data: ListenEventMap[K]) => void): () => void;
+    once(event: string, listener: EventCallback): () => void;
+    /* Excluded from this release type: defer */
+    /* Excluded from this release type: trigger */
+    /* Excluded from this release type: getEventHandler */
+    /**
+     * Appends a text node to the current element on the stack.
+     */
+    private appendText;
+    /**
+     * Trigger close events for any still open elements.
+     */
+    private closeTree;
+}
 
 /**
  * @public

package/dist/types/index.d.ts

@@ -301,7 +301,15 @@ export declare class Config {
     private loadPlugins;
     private loadConfigurations;
     private extendMeta;
-    /* Excluded from this release type: resolve */
+    /**
+     * Resolve all configuration and return a [[ResolvedConfig]] instance.
+     *
+     * A resolved configuration will merge all extended configs and load all
+     * plugins and transformers, and normalize the rest of the configuration.
+     *
+     * @public
+     */
+    resolve(): ResolvedConfig;
     /* Excluded from this release type: resolveData */
     private precompileTransformers;
     /**
@@ -618,6 +626,8 @@ export declare class DOMNode {
     isRootElement(): boolean;
     /**
      * Tests if two nodes are the same (references the same object).
+     *
+     * @since v4.11.0
      */
     isSameNode(otherNode: DOMNode): boolean;
     /**
@@ -1467,9 +1477,27 @@ export declare class MetaTable {
     private schema;
     /* Excluded from this release type: __constructor */
     /* Excluded from this release type: init */
-    /* Excluded from this release type: extendValidationSchema */
-    /* Excluded from this release type: loadFromObject */
-    /* Excluded from this release type: loadFromFile */
+    /**
+     * Extend validation schema.
+     *
+     * @public
+     */
+    extendValidationSchema(patch: SchemaValidationPatch): void;
+    /**
+     * Load metadata table from object.
+     *
+     * @public
+     * @param obj - Object with metadata to load
+     * @param filename - Optional filename used when presenting validation error
+     */
+    loadFromObject(obj: unknown, filename?: string | null): void;
+    /**
+     * Load metadata table from filename
+     *
+     * @public
+     * @param filename - Filename to load
+     */
+    loadFromFile(filename: string): void;
     /**
      * Get [[MetaElement]] for the given tag. If no specific metadata is present
      * the global metadata is returned or null if no global is present.
@@ -1539,7 +1567,102 @@ export declare enum NodeType {
 
 /* Excluded from this release type: ParseEndEvent */
 
-/* Excluded from this release type: Parser */
+/**
+ * Parse HTML document into a DOM tree.
+ *
+ * @public
+ */
+export declare class Parser {
+    private readonly event;
+    private readonly metaTable;
+    private currentNamespace;
+    private dom;
+    /**
+     * Create a new parser instance.
+     *
+     * @public
+     * @param config - Configuration
+     */
+    constructor(config: ResolvedConfig);
+    /**
+     * Parse HTML markup.
+     *
+     * @public
+     * @param source - HTML markup.
+     * @returns DOM tree representing the HTML markup.
+     */
+    parseHtml(source: string | Source): HtmlElement;
+    /**
+     * Detect optional end tag.
+     *
+     * Some tags have optional end tags (e.g. <ul><li>foo<li>bar</ul> is
+     * valid). The parser handles this by checking if the element on top of the
+     * stack when is allowed to omit.
+     */
+    private closeOptional;
+    /* Excluded from this release type: consume */
+    /* Excluded from this release type: consumeTag */
+    /* Excluded from this release type: closeElement */
+    private processElement;
+    /* Excluded from this release type: discardForeignBody */
+    /* Excluded from this release type: consumeAttribute */
+    /**
+     * Takes attribute key token an returns location.
+     */
+    private getAttributeKeyLocation;
+    /**
+     * Take attribute value token and return a new location referring to only the
+     * value.
+     *
+     * foo="bar"    foo='bar'    foo=bar    foo      foo=""
+     *      ^^^          ^^^         ^^^    (null)   (null)
+     */
+    private getAttributeValueLocation;
+    /**
+     * Take attribute key and value token an returns a new location referring to
+     * an aggregate location covering key, quotes if present and value.
+     */
+    private getAttributeLocation;
+    /* Excluded from this release type: consumeDirective */
+    /* Excluded from this release type: consumeConditional */
+    /* Excluded from this release type: consumeComment */
+    /* Excluded from this release type: consumeDoctype */
+    /* Excluded from this release type: consumeUntil */
+    /* Excluded from this release type: consumeUntilMatchingTag */
+    private next;
+    /**
+     * Listen on events.
+     *
+     * @public
+     * @param event - Event name.
+     * @param listener - Event callback.
+     * @returns A function to unregister the listener.
+     */
+    on<K extends keyof ListenEventMap>(event: K, listener: (event: string, data: ListenEventMap[K]) => void): () => void;
+    on(event: string, listener: EventCallback): () => void;
+    /**
+     * Listen on single event. The listener is automatically unregistered once the
+     * event has been received.
+     *
+     * @public
+     * @param event - Event name.
+     * @param listener - Event callback.
+     * @returns A function to unregister the listener.
+     */
+    once<K extends keyof ListenEventMap>(event: K, listener: (event: string, data: ListenEventMap[K]) => void): () => void;
+    once(event: string, listener: EventCallback): () => void;
+    /* Excluded from this release type: defer */
+    /* Excluded from this release type: trigger */
+    /* Excluded from this release type: getEventHandler */
+    /**
+     * Appends a text node to the current element on the stack.
+     */
+    private appendText;
+    /**
+     * Trigger close events for any still open elements.
+     */
+    private closeTree;
+}
 
 /**
  * @public