html-validate 9.0.0-rc.7 → 9.0.0

package/dist/es/test-utils.js

@@ -1,5 +1,8 @@
 import fs from 'fs';
 
+function isIterable(value) {
+  return Symbol.iterator in value;
+}
 function transformFile(fn, filename, chain) {
   const data = fs.readFileSync(filename, "utf-8");
   const source = {
@@ -31,7 +34,11 @@ async function transformSource(fn, source, chain) {
     chain: chain ?? defaultChain
   };
   const result = await fn.call(context, source);
-  return Array.from(result);
+  if (isIterable(result)) {
+    return await Promise.all(Array.from(result));
+  } else {
+    return [result];
+  }
 }
 
 export { transformFile, transformSource, transformString };

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

@@ -1 +1 @@
-{"version":3,"file":"test-utils.js","sources":["../../src/transform/test-utils.ts"],"sourcesContent":["import fs from \"fs\";\nimport { type Source, type TransformContext } from \"html-validate\";\n\n/**\n * @public\n */\nexport type Transformer = (\n\tthis: TransformContext,\n\tsource: Source,\n) => Iterable<Source> | Promise<Iterable<Source>>;\n\n/**\n * Helper function to call a transformer function in test-cases.\n *\n * @public\n * @param fn - Transformer function to call.\n * @param filename - Filename to read data from. Must be readable.\n * @param chain - If set this function is called when chaining transformers. Default is pass-thru.\n */\nexport function transformFile(\n\tfn: Transformer,\n\tfilename: string,\n\tchain?: (source: Source, filename: string) => Iterable<Source> | Promise<Iterable<Source>>,\n): Promise<Source[]> {\n\tconst data = fs.readFileSync(filename, \"utf-8\");\n\tconst source: Source = {\n\t\tfilename,\n\t\tline: 1,\n\t\tcolumn: 1,\n\t\toffset: 0,\n\t\tdata,\n\t};\n\treturn transformSource(fn, source, chain);\n}\n\n/**\n * Helper function to call a transformer function in test-cases.\n *\n * @public\n * @param fn - Transformer function to call.\n * @param data - String to transform.\n * @param chain - If set this function is called when chaining transformers. Default is pass-thru.\n */\nexport function transformString(\n\tfn: Transformer,\n\tdata: string,\n\tchain?: (source: Source, filename: string) => Iterable<Source> | Promise<Iterable<Source>>,\n): Promise<Source[]> {\n\tconst source: Source = {\n\t\tfilename: \"inline\",\n\t\tline: 1,\n\t\tcolumn: 1,\n\t\toffset: 0,\n\t\tdata,\n\t};\n\treturn transformSource(fn, source, chain);\n}\n\n/**\n * Helper function to call a transformer function in test-cases.\n *\n * @public\n * @param fn - Transformer function to call.\n * @param data - Source to transform.\n * @param chain - If set this function is called when chaining transformers. Default is pass-thru.\n */\nexport async function transformSource(\n\tfn: Transformer,\n\tsource: Source,\n\tchain?: (source: Source, filename: string) => Iterable<Source> | Promise<Iterable<Source>>,\n): Promise<Source[]> {\n\tconst defaultChain = (source: Source): Iterable<Source> => [source];\n\tconst context: TransformContext = {\n\t\thasChain: /* istanbul ignore next */ () => true,\n\t\tchain: chain ?? defaultChain,\n\t};\n\tconst result = await fn.call(context, source);\n\treturn Array.from(result);\n}\n"],"names":["source"],"mappings":";;AAmBgB,SAAA,aAAA,CACf,EACA,EAAA,QAAA,EACA,KACoB,EAAA;AACpB,EAAA,MAAM,IAAO,GAAA,EAAA,CAAG,YAAa,CAAA,QAAA,EAAU,OAAO,CAAA;AAC9C,EAAA,MAAM,MAAiB,GAAA;AAAA,IACtB,QAAA;AAAA,IACA,IAAM,EAAA,CAAA;AAAA,IACN,MAAQ,EAAA,CAAA;AAAA,IACR,MAAQ,EAAA,CAAA;AAAA,IACR;AAAA,GACD;AACA,EAAO,OAAA,eAAA,CAAgB,EAAI,EAAA,MAAA,EAAQ,KAAK,CAAA;AACzC;AAUgB,SAAA,eAAA,CACf,EACA,EAAA,IAAA,EACA,KACoB,EAAA;AACpB,EAAA,MAAM,MAAiB,GAAA;AAAA,IACtB,QAAU,EAAA,QAAA;AAAA,IACV,IAAM,EAAA,CAAA;AAAA,IACN,MAAQ,EAAA,CAAA;AAAA,IACR,MAAQ,EAAA,CAAA;AAAA,IACR;AAAA,GACD;AACA,EAAO,OAAA,eAAA,CAAgB,EAAI,EAAA,MAAA,EAAQ,KAAK,CAAA;AACzC;AAUsB,eAAA,eAAA,CACrB,EACA,EAAA,MAAA,EACA,KACoB,EAAA;AACpB,EAAA,MAAM,YAAe,GAAA,CAACA,OAAqC,KAAA,CAACA,OAAM,CAAA;AAClE,EAAA,MAAM,OAA4B,GAAA;AAAA,IACjC,QAAA;AAAA;AAAA,MAAqC,MAAM;AAAA,KAAA;AAAA,IAC3C,OAAO,KAAS,IAAA;AAAA,GACjB;AACA,EAAA,MAAM,MAAS,GAAA,MAAM,EAAG,CAAA,IAAA,CAAK,SAAS,MAAM,CAAA;AAC5C,EAAO,OAAA,KAAA,CAAM,KAAK,MAAM,CAAA;AACzB;;;;"}
+{"version":3,"file":"test-utils.js","sources":["../../src/transform/test-utils.ts"],"sourcesContent":["import fs from \"fs\";\nimport {\n\ttype Source,\n\ttype TransformContext,\n\ttype Transformer,\n\ttype TransformerChainedResult,\n} from \"html-validate\";\n\n/* eslint-disable-next-line import/no-extraneous-dependencies -- this is the package itself */\nexport {\n\ttype Source,\n\ttype Transformer,\n\ttype TransformerResult,\n\ttype TransformerChainedResult,\n} from \"html-validate\";\n\nfunction isIterable(\n\tvalue: Source | Iterable<Source | Promise<Source>>,\n): value is Iterable<Source | Promise<Source>> {\n\treturn Symbol.iterator in value;\n}\n\n/**\n * Helper function to call a transformer function in test-cases.\n *\n * @public\n * @param fn - Transformer function to call.\n * @param filename - Filename to read data from. Must be readable.\n * @param chain - If set this function is called when chaining transformers. Default is pass-thru.\n */\nexport function transformFile(\n\tfn: Transformer,\n\tfilename: string,\n\tchain?: (source: Source, filename: string) => TransformerChainedResult,\n): Promise<Source[]> {\n\tconst data = fs.readFileSync(filename, \"utf-8\");\n\tconst source: Source = {\n\t\tfilename,\n\t\tline: 1,\n\t\tcolumn: 1,\n\t\toffset: 0,\n\t\tdata,\n\t};\n\treturn transformSource(fn, source, chain);\n}\n\n/**\n * Helper function to call a transformer function in test-cases.\n *\n * @public\n * @param fn - Transformer function to call.\n * @param data - String to transform.\n * @param chain - If set this function is called when chaining transformers. Default is pass-thru.\n */\nexport function transformString(\n\tfn: Transformer,\n\tdata: string,\n\tchain?: (source: Source, filename: string) => TransformerChainedResult,\n): Promise<Source[]> {\n\tconst source: Source = {\n\t\tfilename: \"inline\",\n\t\tline: 1,\n\t\tcolumn: 1,\n\t\toffset: 0,\n\t\tdata,\n\t};\n\treturn transformSource(fn, source, chain);\n}\n\n/**\n * Helper function to call a transformer function in test-cases.\n *\n * @public\n * @param fn - Transformer function to call.\n * @param data - Source to transform.\n * @param chain - If set this function is called when chaining transformers. Default is pass-thru.\n */\nexport async function transformSource(\n\tfn: Transformer,\n\tsource: Source,\n\tchain?: (source: Source, filename: string) => TransformerChainedResult,\n): Promise<Source[]> {\n\tconst defaultChain = (source: Source): Iterable<Source> => [source];\n\tconst context: TransformContext = {\n\t\thasChain: /* istanbul ignore next */ () => true,\n\t\tchain: chain ?? defaultChain,\n\t};\n\tconst result = await fn.call(context, source);\n\tif (isIterable(result)) {\n\t\treturn await Promise.all(Array.from(result));\n\t} else {\n\t\treturn [result];\n\t}\n}\n"],"names":["source"],"mappings":";;AAgBA,SAAS,WACR,KAC8C,EAAA;AAC9C,EAAA,OAAO,OAAO,QAAY,IAAA,KAAA;AAC3B;AAUgB,SAAA,aAAA,CACf,EACA,EAAA,QAAA,EACA,KACoB,EAAA;AACpB,EAAA,MAAM,IAAO,GAAA,EAAA,CAAG,YAAa,CAAA,QAAA,EAAU,OAAO,CAAA;AAC9C,EAAA,MAAM,MAAiB,GAAA;AAAA,IACtB,QAAA;AAAA,IACA,IAAM,EAAA,CAAA;AAAA,IACN,MAAQ,EAAA,CAAA;AAAA,IACR,MAAQ,EAAA,CAAA;AAAA,IACR;AAAA,GACD;AACA,EAAO,OAAA,eAAA,CAAgB,EAAI,EAAA,MAAA,EAAQ,KAAK,CAAA;AACzC;AAUgB,SAAA,eAAA,CACf,EACA,EAAA,IAAA,EACA,KACoB,EAAA;AACpB,EAAA,MAAM,MAAiB,GAAA;AAAA,IACtB,QAAU,EAAA,QAAA;AAAA,IACV,IAAM,EAAA,CAAA;AAAA,IACN,MAAQ,EAAA,CAAA;AAAA,IACR,MAAQ,EAAA,CAAA;AAAA,IACR;AAAA,GACD;AACA,EAAO,OAAA,eAAA,CAAgB,EAAI,EAAA,MAAA,EAAQ,KAAK,CAAA;AACzC;AAUsB,eAAA,eAAA,CACrB,EACA,EAAA,MAAA,EACA,KACoB,EAAA;AACpB,EAAA,MAAM,YAAe,GAAA,CAACA,OAAqC,KAAA,CAACA,OAAM,CAAA;AAClE,EAAA,MAAM,OAA4B,GAAA;AAAA,IACjC,QAAA;AAAA;AAAA,MAAqC,MAAM;AAAA,KAAA;AAAA,IAC3C,OAAO,KAAS,IAAA;AAAA,GACjB;AACA,EAAA,MAAM,MAAS,GAAA,MAAM,EAAG,CAAA,IAAA,CAAK,SAAS,MAAM,CAAA;AAC5C,EAAI,IAAA,UAAA,CAAW,MAAM,CAAG,EAAA;AACvB,IAAA,OAAO,MAAM,OAAQ,CAAA,GAAA,CAAI,KAAM,CAAA,IAAA,CAAK,MAAM,CAAC,CAAA;AAAA,GACrC,MAAA;AACN,IAAA,OAAO,CAAC,MAAM,CAAA;AAAA;AAEhB;;;;"}

package/dist/schema/config.json

@@ -50,10 +50,10 @@
     "transform": {
       "type": "object",
       "additionalProperties": {
-        "type": "string"
+        "anyOf": [{ "type": "string" }, { "function": true }]
       },
       "title": "File transformations to use.",
-      "description": "Object where key is regular expression to match filename and value is name of transformer.",
+      "description": "Object where key is regular expression to match filename and value is name of transformer or a function.",
       "examples": [
         {
           "^.*\\.foo$": "my-transformer",

package/dist/schema/elements.json

@@ -127,7 +127,7 @@
         "labelable": {
           "title": "Mark this element as labelable",
           "description": "This element may contain an associated label element.",
-          "anyOf": [{ "type": "boolean" }, { "$ref": "#/definitions/expression" }]
+          "anyOf": [{ "type": "boolean" }, { "function": true }]
         },
 
         "deprecatedAttributes": {
@@ -207,40 +207,7 @@
     },
 
     "contentCategory": {
-      "anyOf": [{ "type": "boolean" }, { "$ref": "#/definitions/expression" }, { "function": true }]
-    },
-
-    "expression": {
-      "type": "array",
-      "minItems": 2,
-      "maxItems": 2,
-      "items": [
-        {
-          "type": "string",
-          "enum": ["isDescendant", "hasAttribute", "matchAttribute"]
-        },
-        {
-          "anyOf": [{ "type": "string" }, { "$ref": "#/definitions/operation" }]
-        }
-      ]
-    },
-
-    "operation": {
-      "type": "array",
-      "minItems": 3,
-      "maxItems": 3,
-      "items": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "string",
-          "enum": ["!=", "="]
-        },
-        {
-          "type": "string"
-        }
-      ]
+      "anyOf": [{ "type": "boolean" }, { "function": true }]
     },
 
     "deprecatedElement": {

package/dist/types/browser.d.ts

@@ -694,7 +694,7 @@ export declare interface ErrorDescriptor<ContextType> {
  * ESM resolver.
  *
  * @public
- * @since 9.0.0-rc.4
+ * @since 9.0.0
  */
 export declare type ESMResolver = Required<Resolver>;
 
@@ -702,7 +702,7 @@ export declare type ESMResolver = Required<Resolver>;
  * Create a new resolver for  using `import(..)`.
  *
  * @public
- * @since 9.0.0-rc.5
+ * @since 9.0.0
  */
 export declare function esmResolver(): ESMResolver;
 
@@ -1539,13 +1539,13 @@ export declare const MetaCopyableProperty: Array<keyof MetaElement>;
  */
 export declare interface MetaData {
     inherit?: string;
-    metadata?: boolean | PropertyExpression | MetaCategoryCallback;
-    flow?: boolean | PropertyExpression | MetaCategoryCallback;
-    sectioning?: boolean | PropertyExpression | MetaCategoryCallback;
-    heading?: boolean | PropertyExpression | MetaCategoryCallback;
-    phrasing?: boolean | PropertyExpression | MetaCategoryCallback;
-    embedded?: boolean | PropertyExpression | MetaCategoryCallback;
-    interactive?: boolean | PropertyExpression | MetaCategoryCallback;
+    metadata?: boolean | MetaCategoryCallback;
+    flow?: boolean | MetaCategoryCallback;
+    sectioning?: boolean | MetaCategoryCallback;
+    heading?: boolean | MetaCategoryCallback;
+    phrasing?: boolean | MetaCategoryCallback;
+    embedded?: boolean | MetaCategoryCallback;
+    interactive?: boolean | MetaCategoryCallback;
     deprecated?: boolean | string | DeprecatedElement;
     foreign?: boolean;
     void?: boolean;
@@ -1557,7 +1557,7 @@ export declare interface MetaData {
     form?: boolean;
     /** Mark element as a form-associated element */
     formAssociated?: Partial<FormAssociated>;
-    labelable?: boolean | PropertyExpression;
+    labelable?: boolean | MetaLabelableCallback;
     /** @deprecated use {@link MetaAria.implicitRole} instead */
     implicitRole?: MetaImplicitRoleCallback;
     /** WAI-ARIA attributes */
@@ -1643,6 +1643,17 @@ export declare type MetaFocusableCallback = (node: HtmlElementLike) => boolean;
  */
 export declare type MetaImplicitRoleCallback = (node: HtmlElementLike) => string | null;
 
+/**
+ * Callback for the `labelable` properties of `MetaData`. It takes a node and
+ * returns whenever the element is labelable or not.
+ *
+ * @public
+ * @since 8.29.0
+ * @param node - The node to determine if it is labelable.
+ * @returns `true` if the node is labelable.
+ */
+export declare type MetaLabelableCallback = (node: HtmlElementLike) => boolean;
+
 /**
  * Properties listed here can be used to reverse search elements with the given
  * property enabled. See [[MetaTable.getTagsWithProperty]].
@@ -1991,12 +2002,6 @@ export declare interface ProcessElementContext {
     getMetaFor(this: void, tagName: string): MetaElement | null;
 }
 
-/**
- * @public
- * @deprecated Use callback variant instead.
- */
-export declare type PropertyExpression = string | [string, any];
-
 /**
  * Report object returned by [[HtmlValidate]].
  *
@@ -2687,7 +2692,7 @@ export declare interface TransformContext {
      * @param filename - Filename to use to match next transformer (unrelated to
      * filename set in source)
      */
-    chain(source: Source, filename: string): Iterable<Source> | Promise<Iterable<Source>>;
+    chain(source: Source, filename: string): TransformerChainedResult;
 }
 
 /**
@@ -2698,8 +2703,14 @@ export declare interface TransformContext {
 declare interface Transformer_2 {
     /**
      * Callback function to transform a source to plain HTML sources.
+     *
+     * Since 9.0.0 the transformer may return:
+     *
+     * - A single `Source` object or a `Promise` resolving to one.
+     * - An array of `Source` objects or a `Promise` resolving to one.
+     * - An array of `Promise` resolving to `Source` objects.
      */
-    (this: TransformContext, source: Source): Source | Iterable<Source | Promise<Source>> | Promise<Source> | Promise<Source | Iterable<Source | Promise<Source>>>;
+    (this: TransformContext, source: Source): TransformerResult;
     /**
      * API version. Must be specified, it is deprecated to leave it out as it
      * assumes version 0 (deprecated version).
@@ -2708,18 +2719,41 @@ declare interface Transformer_2 {
 }
 export { Transformer_2 as Transformer }
 
+/**
+ * The result of a transformer chain.
+ *
+ * Similar to the regular `TransformerResult` but flattened for easier usage.
+ *
+ * @public
+ * @since 9.0.0
+ */
+export declare type TransformerChainedResult = Iterable<Source> | Promise<Iterable<Source>>;
+
 /**
  * @public
  */
-export declare interface TransformerEntry {
+export declare type TransformerEntry = {
+    kind: "import";
     pattern: RegExp;
     name: string;
-}
+} | {
+    kind: "function";
+    pattern: RegExp;
+    function: Transformer_2;
+};
+
+/**
+ * The result of a transformer (or its chain).
+ *
+ * @public
+ * @since 9.0.0
+ */
+export declare type TransformerResult = Source | Iterable<Source | Promise<Source>> | Promise<Source> | Promise<Source | Iterable<Source | Promise<Source>>>;
 
 /**
  * @public
  */
-export declare type TransformMap = Record<string, string>;
+export declare type TransformMap = Record<string, string | Transformer_2>;
 
 /**
  * @public

package/dist/types/index.d.ts

@@ -792,7 +792,7 @@ export declare interface ErrorDescriptor<ContextType> {
  * ESM resolver.
  *
  * @public
- * @since 9.0.0-rc.4
+ * @since 9.0.0
  */
 export declare type ESMResolver = Required<Resolver>;
 
@@ -805,7 +805,7 @@ export declare type ESMResolver = Required<Resolver>;
  * file (starting at the current working directory).
  *
  * @public
- * @since 9.0.0-rc.4
+ * @since 9.0.0
  */
 export declare function esmResolver(options?: {
     rootDir?: string;
@@ -1779,13 +1779,13 @@ export declare const MetaCopyableProperty: Array<keyof MetaElement>;
  */
 export declare interface MetaData {
     inherit?: string;
-    metadata?: boolean | PropertyExpression | MetaCategoryCallback;
-    flow?: boolean | PropertyExpression | MetaCategoryCallback;
-    sectioning?: boolean | PropertyExpression | MetaCategoryCallback;
-    heading?: boolean | PropertyExpression | MetaCategoryCallback;
-    phrasing?: boolean | PropertyExpression | MetaCategoryCallback;
-    embedded?: boolean | PropertyExpression | MetaCategoryCallback;
-    interactive?: boolean | PropertyExpression | MetaCategoryCallback;
+    metadata?: boolean | MetaCategoryCallback;
+    flow?: boolean | MetaCategoryCallback;
+    sectioning?: boolean | MetaCategoryCallback;
+    heading?: boolean | MetaCategoryCallback;
+    phrasing?: boolean | MetaCategoryCallback;
+    embedded?: boolean | MetaCategoryCallback;
+    interactive?: boolean | MetaCategoryCallback;
     deprecated?: boolean | string | DeprecatedElement;
     foreign?: boolean;
     void?: boolean;
@@ -1797,7 +1797,7 @@ export declare interface MetaData {
     form?: boolean;
     /** Mark element as a form-associated element */
     formAssociated?: Partial<FormAssociated>;
-    labelable?: boolean | PropertyExpression;
+    labelable?: boolean | MetaLabelableCallback;
     /** @deprecated use {@link MetaAria.implicitRole} instead */
     implicitRole?: MetaImplicitRoleCallback;
     /** WAI-ARIA attributes */
@@ -1883,6 +1883,17 @@ export declare type MetaFocusableCallback = (node: HtmlElementLike) => boolean;
  */
 export declare type MetaImplicitRoleCallback = (node: HtmlElementLike) => string | null;
 
+/**
+ * Callback for the `labelable` properties of `MetaData`. It takes a node and
+ * returns whenever the element is labelable or not.
+ *
+ * @public
+ * @since 8.29.0
+ * @param node - The node to determine if it is labelable.
+ * @returns `true` if the node is labelable.
+ */
+export declare type MetaLabelableCallback = (node: HtmlElementLike) => boolean;
+
 /**
  * Properties listed here can be used to reverse search elements with the given
  * property enabled. See [[MetaTable.getTagsWithProperty]].
@@ -2256,12 +2267,6 @@ export declare interface ProcessElementContext {
     getMetaFor(this: void, tagName: string): MetaElement | null;
 }
 
-/**
- * @public
- * @deprecated Use callback variant instead.
- */
-export declare type PropertyExpression = string | [string, any];
-
 /**
  * Report object returned by [[HtmlValidate]].
  *
@@ -2952,7 +2957,7 @@ export declare interface TransformContext {
      * @param filename - Filename to use to match next transformer (unrelated to
      * filename set in source)
      */
-    chain(source: Source, filename: string): Iterable<Source> | Promise<Iterable<Source>>;
+    chain(source: Source, filename: string): TransformerChainedResult;
 }
 
 /**
@@ -2963,8 +2968,14 @@ export declare interface TransformContext {
 declare interface Transformer_2 {
     /**
      * Callback function to transform a source to plain HTML sources.
+     *
+     * Since 9.0.0 the transformer may return:
+     *
+     * - A single `Source` object or a `Promise` resolving to one.
+     * - An array of `Source` objects or a `Promise` resolving to one.
+     * - An array of `Promise` resolving to `Source` objects.
      */
-    (this: TransformContext, source: Source): Source | Iterable<Source | Promise<Source>> | Promise<Source> | Promise<Source | Iterable<Source | Promise<Source>>>;
+    (this: TransformContext, source: Source): TransformerResult;
     /**
      * API version. Must be specified, it is deprecated to leave it out as it
      * assumes version 0 (deprecated version).
@@ -2973,18 +2984,41 @@ declare interface Transformer_2 {
 }
 export { Transformer_2 as Transformer }
 
+/**
+ * The result of a transformer chain.
+ *
+ * Similar to the regular `TransformerResult` but flattened for easier usage.
+ *
+ * @public
+ * @since 9.0.0
+ */
+export declare type TransformerChainedResult = Iterable<Source> | Promise<Iterable<Source>>;
+
 /**
  * @public
  */
-export declare interface TransformerEntry {
+export declare type TransformerEntry = {
+    kind: "import";
     pattern: RegExp;
     name: string;
-}
+} | {
+    kind: "function";
+    pattern: RegExp;
+    function: Transformer_2;
+};
+
+/**
+ * The result of a transformer (or its chain).
+ *
+ * @public
+ * @since 9.0.0
+ */
+export declare type TransformerResult = Source | Iterable<Source | Promise<Source>> | Promise<Source> | Promise<Source | Iterable<Source | Promise<Source>>>;
 
 /**
  * @public
  */
-export declare type TransformMap = Record<string, string>;
+export declare type TransformMap = Record<string, string | Transformer_2>;
 
 /**
  * @public

package/dist/types/test-utils.d.ts

@@ -1,12 +1,16 @@
 import { Source } from 'html-validate';
-import { TransformContext } from 'html-validate';
+import { Transformer as Transformer_2 } from 'html-validate';
+import { TransformerChainedResult } from 'html-validate';
+import { TransformerResult } from 'html-validate';
+
+export { Source }
 
-/**
- * @public
- */
-declare type Transformer_2 = (this: TransformContext, source: Source) => Iterable<Source> | Promise<Iterable<Source>>;
 export { Transformer_2 as Transformer }
 
+export { TransformerChainedResult }
+
+export { TransformerResult }
+
 /**
  * Helper function to call a transformer function in test-cases.
  *
@@ -15,7 +19,7 @@ export { Transformer_2 as Transformer }
  * @param filename - Filename to read data from. Must be readable.
  * @param chain - If set this function is called when chaining transformers. Default is pass-thru.
  */
-export declare function transformFile(fn: Transformer_2, filename: string, chain?: (source: Source, filename: string) => Iterable<Source> | Promise<Iterable<Source>>): Promise<Source[]>;
+export declare function transformFile(fn: Transformer_2, filename: string, chain?: (source: Source, filename: string) => TransformerChainedResult): Promise<Source[]>;
 
 /**
  * Helper function to call a transformer function in test-cases.
@@ -25,7 +29,7 @@ export declare function transformFile(fn: Transformer_2, filename: string, chain
  * @param data - Source to transform.
  * @param chain - If set this function is called when chaining transformers. Default is pass-thru.
  */
-export declare function transformSource(fn: Transformer_2, source: Source, chain?: (source: Source, filename: string) => Iterable<Source> | Promise<Iterable<Source>>): Promise<Source[]>;
+export declare function transformSource(fn: Transformer_2, source: Source, chain?: (source: Source, filename: string) => TransformerChainedResult): Promise<Source[]>;
 
 /**
  * Helper function to call a transformer function in test-cases.
@@ -35,6 +39,6 @@ export declare function transformSource(fn: Transformer_2, source: Source, chain
  * @param data - String to transform.
  * @param chain - If set this function is called when chaining transformers. Default is pass-thru.
  */
-export declare function transformString(fn: Transformer_2, data: string, chain?: (source: Source, filename: string) => Iterable<Source> | Promise<Iterable<Source>>): Promise<Source[]>;
+export declare function transformString(fn: Transformer_2, data: string, chain?: (source: Source, filename: string) => TransformerChainedResult): Promise<Source[]>;
 
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "html-validate",
-  "version": "9.0.0-rc.7",
+  "version": "9.0.0",
   "description": "Offline html5 validator",
   "keywords": [
     "html",