@rolldown/browser 1.0.0-beta.35 → 1.0.0-beta.37

package/dist/config.d.mts

@@ -1,5 +1,5 @@
-import "./shared/binding-9k0egz6L.mjs";
-import { ConfigExport, defineConfig } from "./shared/define-config-DJXaSinS.mjs";
+import "./shared/binding-Cjs27cfu.mjs";
+import { ConfigExport, defineConfig } from "./shared/define-config-DzsPS4fI.mjs";
 
 //#region src/utils/load-config.d.ts
 declare function loadConfig(configPath: string): Promise<ConfigExport>;

package/dist/config.mjs

@@ -1,7 +1,7 @@
-import { defineConfig, version } from "./shared/src-B0RCtUy7.mjs";
-import "./shared/parse-ast-index-C_CZT4St.mjs";
-import "./shared/dist-ByKQkexh.mjs";
-import { loadConfig } from "./shared/load-config-BCjD-AGJ.mjs";
+import { defineConfig, version } from "./shared/src-kVjGhYdF.mjs";
+import "./shared/parse-ast-index-C3TkGcEQ.mjs";
+import "./shared/dist-CHTC3-kR.mjs";
+import { loadConfig } from "./shared/load-config-efyGD8HY.mjs";
 
 //#region src/config.ts
 const VERSION = version;

package/dist/experimental-index.browser.mjs

@@ -1,4 +1,4 @@
-import { PluginDriver, assetPlugin, buildImportAnalysisPlugin, createBuiltinPlugin, createBundlerImpl, createBundlerOptions, dynamicImportVarsPlugin, esmExternalRequirePlugin, handleOutputErrors, importGlobPlugin, isolatedDeclarationPlugin, jsonPlugin, loadFallbackPlugin, manifestPlugin, modulePreloadPolyfillPlugin, normalizedStringOrRegex, reporterPlugin, viteResolvePlugin, wasmFallbackPlugin, wasmHelperPlugin, webWorkerPostPlugin } from "./src-C8U06Im1.js";
+import { BuiltinPlugin, PluginDriver, assetPlugin, buildImportAnalysisPlugin, createBundlerImpl, createBundlerOptions, dynamicImportVarsPlugin, esmExternalRequirePlugin, handleOutputErrors, importGlobPlugin, isolatedDeclarationPlugin, jsonPlugin, loadFallbackPlugin, manifestPlugin, modulePreloadPolyfillPlugin, normalizedStringOrRegex, reporterPlugin, viteResolvePlugin, wasmFallbackPlugin, wasmHelperPlugin, webWorkerPostPlugin } from "./src-C2GHZXDs.js";
 import { BindingBundler, BindingDevEngine, ResolverFactory, isolatedDeclaration, moduleRunnerTransform, transform } from "./rolldown-binding.wasi-browser.js";
 
 //#region src/api/dev/dev-engine.ts
@@ -10,8 +10,14 @@ var DevEngine = class DevEngine {
 		const options = await createBundlerOptions(inputOptions, outputOptions, false);
 		const bindingDevOptions = {
 			onHmrUpdates: devOptions.onHmrUpdates,
-			usePolling: devOptions.usePolling,
-			pollInterval: devOptions.pollInterval
+			watch: devOptions.watch && {
+				usePolling: devOptions.watch.usePolling,
+				pollInterval: devOptions.watch.pollInterval,
+				useDebounce: devOptions.watch.useDebounce,
+				debounceDuration: devOptions.watch.debounceDuration,
+				compareContentsForPolling: devOptions.watch.compareContentsForPolling,
+				debounceTickRate: devOptions.watch.debounceTickRate
+			}
 		};
 		const inner = new BindingDevEngine(options.bundlerOptions, bindingDevOptions);
 		return new DevEngine(inner);
@@ -33,6 +39,16 @@ var DevEngine = class DevEngine {
 	async ensureLatestBuild() {
 		await this.#inner.ensureLatestBuild();
 	}
+	/**
+	* Returns true if a new build is scheduled.
+	*/
+	async scheduleBuildIfStale() {
+		const scheduled = await this.#inner.scheduleBuildIfStale();
+		if (scheduled) {
+			scheduled.wait().catch(() => {});
+			return scheduled.alreadyScheduled() ? "alreadyScheduled" : "scheduled";
+		}
+	}
 	async invalidate(file, firstInvalidatedBy) {
 		return this.#inner.invalidate(file, firstInvalidatedBy);
 	}
@@ -66,7 +82,471 @@ function defineParallelPlugin(pluginPath) {
 //#endregion
 //#region src/builtin-plugin/alias-plugin.ts
 function aliasPlugin(config) {
-	return createBuiltinPlugin("builtin:alias", config);
+	return new BuiltinPlugin("builtin:alias", config);
+}
+
+//#endregion
+//#region ../../node_modules/.pnpm/consola@3.4.2/node_modules/consola/dist/core.mjs
+const LogLevels = {
+	silent: Number.NEGATIVE_INFINITY,
+	fatal: 0,
+	error: 0,
+	warn: 1,
+	log: 2,
+	info: 3,
+	success: 3,
+	fail: 3,
+	ready: 3,
+	start: 3,
+	box: 3,
+	debug: 4,
+	trace: 5,
+	verbose: Number.POSITIVE_INFINITY
+};
+const LogTypes = {
+	silent: { level: -1 },
+	fatal: { level: LogLevels.fatal },
+	error: { level: LogLevels.error },
+	warn: { level: LogLevels.warn },
+	log: { level: LogLevels.log },
+	info: { level: LogLevels.info },
+	success: { level: LogLevels.success },
+	fail: { level: LogLevels.fail },
+	ready: { level: LogLevels.info },
+	start: { level: LogLevels.info },
+	box: { level: LogLevels.info },
+	debug: { level: LogLevels.debug },
+	trace: { level: LogLevels.trace },
+	verbose: { level: LogLevels.verbose }
+};
+function isPlainObject$1(value) {
+	if (value === null || typeof value !== "object") return false;
+	const prototype = Object.getPrototypeOf(value);
+	if (prototype !== null && prototype !== Object.prototype && Object.getPrototypeOf(prototype) !== null) return false;
+	if (Symbol.iterator in value) return false;
+	if (Symbol.toStringTag in value) return Object.prototype.toString.call(value) === "[object Module]";
+	return true;
+}
+function _defu(baseObject, defaults, namespace = ".", merger) {
+	if (!isPlainObject$1(defaults)) return _defu(baseObject, {}, namespace, merger);
+	const object = Object.assign({}, defaults);
+	for (const key in baseObject) {
+		if (key === "__proto__" || key === "constructor") continue;
+		const value = baseObject[key];
+		if (value === null || value === void 0) continue;
+		if (merger && merger(object, key, value, namespace)) continue;
+		if (Array.isArray(value) && Array.isArray(object[key])) object[key] = [...value, ...object[key]];
+		else if (isPlainObject$1(value) && isPlainObject$1(object[key])) object[key] = _defu(value, object[key], (namespace ? `${namespace}.` : "") + key.toString(), merger);
+		else object[key] = value;
+	}
+	return object;
+}
+function createDefu(merger) {
+	return (...arguments_) => arguments_.reduce((p, c) => _defu(p, c, "", merger), {});
+}
+const defu = createDefu();
+function isPlainObject(obj) {
+	return Object.prototype.toString.call(obj) === "[object Object]";
+}
+function isLogObj(arg) {
+	if (!isPlainObject(arg)) return false;
+	if (!arg.message && !arg.args) return false;
+	if (arg.stack) return false;
+	return true;
+}
+let paused = false;
+const queue = [];
+var Consola = class Consola {
+	options;
+	_lastLog;
+	_mockFn;
+	/**
+	* Creates an instance of Consola with specified options or defaults.
+	*
+	* @param {Partial<ConsolaOptions>} [options={}] - Configuration options for the Consola instance.
+	*/
+	constructor(options = {}) {
+		const types = options.types || LogTypes;
+		this.options = defu({
+			...options,
+			defaults: { ...options.defaults },
+			level: _normalizeLogLevel(options.level, types),
+			reporters: [...options.reporters || []]
+		}, {
+			types: LogTypes,
+			throttle: 1e3,
+			throttleMin: 5,
+			formatOptions: {
+				date: true,
+				colors: false,
+				compact: true
+			}
+		});
+		for (const type in types) {
+			const defaults = {
+				type,
+				...this.options.defaults,
+				...types[type]
+			};
+			this[type] = this._wrapLogFn(defaults);
+			this[type].raw = this._wrapLogFn(defaults, true);
+		}
+		if (this.options.mockFn) this.mockTypes();
+		this._lastLog = {};
+	}
+	/**
+	* Gets the current log level of the Consola instance.
+	*
+	* @returns {number} The current log level.
+	*/
+	get level() {
+		return this.options.level;
+	}
+	/**
+	* Sets the minimum log level that will be output by the instance.
+	*
+	* @param {number} level - The new log level to set.
+	*/
+	set level(level) {
+		this.options.level = _normalizeLogLevel(level, this.options.types, this.options.level);
+	}
+	/**
+	* Displays a prompt to the user and returns the response.
+	* Throw an error if `prompt` is not supported by the current configuration.
+	*
+	* @template T
+	* @param {string} message - The message to display in the prompt.
+	* @param {T} [opts] - Optional options for the prompt. See {@link PromptOptions}.
+	* @returns {promise<T>} A promise that infer with the prompt options. See {@link PromptOptions}.
+	*/
+	prompt(message, opts) {
+		if (!this.options.prompt) throw new Error("prompt is not supported!");
+		return this.options.prompt(message, opts);
+	}
+	/**
+	* Creates a new instance of Consola, inheriting options from the current instance, with possible overrides.
+	*
+	* @param {Partial<ConsolaOptions>} options - Optional overrides for the new instance. See {@link ConsolaOptions}.
+	* @returns {ConsolaInstance} A new Consola instance. See {@link ConsolaInstance}.
+	*/
+	create(options) {
+		const instance = new Consola({
+			...this.options,
+			...options
+		});
+		if (this._mockFn) instance.mockTypes(this._mockFn);
+		return instance;
+	}
+	/**
+	* Creates a new Consola instance with the specified default log object properties.
+	*
+	* @param {InputLogObject} defaults - Default properties to include in any log from the new instance. See {@link InputLogObject}.
+	* @returns {ConsolaInstance} A new Consola instance. See {@link ConsolaInstance}.
+	*/
+	withDefaults(defaults) {
+		return this.create({
+			...this.options,
+			defaults: {
+				...this.options.defaults,
+				...defaults
+			}
+		});
+	}
+	/**
+	* Creates a new Consola instance with a specified tag, which will be included in every log.
+	*
+	* @param {string} tag - The tag to include in each log of the new instance.
+	* @returns {ConsolaInstance} A new Consola instance. See {@link ConsolaInstance}.
+	*/
+	withTag(tag) {
+		return this.withDefaults({ tag: this.options.defaults.tag ? this.options.defaults.tag + ":" + tag : tag });
+	}
+	/**
+	* Adds a custom reporter to the Consola instance.
+	* Reporters will be called for each log message, depending on their implementation and log level.
+	*
+	* @param {ConsolaReporter} reporter - The reporter to add. See {@link ConsolaReporter}.
+	* @returns {Consola} The current Consola instance.
+	*/
+	addReporter(reporter) {
+		this.options.reporters.push(reporter);
+		return this;
+	}
+	/**
+	* Removes a custom reporter from the Consola instance.
+	* If no reporter is specified, all reporters will be removed.
+	*
+	* @param {ConsolaReporter} reporter - The reporter to remove. See {@link ConsolaReporter}.
+	* @returns {Consola} The current Consola instance.
+	*/
+	removeReporter(reporter) {
+		if (reporter) {
+			const i = this.options.reporters.indexOf(reporter);
+			if (i !== -1) return this.options.reporters.splice(i, 1);
+		} else this.options.reporters.splice(0);
+		return this;
+	}
+	/**
+	* Replaces all reporters of the Consola instance with the specified array of reporters.
+	*
+	* @param {ConsolaReporter[]} reporters - The new reporters to set. See {@link ConsolaReporter}.
+	* @returns {Consola} The current Consola instance.
+	*/
+	setReporters(reporters) {
+		this.options.reporters = Array.isArray(reporters) ? reporters : [reporters];
+		return this;
+	}
+	wrapAll() {
+		this.wrapConsole();
+		this.wrapStd();
+	}
+	restoreAll() {
+		this.restoreConsole();
+		this.restoreStd();
+	}
+	/**
+	* Overrides console methods with Consola logging methods for consistent logging.
+	*/
+	wrapConsole() {
+		for (const type in this.options.types) {
+			if (!console["__" + type]) console["__" + type] = console[type];
+			console[type] = this[type].raw;
+		}
+	}
+	/**
+	* Restores the original console methods, removing Consola overrides.
+	*/
+	restoreConsole() {
+		for (const type in this.options.types) if (console["__" + type]) {
+			console[type] = console["__" + type];
+			delete console["__" + type];
+		}
+	}
+	/**
+	* Overrides standard output and error streams to redirect them through Consola.
+	*/
+	wrapStd() {
+		this._wrapStream(this.options.stdout, "log");
+		this._wrapStream(this.options.stderr, "log");
+	}
+	_wrapStream(stream, type) {
+		if (!stream) return;
+		if (!stream.__write) stream.__write = stream.write;
+		stream.write = (data) => {
+			this[type].raw(String(data).trim());
+		};
+	}
+	/**
+	* Restores the original standard output and error streams, removing the Consola redirection.
+	*/
+	restoreStd() {
+		this._restoreStream(this.options.stdout);
+		this._restoreStream(this.options.stderr);
+	}
+	_restoreStream(stream) {
+		if (!stream) return;
+		if (stream.__write) {
+			stream.write = stream.__write;
+			delete stream.__write;
+		}
+	}
+	/**
+	* Pauses logging, queues incoming logs until resumed.
+	*/
+	pauseLogs() {
+		paused = true;
+	}
+	/**
+	* Resumes logging, processing any queued logs.
+	*/
+	resumeLogs() {
+		paused = false;
+		const _queue = queue.splice(0);
+		for (const item of _queue) item[0]._logFn(item[1], item[2]);
+	}
+	/**
+	* Replaces logging methods with mocks if a mock function is provided.
+	*
+	* @param {ConsolaOptions["mockFn"]} mockFn - The function to use for mocking logging methods. See {@link ConsolaOptions["mockFn"]}.
+	*/
+	mockTypes(mockFn) {
+		const _mockFn = mockFn || this.options.mockFn;
+		this._mockFn = _mockFn;
+		if (typeof _mockFn !== "function") return;
+		for (const type in this.options.types) {
+			this[type] = _mockFn(type, this.options.types[type]) || this[type];
+			this[type].raw = this[type];
+		}
+	}
+	_wrapLogFn(defaults, isRaw) {
+		return (...args) => {
+			if (paused) {
+				queue.push([
+					this,
+					defaults,
+					args,
+					isRaw
+				]);
+				return;
+			}
+			return this._logFn(defaults, args, isRaw);
+		};
+	}
+	_logFn(defaults, args, isRaw) {
+		if ((defaults.level || 0) > this.level) return false;
+		const logObj = {
+			date: /* @__PURE__ */ new Date(),
+			args: [],
+			...defaults,
+			level: _normalizeLogLevel(defaults.level, this.options.types)
+		};
+		if (!isRaw && args.length === 1 && isLogObj(args[0])) Object.assign(logObj, args[0]);
+		else logObj.args = [...args];
+		if (logObj.message) {
+			logObj.args.unshift(logObj.message);
+			delete logObj.message;
+		}
+		if (logObj.additional) {
+			if (!Array.isArray(logObj.additional)) logObj.additional = logObj.additional.split("\n");
+			logObj.args.push("\n" + logObj.additional.join("\n"));
+			delete logObj.additional;
+		}
+		logObj.type = typeof logObj.type === "string" ? logObj.type.toLowerCase() : "log";
+		logObj.tag = typeof logObj.tag === "string" ? logObj.tag : "";
+		const resolveLog = (newLog = false) => {
+			const repeated = (this._lastLog.count || 0) - this.options.throttleMin;
+			if (this._lastLog.object && repeated > 0) {
+				const args2 = [...this._lastLog.object.args];
+				if (repeated > 1) args2.push(`(repeated ${repeated} times)`);
+				this._log({
+					...this._lastLog.object,
+					args: args2
+				});
+				this._lastLog.count = 1;
+			}
+			if (newLog) {
+				this._lastLog.object = logObj;
+				this._log(logObj);
+			}
+		};
+		clearTimeout(this._lastLog.timeout);
+		const diffTime = this._lastLog.time && logObj.date ? logObj.date.getTime() - this._lastLog.time.getTime() : 0;
+		this._lastLog.time = logObj.date;
+		if (diffTime < this.options.throttle) try {
+			const serializedLog = JSON.stringify([
+				logObj.type,
+				logObj.tag,
+				logObj.args
+			]);
+			const isSameLog = this._lastLog.serialized === serializedLog;
+			this._lastLog.serialized = serializedLog;
+			if (isSameLog) {
+				this._lastLog.count = (this._lastLog.count || 0) + 1;
+				if (this._lastLog.count > this.options.throttleMin) {
+					this._lastLog.timeout = setTimeout(resolveLog, this.options.throttle);
+					return;
+				}
+			}
+		} catch {}
+		resolveLog(true);
+	}
+	_log(logObj) {
+		for (const reporter of this.options.reporters) reporter.log(logObj, { options: this.options });
+	}
+};
+function _normalizeLogLevel(input, types = {}, defaultLevel = 3) {
+	if (input === void 0) return defaultLevel;
+	if (typeof input === "number") return input;
+	if (types[input] && types[input].level !== void 0) return types[input].level;
+	return defaultLevel;
+}
+Consola.prototype.add = Consola.prototype.addReporter;
+Consola.prototype.remove = Consola.prototype.removeReporter;
+Consola.prototype.clear = Consola.prototype.removeReporter;
+Consola.prototype.withScope = Consola.prototype.withTag;
+Consola.prototype.mock = Consola.prototype.mockTypes;
+Consola.prototype.pause = Consola.prototype.pauseLogs;
+Consola.prototype.resume = Consola.prototype.resumeLogs;
+function createConsola$1(options = {}) {
+	return new Consola(options);
+}
+
+//#endregion
+//#region ../../node_modules/.pnpm/consola@3.4.2/node_modules/consola/dist/browser.mjs
+var BrowserReporter = class {
+	options;
+	defaultColor;
+	levelColorMap;
+	typeColorMap;
+	constructor(options) {
+		this.options = { ...options };
+		this.defaultColor = "#7f8c8d";
+		this.levelColorMap = {
+			0: "#c0392b",
+			1: "#f39c12",
+			3: "#00BCD4"
+		};
+		this.typeColorMap = { success: "#2ecc71" };
+	}
+	_getLogFn(level) {
+		if (level < 1) return console.__error || console.error;
+		if (level === 1) return console.__warn || console.warn;
+		return console.__log || console.log;
+	}
+	log(logObj) {
+		const consoleLogFn = this._getLogFn(logObj.level);
+		const type = logObj.type === "log" ? "" : logObj.type;
+		const tag = logObj.tag || "";
+		const style = `
+      background: ${this.typeColorMap[logObj.type] || this.levelColorMap[logObj.level] || this.defaultColor};
+      border-radius: 0.5em;
+      color: white;
+      font-weight: bold;
+      padding: 2px 0.5em;
+    `;
+		const badge = `%c${[tag, type].filter(Boolean).join(":")}`;
+		if (typeof logObj.args[0] === "string") consoleLogFn(`${badge}%c ${logObj.args[0]}`, style, "", ...logObj.args.slice(1));
+		else consoleLogFn(badge, style, ...logObj.args);
+	}
+};
+function createConsola(options = {}) {
+	return createConsola$1({
+		reporters: options.reporters || [new BrowserReporter({})],
+		prompt(message, options2 = {}) {
+			if (options2.type === "confirm") return Promise.resolve(confirm(message));
+			return Promise.resolve(prompt(message));
+		},
+		...options
+	});
+}
+const consola = createConsola();
+
+//#endregion
+//#region src/cli/logger.ts
+/**
+* Console logger
+*/
+const logger = process.env.ROLLDOWN_TEST ? createTestingLogger() : createConsola({ formatOptions: { date: false } });
+function createTestingLogger() {
+	const types = [
+		"silent",
+		"fatal",
+		"error",
+		"warn",
+		"log",
+		"info",
+		"success",
+		"fail",
+		"ready",
+		"start",
+		"box",
+		"debug",
+		"trace",
+		"verbose"
+	];
+	const ret = Object.create(null);
+	for (const type of types) ret[type] = console.log;
+	return ret;
 }
 
 //#endregion
@@ -94,10 +574,16 @@ function aliasPlugin(config) {
 * ```
 */
 function replacePlugin(values = {}, options = {}) {
+	let hasNonStringValues = false;
 	Object.keys(values).forEach((key) => {
-		values[key] = values[key].toString();
+		const value = values[key];
+		if (typeof value !== "string") {
+			hasNonStringValues = true;
+			values[key] = String(value);
+		}
 	});
-	return createBuiltinPlugin("builtin:replace", {
+	if (hasNonStringValues) logger.warn("Some values provided to `replacePlugin` are not strings. They will be converted to strings, but for better performance consider converting them manually.");
+	return new BuiltinPlugin("builtin:replace", {
 		...options,
 		values
 	});
@@ -113,7 +599,7 @@ function transformPlugin(config) {
 		jsxRefreshInclude: normalizedStringOrRegex(config.jsxRefreshInclude),
 		jsxRefreshExclude: normalizedStringOrRegex(config.jsxRefreshExclude)
 	};
-	return createBuiltinPlugin("builtin:transform", config);
+	return new BuiltinPlugin("builtin:transform", config);
 }
 
 //#endregion

package/dist/experimental-index.d.mts

@@ -1,11 +1,45 @@
-import { BindingAssetPluginConfig, BindingBuildImportAnalysisPluginConfig, BindingDynamicImportVarsPluginConfig, BindingEsmExternalRequirePluginConfig, BindingHmrUpdate, BindingImportGlobPluginConfig, BindingIsolatedDeclarationPluginConfig, BindingJsonPluginConfig, BindingManifestPluginConfig, BindingModulePreloadPolyfillPluginConfig, BindingReplacePluginConfig, BindingReporterPluginConfig, BindingTransformPluginConfig, BindingViteResolvePluginConfig, BindingWasmHelperPluginConfig, IsolatedDeclarationsOptions, IsolatedDeclarationsResult, NapiResolveOptions, ResolveResult, ResolverFactory, TransformOptions, TransformResult, isolatedDeclaration, moduleRunnerTransform, transform } from "./shared/binding-9k0egz6L.mjs";
-import { BuiltinPlugin, InputOptions, OutputOptions, StringOrRegExp, defineParallelPlugin } from "./shared/define-config-DJXaSinS.mjs";
+import { BindingAssetPluginConfig, BindingBuildImportAnalysisPluginConfig, BindingDynamicImportVarsPluginConfig, BindingEsmExternalRequirePluginConfig, BindingHmrUpdate, BindingImportGlobPluginConfig, BindingIsolatedDeclarationPluginConfig, BindingJsonPluginConfig, BindingManifestPluginConfig, BindingModulePreloadPolyfillPluginConfig, BindingReplacePluginConfig, BindingReporterPluginConfig, BindingTransformPluginConfig, BindingViteResolvePluginConfig, BindingWasmHelperPluginConfig, IsolatedDeclarationsOptions, IsolatedDeclarationsResult, NapiResolveOptions, ResolveResult, ResolverFactory, TransformOptions, TransformResult, isolatedDeclaration, moduleRunnerTransform, transform } from "./shared/binding-Cjs27cfu.mjs";
+import { BuiltinPlugin, InputOptions, OutputOptions, StringOrRegExp, defineParallelPlugin } from "./shared/define-config-DzsPS4fI.mjs";
 
 //#region src/api/dev/dev-options.d.ts
-interface DevOptions {
-  onHmrUpdates?: (updates: BindingHmrUpdate[]) => void | Promise<void>;
+interface DevWatchOptions {
+  /**
+  * If `true`, use polling instead of native file system events for watching.
+  * @default false
+  */
   usePolling?: boolean;
+  /**
+  * Poll interval in milliseconds (only used when usePolling is true).
+  * @default 100
+  */
   pollInterval?: number;
+  /**
+  * If `true`, use debounced watcher. If `false`, use non-debounced watcher for immediate responses.
+  * @default true
+  */
+  useDebounce?: boolean;
+  /**
+  * Debounce duration in milliseconds (only used when useDebounce is true).
+  * @default 10
+  */
+  debounceDuration?: number;
+  /**
+  * Whether to compare file contents for poll-based watchers (only used when usePolling is true).
+  * When enabled, poll watchers will check file contents to determine if they actually changed.
+  * @default false
+  */
+  compareContentsForPolling?: boolean;
+  /**
+  * Tick rate in milliseconds for debounced watchers (only used when useDebounce is true).
+  * Controls how frequently the debouncer checks for events to process.
+  * When not specified, the debouncer will auto-select an appropriate tick rate (1/4 of the debounce duration).
+  * @default undefined (auto-select)
+  */
+  debounceTickRate?: number;
+}
+interface DevOptions {
+  onHmrUpdates?: (updates: BindingHmrUpdate[], changedFiles: string[]) => void | Promise<void>;
+  watch?: DevWatchOptions;
 }
 //#endregion
 //#region src/api/dev/dev-engine.d.ts
@@ -16,6 +50,10 @@ declare class DevEngine {
   run(): Promise<void>;
   ensureCurrentBuildFinish(): Promise<void>;
   ensureLatestBuild(): Promise<void>;
+  /**
+  * Returns true if a new build is scheduled.
+  */
+  scheduleBuildIfStale(): Promise<"scheduled" | "alreadyScheduled" | undefined>;
   invalidate(file: string, firstInvalidatedBy?: string): Promise<BindingHmrUpdate>;
 }
 //#endregion
@@ -96,4 +134,4 @@ type TransformPluginConfig = Omit<BindingTransformPluginConfig, "include" | "exc
 };
 declare function transformPlugin(config?: TransformPluginConfig): BuiltinPlugin;
 //#endregion
-export { DevEngine, type DevOptions, type IsolatedDeclarationsOptions, type IsolatedDeclarationsResult, type NapiResolveOptions as ResolveOptions, type ResolveResult, ResolverFactory, type TransformOptions, type TransformResult, aliasPlugin, assetPlugin, buildImportAnalysisPlugin, defineParallelPlugin, dev, dynamicImportVarsPlugin, esmExternalRequirePlugin, importGlobPlugin, isolatedDeclaration, isolatedDeclarationPlugin, jsonPlugin, loadFallbackPlugin, manifestPlugin, modulePreloadPolyfillPlugin, moduleRunnerTransform, replacePlugin, reporterPlugin, experimental_scan as scan, transform, transformPlugin, viteResolvePlugin, wasmFallbackPlugin, wasmHelperPlugin, webWorkerPostPlugin };
+export { DevEngine, type DevOptions, type DevWatchOptions, type IsolatedDeclarationsOptions, type IsolatedDeclarationsResult, type NapiResolveOptions as ResolveOptions, type ResolveResult, ResolverFactory, type TransformOptions, type TransformResult, aliasPlugin, assetPlugin, buildImportAnalysisPlugin, defineParallelPlugin, dev, dynamicImportVarsPlugin, esmExternalRequirePlugin, importGlobPlugin, isolatedDeclaration, isolatedDeclarationPlugin, jsonPlugin, loadFallbackPlugin, manifestPlugin, modulePreloadPolyfillPlugin, moduleRunnerTransform, replacePlugin, reporterPlugin, experimental_scan as scan, transform, transformPlugin, viteResolvePlugin, wasmFallbackPlugin, wasmHelperPlugin, webWorkerPostPlugin };