Add documentation

docs/01-command-line-reference.md

@@ -97,6 +97,7 @@ export default { // can be an array (for multiple inputs)
   },
 
   watch: {
+  	buildDelay,
     chokidar,
     clearScreen,
     skipWrite,

docs/02-javascript-api.md

@@ -184,6 +184,7 @@ const watchOptions = {
   ...inputOptions,
   output: [outputOptions],
   watch: {
+    buildDelay,
     chokidar,
     clearScreen,
     skipWrite,

docs/999-big-list-of-options.md

@@ -1222,28 +1222,31 @@ For each key, the first number represents the elapsed time while the second repr
 
 These options only take effect when running Rollup with the `--watch` flag, or using `rollup.watch`.
 
+#### watch.buildDelay
+Type: `number`<br>
+Default: `0`
+
+Configures how long Rollup will wait for further changes until it triggers a rebuild in milliseconds. By default, Rollup does not wait but there is a small debounce timeout configured in the chokidar instance. Setting this to a value greater than `0` will mean that Rollup will only triger a rebuild if there was no change for the configured number of milliseconds.
+
 #### watch.chokidar
 Type: `ChokidarOptions`<br>
 
 An optional object of watch options that will be passed to the bundled [chokidar](https://github.com/paulmillr/chokidar) instance. See the [chokidar documentation](https://github.com/paulmillr/chokidar#api) to find out what options are available.
 
 #### watch.clearScreen
 Type: `boolean`<br>
-CLI: `--watch.clearScreen`/`--no-watch.clearScreen`<br>
 Default: `true`
 
 Whether to clear the screen when a rebuild is triggered.
 
 #### watch.skipWrite
 Type: `boolean`<br>
-<!-- CLI: `--watch.skipWrite`<br> -->
 Default: `false`
 
 Whether to skip the `bundle.write()` step when a rebuild is triggered.
 
 #### watch.exclude
-Type: `string`<br>
-CLI: `--watch.exclude <excludedPattern>`
+Type: `string`
 
 Prevent files from being watched:
 
@@ -1258,8 +1261,7 @@ export default {
 ```
 
 #### watch.include
-Type: `string`<br>
-CLI: `--watch.include <includedPattern>`
+Type: `string`
 
 Limit the file-watching to certain files:
 

src/rollup/types.d.ts

@@ -625,6 +625,7 @@ export interface ChokidarOptions {
 }
 
 export interface WatcherOptions {
+	buildDelay?: number;
 	chokidar?: ChokidarOptions;
 	clearScreen?: boolean;
 	exclude?: string[];
@@ -674,7 +675,6 @@ export interface RollupWatcher
 		event: (event: RollupWatcherEvent) => void;
 		restart: () => void;
 	}> {
-	delay?: number;
 	close(): void;
 }
 

src/watch/watch.ts

@@ -31,7 +31,7 @@ export class Watcher {
 		this.buildDelay = configArray.reduce(
 			(buildDelay, { watch }: any) =>
 				watch && typeof watch.buildDelay === 'number'
-					? Math.max(buildDelay, watch.buildDelay)
+					? Math.max(buildDelay, (watch as WatcherOptions).buildDelay!)
 					: buildDelay,
 			this.buildDelay
 		);