@rolldown/browser 1.0.0-rc.7 → 1.0.0-rc.8

package/dist/cli.mjs

@@ -1,16 +1,495 @@
-import { n as onExit, t as watch } from "./shared/watch-dCFQWE8a.mjs";
+import { n as onExit, t as watch } from "./shared/watch-BMFUc4Au.mjs";
 import "./shared/normalize-string-or-regex-CF3Uz6aU.mjs";
-import { S as version, x as description } from "./shared/bindingify-input-options-kCVufQp0.mjs";
+import { S as version, x as description } from "./shared/bindingify-input-options-CxjTlvCV.mjs";
 import { h as arraify } from "./shared/composable-filters-B2ByPP8y.mjs";
-import { a as getInputCliKeys, i as getCliSchemaInfo, l as styleText$1, o as getOutputCliKeys, r as logger, s as validateCliOptions } from "./shared/rolldown-build-8_xyZuDH.mjs";
+import { a as getInputCliKeys, i as getCliSchemaInfo, l as styleText, o as getOutputCliKeys, r as logger, s as validateCliOptions } from "./shared/rolldown-build-D_FXM8pA.mjs";
 import "./shared/error-CQ6njWsV.mjs";
 import "./shared/parse-DDUnGYGU.mjs";
-import { t as rolldown } from "./shared/rolldown-C9kn7lTZ.mjs";
-import { t as loadConfig } from "./shared/load-config-DNGVjxdv.mjs";
+import { t as rolldown } from "./shared/rolldown-D2p2QuF1.mjs";
+import { t as loadConfig } from "./shared/load-config-Cs9h9aXF.mjs";
 import path from "node:path";
-import { parseArgs } from "node:util";
 import process$1 from "node:process";
+import { EventEmitter } from "events";
 import { performance } from "node:perf_hooks";
+//#region ../../node_modules/.pnpm/cac@6.7.14/node_modules/cac/dist/index.mjs
+function toArr(any) {
+	return any == null ? [] : Array.isArray(any) ? any : [any];
+}
+function toVal(out, key, val, opts) {
+	var x, old = out[key], nxt = !!~opts.string.indexOf(key) ? val == null || val === true ? "" : String(val) : typeof val === "boolean" ? val : !!~opts.boolean.indexOf(key) ? val === "false" ? false : val === "true" || (out._.push((x = +val, x * 0 === 0) ? x : val), !!val) : (x = +val, x * 0 === 0) ? x : val;
+	out[key] = old == null ? nxt : Array.isArray(old) ? old.concat(nxt) : [old, nxt];
+}
+function mri2(args, opts) {
+	args = args || [];
+	opts = opts || {};
+	var k, arr, arg, name, val, out = { _: [] };
+	var i = 0, j = 0, idx = 0, len = args.length;
+	const alibi = opts.alias !== void 0;
+	const strict = opts.unknown !== void 0;
+	const defaults = opts.default !== void 0;
+	opts.alias = opts.alias || {};
+	opts.string = toArr(opts.string);
+	opts.boolean = toArr(opts.boolean);
+	if (alibi) for (k in opts.alias) {
+		arr = opts.alias[k] = toArr(opts.alias[k]);
+		for (i = 0; i < arr.length; i++) (opts.alias[arr[i]] = arr.concat(k)).splice(i, 1);
+	}
+	for (i = opts.boolean.length; i-- > 0;) {
+		arr = opts.alias[opts.boolean[i]] || [];
+		for (j = arr.length; j-- > 0;) opts.boolean.push(arr[j]);
+	}
+	for (i = opts.string.length; i-- > 0;) {
+		arr = opts.alias[opts.string[i]] || [];
+		for (j = arr.length; j-- > 0;) opts.string.push(arr[j]);
+	}
+	if (defaults) for (k in opts.default) {
+		name = typeof opts.default[k];
+		arr = opts.alias[k] = opts.alias[k] || [];
+		if (opts[name] !== void 0) {
+			opts[name].push(k);
+			for (i = 0; i < arr.length; i++) opts[name].push(arr[i]);
+		}
+	}
+	const keys = strict ? Object.keys(opts.alias) : [];
+	for (i = 0; i < len; i++) {
+		arg = args[i];
+		if (arg === "--") {
+			out._ = out._.concat(args.slice(++i));
+			break;
+		}
+		for (j = 0; j < arg.length; j++) if (arg.charCodeAt(j) !== 45) break;
+		if (j === 0) out._.push(arg);
+		else if (arg.substring(j, j + 3) === "no-") {
+			name = arg.substring(j + 3);
+			if (strict && !~keys.indexOf(name)) return opts.unknown(arg);
+			out[name] = false;
+		} else {
+			for (idx = j + 1; idx < arg.length; idx++) if (arg.charCodeAt(idx) === 61) break;
+			name = arg.substring(j, idx);
+			val = arg.substring(++idx) || i + 1 === len || ("" + args[i + 1]).charCodeAt(0) === 45 || args[++i];
+			arr = j === 2 ? [name] : name;
+			for (idx = 0; idx < arr.length; idx++) {
+				name = arr[idx];
+				if (strict && !~keys.indexOf(name)) return opts.unknown("-".repeat(j) + name);
+				toVal(out, name, idx + 1 < arr.length || val, opts);
+			}
+		}
+	}
+	if (defaults) {
+		for (k in opts.default) if (out[k] === void 0) out[k] = opts.default[k];
+	}
+	if (alibi) for (k in out) {
+		arr = opts.alias[k] || [];
+		while (arr.length > 0) out[arr.shift()] = out[k];
+	}
+	return out;
+}
+const removeBrackets = (v) => v.replace(/[<[].+/, "").trim();
+const findAllBrackets = (v) => {
+	const ANGLED_BRACKET_RE_GLOBAL = /<([^>]+)>/g;
+	const SQUARE_BRACKET_RE_GLOBAL = /\[([^\]]+)\]/g;
+	const res = [];
+	const parse = (match) => {
+		let variadic = false;
+		let value = match[1];
+		if (value.startsWith("...")) {
+			value = value.slice(3);
+			variadic = true;
+		}
+		return {
+			required: match[0].startsWith("<"),
+			value,
+			variadic
+		};
+	};
+	let angledMatch;
+	while (angledMatch = ANGLED_BRACKET_RE_GLOBAL.exec(v)) res.push(parse(angledMatch));
+	let squareMatch;
+	while (squareMatch = SQUARE_BRACKET_RE_GLOBAL.exec(v)) res.push(parse(squareMatch));
+	return res;
+};
+const getMriOptions = (options) => {
+	const result = {
+		alias: {},
+		boolean: []
+	};
+	for (const [index, option] of options.entries()) {
+		if (option.names.length > 1) result.alias[option.names[0]] = option.names.slice(1);
+		if (option.isBoolean) if (option.negated) {
+			if (!options.some((o, i) => {
+				return i !== index && o.names.some((name) => option.names.includes(name)) && typeof o.required === "boolean";
+			})) result.boolean.push(option.names[0]);
+		} else result.boolean.push(option.names[0]);
+	}
+	return result;
+};
+const findLongest = (arr) => {
+	return arr.sort((a, b) => {
+		return a.length > b.length ? -1 : 1;
+	})[0];
+};
+const padRight = (str, length) => {
+	return str.length >= length ? str : `${str}${" ".repeat(length - str.length)}`;
+};
+const camelcase = (input) => {
+	return input.replace(/([a-z])-([a-z])/g, (_, p1, p2) => {
+		return p1 + p2.toUpperCase();
+	});
+};
+const setDotProp = (obj, keys, val) => {
+	let i = 0;
+	let length = keys.length;
+	let t = obj;
+	let x;
+	for (; i < length; ++i) {
+		x = t[keys[i]];
+		t = t[keys[i]] = i === length - 1 ? val : x != null ? x : !!~keys[i + 1].indexOf(".") || !(+keys[i + 1] > -1) ? {} : [];
+	}
+};
+const setByType = (obj, transforms) => {
+	for (const key of Object.keys(transforms)) {
+		const transform = transforms[key];
+		if (transform.shouldTransform) {
+			obj[key] = Array.prototype.concat.call([], obj[key]);
+			if (typeof transform.transformFunction === "function") obj[key] = obj[key].map(transform.transformFunction);
+		}
+	}
+};
+const getFileName = (input) => {
+	const m = /([^\\\/]+)$/.exec(input);
+	return m ? m[1] : "";
+};
+const camelcaseOptionName = (name) => {
+	return name.split(".").map((v, i) => {
+		return i === 0 ? camelcase(v) : v;
+	}).join(".");
+};
+var CACError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = this.constructor.name;
+		if (typeof Error.captureStackTrace === "function") Error.captureStackTrace(this, this.constructor);
+		else this.stack = new Error(message).stack;
+	}
+};
+var Option = class {
+	constructor(rawName, description, config) {
+		this.rawName = rawName;
+		this.description = description;
+		this.config = Object.assign({}, config);
+		rawName = rawName.replace(/\.\*/g, "");
+		this.negated = false;
+		this.names = removeBrackets(rawName).split(",").map((v) => {
+			let name = v.trim().replace(/^-{1,2}/, "");
+			if (name.startsWith("no-")) {
+				this.negated = true;
+				name = name.replace(/^no-/, "");
+			}
+			return camelcaseOptionName(name);
+		}).sort((a, b) => a.length > b.length ? 1 : -1);
+		this.name = this.names[this.names.length - 1];
+		if (this.negated && this.config.default == null) this.config.default = true;
+		if (rawName.includes("<")) this.required = true;
+		else if (rawName.includes("[")) this.required = false;
+		else this.isBoolean = true;
+	}
+};
+const processArgs = process.argv;
+const platformInfo = `${process.platform}-${process.arch} node-${process.version}`;
+var Command = class {
+	constructor(rawName, description, config = {}, cli) {
+		this.rawName = rawName;
+		this.description = description;
+		this.config = config;
+		this.cli = cli;
+		this.options = [];
+		this.aliasNames = [];
+		this.name = removeBrackets(rawName);
+		this.args = findAllBrackets(rawName);
+		this.examples = [];
+	}
+	usage(text) {
+		this.usageText = text;
+		return this;
+	}
+	allowUnknownOptions() {
+		this.config.allowUnknownOptions = true;
+		return this;
+	}
+	ignoreOptionDefaultValue() {
+		this.config.ignoreOptionDefaultValue = true;
+		return this;
+	}
+	version(version, customFlags = "-v, --version") {
+		this.versionNumber = version;
+		this.option(customFlags, "Display version number");
+		return this;
+	}
+	example(example) {
+		this.examples.push(example);
+		return this;
+	}
+	option(rawName, description, config) {
+		const option = new Option(rawName, description, config);
+		this.options.push(option);
+		return this;
+	}
+	alias(name) {
+		this.aliasNames.push(name);
+		return this;
+	}
+	action(callback) {
+		this.commandAction = callback;
+		return this;
+	}
+	isMatched(name) {
+		return this.name === name || this.aliasNames.includes(name);
+	}
+	get isDefaultCommand() {
+		return this.name === "" || this.aliasNames.includes("!");
+	}
+	get isGlobalCommand() {
+		return this instanceof GlobalCommand;
+	}
+	hasOption(name) {
+		name = name.split(".")[0];
+		return this.options.find((option) => {
+			return option.names.includes(name);
+		});
+	}
+	outputHelp() {
+		const { name, commands } = this.cli;
+		const { versionNumber, options: globalOptions, helpCallback } = this.cli.globalCommand;
+		let sections = [{ body: `${name}${versionNumber ? `/${versionNumber}` : ""}` }];
+		sections.push({
+			title: "Usage",
+			body: `  $ ${name} ${this.usageText || this.rawName}`
+		});
+		if ((this.isGlobalCommand || this.isDefaultCommand) && commands.length > 0) {
+			const longestCommandName = findLongest(commands.map((command) => command.rawName));
+			sections.push({
+				title: "Commands",
+				body: commands.map((command) => {
+					return `  ${padRight(command.rawName, longestCommandName.length)}  ${command.description}`;
+				}).join("\n")
+			});
+			sections.push({
+				title: `For more info, run any command with the \`--help\` flag`,
+				body: commands.map((command) => `  $ ${name}${command.name === "" ? "" : ` ${command.name}`} --help`).join("\n")
+			});
+		}
+		let options = this.isGlobalCommand ? globalOptions : [...this.options, ...globalOptions || []];
+		if (!this.isGlobalCommand && !this.isDefaultCommand) options = options.filter((option) => option.name !== "version");
+		if (options.length > 0) {
+			const longestOptionName = findLongest(options.map((option) => option.rawName));
+			sections.push({
+				title: "Options",
+				body: options.map((option) => {
+					return `  ${padRight(option.rawName, longestOptionName.length)}  ${option.description} ${option.config.default === void 0 ? "" : `(default: ${option.config.default})`}`;
+				}).join("\n")
+			});
+		}
+		if (this.examples.length > 0) sections.push({
+			title: "Examples",
+			body: this.examples.map((example) => {
+				if (typeof example === "function") return example(name);
+				return example;
+			}).join("\n")
+		});
+		if (helpCallback) sections = helpCallback(sections) || sections;
+		console.log(sections.map((section) => {
+			return section.title ? `${section.title}:
+${section.body}` : section.body;
+		}).join("\n\n"));
+	}
+	outputVersion() {
+		const { name } = this.cli;
+		const { versionNumber } = this.cli.globalCommand;
+		if (versionNumber) console.log(`${name}/${versionNumber} ${platformInfo}`);
+	}
+	checkRequiredArgs() {
+		const minimalArgsCount = this.args.filter((arg) => arg.required).length;
+		if (this.cli.args.length < minimalArgsCount) throw new CACError(`missing required args for command \`${this.rawName}\``);
+	}
+	checkUnknownOptions() {
+		const { options, globalCommand } = this.cli;
+		if (!this.config.allowUnknownOptions) {
+			for (const name of Object.keys(options)) if (name !== "--" && !this.hasOption(name) && !globalCommand.hasOption(name)) throw new CACError(`Unknown option \`${name.length > 1 ? `--${name}` : `-${name}`}\``);
+		}
+	}
+	checkOptionValue() {
+		const { options: parsedOptions, globalCommand } = this.cli;
+		const options = [...globalCommand.options, ...this.options];
+		for (const option of options) {
+			const value = parsedOptions[option.name.split(".")[0]];
+			if (option.required) {
+				const hasNegated = options.some((o) => o.negated && o.names.includes(option.name));
+				if (value === true || value === false && !hasNegated) throw new CACError(`option \`${option.rawName}\` value is missing`);
+			}
+		}
+	}
+};
+var GlobalCommand = class extends Command {
+	constructor(cli) {
+		super("@@global@@", "", {}, cli);
+	}
+};
+var __assign = Object.assign;
+var CAC = class extends EventEmitter {
+	constructor(name = "") {
+		super();
+		this.name = name;
+		this.commands = [];
+		this.rawArgs = [];
+		this.args = [];
+		this.options = {};
+		this.globalCommand = new GlobalCommand(this);
+		this.globalCommand.usage("<command> [options]");
+	}
+	usage(text) {
+		this.globalCommand.usage(text);
+		return this;
+	}
+	command(rawName, description, config) {
+		const command = new Command(rawName, description || "", config, this);
+		command.globalCommand = this.globalCommand;
+		this.commands.push(command);
+		return command;
+	}
+	option(rawName, description, config) {
+		this.globalCommand.option(rawName, description, config);
+		return this;
+	}
+	help(callback) {
+		this.globalCommand.option("-h, --help", "Display this message");
+		this.globalCommand.helpCallback = callback;
+		this.showHelpOnExit = true;
+		return this;
+	}
+	version(version, customFlags = "-v, --version") {
+		this.globalCommand.version(version, customFlags);
+		this.showVersionOnExit = true;
+		return this;
+	}
+	example(example) {
+		this.globalCommand.example(example);
+		return this;
+	}
+	outputHelp() {
+		if (this.matchedCommand) this.matchedCommand.outputHelp();
+		else this.globalCommand.outputHelp();
+	}
+	outputVersion() {
+		this.globalCommand.outputVersion();
+	}
+	setParsedInfo({ args, options }, matchedCommand, matchedCommandName) {
+		this.args = args;
+		this.options = options;
+		if (matchedCommand) this.matchedCommand = matchedCommand;
+		if (matchedCommandName) this.matchedCommandName = matchedCommandName;
+		return this;
+	}
+	unsetMatchedCommand() {
+		this.matchedCommand = void 0;
+		this.matchedCommandName = void 0;
+	}
+	parse(argv = processArgs, { run = true } = {}) {
+		this.rawArgs = argv;
+		if (!this.name) this.name = argv[1] ? getFileName(argv[1]) : "cli";
+		let shouldParse = true;
+		for (const command of this.commands) {
+			const parsed = this.mri(argv.slice(2), command);
+			const commandName = parsed.args[0];
+			if (command.isMatched(commandName)) {
+				shouldParse = false;
+				const parsedInfo = __assign(__assign({}, parsed), { args: parsed.args.slice(1) });
+				this.setParsedInfo(parsedInfo, command, commandName);
+				this.emit(`command:${commandName}`, command);
+			}
+		}
+		if (shouldParse) {
+			for (const command of this.commands) if (command.name === "") {
+				shouldParse = false;
+				const parsed = this.mri(argv.slice(2), command);
+				this.setParsedInfo(parsed, command);
+				this.emit(`command:!`, command);
+			}
+		}
+		if (shouldParse) {
+			const parsed = this.mri(argv.slice(2));
+			this.setParsedInfo(parsed);
+		}
+		if (this.options.help && this.showHelpOnExit) {
+			this.outputHelp();
+			run = false;
+			this.unsetMatchedCommand();
+		}
+		if (this.options.version && this.showVersionOnExit && this.matchedCommandName == null) {
+			this.outputVersion();
+			run = false;
+			this.unsetMatchedCommand();
+		}
+		const parsedArgv = {
+			args: this.args,
+			options: this.options
+		};
+		if (run) this.runMatchedCommand();
+		if (!this.matchedCommand && this.args[0]) this.emit("command:*");
+		return parsedArgv;
+	}
+	mri(argv, command) {
+		const cliOptions = [...this.globalCommand.options, ...command ? command.options : []];
+		const mriOptions = getMriOptions(cliOptions);
+		let argsAfterDoubleDashes = [];
+		const doubleDashesIndex = argv.indexOf("--");
+		if (doubleDashesIndex > -1) {
+			argsAfterDoubleDashes = argv.slice(doubleDashesIndex + 1);
+			argv = argv.slice(0, doubleDashesIndex);
+		}
+		let parsed = mri2(argv, mriOptions);
+		parsed = Object.keys(parsed).reduce((res, name) => {
+			return __assign(__assign({}, res), { [camelcaseOptionName(name)]: parsed[name] });
+		}, { _: [] });
+		const args = parsed._;
+		const options = { "--": argsAfterDoubleDashes };
+		const ignoreDefault = command && command.config.ignoreOptionDefaultValue ? command.config.ignoreOptionDefaultValue : this.globalCommand.config.ignoreOptionDefaultValue;
+		let transforms = Object.create(null);
+		for (const cliOption of cliOptions) {
+			if (!ignoreDefault && cliOption.config.default !== void 0) for (const name of cliOption.names) options[name] = cliOption.config.default;
+			if (Array.isArray(cliOption.config.type)) {
+				if (transforms[cliOption.name] === void 0) {
+					transforms[cliOption.name] = Object.create(null);
+					transforms[cliOption.name]["shouldTransform"] = true;
+					transforms[cliOption.name]["transformFunction"] = cliOption.config.type[0];
+				}
+			}
+		}
+		for (const key of Object.keys(parsed)) if (key !== "_") {
+			setDotProp(options, key.split("."), parsed[key]);
+			setByType(options, transforms);
+		}
+		return {
+			args,
+			options
+		};
+	}
+	runMatchedCommand() {
+		const { args, options, matchedCommand: command } = this;
+		if (!command || !command.commandAction) return;
+		command.checkUnknownOptions();
+		command.checkOptionValue();
+		command.checkRequiredArgs();
+		const actionArgs = [];
+		command.args.forEach((arg, index) => {
+			if (arg.variadic) actionArgs.push(args.slice(index));
+			else actionArgs.push(args[index]);
+		});
+		actionArgs.push(options);
+		return command.commandAction.apply(this, actionArgs);
+	}
+};
+const cac = (name = "") => new CAC(name);
+//#endregion
 //#region src/cli/arguments/alias.ts
 const alias = {
 	config: {
@@ -32,27 +511,15 @@ const alias = {
 	format: { abbreviation: "f" },
 	name: { abbreviation: "n" },
 	globals: { abbreviation: "g" },
-	sourcemap: {
-		abbreviation: "s",
-		default: true
-	},
+	sourcemap: { abbreviation: "s" },
 	minify: { abbreviation: "m" },
 	platform: { abbreviation: "p" },
 	assetFileNames: { hint: "name" },
 	chunkFileNames: { hint: "name" },
 	entryFileNames: { hint: "name" },
-	externalLiveBindings: {
-		default: true,
-		reverse: true
-	},
-	treeshake: {
-		default: true,
-		reverse: true
-	},
-	preserveEntrySignatures: {
-		default: "strict",
-		reverse: true
-	},
+	externalLiveBindings: { reverse: true },
+	treeshake: { reverse: true },
+	preserveEntrySignatures: { reverse: true },
 	moduleTypes: { hint: "types" }
 };
 //#endregion
@@ -75,24 +542,17 @@ function setNestedProperty(obj, path, value) {
 function camelCaseToKebabCase(str) {
 	return str.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`);
 }
-function kebabCaseToCamelCase(str) {
-	return str.replace(/-./g, (match) => match[1].toUpperCase());
-}
 //#endregion
 //#region src/cli/arguments/normalize.ts
+const reservedKeys = new Set([
+	"help",
+	"version",
+	"config",
+	"watch",
+	"environment"
+]);
 function normalizeCliOptions(cliOptions, positionals) {
-	const prototypePollutionKeys = [
-		"__proto__",
-		"constructor",
-		"prototype"
-	];
-	const unflattenedCliOptions = {};
-	for (let [key, value] of Object.entries(cliOptions)) if (prototypePollutionKeys.includes(key)) {} else if (key.includes(".")) {
-		const [parentKey] = key.split(".");
-		unflattenedCliOptions[parentKey] ??= {};
-		setNestedProperty(unflattenedCliOptions, key, value);
-	} else unflattenedCliOptions[key] = value;
-	const [data, errors] = validateCliOptions(unflattenedCliOptions);
+	const [data, errors] = validateCliOptions(cliOptions);
 	if (errors?.length) {
 		errors.forEach((error) => {
 			logger.error(`${error}. You can use \`rolldown -h\` to see the help.`);
@@ -108,21 +568,15 @@ function normalizeCliOptions(cliOptions, positionals) {
 		watch: options.watch ?? false
 	};
 	if (typeof options.config === "string") result.config = options.config;
+	else if (options.config === true) result.config = "";
 	if (options.environment !== void 0) result.environment = options.environment;
-	const keysOfInput = getInputCliKeys();
-	const keysOfOutput = getOutputCliKeys();
-	const reservedKeys = [
-		"help",
-		"version",
-		"config",
-		"watch",
-		"environment"
-	];
+	const keysOfInput = new Set(getInputCliKeys());
+	const keysOfOutput = new Set(getOutputCliKeys());
 	for (let [key, value] of Object.entries(options)) {
 		const [primary] = key.split(".");
-		if (keysOfInput.includes(primary)) setNestedProperty(result.input, key, value);
-		else if (keysOfOutput.includes(primary)) setNestedProperty(result.output, key, value);
-		else if (!reservedKeys.includes(key)) {
+		if (keysOfInput.has(primary)) setNestedProperty(result.input, key, value);
+		else if (keysOfOutput.has(primary)) setNestedProperty(result.output, key, value);
+		else if (!reservedKeys.has(key)) {
 			logger.error(`Unknown option: ${key}`);
 			process.exit(1);
 		}
@@ -135,119 +589,99 @@ function normalizeCliOptions(cliOptions, positionals) {
 //#region src/cli/arguments/index.ts
 const schemaInfo = getCliSchemaInfo();
 const options = Object.fromEntries(Object.entries(schemaInfo).filter(([_key, info]) => info.type !== "never").map(([key, info]) => {
-	const config = Object.getOwnPropertyDescriptor(alias, key)?.value;
+	const config = alias[key];
+	let description = info?.description ?? config?.description ?? "";
+	if (config?.reverse) {
+		if (description.startsWith("enable")) description = description.replace("enable", "disable");
+		else if (!description.startsWith("Avoid")) description = `disable ${description}`;
+	}
 	const result = {
 		type: info.type === "boolean" ? "boolean" : "string",
-		description: info?.description ?? config?.description ?? "",
-		hint: config?.hint
+		description
 	};
-	if (config && config?.abbreviation) result.short = config?.abbreviation;
-	if (config && config.reverse) {
-		if (result.description.startsWith("enable")) result.description = result.description.replace("enable", "disable");
-		else if (!result.description.startsWith("Avoid")) result.description = `disable ${result.description}`;
-	}
-	key = camelCaseToKebabCase(key);
-	return [config?.reverse ? `no-${key}` : key, result];
+	if (config?.abbreviation) result.short = config.abbreviation;
+	if (config?.hint) result.hint = config.hint;
+	const kebabKey = camelCaseToKebabCase(key);
+	return [config?.reverse ? `no-${kebabKey}` : kebabKey, result];
 }));
+const knownKeys = new Set(Object.keys(schemaInfo));
+for (const key of Object.keys(schemaInfo)) {
+	const dotIdx = key.indexOf(".");
+	if (dotIdx > 0) knownKeys.add(key.substring(0, dotIdx));
+}
+const shortAliases = /* @__PURE__ */ new Set();
+for (const config of Object.values(alias)) if (config?.abbreviation) shortAliases.add(config.abbreviation);
 function parseCliArguments() {
-	const { values, tokens, positionals } = parseArgs({
-		options,
-		tokens: true,
-		allowPositionals: true,
-		strict: false
+	const cli = cac("rolldown");
+	for (const [key, info] of Object.entries(schemaInfo)) {
+		if (info.type === "never") continue;
+		const config = alias[key];
+		let rawName = "";
+		if (config?.abbreviation) rawName += `-${config.abbreviation}, `;
+		if (config?.reverse) rawName += `--no-${key}`;
+		else rawName += `--${key}`;
+		if (info.type !== "boolean" && !config?.reverse) if (config?.requireValue) rawName += ` <${config?.hint ?? key}>`;
+		else rawName += ` [${config?.hint ?? key}]`;
+		cli.option(rawName, info.description ?? config?.description ?? "");
+	}
+	let parsedInput = [];
+	let parsedOptions = {};
+	const cmd = cli.command("[...input]", "");
+	cmd.allowUnknownOptions();
+	cmd.ignoreOptionDefaultValue();
+	cmd.action((input, opts) => {
+		parsedInput = input;
+		parsedOptions = opts;
 	});
-	let invalid_options = tokens.filter((token) => token.kind === "option").map((option) => {
-		let negative = false;
-		if (option.name.startsWith("no-")) {
-			const name = kebabCaseToCamelCase(option.name.substring(3));
-			if (name in schemaInfo) {
-				delete values[option.name];
-				option.name = name;
-				negative = true;
-			}
+	try {
+		cli.parse(process.argv, { run: true });
+	} catch (err) {
+		if (err?.name === "CACError") {
+			const match = err.message.match(/option `(.+?)` value is missing/);
+			if (match) {
+				const optName = match[1].replace(/ [<[].*/, "").replace(/^-\w, /, "");
+				logger.error(`Option \`${optName}\` requires a value but none was provided.`);
+			} else logger.error(err.message);
+			process.exit(1);
 		}
-		delete values[option.name];
-		option.name = kebabCaseToCamelCase(option.name);
-		let originalInfo = schemaInfo[option.name];
-		if (!originalInfo) return {
-			name: option.name,
-			value: option.value
-		};
-		let type = originalInfo.type;
-		if (type === "string" && typeof option.value !== "string") {
-			let opt = option;
-			let config = Object.getOwnPropertyDescriptor(alias, opt.name)?.value;
-			if (config?.requireValue) {
-				logger.error(`Option \`--${camelCaseToKebabCase(opt.name)}\` requires a value but none was provided.`);
-				process.exit(1);
-			}
-			Object.defineProperty(values, opt.name, {
-				value: config?.default ?? "",
-				enumerable: true,
-				configurable: true,
-				writable: true
-			});
-		} else if (type === "object" && typeof option.value === "string") {
-			const pairs = option.value.split(",").map((x) => x.split("="));
-			if (!values[option.name]) Object.defineProperty(values, option.name, {
-				value: {},
-				enumerable: true,
-				configurable: true,
-				writable: true
-			});
-			for (const [key, value] of pairs) if (key && value) Object.defineProperty(values[option.name], key, {
-				value,
-				enumerable: true,
-				configurable: true,
-				writable: true
-			});
-		} else if (type === "array" && typeof option.value === "string") {
-			if (!values[option.name]) Object.defineProperty(values, option.name, {
-				value: [],
-				enumerable: true,
-				configurable: true,
-				writable: true
-			});
-			values[option.name].push(option.value);
-		} else if (type === "boolean") Object.defineProperty(values, option.name, {
-			value: !negative,
-			enumerable: true,
-			configurable: true,
-			writable: true
-		});
-		else if (type === "union") {
-			let defaultValue = Object.getOwnPropertyDescriptor(alias, option.name)?.value;
-			Object.defineProperty(values, option.name, {
-				value: option.value ?? defaultValue?.default ?? "",
-				enumerable: true,
-				configurable: true,
-				writable: true
-			});
-		} else Object.defineProperty(values, option.name, {
-			value: option.value ?? "",
-			enumerable: true,
-			configurable: true,
-			writable: true
-		});
-	}).filter((item) => {
-		return item !== void 0;
-	});
-	invalid_options.sort((a, b) => {
-		return a.name.localeCompare(b.name);
-	});
-	if (invalid_options.length !== 0) {
-		let single = invalid_options.length === 1;
-		logger.warn(`Option \`${invalid_options.map((item) => item.name).join(",")}\` ${single ? "is" : "are"} unrecognized. We will ignore ${single ? "this" : "those"} option${single ? "" : "s"}.`);
-	}
-	let rawArgs = {
-		...values,
-		...invalid_options.reduce((acc, cur) => {
-			acc[cur.name] = cur.value;
-			return acc;
-		}, Object.create(null))
-	};
+		throw err;
+	}
+	delete parsedOptions["--"];
+	for (const short of shortAliases) delete parsedOptions[short];
+	for (const key of Object.keys(parsedOptions)) if (key === "__proto__" || key === "constructor" || key === "prototype" || key.startsWith("__proto__.") || key.startsWith("constructor.") || key.startsWith("prototype.")) delete parsedOptions[key];
+	const unknownKeys = Object.keys(parsedOptions).filter((k) => !knownKeys.has(k));
+	if (unknownKeys.length > 0) {
+		unknownKeys.sort();
+		const single = unknownKeys.length === 1;
+		logger.warn(`Option \`${unknownKeys.join(",")}\` ${single ? "is" : "are"} unrecognized. We will ignore ${single ? "this" : "those"} option${single ? "" : "s"}.`);
+	}
+	const rawArgs = { ...parsedOptions };
+	for (const key of unknownKeys) delete parsedOptions[key];
+	for (const [key, value] of Object.entries(parsedOptions)) {
+		const type = schemaInfo[key]?.type;
+		if (Array.isArray(value)) {
+			if (type !== "array" && type !== "object") parsedOptions[key] = value[value.length - 1];
+		} else if (type === "array" && typeof value === "string") parsedOptions[key] = [value];
+	}
+	for (const [schemaKey, info] of Object.entries(schemaInfo)) {
+		if (info.type !== "object") continue;
+		const parts = schemaKey.split(".");
+		let parent = parsedOptions;
+		for (let i = 0; i < parts.length - 1; i++) parent = parent?.[parts[i]];
+		const leafKey = parts[parts.length - 1];
+		const value = parent?.[leafKey];
+		if (value === void 0) continue;
+		const values = Array.isArray(value) ? value : [value];
+		if (typeof values[0] !== "string") continue;
+		const result = {};
+		for (const v of values) for (const pair of String(v).split(",")) {
+			const [k, ...rest] = pair.split("=");
+			if (k && rest.length > 0) result[k] = rest.join("=");
+		}
+		parent[leafKey] = result;
+	}
 	return {
-		...normalizeCliOptions(values, positionals),
+		...normalizeCliOptions(parsedOptions, parsedInput),
 		rawArgs
 	};
 }
@@ -350,7 +784,7 @@ async function bundleWithCliOptions(cliOptions) {
 			process.exit(1);
 		}
 		for (const file of outputs) {
-			if (outputs.length > 1) logger.log(`\n${styleText$1(["cyan", "bold"], `|→ ${file.fileName}:`)}\n`);
+			if (outputs.length > 1) logger.log(`\n${styleText(["cyan", "bold"], `|→ ${file.fileName}:`)}\n`);
 			console.log(file.type === "asset" ? file.source : file.code);
 		}
 	} catch (_) {
@@ -390,12 +824,12 @@ async function watchInner(config, cliOptions) {
 				clearScreen?.();
 				break;
 			case "BUNDLE_START":
-				if (changedFile.length > 0) logger.log(`Found ${styleText$1("bold", changedFile.map(relativeId).join(", "))} changed, rebuilding...`);
+				if (changedFile.length > 0) logger.log(`Found ${styleText("bold", changedFile.map(relativeId).join(", "))} changed, rebuilding...`);
 				changedFile.length = 0;
 				break;
 			case "BUNDLE_END":
 				await event.result.close();
-				logger.success(`Rebuilt ${styleText$1("bold", relativeId(event.output[0]))} in ${styleText$1("green", ms(event.duration))}.`);
+				logger.success(`Rebuilt ${styleText("bold", relativeId(event.output[0]))} in ${styleText("green", ms(event.duration))}.`);
 				break;
 			case "ERROR":
 				await event.result.close();
@@ -428,7 +862,7 @@ async function bundleInner(config, cliOptions) {
 	result.forEach(printBundleOutputPretty);
 	logger.log(``);
 	const duration = performance.now() - startTime;
-	logger.success(`rolldown v${version} Finished in ${styleText$1("green", ms(duration))}`);
+	logger.success(`rolldown v${version} Finished in ${styleText("green", ms(duration))}`);
 }
 function printBundleOutputPretty(output) {
 	const outputEntries = collectOutputEntries(output.output);
@@ -474,10 +908,10 @@ function printOutputEntries(entries, sizeAdjustment, distPath) {
 		const filtered = entries.filter((e) => e.type === group.type);
 		if (!filtered.length) continue;
 		for (const entry of filtered.sort((a, z) => a.size - z.size)) {
-			let log = styleText$1("dim", withTrailingSlash(distPath));
-			log += styleText$1(group.color, entry.fileName.padEnd(sizeAdjustment.longest + 2));
-			log += styleText$1("dim", entry.type);
-			log += styleText$1("dim", ` │ size: ${displaySize(entry.size).padStart(sizeAdjustment.sizePad)}`);
+			let log = styleText("dim", withTrailingSlash(distPath));
+			log += styleText(group.color, entry.fileName.padEnd(sizeAdjustment.longest + 2));
+			log += styleText("dim", entry.type);
+			log += styleText("dim", ` │ size: ${displaySize(entry.size).padStart(sizeAdjustment.sizePad)}`);
 			logger.log(log);
 		}
 	}
@@ -517,22 +951,17 @@ const examples = [
 		command: "rolldown src/main.ts -d dist -n bundle -f iife -e jQuery,window._ -g jQuery=$"
 	}
 ];
-const notes = [
-	"Due to the API limitation, you need to pass `-s` for `.map` sourcemap file as the last argument.",
-	"If you are using the configuration, please pass the `-c` as the last argument if you ignore the default configuration file.",
-	"CLI options will override the configuration file.",
-	"For more information, please visit https://rolldown.rs/."
-];
+const notes = ["CLI options will override the configuration file.", "For more information, please visit https://rolldown.rs/."];
 /**
 * Generates the CLI help text as a string.
 */
 function generateHelpText() {
 	const lines = [];
-	lines.push(`${styleText$1("gray", `${description} (rolldown v${version})`)}`);
+	lines.push(`${styleText("gray", `${description} (rolldown v${version})`)}`);
 	lines.push("");
-	lines.push(`${styleText$1(["bold", "underline"], "USAGE")} ${styleText$1("cyan", "rolldown -c <config>")} or ${styleText$1("cyan", "rolldown <input> <options>")}`);
+	lines.push(`${styleText(["bold", "underline"], "USAGE")} ${styleText("cyan", "rolldown -c <config>")} or ${styleText("cyan", "rolldown <input> <options>")}`);
 	lines.push("");
-	lines.push(`${styleText$1(["bold", "underline"], "OPTIONS")}`);
+	lines.push(`${styleText(["bold", "underline"], "OPTIONS")}`);
 	lines.push("");
 	lines.push(Object.entries(options).sort(([a], [b]) => {
 		if (options[a].short && !options[b].short) return -1;
@@ -545,20 +974,20 @@ function generateHelpText() {
 		if (short) optionStr += `-${short}, `;
 		if (type === "string") optionStr += `<${hint ?? option}>`;
 		if (description && description.length > 0) description = description[0].toUpperCase() + description.slice(1);
-		return styleText$1("cyan", optionStr.padEnd(30)) + description + (description && description?.endsWith(".") ? "" : ".");
+		return styleText("cyan", optionStr.padEnd(30)) + description + (description && description?.endsWith(".") ? "" : ".");
 	}).join("\n"));
 	lines.push("");
-	lines.push(`${styleText$1(["bold", "underline"], "EXAMPLES")}`);
+	lines.push(`${styleText(["bold", "underline"], "EXAMPLES")}`);
 	lines.push("");
 	examples.forEach(({ title, command }, ord) => {
 		lines.push(`  ${ord + 1}. ${title}:`);
-		lines.push(`    ${styleText$1("cyan", command)}`);
+		lines.push(`    ${styleText("cyan", command)}`);
 		lines.push("");
 	});
-	lines.push(`${styleText$1(["bold", "underline"], "NOTES")}`);
+	lines.push(`${styleText(["bold", "underline"], "NOTES")}`);
 	lines.push("");
 	notes.forEach((note) => {
-		lines.push(`  * ${styleText$1("gray", note)}`);
+		lines.push(`  * ${styleText("gray", note)}`);
 	});
 	return lines.join("\n");
 }
@@ -585,6 +1014,14 @@ async function main() {
 			process$1.env[key] = value.length === 0 ? String(true) : value.join(":");
 		}
 	}
+	if (cliOptions.help) {
+		showHelp();
+		return;
+	}
+	if (cliOptions.version) {
+		logger.log(`rolldown v${version}`);
+		return;
+	}
 	if (cliOptions.config || cliOptions.config === "") {
 		await bundleWithConfig(cliOptions.config, cliOptions, rawArgs);
 		return;
@@ -593,10 +1030,6 @@ async function main() {
 		await bundleWithCliOptions(cliOptions);
 		return;
 	}
-	if (cliOptions.version) {
-		logger.log(`rolldown v${version}`);
-		return;
-	}
 	showHelp();
 }
 main().catch((err) => {

package/dist/config.d.mts

@@ -1,4 +1,4 @@
-import { et as VERSION, r as defineConfig, t as ConfigExport } from "./shared/define-config-Cci3IvO_.mjs";
+import { et as VERSION, r as defineConfig, t as ConfigExport } from "./shared/define-config-TEoV5q6D.mjs";
 
 //#region src/utils/load-config.d.ts
 /**

package/dist/config.mjs

@@ -1,9 +1,9 @@
 import "./shared/normalize-string-or-regex-CF3Uz6aU.mjs";
-import { b as VERSION } from "./shared/bindingify-input-options-kCVufQp0.mjs";
-import "./shared/rolldown-build-8_xyZuDH.mjs";
+import { b as VERSION } from "./shared/bindingify-input-options-CxjTlvCV.mjs";
+import "./shared/rolldown-build-D_FXM8pA.mjs";
 import "./shared/error-CQ6njWsV.mjs";
 import "./shared/parse-DDUnGYGU.mjs";
-import "./shared/rolldown-C9kn7lTZ.mjs";
+import "./shared/rolldown-D2p2QuF1.mjs";
 import { t as defineConfig } from "./shared/define-config-DJOr6Iwt.mjs";
-import { t as loadConfig } from "./shared/load-config-DNGVjxdv.mjs";
+import { t as loadConfig } from "./shared/load-config-Cs9h9aXF.mjs";
 export { VERSION, defineConfig, loadConfig };

package/dist/experimental-index.browser.mjs

@@ -1,5 +1,5 @@
 import { n as BuiltinPlugin, t as normalizedStringOrRegex } from "./normalize-string-or-regex-TtAGUp42.js";
-import { a as PluginDriver, i as validateOption, n as createBundlerOptions, r as transformToRollupOutput, t as RolldownBuild } from "./rolldown-build-D97C-VhN.js";
+import { a as PluginDriver, i as validateOption, n as createBundlerOptions, r as transformToRollupOutput, t as RolldownBuild } from "./rolldown-build-Clh1p2eh.js";
 import { a as parse$2, i as unwrapBindingResult, o as parseSync$2, r as normalizeBindingResult } from "./error-DkAP_6fk.js";
 import { a as viteImportGlobPlugin, c as viteModulePreloadPolyfillPlugin, d as viteResolvePlugin, f as viteWasmFallbackPlugin, i as viteDynamicImportVarsPlugin, l as viteReactRefreshWrapperPlugin, n as isolatedDeclarationPlugin, o as viteJsonPlugin, p as viteWebWorkerPostPlugin, r as viteBuildImportAnalysisPlugin, s as viteLoadFallbackPlugin, u as viteReporterPlugin } from "./constructors-BgL_dmUe.js";
 import { a as minifySync$2, i as minify$2, n as transform$1, r as transformSync$1, t as TsconfigCache$1 } from "./transform-UkHb5h4g.js";

package/dist/experimental-index.d.mts

@@ -1,4 +1,4 @@
-import { Et as NormalizedOutputOptions, c as InputOptions, ht as defineParallelPlugin, ln as freeExternalMemory, sn as RolldownOutput, tn as OutputOptions } from "./shared/define-config-Cci3IvO_.mjs";
+import { Et as NormalizedOutputOptions, c as InputOptions, ht as defineParallelPlugin, ln as freeExternalMemory, sn as RolldownOutput, tn as OutputOptions } from "./shared/define-config-TEoV5q6D.mjs";
 import { t as BuiltinPlugin } from "./shared/utils-6wxe_LMG.mjs";
 import { a as viteImportGlobPlugin, c as viteModulePreloadPolyfillPlugin, d as viteResolvePlugin, f as viteWasmFallbackPlugin, i as viteDynamicImportVarsPlugin, l as viteReactRefreshWrapperPlugin, n as isolatedDeclarationPlugin, o as viteJsonPlugin, p as viteWebWorkerPostPlugin, r as viteBuildImportAnalysisPlugin, s as viteLoadFallbackPlugin, u as viteReporterPlugin } from "./shared/constructors-C1tQjDsj.mjs";
 import { a as TsconfigRawOptions$1, c as MinifyOptions$2, d as minifySync$1, f as ParseResult$3, h as parseSync$1, i as TsconfigCompilerOptions$1, l as MinifyResult$2, m as parse$1, n as TransformResult$1, o as transform$1, p as ParserOptions$3, r as TsconfigCache$1, s as transformSync$1, t as TransformOptions$2, u as minify$1 } from "./shared/transform-BSAGL1b_.mjs";

package/dist/experimental-index.mjs

@@ -1,6 +1,6 @@
 import { n as BuiltinPlugin, t as normalizedStringOrRegex } from "./shared/normalize-string-or-regex-CF3Uz6aU.mjs";
-import { a as transformToRollupOutput } from "./shared/bindingify-input-options-kCVufQp0.mjs";
-import { c as validateOption, n as createBundlerOptions, t as RolldownBuild, u as PluginDriver } from "./shared/rolldown-build-8_xyZuDH.mjs";
+import { a as transformToRollupOutput } from "./shared/bindingify-input-options-CxjTlvCV.mjs";
+import { c as validateOption, n as createBundlerOptions, t as RolldownBuild, u as PluginDriver } from "./shared/rolldown-build-D_FXM8pA.mjs";
 import { i as unwrapBindingResult, r as normalizeBindingResult } from "./shared/error-CQ6njWsV.mjs";
 import { n as parseSync$2, t as parse$2 } from "./shared/parse-DDUnGYGU.mjs";
 import { a as viteImportGlobPlugin, c as viteModulePreloadPolyfillPlugin, d as viteResolvePlugin, f as viteWasmFallbackPlugin, i as viteDynamicImportVarsPlugin, l as viteReactRefreshWrapperPlugin, n as isolatedDeclarationPlugin, o as viteJsonPlugin, p as viteWebWorkerPostPlugin, r as viteBuildImportAnalysisPlugin, s as viteLoadFallbackPlugin, u as viteReporterPlugin } from "./shared/constructors-C7Kkidxk.mjs";

package/dist/filter-index.d.mts

@@ -1,4 +1,4 @@
-import { B as exprInterpreter, F as QueryFilterObject, G as interpreterImpl, H as importerId, I as TopLevelFilterExpression, J as or, K as moduleType, L as and, M as withFilter, N as FilterExpression, P as FilterExpressionKind, R as code, U as include, V as id, W as interpreter, X as query, Y as queries, q as not, z as exclude } from "./shared/define-config-Cci3IvO_.mjs";
+import { B as exprInterpreter, F as QueryFilterObject, G as interpreterImpl, H as importerId, I as TopLevelFilterExpression, J as or, K as moduleType, L as and, M as withFilter, N as FilterExpression, P as FilterExpressionKind, R as code, U as include, V as id, W as interpreter, X as query, Y as queries, q as not, z as exclude } from "./shared/define-config-TEoV5q6D.mjs";
 
 //#region ../pluginutils/dist/filter/filter-vite-plugins.d.ts
 /**

package/dist/index.browser.mjs

@@ -1,5 +1,5 @@
 import { d as logMultipleWatcherOption } from "./normalize-string-or-regex-TtAGUp42.js";
-import { a as PluginDriver, c as RUNTIME_MODULE_ID, i as validateOption, l as VERSION, n as createBundlerOptions, o as LOG_LEVEL_WARN, s as arraify, t as RolldownBuild } from "./rolldown-build-D97C-VhN.js";
+import { a as PluginDriver, c as RUNTIME_MODULE_ID, i as validateOption, l as VERSION, n as createBundlerOptions, o as LOG_LEVEL_WARN, s as arraify, t as RolldownBuild } from "./rolldown-build-Clh1p2eh.js";
 import { t as aggregateBindingErrorsIntoJsError } from "./error-DkAP_6fk.js";
 import { BindingMagicString, BindingWatcher, shutdownAsyncRuntime } from "./rolldown-binding.wasi-browser.js";
 //#region src/api/rolldown/index.ts

package/dist/index.d.mts

@@ -1,4 +1,4 @@
 import { a as RolldownLog, i as RolldownError, n as LogLevelOption, o as RolldownLogWithString, r as LogOrStringHandler, t as LogLevel } from "./shared/logging-C6h4g8dA.mjs";
-import { $ as RUNTIME_MODULE_ID, $t as MinifyOptions, A as SourceDescription, At as LoggingFunction, Bt as build, C as PartialResolvedId, Ct as RolldownFileStats, D as ResolvedId, Dt as NormalizedInputOptions, E as ResolveIdResult, Et as NormalizedOutputOptions, Ft as RolldownWatcherWatcherEventMap, Gt as ChunkingContext, Ht as AdvancedChunksGroup, It as WatchOptions, Jt as CodeSplittingOptions, Kt as CodeSplittingGroup, Lt as rolldown, Mt as watch, Nt as RolldownWatcher, O as RolldownPlugin, Ot as TransformOptions, Pt as RolldownWatcherEvent, Q as PreRenderedChunk, Qt as GlobalsFunction, Rt as RolldownBuild, S as ParallelPluginHooks, St as RolldownDirectoryEntry, T as ResolveIdExtraOptions, Tt as InternalModuleFormat, Ut as AdvancedChunksOptions, Vt as AddonFunction, Wt as ChunkFileNamesFunction, Xt as GeneratedCodeOptions, Yt as CommentsOptions, Z as BindingMagicString, Zt as GeneratedCodePreset, _ as ImportKind, _t as PluginContextMeta, a as ExternalOption, an as RenderedChunk, at as TreeshakingOptions, b as ModuleType, bt as ModuleTypeFilter, c as InputOptions, cn as SourceMap, ct as EmittedChunk, d as WatcherFileWatcherOptions, dn as SourcemapIgnoreListOption, dt as GetModuleInfo, en as ModuleFormat, et as VERSION, f as WatcherOptions, ft as PluginContext, g as HookFilterExtension, gt as MinimalPluginContext, h as FunctionPluginHooks, i as RolldownOptions, in as OutputChunk, it as OutputBundle, j as TransformResult, jt as WarningHandlerWithDefault, k as RolldownPluginOption, kt as ChecksOptions, l as ModuleTypes, lt as EmittedFile, m as CustomPluginOptions, mt as DefineParallelPluginResult, n as RolldownOptionsFunction, nn as PreRenderedAsset, nt as ExistingRawSourceMap, o as ExternalOptionFunction, on as RenderedModule, ot as TransformPluginContext, p as AsyncPluginHooks, pt as PluginContextResolveOptions, qt as CodeSplittingNameFunction, r as defineConfig, rn as OutputAsset, rt as SourceMapInput, s as InputOption, sn as RolldownOutput, st as EmittedAsset, t as ConfigExport, tn as OutputOptions, tt as BundleError, u as OptimizationOptions, un as ModuleInfo, ut as EmittedPrebuiltChunk, v as LoadResult, vt as GeneralHookFilter, w as Plugin, wt as RolldownFsModule, x as ObjectHook, xt as BufferEncoding, y as ModuleOptions, yt as HookFilter, zt as BuildOptions } from "./shared/define-config-Cci3IvO_.mjs";
+import { $ as RUNTIME_MODULE_ID, $t as MinifyOptions, A as SourceDescription, At as LoggingFunction, Bt as build, C as PartialResolvedId, Ct as RolldownFileStats, D as ResolvedId, Dt as NormalizedInputOptions, E as ResolveIdResult, Et as NormalizedOutputOptions, Ft as RolldownWatcherWatcherEventMap, Gt as ChunkingContext, Ht as AdvancedChunksGroup, It as WatchOptions, Jt as CodeSplittingOptions, Kt as CodeSplittingGroup, Lt as rolldown, Mt as watch, Nt as RolldownWatcher, O as RolldownPlugin, Ot as TransformOptions, Pt as RolldownWatcherEvent, Q as PreRenderedChunk, Qt as GlobalsFunction, Rt as RolldownBuild, S as ParallelPluginHooks, St as RolldownDirectoryEntry, T as ResolveIdExtraOptions, Tt as InternalModuleFormat, Ut as AdvancedChunksOptions, Vt as AddonFunction, Wt as ChunkFileNamesFunction, Xt as GeneratedCodeOptions, Yt as CommentsOptions, Z as BindingMagicString, Zt as GeneratedCodePreset, _ as ImportKind, _t as PluginContextMeta, a as ExternalOption, an as RenderedChunk, at as TreeshakingOptions, b as ModuleType, bt as ModuleTypeFilter, c as InputOptions, cn as SourceMap, ct as EmittedChunk, d as WatcherFileWatcherOptions, dn as SourcemapIgnoreListOption, dt as GetModuleInfo, en as ModuleFormat, et as VERSION, f as WatcherOptions, ft as PluginContext, g as HookFilterExtension, gt as MinimalPluginContext, h as FunctionPluginHooks, i as RolldownOptions, in as OutputChunk, it as OutputBundle, j as TransformResult, jt as WarningHandlerWithDefault, k as RolldownPluginOption, kt as ChecksOptions, l as ModuleTypes, lt as EmittedFile, m as CustomPluginOptions, mt as DefineParallelPluginResult, n as RolldownOptionsFunction, nn as PreRenderedAsset, nt as ExistingRawSourceMap, o as ExternalOptionFunction, on as RenderedModule, ot as TransformPluginContext, p as AsyncPluginHooks, pt as PluginContextResolveOptions, qt as CodeSplittingNameFunction, r as defineConfig, rn as OutputAsset, rt as SourceMapInput, s as InputOption, sn as RolldownOutput, st as EmittedAsset, t as ConfigExport, tn as OutputOptions, tt as BundleError, u as OptimizationOptions, un as ModuleInfo, ut as EmittedPrebuiltChunk, v as LoadResult, vt as GeneralHookFilter, w as Plugin, wt as RolldownFsModule, x as ObjectHook, xt as BufferEncoding, y as ModuleOptions, yt as HookFilter, zt as BuildOptions } from "./shared/define-config-TEoV5q6D.mjs";
 import { o as PartialNull } from "./shared/utils-6wxe_LMG.mjs";
 export { AddonFunction, AdvancedChunksGroup, AdvancedChunksOptions, AsyncPluginHooks, BindingMagicString, BufferEncoding, BuildOptions, BundleError, ChecksOptions, ChunkFileNamesFunction, ChunkingContext, CodeSplittingGroup, CodeSplittingNameFunction, CodeSplittingOptions, CommentsOptions, ConfigExport, CustomPluginOptions, DefineParallelPluginResult, EmittedAsset, EmittedChunk, EmittedFile, EmittedPrebuiltChunk, ExistingRawSourceMap, ExternalOption, ExternalOptionFunction, FunctionPluginHooks, GeneralHookFilter, GeneratedCodeOptions, GeneratedCodePreset, GetModuleInfo, GlobalsFunction, HookFilter, HookFilterExtension, ImportKind, InputOption, InputOptions, InternalModuleFormat, LoadResult, LogLevel, LogLevelOption, LogOrStringHandler, LoggingFunction, MinifyOptions, MinimalPluginContext, ModuleFormat, ModuleInfo, ModuleOptions, ModuleType, ModuleTypeFilter, ModuleTypes, NormalizedInputOptions, NormalizedOutputOptions, ObjectHook, OptimizationOptions, OutputAsset, OutputBundle, OutputChunk, OutputOptions, ParallelPluginHooks, PartialNull, PartialResolvedId, Plugin, PluginContext, PluginContextMeta, PluginContextResolveOptions, PreRenderedAsset, PreRenderedChunk, RUNTIME_MODULE_ID, RenderedChunk, RenderedModule, ResolveIdExtraOptions, ResolveIdResult, ResolvedId, RolldownBuild, RolldownDirectoryEntry, RolldownError, RolldownError as RollupError, RolldownFileStats, RolldownFsModule, RolldownLog, RolldownLog as RollupLog, RolldownLogWithString, RolldownLogWithString as RollupLogWithString, RolldownOptions, RolldownOptionsFunction, RolldownOutput, RolldownPlugin, RolldownPluginOption, RolldownWatcher, RolldownWatcherEvent, RolldownWatcherWatcherEventMap, SourceDescription, SourceMap, SourceMapInput, SourcemapIgnoreListOption, TransformOptions, TransformPluginContext, TransformResult, TreeshakingOptions, VERSION, WarningHandlerWithDefault, WatchOptions, WatcherFileWatcherOptions, WatcherOptions, build, defineConfig, rolldown, watch };

package/dist/index.mjs

@@ -1,10 +1,10 @@
-import { n as onExit, t as watch } from "./shared/watch-dCFQWE8a.mjs";
+import { n as onExit, t as watch } from "./shared/watch-BMFUc4Au.mjs";
 import "./shared/normalize-string-or-regex-CF3Uz6aU.mjs";
-import { b as VERSION, y as RUNTIME_MODULE_ID } from "./shared/bindingify-input-options-kCVufQp0.mjs";
-import "./shared/rolldown-build-8_xyZuDH.mjs";
+import { b as VERSION, y as RUNTIME_MODULE_ID } from "./shared/bindingify-input-options-CxjTlvCV.mjs";
+import "./shared/rolldown-build-D_FXM8pA.mjs";
 import "./shared/error-CQ6njWsV.mjs";
 import "./shared/parse-DDUnGYGU.mjs";
-import { t as rolldown } from "./shared/rolldown-C9kn7lTZ.mjs";
+import { t as rolldown } from "./shared/rolldown-D2p2QuF1.mjs";
 import { t as defineConfig } from "./shared/define-config-DJOr6Iwt.mjs";
 import { isMainThread } from "node:worker_threads";
 import { BindingMagicString, initTraceSubscriber } from "./rolldown-binding.wasi.cjs";

package/dist/parallel-plugin-worker.mjs

@@ -1,5 +1,5 @@
 import "./shared/normalize-string-or-regex-CF3Uz6aU.mjs";
-import { n as PluginContextData, r as bindingifyPlugin } from "./shared/bindingify-input-options-kCVufQp0.mjs";
+import { n as PluginContextData, r as bindingifyPlugin } from "./shared/bindingify-input-options-CxjTlvCV.mjs";
 import "./shared/error-CQ6njWsV.mjs";
 import "./shared/parse-DDUnGYGU.mjs";
 import { parentPort, workerData } from "node:worker_threads";

package/dist/parallel-plugin.d.mts

@@ -1,4 +1,4 @@
-import { w as Plugin } from "./shared/define-config-Cci3IvO_.mjs";
+import { w as Plugin } from "./shared/define-config-TEoV5q6D.mjs";
 import { i as MaybePromise } from "./shared/utils-6wxe_LMG.mjs";
 
 //#region src/plugin/parallel-plugin-implementation.d.ts

package/dist/{rolldown-build-D97C-VhN.js → rolldown-build-Clh1p2eh.js}

@@ -454,7 +454,7 @@ const win32 = /* @__PURE__ */ mix(";");
 *
 * @category Plugin APIs
 */
-const VERSION = "1.0.0-rc.7";
+const VERSION = "1.0.0-rc.8";
 //#endregion
 //#region src/constants/index.ts
 /**
@@ -1964,7 +1964,10 @@ isTypeTrue();
 const WatcherFileWatcherOptionsSchema = /* @__PURE__ */ strictObject({
 	usePolling: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ boolean()), /* @__PURE__ */ description("Use polling-based file watching instead of native OS events")),
 	pollInterval: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ number()), /* @__PURE__ */ description("Poll interval in milliseconds (only used when usePolling is true)")),
-	compareContentsForPolling: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ boolean()), /* @__PURE__ */ description("Compare file contents for poll-based watchers (only used when usePolling is true)"))
+	compareContentsForPolling: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ boolean()), /* @__PURE__ */ description("Compare file contents for poll-based watchers (only used when usePolling is true)")),
+	useDebounce: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ boolean()), /* @__PURE__ */ description("Use debounced event delivery at the filesystem level")),
+	debounceDelay: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ number()), /* @__PURE__ */ description("Debounce delay in milliseconds (only used when useDebounce is true)")),
+	debounceTickRate: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ number()), /* @__PURE__ */ description("Tick rate in milliseconds for debouncer (only used when useDebounce is true)"))
 });
 const WatcherOptionsSchema = /* @__PURE__ */ strictObject({
 	chokidar: /* @__PURE__ */ optional(/* @__PURE__ */ never(`The "watch.chokidar" option is deprecated, please use "watch.watcher" instead of it`)),
@@ -2255,7 +2258,7 @@ const OutputOptionsSchema = /* @__PURE__ */ strictObject({
 		/* @__PURE__ */ boolean(),
 		/* @__PURE__ */ literal("inline"),
 		/* @__PURE__ */ literal("hidden")
-	])), /* @__PURE__ */ description(`Generate sourcemap (\`-s inline\` for inline, or ${styleText("bold", "pass the `-s` on the last argument if you want to generate `.map` file")})`)),
+	])), /* @__PURE__ */ description(`Generate sourcemap (\`-s inline\` for inline, or \`-s\` for \`.map\` file)`)),
 	sourcemapBaseUrl: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ string()), /* @__PURE__ */ description("Base URL used to prefix sourcemap paths")),
 	sourcemapDebugIds: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ boolean()), /* @__PURE__ */ description("Inject sourcemap debug IDs")),
 	sourcemapIgnoreList: /* @__PURE__ */ optional(/* @__PURE__ */ union([
@@ -4524,6 +4527,9 @@ function bindingifyWatch(watch) {
 			usePolling: watcher.usePolling,
 			pollInterval: watcher.pollInterval,
 			compareContentsForPolling: watcher.compareContentsForPolling,
+			useDebounce: watcher.useDebounce,
+			debounceDelay: watcher.debounceDelay,
+			debounceTickRate: watcher.debounceTickRate,
 			include: normalizedStringOrRegex(watch.include),
 			exclude: normalizedStringOrRegex(watch.exclude),
 			onInvalidate: (...args) => watch.onInvalidate?.(...args)

package/dist/shared/{bindingify-input-options-kCVufQp0.mjs → bindingify-input-options-CxjTlvCV.mjs}

@@ -7,7 +7,7 @@ import { BindingAttachDebugInfo, BindingChunkModuleOrderBy, BindingLogLevel, Bin
 import path from "node:path";
 import fsp from "node:fs/promises";
 //#region package.json
-var version = "1.0.0-rc.7";
+var version = "1.0.0-rc.8";
 var description = "Fast JavaScript/TypeScript bundler in Rust with Rollup-compatible API.";
 //#endregion
 //#region src/constants/version.ts
@@ -2084,6 +2084,9 @@ function bindingifyWatch(watch) {
 			usePolling: watcher.usePolling,
 			pollInterval: watcher.pollInterval,
 			compareContentsForPolling: watcher.compareContentsForPolling,
+			useDebounce: watcher.useDebounce,
+			debounceDelay: watcher.debounceDelay,
+			debounceTickRate: watcher.debounceTickRate,
 			include: normalizedStringOrRegex(watch.include),
 			exclude: normalizedStringOrRegex(watch.exclude),
 			onInvalidate: (...args) => watch.onInvalidate?.(...args)

package/dist/shared/{define-config-Cci3IvO_.d.mts → define-config-TEoV5q6D.d.mts}

@@ -3119,6 +3119,24 @@ interface WatcherFileWatcherOptions {
   * @default false
   */
   compareContentsForPolling?: boolean;
+  /**
+  * Whether to use debounced event delivery at the filesystem level.
+  * This coalesces rapid filesystem events before they reach the build coordinator.
+  * @default false
+  */
+  useDebounce?: boolean;
+  /**
+  * Debounce delay in milliseconds for fs-level debounced watchers.
+  * Only used when {@linkcode useDebounce} is `true`.
+  * @default 10
+  */
+  debounceDelay?: number;
+  /**
+  * Tick rate in milliseconds for the debouncer's internal polling.
+  * Only used when {@linkcode useDebounce} is `true`.
+  * When undefined, auto-selects 1/4 of debounceDelay.
+  */
+  debounceTickRate?: number;
 }
 interface WatcherOptions {
   /**

package/dist/shared/{load-config-DNGVjxdv.mjs → load-config-Cs9h9aXF.mjs}

@@ -1,4 +1,4 @@
-import { t as rolldown } from "./rolldown-C9kn7lTZ.mjs";
+import { t as rolldown } from "./rolldown-D2p2QuF1.mjs";
 import path from "node:path";
 import { readdir } from "node:fs/promises";
 import { cwd } from "node:process";

package/dist/shared/{rolldown-C9kn7lTZ.mjs → rolldown-D2p2QuF1.mjs}

@@ -1,4 +1,4 @@
-import { c as validateOption, t as RolldownBuild, u as PluginDriver } from "./rolldown-build-8_xyZuDH.mjs";
+import { c as validateOption, t as RolldownBuild, u as PluginDriver } from "./rolldown-build-D_FXM8pA.mjs";
 //#region src/api/rolldown/index.ts
 /**
 * The API compatible with Rollup's `rollup` function.

package/dist/shared/{rolldown-build-8_xyZuDH.mjs → rolldown-build-D_FXM8pA.mjs}

@@ -1,6 +1,6 @@
 import { i as logInputHookInOutputPlugin, n as error } from "./logs-D80CXhvg.mjs";
 import { n as BuiltinPlugin } from "./normalize-string-or-regex-CF3Uz6aU.mjs";
-import { _ as LOG_LEVEL_WARN, a as transformToRollupOutput, b as VERSION, c as transformAssetSource, d as MinimalPluginContextImpl, f as normalizeHook, i as transformModuleInfo, l as lazyProp, m as LOG_LEVEL_DEBUG, o as transformRenderedChunk, p as normalizeLog, s as __decorate, t as bindingifyInputOptions, u as PlainObjectLike, v as logLevelPriority } from "./bindingify-input-options-kCVufQp0.mjs";
+import { _ as LOG_LEVEL_WARN, a as transformToRollupOutput, b as VERSION, c as transformAssetSource, d as MinimalPluginContextImpl, f as normalizeHook, i as transformModuleInfo, l as lazyProp, m as LOG_LEVEL_DEBUG, o as transformRenderedChunk, p as normalizeLog, s as __decorate, t as bindingifyInputOptions, u as PlainObjectLike, v as logLevelPriority } from "./bindingify-input-options-CxjTlvCV.mjs";
 import { v as unimplemented } from "./composable-filters-B2ByPP8y.mjs";
 import { i as unwrapBindingResult } from "./error-CQ6njWsV.mjs";
 import { Worker } from "node:worker_threads";
@@ -1521,7 +1521,10 @@ isTypeTrue();
 const WatcherFileWatcherOptionsSchema = /* @__PURE__ */ strictObject({
 	usePolling: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ boolean()), /* @__PURE__ */ description("Use polling-based file watching instead of native OS events")),
 	pollInterval: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ number()), /* @__PURE__ */ description("Poll interval in milliseconds (only used when usePolling is true)")),
-	compareContentsForPolling: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ boolean()), /* @__PURE__ */ description("Compare file contents for poll-based watchers (only used when usePolling is true)"))
+	compareContentsForPolling: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ boolean()), /* @__PURE__ */ description("Compare file contents for poll-based watchers (only used when usePolling is true)")),
+	useDebounce: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ boolean()), /* @__PURE__ */ description("Use debounced event delivery at the filesystem level")),
+	debounceDelay: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ number()), /* @__PURE__ */ description("Debounce delay in milliseconds (only used when useDebounce is true)")),
+	debounceTickRate: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ number()), /* @__PURE__ */ description("Tick rate in milliseconds for debouncer (only used when useDebounce is true)"))
 });
 const WatcherOptionsSchema = /* @__PURE__ */ strictObject({
 	chokidar: /* @__PURE__ */ optional(/* @__PURE__ */ never(`The "watch.chokidar" option is deprecated, please use "watch.watcher" instead of it`)),
@@ -1812,7 +1815,7 @@ const OutputOptionsSchema = /* @__PURE__ */ strictObject({
 		/* @__PURE__ */ boolean(),
 		/* @__PURE__ */ literal("inline"),
 		/* @__PURE__ */ literal("hidden")
-	])), /* @__PURE__ */ description(`Generate sourcemap (\`-s inline\` for inline, or ${styleText$1("bold", "pass the `-s` on the last argument if you want to generate `.map` file")})`)),
+	])), /* @__PURE__ */ description(`Generate sourcemap (\`-s inline\` for inline, or \`-s\` for \`.map\` file)`)),
 	sourcemapBaseUrl: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ string()), /* @__PURE__ */ description("Base URL used to prefix sourcemap paths")),
 	sourcemapDebugIds: /* @__PURE__ */ pipe(/* @__PURE__ */ optional(/* @__PURE__ */ boolean()), /* @__PURE__ */ description("Inject sourcemap debug IDs")),
 	sourcemapIgnoreList: /* @__PURE__ */ optional(/* @__PURE__ */ union([

package/dist/shared/{watch-dCFQWE8a.mjs → watch-BMFUc4Au.mjs}

@@ -1,7 +1,7 @@
 import { o as logMultipleWatcherOption } from "./logs-D80CXhvg.mjs";
-import { _ as LOG_LEVEL_WARN } from "./bindingify-input-options-kCVufQp0.mjs";
+import { _ as LOG_LEVEL_WARN } from "./bindingify-input-options-CxjTlvCV.mjs";
 import { h as arraify } from "./composable-filters-B2ByPP8y.mjs";
-import { n as createBundlerOptions, u as PluginDriver } from "./rolldown-build-8_xyZuDH.mjs";
+import { n as createBundlerOptions, u as PluginDriver } from "./rolldown-build-D_FXM8pA.mjs";
 import { t as aggregateBindingErrorsIntoJsError } from "./error-CQ6njWsV.mjs";
 import { BindingWatcher, shutdownAsyncRuntime } from "../rolldown-binding.wasi.cjs";
 //#region ../../node_modules/.pnpm/signal-exit@4.1.0/node_modules/signal-exit/dist/mjs/signals.js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rolldown/browser",
-  "version": "1.0.0-rc.7",
+  "version": "1.0.0-rc.8",
   "description": "Fast JavaScript/TypeScript bundler in Rust with Rollup-compatible API.",
   "keywords": [
     "bundler",