html-validate 9.0.0-rc.2 → 9.0.0-rc.3

package/dist/types/browser.d.ts

@@ -184,7 +184,6 @@ export declare interface ConditionalEvent extends Event_2 {
 export declare class Config {
     private config;
     private configurations;
-    private initialized;
     private resolvers;
     private metaTable;
     private plugins;
@@ -205,15 +204,6 @@ export declare class Config {
     static defaultConfig(): Config;
     /* Excluded from this release type: create */
     /* Excluded from this release type: __constructor */
-    /**
-     * Initialize plugins, transforms etc.
-     *
-     * Must be called before trying to use config. Can safely be called multiple
-     * times.
-     *
-     * @public
-     */
-    init(): void;
     /**
      * Returns true if this configuration is marked as "root".
      */
@@ -229,10 +219,12 @@ export declare class Config {
     private extendConfig;
     private extendConfigAsync;
     /* Excluded from this release type: getMetaTable */
+    private getElementsFromEntry;
     /* Excluded from this release type: get */
     /* Excluded from this release type: getRules */
     private static getRulesObject;
     /* Excluded from this release type: getPlugins */
+    /* Excluded from this release type: getTransformers */
     private loadPlugins;
     private loadConfigurations;
     private extendMeta;
@@ -244,33 +236,8 @@ export declare class Config {
      *
      * @public
      */
-    resolve(): ResolvedConfig;
+    resolve(): ResolvedConfig | Promise<ResolvedConfig>;
     /* Excluded from this release type: resolveData */
-    private precompileTransformers;
-    /**
-     * Get transformation function requested by configuration.
-     *
-     * Searches:
-     *
-     * - Named transformers from plugins.
-     * - Unnamed transformer from plugin.
-     * - Standalone modules (local or node_modules)
-     *
-     * @param name - Key from configuration
-     */
-    private getTransformFunction;
-    /**
-     * @param name - Original name from configuration
-     * @param pluginName - Name of plugin
-     * @param key - Name of transform (from plugin)
-     */
-    private getNamedTransformerFromPlugin;
-    /**
-     * @param name - Original name from configuration
-     * @param plugin - Plugin instance
-     */
-    private getUnnamedTransformerFromPlugin;
-    private getTransformerFromModule;
 }
 
 /**
@@ -382,6 +349,7 @@ export declare abstract class ConfigLoader {
      * @param configOverride - Optional configuration to merge final results with.
      */
     abstract getConfigFor(handle: string, configOverride?: ConfigData): ResolvedConfig | Promise<ResolvedConfig>;
+    /* Excluded from this release type: getResolvers */
     /**
      * Flush configuration cache.
      *
@@ -582,6 +550,7 @@ export declare class DOMNode {
      */
     get textContent(): string;
     append(node: DOMNode): void;
+    /* Excluded from this release type: insertBefore */
     isRootElement(): boolean;
     /**
      * Tests if two nodes are the same (references the same object).
@@ -599,6 +568,7 @@ export declare class DOMNode {
      * node has no children.
      */
     get lastChild(): DOMNode;
+    /* Excluded from this release type: removeChild */
     /* Excluded from this release type: blockRule */
     /* Excluded from this release type: blockRules */
     /* Excluded from this release type: disableRule */
@@ -614,6 +584,8 @@ export declare class DOMNode {
     /* Excluded from this release type: ruleEnabled */
     /* Excluded from this release type: ruleBlockers */
     generateSelector(): string | null;
+    /* Excluded from this release type: _setParent */
+    private _removeChild;
 }
 
 /**
@@ -781,13 +753,13 @@ export declare interface FormAssociated {
  */
 export declare class HtmlElement extends DOMNode {
     readonly tagName: string;
-    readonly parent: HtmlElement | null;
     readonly voidElement: boolean;
     readonly depth: number;
     closed: NodeClosed;
     protected readonly attr: Record<string, Attribute[]>;
     private metaElement;
     private annotation;
+    private _parent;
     /* Excluded from this release type: _adapter */
     private constructor();
     /**
@@ -884,6 +856,7 @@ export declare class HtmlElement extends DOMNode {
      */
     matches(selector: string): boolean;
     get meta(): MetaElement | null;
+    get parent(): HtmlElement | null;
     /**
      * Get current role for this element (explicit with `role` attribute or mapped
      * with implicit role).
@@ -994,6 +967,7 @@ export declare class HtmlElement extends DOMNode {
     /* Excluded from this release type: someChildren */
     /* Excluded from this release type: everyChildren */
     /* Excluded from this release type: find */
+    /* Excluded from this release type: _setParent */
 }
 
 /**
@@ -1139,7 +1113,7 @@ export declare class HtmlValidate {
     /**
      * Get effective configuration schema.
      */
-    getConfigurationSchema(): SchemaObject;
+    getConfigurationSchema(): Promise<SchemaObject>;
     /**
      * Get effective metadata element schema.
      *
@@ -1365,9 +1339,7 @@ export declare interface ListenEventMap {
     "config:ready": ConfigReadyEvent;
     "source:ready": SourceReadyEvent;
     /* Excluded from this release type: token */
-    "tag:open": TagOpenEvent;
     "tag:start": TagStartEvent;
-    "tag:close": TagCloseEvent;
     "tag:end": TagEndEvent;
     "tag:ready": TagReadyEvent;
     "element:ready": ElementReadyEvent;
@@ -2072,6 +2044,7 @@ export declare class ResolvedConfig {
     private plugins;
     private rules;
     private transformers;
+    private cache;
     /** The original data this resolved configuration was created from */
     private original;
     /* Excluded from this release type: __constructor */
@@ -2083,28 +2056,14 @@ export declare class ResolvedConfig {
     getMetaTable(): MetaTable;
     getPlugins(): Plugin_2[];
     getRules(): Map<string, [Severity, RuleOptions]>;
-    /**
-     * Transform a source.
-     *
-     * When transforming zero or more new sources will be generated.
-     *
-     * @param source - Current source to transform.
-     * @param filename - If set it is the filename used to match
-     * transformer. Default is to use filename from source.
-     * @returns A list of transformed sources ready for validation.
-     */
-    transformSource(source: Source, filename?: string): Source[];
-    /**
-     * Wrapper around [[transformSource]] which reads a file before passing it
-     * as-is to transformSource.
-     *
-     * @param filename - Filename to transform (according to configured
-     * transformations)
-     * @returns A list of transformed sources ready for validation.
-     */
-    transformFilename(filename: string): Source[];
+    /* Excluded from this release type: transformSource */
+    /* Excluded from this release type: transformSourceSync */
+    /* Excluded from this release type: transformFilename */
+    /* Excluded from this release type: transformFilenameSync */
     /**
      * Returns true if a transformer matches given filename.
+     *
+     * @public
      */
     canTransform(filename: string): boolean;
     private findTransformer;
@@ -2130,19 +2089,19 @@ export declare interface Resolver {
     /**
      * Resolve table of element metadata.
      */
-    resolveElements?(id: string, options: ResolverOptions): MetaDataTable | null;
+    resolveElements?(id: string, options: ResolverOptions): MetaDataTable | Promise<MetaDataTable | null> | null;
     /**
      * Resolve a configuration to extend.
      */
-    resolveConfig?(id: string, options: ResolverOptions): ConfigData | null;
+    resolveConfig?(id: string, options: ResolverOptions): ConfigData | Promise<ConfigData | null> | null;
     /**
      * Resolve a plugin.
      */
-    resolvePlugin?(id: string, options: ResolverOptions): Plugin_2 | null;
+    resolvePlugin?(id: string, options: ResolverOptions): Plugin_2 | Promise<Plugin_2 | null> | null;
     /**
      * Resolve a transformer.
      */
-    resolveTransformer?(id: string, options: ResolverOptions): Transformer_2 | null;
+    resolveTransformer?(id: string, options: ResolverOptions): Transformer_2 | Promise<Transformer_2 | null> | null;
 }
 
 /**
@@ -2347,7 +2306,7 @@ export declare type RuleOptions = string | number | Record<string, any>;
 /**
  * @public
  */
-export declare type RuleSeverity = "off" | "warn" | "error" | number;
+export declare type RuleSeverity = "off" | "warn" | "error" | 0 | 1 | 2;
 
 export { SchemaObject }
 
@@ -2570,14 +2529,6 @@ export declare interface StaticResolverMap {
 
 /* Excluded from this release type: StyleToken */
 
-/**
- * Deprecated alias for TagEndEvent
- *
- * @public
- * @deprecated Use TagEndEvent instead
- */
-export declare type TagCloseEvent = TagEndEvent;
-
 /* Excluded from this release type: TagCloseToken */
 
 /**
@@ -2595,14 +2546,6 @@ export declare interface TagEndEvent extends Event_2 {
     previous: HtmlElement;
 }
 
-/**
- * Deprecated alias for TagStartEvent
- *
- * @public
- * @deprecated Use TagStartEvent instead
- */
-export declare type TagOpenEvent = TagStartEvent;
-
 /* Excluded from this release type: TagOpenToken */
 
 /**
@@ -2727,7 +2670,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>;
+    chain(source: Source, filename: string): Iterable<Source> | Promise<Iterable<Source>>;
 }
 
 /**
@@ -2739,7 +2682,7 @@ declare interface Transformer_2 {
     /**
      * Callback function to transform a source to plain HTML sources.
      */
-    (this: TransformContext, source: Source): Iterable<Source>;
+    (this: TransformContext, source: Source): Iterable<Source> | Promise<Iterable<Source>>;
     /**
      * API version. Must be specified, it is deprecated to leave it out as it
      * assumes version 0 (deprecated version).
@@ -2754,7 +2697,6 @@ export { Transformer_2 as Transformer }
 export declare interface TransformerEntry {
     pattern: RegExp;
     name: string;
-    fn: Transformer_2;
 }
 
 /**

package/dist/types/index.d.ts

@@ -177,8 +177,8 @@ export declare class CLI {
      *
      * @public
      */
-    expandFiles(patterns: string[], options?: ExpandOptions): string[];
-    getFormatter(formatters: string): (report: Report_2) => string;
+    expandFiles(patterns: string[], options?: ExpandOptions): Promise<string[]>;
+    getFormatter(formatters: string): Promise<(report: Report_2) => string>;
     /**
      * Initialize project with a new configuration.
      *
@@ -186,18 +186,13 @@ export declare class CLI {
      * `cwd`.
      */
     init(cwd: string): Promise<InitResult>;
-    /**
-     * Searches ".htmlvalidateignore" files from filesystem and returns `true` if
-     * one of them contains a pattern matching given filename.
-     */
-    isIgnored(filename: string): boolean;
     /**
      * Clear cache.
      *
      * Previously fetched [[HtmlValidate]] instances must either be fetched again
      * or call [[HtmlValidate.flushConfigCache]].
      */
-    clearCache(): void;
+    clearCache(): Promise<void>;
     /* Excluded from this release type: getLoader */
     /**
      * Get HtmlValidate instance with configuration based on options passed to the
@@ -205,8 +200,13 @@ export declare class CLI {
      *
      * @public
      */
-    getValidator(): HtmlValidate;
+    getValidator(): Promise<HtmlValidate>;
     /* Excluded from this release type: getConfig */
+    /**
+     * Searches ".htmlvalidateignore" files from filesystem and returns `true` if
+     * one of them contains a pattern matching given filename.
+     */
+    private isIgnored;
     private resolveConfig;
 }
 
@@ -215,6 +215,8 @@ export declare class CLI {
  */
 export declare interface CLIOptions {
     configFile?: string;
+    /** Comma-separated list of presets to use */
+    preset?: string;
     rules?: string | string[];
 }
 
@@ -280,7 +282,6 @@ export declare interface ConditionalEvent extends Event_2 {
 export declare class Config {
     private config;
     private configurations;
-    private initialized;
     private resolvers;
     private metaTable;
     private plugins;
@@ -301,15 +302,6 @@ export declare class Config {
     static defaultConfig(): Config;
     /* Excluded from this release type: create */
     /* Excluded from this release type: __constructor */
-    /**
-     * Initialize plugins, transforms etc.
-     *
-     * Must be called before trying to use config. Can safely be called multiple
-     * times.
-     *
-     * @public
-     */
-    init(): void;
     /**
      * Returns true if this configuration is marked as "root".
      */
@@ -325,10 +317,12 @@ export declare class Config {
     private extendConfig;
     private extendConfigAsync;
     /* Excluded from this release type: getMetaTable */
+    private getElementsFromEntry;
     /* Excluded from this release type: get */
     /* Excluded from this release type: getRules */
     private static getRulesObject;
     /* Excluded from this release type: getPlugins */
+    /* Excluded from this release type: getTransformers */
     private loadPlugins;
     private loadConfigurations;
     private extendMeta;
@@ -340,33 +334,8 @@ export declare class Config {
      *
      * @public
      */
-    resolve(): ResolvedConfig;
+    resolve(): ResolvedConfig | Promise<ResolvedConfig>;
     /* Excluded from this release type: resolveData */
-    private precompileTransformers;
-    /**
-     * Get transformation function requested by configuration.
-     *
-     * Searches:
-     *
-     * - Named transformers from plugins.
-     * - Unnamed transformer from plugin.
-     * - Standalone modules (local or node_modules)
-     *
-     * @param name - Key from configuration
-     */
-    private getTransformFunction;
-    /**
-     * @param name - Original name from configuration
-     * @param pluginName - Name of plugin
-     * @param key - Name of transform (from plugin)
-     */
-    private getNamedTransformerFromPlugin;
-    /**
-     * @param name - Original name from configuration
-     * @param plugin - Plugin instance
-     */
-    private getUnnamedTransformerFromPlugin;
-    private getTransformerFromModule;
 }
 
 /**
@@ -478,6 +447,7 @@ export declare abstract class ConfigLoader {
      * @param configOverride - Optional configuration to merge final results with.
      */
     abstract getConfigFor(handle: string, configOverride?: ConfigData): ResolvedConfig | Promise<ResolvedConfig>;
+    /* Excluded from this release type: getResolvers */
     /**
      * Flush configuration cache.
      *
@@ -678,6 +648,7 @@ export declare class DOMNode {
      */
     get textContent(): string;
     append(node: DOMNode): void;
+    /* Excluded from this release type: insertBefore */
     isRootElement(): boolean;
     /**
      * Tests if two nodes are the same (references the same object).
@@ -695,6 +666,7 @@ export declare class DOMNode {
      * node has no children.
      */
     get lastChild(): DOMNode;
+    /* Excluded from this release type: removeChild */
     /* Excluded from this release type: blockRule */
     /* Excluded from this release type: blockRules */
     /* Excluded from this release type: disableRule */
@@ -710,6 +682,8 @@ export declare class DOMNode {
     /* Excluded from this release type: ruleEnabled */
     /* Excluded from this release type: ruleBlockers */
     generateSelector(): string | null;
+    /* Excluded from this release type: _setParent */
+    private _removeChild;
 }
 
 /**
@@ -813,6 +787,29 @@ export declare interface ErrorDescriptor<ContextType> {
     context?: ContextType;
 }
 
+/**
+ * ESM resolver.
+ *
+ * @public
+ * @since %version%
+ */
+export declare type ESMResolver = Required<Resolver>;
+
+/**
+ * Create a new resolver for NodeJS packages using `require(..)`.
+ *
+ * If the module name contains `<rootDir>` (e.g. `<rootDir/foo`) it will be
+ * expanded relative to the root directory either explicitly set by the
+ * `rootDir` parameter or determined automatically by the closest `package.json`
+ * file (starting at the current working directory).
+ *
+ * @public
+ * @since %version%
+ */
+export declare function esmResolver(options?: {
+    rootDir?: string;
+}): ESMResolver;
+
 /**
  * @public
  */
@@ -891,6 +888,7 @@ export declare interface ExpandOptions {
  * - `.htmlvalidate.json`
  * - `.htmlvalidate.js`
  * - `.htmlvalidate.cjs`
+ * - `.htmlvalidate.mjs`
  *
  * Global configuration is used when no configuration file is found. The
  * result is always merged with override if present.
@@ -945,8 +943,9 @@ export declare class FileSystemConfigLoader extends ConfigLoader {
      */
     fromFilename(filename: string): Config | Promise<Config | null> | null;
     /* Excluded from this release type: fromFilenameAsync */
-    private _mergeSync;
-    private _resolveSync;
+    private _merge;
+    private _resolveSync1;
+    private _resolveSync2;
     private _resolveAsync;
     /* Excluded from this release type: _getInternalCache */
     protected defaultConfig(): Config | Promise<Config>;
@@ -1003,13 +1002,13 @@ export declare interface FSLike {
  */
 export declare class HtmlElement extends DOMNode {
     readonly tagName: string;
-    readonly parent: HtmlElement | null;
     readonly voidElement: boolean;
     readonly depth: number;
     closed: NodeClosed;
     protected readonly attr: Record<string, Attribute[]>;
     private metaElement;
     private annotation;
+    private _parent;
     /* Excluded from this release type: _adapter */
     private constructor();
     /**
@@ -1106,6 +1105,7 @@ export declare class HtmlElement extends DOMNode {
      */
     matches(selector: string): boolean;
     get meta(): MetaElement | null;
+    get parent(): HtmlElement | null;
     /**
      * Get current role for this element (explicit with `role` attribute or mapped
      * with implicit role).
@@ -1216,6 +1216,7 @@ export declare class HtmlElement extends DOMNode {
     /* Excluded from this release type: someChildren */
     /* Excluded from this release type: everyChildren */
     /* Excluded from this release type: find */
+    /* Excluded from this release type: _setParent */
 }
 
 /**
@@ -1361,7 +1362,7 @@ export declare class HtmlValidate {
     /**
      * Get effective configuration schema.
      */
-    getConfigurationSchema(): SchemaObject;
+    getConfigurationSchema(): Promise<SchemaObject>;
     /**
      * Get effective metadata element schema.
      *
@@ -1594,9 +1595,7 @@ export declare interface ListenEventMap {
     "config:ready": ConfigReadyEvent;
     "source:ready": SourceReadyEvent;
     /* Excluded from this release type: token */
-    "tag:open": TagOpenEvent;
     "tag:start": TagStartEvent;
-    "tag:close": TagCloseEvent;
     "tag:end": TagEndEvent;
     "tag:ready": TagReadyEvent;
     "element:ready": ElementReadyEvent;
@@ -2326,6 +2325,7 @@ export declare class ResolvedConfig {
     private plugins;
     private rules;
     private transformers;
+    private cache;
     /** The original data this resolved configuration was created from */
     private original;
     /* Excluded from this release type: __constructor */
@@ -2337,28 +2337,14 @@ export declare class ResolvedConfig {
     getMetaTable(): MetaTable;
     getPlugins(): Plugin_2[];
     getRules(): Map<string, [Severity, RuleOptions]>;
-    /**
-     * Transform a source.
-     *
-     * When transforming zero or more new sources will be generated.
-     *
-     * @param source - Current source to transform.
-     * @param filename - If set it is the filename used to match
-     * transformer. Default is to use filename from source.
-     * @returns A list of transformed sources ready for validation.
-     */
-    transformSource(source: Source, filename?: string): Source[];
-    /**
-     * Wrapper around [[transformSource]] which reads a file before passing it
-     * as-is to transformSource.
-     *
-     * @param filename - Filename to transform (according to configured
-     * transformations)
-     * @returns A list of transformed sources ready for validation.
-     */
-    transformFilename(filename: string): Source[];
+    /* Excluded from this release type: transformSource */
+    /* Excluded from this release type: transformSourceSync */
+    /* Excluded from this release type: transformFilename */
+    /* Excluded from this release type: transformFilenameSync */
     /**
      * Returns true if a transformer matches given filename.
+     *
+     * @public
      */
     canTransform(filename: string): boolean;
     private findTransformer;
@@ -2384,19 +2370,19 @@ export declare interface Resolver {
     /**
      * Resolve table of element metadata.
      */
-    resolveElements?(id: string, options: ResolverOptions): MetaDataTable | null;
+    resolveElements?(id: string, options: ResolverOptions): MetaDataTable | Promise<MetaDataTable | null> | null;
     /**
      * Resolve a configuration to extend.
      */
-    resolveConfig?(id: string, options: ResolverOptions): ConfigData | null;
+    resolveConfig?(id: string, options: ResolverOptions): ConfigData | Promise<ConfigData | null> | null;
     /**
      * Resolve a plugin.
      */
-    resolvePlugin?(id: string, options: ResolverOptions): Plugin_2 | null;
+    resolvePlugin?(id: string, options: ResolverOptions): Plugin_2 | Promise<Plugin_2 | null> | null;
     /**
      * Resolve a transformer.
      */
-    resolveTransformer?(id: string, options: ResolverOptions): Transformer_2 | null;
+    resolveTransformer?(id: string, options: ResolverOptions): Transformer_2 | Promise<Transformer_2 | null> | null;
 }
 
 /**
@@ -2601,7 +2587,7 @@ export declare type RuleOptions = string | number | Record<string, any>;
 /**
  * @public
  */
-export declare type RuleSeverity = "off" | "warn" | "error" | number;
+export declare type RuleSeverity = "off" | "warn" | "error" | 0 | 1 | 2;
 
 export { SchemaObject }
 
@@ -2824,14 +2810,6 @@ export declare interface StaticResolverMap {
 
 /* Excluded from this release type: StyleToken */
 
-/**
- * Deprecated alias for TagEndEvent
- *
- * @public
- * @deprecated Use TagEndEvent instead
- */
-export declare type TagCloseEvent = TagEndEvent;
-
 /* Excluded from this release type: TagCloseToken */
 
 /**
@@ -2849,14 +2827,6 @@ export declare interface TagEndEvent extends Event_2 {
     previous: HtmlElement;
 }
 
-/**
- * Deprecated alias for TagStartEvent
- *
- * @public
- * @deprecated Use TagStartEvent instead
- */
-export declare type TagOpenEvent = TagStartEvent;
-
 /* Excluded from this release type: TagOpenToken */
 
 /**
@@ -2981,7 +2951,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>;
+    chain(source: Source, filename: string): Iterable<Source> | Promise<Iterable<Source>>;
 }
 
 /**
@@ -2993,7 +2963,7 @@ declare interface Transformer_2 {
     /**
      * Callback function to transform a source to plain HTML sources.
      */
-    (this: TransformContext, source: Source): Iterable<Source>;
+    (this: TransformContext, source: Source): Iterable<Source> | Promise<Iterable<Source>>;
     /**
      * API version. Must be specified, it is deprecated to leave it out as it
      * assumes version 0 (deprecated version).
@@ -3008,7 +2978,6 @@ export { Transformer_2 as Transformer }
 export declare interface TransformerEntry {
     pattern: RegExp;
     name: string;
-    fn: Transformer_2;
 }
 
 /**

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

@@ -4,7 +4,7 @@ import { TransformContext } from 'html-validate';
 /**
  * @public
  */
-declare type Transformer_2 = (this: TransformContext, source: Source) => Iterable<Source>;
+declare type Transformer_2 = (this: TransformContext, source: Source) => Iterable<Source> | Promise<Iterable<Source>>;
 export { Transformer_2 as Transformer }
 
 /**
@@ -15,7 +15,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>): Source[];
+export declare function transformFile(fn: Transformer_2, filename: string, chain?: (source: Source, filename: string) => Iterable<Source> | Promise<Iterable<Source>>): Promise<Source[]>;
 
 /**
  * Helper function to call a transformer function in test-cases.
@@ -25,7 +25,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>): Source[];
+export declare function transformSource(fn: Transformer_2, source: Source, chain?: (source: Source, filename: string) => Iterable<Source> | Promise<Iterable<Source>>): Promise<Source[]>;
 
 /**
  * Helper function to call a transformer function in test-cases.
@@ -35,6 +35,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>): Source[];
+export declare function transformString(fn: Transformer_2, data: string, chain?: (source: Source, filename: string) => Iterable<Source> | Promise<Iterable<Source>>): Promise<Source[]>;
 
 export { }