@rollup/browser 3.0.1 → 3.2.0

package/dist/rollup.browser.d.ts

@@ -1,5 +1,9 @@
 export const VERSION: string;
 
+type FalsyValue = false | null | undefined;
+type MaybeArray<T> = T | T[];
+type MaybePromise<T> = T | Promise<T>;
+
 export interface RollupError extends RollupLog {
 	name?: string;
 	stack?: string;
@@ -176,7 +180,7 @@ export interface PluginContext extends MinimalPluginContext {
 	addWatchFile: (id: string) => void;
 	cache: PluginCache;
 	emitFile: EmitFile;
-	error: (err: RollupError | string, pos?: number | { column: number; line: number }) => never;
+	error: (error: RollupError | string, pos?: number | { column: number; line: number }) => never;
 	getFileName: (fileReferenceId: string) => string;
 	getModuleIds: () => IterableIterator<string>;
 	getModuleInfo: GetModuleInfo;
@@ -287,7 +291,7 @@ export type ResolveDynamicImportHook = (
 
 export type ResolveImportMetaHook = (
 	this: PluginContext,
-	prop: string | null,
+	property: string | null,
 	options: { chunkId: string; format: InternalModuleFormat; moduleId: string }
 ) => string | null | void;
 
@@ -335,7 +339,7 @@ export interface OutputBundle {
 
 export interface FunctionPluginHooks {
 	augmentChunkHash: (this: PluginContext, chunk: RenderedChunk) => string | void;
-	buildEnd: (this: PluginContext, err?: Error) => void;
+	buildEnd: (this: PluginContext, error?: Error) => void;
 	buildStart: (this: PluginContext, options: NormalizedInputOptions) => void;
 	closeBundle: (this: PluginContext) => void;
 	closeWatcher: (this: PluginContext) => void;
@@ -359,7 +363,7 @@ export interface FunctionPluginHooks {
 			targetModuleId: string | null;
 		}
 	) => { left: string; right: string } | null | void;
-	renderError: (this: PluginContext, err?: Error) => void;
+	renderError: (this: PluginContext, error?: Error) => void;
 	renderStart: (
 		this: PluginContext,
 		outputOptions: NormalizedOutputOptions,
@@ -426,8 +430,11 @@ export type ParallelPluginHooks = Exclude<
 
 export type AddonHooks = 'banner' | 'footer' | 'intro' | 'outro';
 
-type MakeAsync<Fn> = Fn extends (this: infer This, ...args: infer Args) => infer Return
-	? (this: This, ...args: Args) => Return | Promise<Return>
+type MakeAsync<Function_> = Function_ extends (
+	this: infer This,
+	...parameters: infer Arguments
+) => infer Return
+	? (this: This, ...parameters: Arguments) => Return | Promise<Return>
 	: never;
 
 // eslint-disable-next-line @typescript-eslint/ban-types
@@ -492,6 +499,8 @@ export type SourcemapPathTransformOption = (
 	sourcemapPath: string
 ) => string;
 
+export type InputPluginOption = MaybePromise<Plugin | FalsyValue | InputPluginOption[]>;
+
 export interface InputOptions {
 	acorn?: Record<string, unknown>;
 	acornInjectPlugins?: (() => unknown)[] | (() => unknown);
@@ -511,7 +520,7 @@ export interface InputOptions {
 	moduleContext?: ((id: string) => string | null | void) | { [id: string]: string };
 	onwarn?: WarningHandlerWithDefault;
 	perf?: boolean;
-	plugins?: (Plugin | null | false | undefined)[];
+	plugins?: InputPluginOption;
 	preserveEntrySignatures?: PreserveEntrySignaturesOption;
 	/** @deprecated Use the "preserveModules" output option instead. */
 	preserveModules?: boolean;
@@ -522,6 +531,10 @@ export interface InputOptions {
 	watch?: WatcherOptions | false;
 }
 
+export interface InputOptionsWithPlugins extends InputOptions {
+	plugins: Plugin[];
+}
+
 export interface NormalizedInputOptions {
 	acorn: Record<string, unknown>;
 	acornInjectPlugins: (() => unknown)[];
@@ -610,6 +623,8 @@ export type NormalizedAmdOptions = (
 
 type AddonFunction = (chunk: RenderedChunk) => string | Promise<string>;
 
+type OutputPluginOption = MaybePromise<OutputPlugin | FalsyValue | OutputPluginOption[]>;
+
 export interface OutputOptions {
 	amd?: AmdOptions;
 	assetFileNames?: string | ((chunkInfo: PreRenderedAsset) => string);
@@ -647,7 +662,7 @@ export interface OutputOptions {
 	noConflict?: boolean;
 	outro?: string | AddonFunction;
 	paths?: OptionsPaths;
-	plugins?: (OutputPlugin | null | false | undefined)[];
+	plugins?: OutputPluginOption;
 	/** @deprecated Use "generatedCode.constBindings" instead. */
 	preferConst?: boolean;
 	preserveModules?: boolean;
@@ -800,7 +815,7 @@ export interface RollupOptions extends InputOptions {
 	output?: OutputOptions | OutputOptions[];
 }
 
-export interface MergedRollupOptions extends InputOptions {
+export interface MergedRollupOptions extends InputOptionsWithPlugins {
 	output: OutputOptions[];
 }
 
@@ -846,13 +861,13 @@ export interface RollupWatchOptions extends InputOptions {
 }
 
 export type AwaitedEventListener<
-	T extends { [event: string]: (...args: any) => any },
+	T extends { [event: string]: (...parameters: any) => any },
 	K extends keyof T
-> = (...args: Parameters<T[K]>) => void | Promise<void>;
+> = (...parameters: Parameters<T[K]>) => void | Promise<void>;
 
-export interface AwaitingEventEmitter<T extends { [event: string]: (...args: any) => any }> {
+export interface AwaitingEventEmitter<T extends { [event: string]: (...parameters: any) => any }> {
 	close(): Promise<void>;
-	emit<K extends keyof T>(event: K, ...args: Parameters<T[K]>): Promise<unknown>;
+	emit<K extends keyof T>(event: K, ...parameters: Parameters<T[K]>): Promise<unknown>;
 	/**
 	 * Removes an event listener.
 	 */
@@ -872,7 +887,7 @@ export interface AwaitingEventEmitter<T extends { [event: string]: (...args: any
 	 */
 	onCurrentRun<K extends keyof T>(
 		event: K,
-		listener: (...args: Parameters<T[K]>) => Promise<ReturnType<T[K]>>
+		listener: (...parameters: Parameters<T[K]>) => Promise<ReturnType<T[K]>>
 	): this;
 	removeAllListeners(): this;
 	removeListenersForCurrentRun(): this;