Skip to content

Comments

feat: support context option#5631

Merged
hyf0 merged 7 commits intorolldown:mainfrom
7086cmd:feat/context-cjs
Aug 7, 2025
Merged

feat: support context option#5631
hyf0 merged 7 commits intorolldown:mainfrom
7086cmd:feat/context-cjs

Conversation

@7086cmd
Copy link
Contributor

@7086cmd 7086cmd commented Aug 6, 2025 •
edited
Loading

resolves #5316.

@7086cmd 7086cmd requested a review from hyf0 August 6, 2025 08:46
IWANABETHATGUY
IWANABETHATGUY reviewed Aug 6, 2025
View reviewed changes
@IWANABETHATGUY
Copy link
Member

IWANABETHATGUY commented Aug 6, 2025

Can you update the validator.ts as well?

rolldown/packages/rolldown/src/utils/validator.ts

Lines 1 to 990 in 1704053

import { toJsonSchema } from '@valibot/to-json-schema';
import colors from 'ansis';
import * as v from 'valibot';
import type { PreRenderedChunk } from '../binding';
import type { PreRenderedAsset } from '../options/output-options';
import type {
RolldownOutputPluginOption,
RolldownPluginOption,
} from '../plugin';
import type {
SourcemapIgnoreListOption,
SourcemapPathTransformOption,
} from '../types/misc';
import type { RenderedChunk } from '../types/rolldown-output';
import type { ObjectSchema } from '../types/schema';
const StringOrRegExpSchema = v.union([v.string(), v.instance(RegExp)]);
const LogLevelSchema = v.union([
v.literal('debug'),
v.literal('info'),
v.literal('warn'),
]);
const LogLevelOptionSchema = v.union([LogLevelSchema, v.literal('silent')]);
const LogLevelWithErrorSchema = v.union([LogLevelSchema, v.literal('error')]);
const RollupLogSchema = v.any();
const RollupLogWithStringSchema = v.union([RollupLogSchema, v.string()]);
/// --- InputSchema ---
const InputOptionSchema = v.union([
v.string(),
v.array(v.string()),
v.record(v.string(), v.string()),
]);
const ExternalSchema = v.union([
StringOrRegExpSchema,
v.array(StringOrRegExpSchema),
v.pipe(
v.function(),
v.args(v.tuple([v.string(), v.optional(v.string()), v.boolean()])),
v.returns(v.nullish(v.boolean())),
),
]);
const ModuleTypesSchema = v.record(
v.string(),
v.union([
v.literal('asset'),
v.literal('base64'),
v.literal('binary'),
v.literal('css'),
v.literal('dataurl'),
v.literal('empty'),
v.literal('js'),
v.literal('json'),
v.literal('jsx'),
v.literal('text'),
v.literal('ts'),
v.literal('tsx'),
]),
);
const JsxOptionsSchema = v.strictObject({
runtime: v.pipe(
v.optional(v.union([
v.literal('classic'),
v.literal('automatic'),
])),
v.description('Which runtime to use'),
),
development: v.pipe(
v.optional(v.boolean()),
v.description('Development specific information'),
),
throwIfNamespace: v.pipe(
v.optional(v.string()),
v.description(
'Toggles whether to throw an error when a tag name uses an XML namespace',
),
),
importSource: v.pipe(
v.optional(v.string()),
v.description(
'Import the factory of element and fragment if mode is classic',
),
),
pragma: v.pipe(
v.optional(v.string()),
v.description('Jsx element transformation'),
),
pragmaFlag: v.pipe(
v.optional(
v.string(),
),
v.description('Jsx fragment transformation'),
),
refresh: v.pipe(
v.optional(v.boolean()),
v.description('Enable react fast refresh'),
),
});
const RollupJsxOptionsSchema = v.strictObject({
mode: v.optional(v.union([
v.literal('classic'),
v.literal('automatic'),
v.literal('preserve'),
])),
factory: v.optional(v.string()),
fragment: v.optional(v.string()),
importSource: v.optional(v.string()),
jsxImportSource: v.optional(v.string()),
});
const HelperModeSchema = v.union([v.literal('Runtime'), v.literal('External')]);
const DecoratorOptionSchema = v.object({
legacy: v.optional(v.boolean()),
emitDecoratorMetadata: v.optional(v.boolean()),
});
const HelpersSchema = v.object({
mode: v.optional(HelperModeSchema),
});
const RewriteImportExtensionsSchema = v.union([
v.literal('rewrite'),
v.literal('remove'),
v.boolean(),
]);
const TypescriptSchema = v.object({
jsxPragma: v.optional(v.string()),
jsxPragmaFrag: v.optional(v.string()),
onlyRemoveTypeImports: v.optional(v.boolean()),
allowNamespaces: v.optional(v.boolean()),
allowDeclareFields: v.optional(v.boolean()),
declaration: v.optional(
v.object({
stripInternal: v.optional(v.boolean()),
sourcemap: v.optional(v.boolean()),
}),
),
rewriteImportExtensions: v.optional(RewriteImportExtensionsSchema),
});
const AssumptionsSchema = v.object({
ignoreFunctionLength: v.optional(v.boolean()),
noDocumentAll: v.optional(v.boolean()),
objectRestNoSymbols: v.optional(v.boolean()),
pureGetters: v.optional(v.boolean()),
setPublicClassFields: v.optional(v.boolean()),
});
const TransformOptionsSchema = v.object({
assumptions: v.optional(AssumptionsSchema),
typescript: v.optional(TypescriptSchema),
helpers: v.optional(HelpersSchema),
decorators: v.optional(DecoratorOptionSchema),
jsx: v.optional(JsxOptionsSchema),
target: v.pipe(
v.optional(v.union([v.string(), v.array(v.string())])),
v.description('The JavaScript target environment'),
),
});
const WatchOptionsSchema = v.strictObject({
chokidar: v.optional(
v.never(
`The "watch.chokidar" option is deprecated, please use "watch.notify" instead of it`,
),
),
exclude: v.optional(
v.union([StringOrRegExpSchema, v.array(StringOrRegExpSchema)]),
),
include: v.optional(
v.union([StringOrRegExpSchema, v.array(StringOrRegExpSchema)]),
),
notify: v.pipe(
v.optional(
v.strictObject({
compareContents: v.optional(v.boolean()),
pollInterval: v.optional(v.number()),
}),
),
v.description('Notify options'),
),
skipWrite: v.pipe(
v.optional(v.boolean()),
v.description('Skip the bundle.write() step'),
),
buildDelay: v.pipe(
v.optional(v.number()),
v.description('Throttle watch rebuilds'),
),
clearScreen: v.pipe(
v.optional(v.boolean()),
v.description('Whether to clear the screen when a rebuild is triggered'),
),
onInvalidate: v.pipe(
v.optional(
v.pipe(
v.function(),
v.args(v.tuple([v.string()])),
),
),
v.description(
'An optional function that will be called immediately every time a module changes that is part of the build.',
),
),
});
const ChecksOptionsSchema = v.strictObject({
circularDependency: v.pipe(
v.optional(v.boolean()),
v.description(
'Whether to emit warning when detecting circular dependency',
),
),
eval: v.pipe(
v.optional(v.boolean()),
v.description(
'Whether to emit warning when detecting eval',
),
),
missingGlobalName: v.pipe(
v.optional(v.boolean()),
v.description(
'Whether to emit warning when detecting missing global name',
),
),
missingNameOptionForIifeExport: v.pipe(
v.optional(v.boolean()),
v.description(
'Whether to emit warning when detecting missing name option for iife export',
),
),
mixedExport: v.pipe(
v.optional(v.boolean()),
v.description(
'Whether to emit warning when detecting mixed export',
),
),
unresolvedEntry: v.pipe(
v.optional(v.boolean()),
v.description(
'Whether to emit warning when detecting unresolved entry',
),
),
unresolvedImport: v.pipe(
v.optional(v.boolean()),
v.description(
'Whether to emit warning when detecting unresolved import',
),
),
filenameConflict: v.pipe(
v.optional(v.boolean()),
v.description(
'Whether to emit warning when detecting filename conflict',
),
),
commonJsVariableInEsm: v.pipe(
v.optional(v.boolean()),
v.description(
'Whether to emit warning when detecting common js variable in esm',
),
),
importIsUndefined: v.pipe(
v.optional(v.boolean()),
v.description(
'Whether to emit warning when detecting import is undefined',
),
),
emptyImportMeta: v.pipe(
v.optional(v.boolean()),
v.description(
'Whether to emit warning when detecting empty import meta',
),
),
configurationFieldConflict: v.pipe(
v.optional(v.boolean()),
v.description(
'Whether to emit warning when detecting configuration field conflict',
),
),
});
const MinifyOptionsSchema = v.strictObject({
mangle: v.optional(v.boolean()),
compress: v.optional(v.boolean()),
removeWhitespace: v.optional(v.boolean()),
});
const ResolveOptionsSchema = v.strictObject({
alias: v.optional(
v.record(v.string(), v.union([v.string(), v.array(v.string())])),
),
aliasFields: v.optional(v.array(v.array(v.string()))),
conditionNames: v.optional(v.array(v.string())),
extensionAlias: v.optional(v.record(v.string(), v.array(v.string()))),
exportsFields: v.optional(v.array(v.array(v.string()))),
extensions: v.optional(v.array(v.string())),
mainFields: v.optional(v.array(v.string())),
mainFiles: v.optional(v.array(v.string())),
modules: v.optional(v.array(v.string())),
symlinks: v.optional(v.boolean()),
tsconfigFilename: v.optional(v.string()),
yarnPnp: v.optional(v.boolean()),
});
// TODO: moduleSideEffects
const TreeshakingOptionsSchema = v.union([
v.boolean(),
v.looseObject({
annotations: v.optional(v.boolean()),
manualPureFunctions: v.optional(v.array(v.string())),
unknownGlobalSideEffects: v.optional(v.boolean()),
commonjs: v.optional(v.boolean()),
}),
]);
const OptimizationOptionsSchema = v.strictObject({
inlineConst: v.pipe(
v.optional(v.boolean()),
v.description('Enable crossmodule constant inlining'),
),
pifeForModuleWrappers: v.pipe(
v.optional(v.boolean()),
v.description('Use PIFE pattern for module wrappers'),
),
});
const OnLogSchema = v.pipe(
v.function(),
v.args(
v.tuple([
LogLevelSchema,
RollupLogSchema,
v.pipe(
v.function(),
v.args(v.tuple([LogLevelWithErrorSchema, RollupLogWithStringSchema])),
),
]),
),
);
const OnwarnSchema = v.pipe(
v.function(),
v.args(
v.tuple([
RollupLogSchema,
v.pipe(
v.function(),
v.args(
v.tuple([
v.union([
RollupLogWithStringSchema,
v.pipe(v.function(), v.returns(RollupLogWithStringSchema)),
]),
]),
),
),
]),
),
);
const HmrSchema = v.union([
v.boolean(),
v.strictObject({
port: v.optional(v.number()),
host: v.optional(v.string()),
implement: v.optional(v.string()),
}),
]);
const InputOptionsSchema = v.strictObject({
input: v.optional(InputOptionSchema),
plugins: v.optional(v.custom<RolldownPluginOption>(() => true)),
external: v.optional(ExternalSchema),
makeAbsoluteExternalsRelative: v.optional(
v.union([v.boolean(), v.literal('ifRelativeSource')]),
),
resolve: v.optional(ResolveOptionsSchema),
cwd: v.pipe(
v.optional(v.string()),
v.description('Current working directory'),
),
platform: v.pipe(
v.optional(
v.union([v.literal('browser'), v.literal('neutral'), v.literal('node')]),
),
v.description(
`Platform for which the code should be generated (node, ${
colors.underline('browser')
}, neutral)`,
),
),
shimMissingExports: v.pipe(
v.optional(v.boolean()),
v.description('Create shim variables for missing exports'),
),
treeshake: v.optional(TreeshakingOptionsSchema),
optimization: v.optional(OptimizationOptionsSchema),
logLevel: v.pipe(
v.optional(LogLevelOptionSchema),
v.description(
`Log level (${colors.dim('silent')}, ${
colors.underline(colors.gray('info'))
}, debug, ${colors.yellow('warn')})`,
),
),
onLog: v.optional(OnLogSchema),
onwarn: v.optional(OnwarnSchema),
moduleTypes: v.pipe(
v.optional(ModuleTypesSchema),
v.description('Module types for customized extensions'),
),
experimental: v.optional(
v.strictObject({
disableLiveBindings: v.optional(v.boolean()),
enableComposingJsPlugins: v.optional(v.boolean()),
viteMode: v.optional(v.boolean()),
resolveNewUrlToAsset: v.optional(v.boolean()),
strictExecutionOrder: v.optional(v.boolean()),
onDemandWrapping: v.optional(v.boolean()),
incrementalBuild: v.optional(v.boolean()),
hmr: v.optional(HmrSchema),
attachDebugInfo: v.optional(v.union([
v.literal('none'),
v.literal('simple'),
v.literal('full'),
])),
chunkModulesOrder: v.optional(v.union([
v.literal('module-id'),
v.literal('exec-order'),
])),
chunkImportMap: v.optional(v.union([
v.boolean(),
v.object({
baseUrl: v.optional(v.string()),
fileName: v.optional(v.string()),
}),
])),
}),
),
define: v.pipe(
v.optional(v.record(v.string(), v.string())),
v.description('Define global variables'),
),
inject: v.optional(
v.record(
v.string(),
v.union([v.string(), v.tuple([v.string(), v.string()])]),
),
),
profilerNames: v.optional(v.boolean()),
jsx: v.optional(
v.union([
v.literal(false),
v.literal('react'),
v.literal('react-jsx'),
v.literal('preserve'),
RollupJsxOptionsSchema,
]),
),
transform: v.optional(TransformOptionsSchema),
watch: v.optional(v.union([WatchOptionsSchema, v.literal(false)])),
dropLabels: v.pipe(
v.optional(v.array(v.string())),
v.description('Remove labeled statements with these label names'),
),
checks: v.optional(ChecksOptionsSchema),
keepNames: v.pipe(
v.optional(v.boolean()),
v.description('Keep function/class name'),
),
debug: v.pipe(
v.optional(v.object({
sessionId: v.pipe(
v.optional(v.string()),
v.description('Used to name the build.'),
),
})),
v.description(
'Enable debug mode. Emit debug information to disk. This might slow down the build process significantly.',
),
),
preserveEntrySignatures: v.pipe(
v.optional(v.union([
v.literal('strict'),
v.literal('allow-extension'),
v.literal('exports-only'),
v.literal(false),
])),
),
});
const InputCliOverrideSchema = v.strictObject({
input: v.pipe(
v.optional(v.array(v.string())),
v.description('Entry file'),
),
external: v.pipe(
v.optional(v.array(v.string())),
v.description(
'Comma-separated list of module ids to exclude from the bundle `<module-id>,...`',
),
),
inject: v.pipe(
v.optional(v.record(v.string(), v.string())),
v.description('Inject import statements on demand'),
),
treeshake: v.pipe(
v.optional(v.boolean()),
v.description('enable treeshaking'),
),
makeAbsoluteExternalsRelative: v.pipe(
v.optional(v.boolean()),
v.description('Prevent normalization of external imports'),
),
jsx: v.pipe(
v.optional(
v.union([
v.literal(false),
v.literal('react'),
v.literal('react-jsx'),
v.literal('preserve'),
]),
),
v.description('Jsx options preset'),
),
preserveEntrySignatures: v.pipe(
v.optional(v.union([
v.literal(false),
])),
v.description('Avoid facade chunks for entry points'),
),
});
const InputCliOptionsSchema = v.omit(
v.strictObject({
...InputOptionsSchema.entries,
...InputCliOverrideSchema.entries,
}),
[
'plugins',
'onwarn',
'onLog',
'resolve',
'experimental',
'profilerNames',
'watch',
],
);
/// --- OutputSchema ---
const ModuleFormatSchema = v.union([
v.literal('es'),
v.literal('cjs'),
v.literal('esm'),
v.literal('module'),
v.literal('commonjs'),
v.literal('iife'),
v.literal('umd'),
]);
const AddonFunctionSchema = v.pipe(
v.function(),
v.args(v.tuple([v.custom<RenderedChunk>(() => true)])),
v.returnsAsync(
v.unionAsync([
v.string(),
v.pipeAsync(v.promise(), v.awaitAsync(), v.string()),
]),
),
);
const ChunkFileNamesSchema = v.union([
v.string(),
v.pipe(
v.function(),
v.args(v.tuple([v.custom<PreRenderedChunk>(() => true)])),
v.returns(v.string()),
),
]);
const AssetFileNamesSchema = v.union([
v.string(),
v.pipe(
v.function(),
v.args(v.tuple([v.custom<PreRenderedAsset>(() => true)])),
v.returns(v.string()),
),
]);
const SanitizeFileNameSchema = v.union([
v.boolean(),
v.pipe(v.function(), v.args(v.tuple([v.string()])), v.returns(v.string())),
]);
const GlobalsFunctionSchema = v.pipe(
v.function(),
v.args(v.tuple([v.string()])),
v.returns(v.string()),
);
const AdvancedChunksSchema = v.strictObject({
minSize: v.optional(v.number()),
maxSize: v.optional(v.number()),
minModuleSize: v.optional(v.number()),
maxModuleSize: v.optional(v.number()),
minShareCount: v.optional(v.number()),
groups: v.optional(
v.array(
v.strictObject({
name: v.union([
v.string(),
v.pipe(
v.function(),
v.args(v.tuple([v.string()])),
v.returns(v.nullish(v.string())),
),
]),
test: v.optional(
v.union([
v.string(),
v.instance(RegExp),
v.pipe(
v.function(),
v.args(v.tuple([v.string()])),
v.returns(v.union([v.nullish(v.boolean()), v.void()])),
),
]),
),
priority: v.optional(v.number()),
minSize: v.optional(v.number()),
minShareCount: v.optional(v.number()),
maxSize: v.optional(v.number()),
minModuleSize: v.optional(v.number()),
maxModuleSize: v.optional(v.number()),
}),
),
),
});
const OutputOptionsSchema = v.strictObject({
dir: v.pipe(
v.optional(v.string()),
v.description('Output directory, defaults to `dist` if `file` is not set'),
),
file: v.pipe(v.optional(v.string()), v.description('Single output file')),
exports: v.pipe(
v.optional(
v.union([
v.literal('auto'),
v.literal('named'),
v.literal('default'),
v.literal('none'),
]),
),
v.description(
`Specify a export mode (${
colors.underline('auto')
}, named, default, none)`,
),
),
hashCharacters: v.pipe(
v.optional(
v.union([v.literal('base64'), v.literal('base36'), v.literal('hex')]),
),
v.description('Use the specified character set for file hashes'),
),
format: v.pipe(
v.optional(ModuleFormatSchema),
v.description(
`Output format of the generated bundle (supports ${
colors.underline('esm')
}, cjs, and iife)`,
),
),
sourcemap: v.pipe(
v.optional(
v.union([v.boolean(), v.literal('inline'), v.literal('hidden')]),
),
v.description(
`Generate sourcemap (\`-s inline\` for inline, or ${
colors.bold(
'pass the `-s` on the last argument if you want to generate `.map` file',
)
})`,
),
),
sourcemapBaseUrl: v.pipe(
v.optional(v.string()),
v.description('Base URL used to prefix sourcemap paths'),
),
sourcemapDebugIds: v.pipe(
v.optional(v.boolean()),
v.description('Inject sourcemap debug IDs'),
),
sourcemapIgnoreList: v.optional(
v.union([v.boolean(), v.custom<SourcemapIgnoreListOption>(() => true)]),
),
sourcemapPathTransform: v.optional(
v.custom<SourcemapPathTransformOption>(() => true),
),
banner: v.optional(v.union([v.string(), AddonFunctionSchema])),
footer: v.optional(v.union([v.string(), AddonFunctionSchema])),
intro: v.optional(v.union([v.string(), AddonFunctionSchema])),
outro: v.optional(v.union([v.string(), AddonFunctionSchema])),
extend: v.pipe(
v.optional(v.boolean()),
v.description(
'Extend global variable defined by name in IIFE / UMD formats',
),
),
esModule: v.optional(v.union([v.boolean(), v.literal('if-default-prop')])),
assetFileNames: v.optional(AssetFileNamesSchema),
entryFileNames: v.optional(ChunkFileNamesSchema),
chunkFileNames: v.optional(ChunkFileNamesSchema),
cssEntryFileNames: v.optional(ChunkFileNamesSchema),
cssChunkFileNames: v.optional(ChunkFileNamesSchema),
sanitizeFileName: v.optional(SanitizeFileNameSchema),
minify: v.pipe(
v.optional(
v.union([v.boolean(), v.string('dce-only'), MinifyOptionsSchema]),
),
v.description('Minify the bundled file'),
),
name: v.pipe(
v.optional(v.string()),
v.description('Name for UMD / IIFE format outputs'),
),
globals: v.pipe(
v.optional(
v.union([v.record(v.string(), v.string()), GlobalsFunctionSchema]),
),
v.description(
'Global variable of UMD / IIFE dependencies (syntax: `key=value`)',
),
),
externalLiveBindings: v.pipe(
v.optional(v.boolean()),
v.description('external live bindings'),
),
inlineDynamicImports: v.pipe(
v.optional(v.boolean()),
v.description('Inline dynamic imports'),
),
manualChunks: v.optional(
v.pipe(
v.function(),
v.args(v.tuple([v.string(), v.object({})])),
v.returns(v.union([v.string(), v.nullish(v.string())])),
),
),
advancedChunks: v.optional(AdvancedChunksSchema),
legalComments: v.pipe(
v.optional(v.union([v.literal('none'), v.literal('inline')])),
v.description('Control comments in the output'),
),
plugins: v.optional(v.custom<RolldownOutputPluginOption>(() => true)),
polyfillRequire: v.pipe(
v.optional(v.boolean()),
v.description('Disable require polyfill injection'),
),
hoistTransitiveImports: v.optional(
v.custom<boolean, () => string>((input) => {
if (input) {
return false;
}
return true;
}, () => `The 'true' value is not supported`),
),
preserveModules: v.pipe(
v.optional(v.boolean()),
v.description('Preserve module structure'),
),
preserveModulesRoot: v.pipe(
v.optional(v.string()),
v.description('Put preserved modules under this path at root level'),
),
virtualDirname: v.optional(v.string()),
minifyInternalExports: v.pipe(
v.optional(v.boolean()),
v.description('Minify internal exports'),
),
});
const getAddonDescription = (
placement: 'bottom' | 'top',
wrapper: 'inside' | 'outside',
) => {
return `Code to insert the ${colors.bold(placement)} of the bundled file (${
colors.bold(wrapper)
} the wrapper function)`;
};
const OutputCliOverrideSchema = v.strictObject({
// Reject all functions in CLI
assetFileNames: v.pipe(
v.optional(v.string()),
v.description('Name pattern for asset files'),
),
entryFileNames: v.pipe(
v.optional(v.string()),
v.description('Name pattern for emitted entry chunks'),
),
chunkFileNames: v.pipe(
v.optional(v.string()),
v.description('Name pattern for emitted secondary chunks'),
),
cssEntryFileNames: v.pipe(
v.optional(v.string()),
v.description('Name pattern for emitted css entry chunks'),
),
cssChunkFileNames: v.pipe(
v.optional(v.string()),
v.description('Name pattern for emitted css secondary chunks'),
),
sanitizeFileName: v.pipe(
v.optional(v.boolean()),
v.description('Sanitize file name'),
),
banner: v.pipe(
v.optional(v.string()),
v.description(getAddonDescription('top', 'outside')),
),
footer: v.pipe(
v.optional(v.string()),
v.description(getAddonDescription('bottom', 'outside')),
),
intro: v.pipe(
v.optional(v.string()),
v.description(getAddonDescription('top', 'inside')),
),
outro: v.pipe(
v.optional(v.string()),
v.description(getAddonDescription('bottom', 'inside')),
),
// It is hard to handle the union type in json schema, so use this first.
esModule: v.pipe(
v.optional(v.boolean()),
v.description(
'Always generate `__esModule` marks in non-ESM formats, defaults to `if-default-prop` (use `--no-esModule` to always disable)',
),
),
globals: v.pipe(
v.optional(v.record(v.string(), v.string())),
v.description(
'Global variable of UMD / IIFE dependencies (syntax: `key=value`)',
),
),
advancedChunks: v.pipe(
v.optional(
v.strictObject({
minSize: v.pipe(
v.optional(v.number()),
v.description('Minimum size of the chunk'),
),
minShareCount: v.pipe(
v.optional(v.number()),
v.description('Minimum share count of the chunk'),
),
}),
),
v.description(
'Global variable of UMD / IIFE dependencies (syntax: `key=value`)',
),
),
minify: v.pipe(
v.optional(v.boolean()),
v.description('Minify the bundled file'),
),
});
const OutputCliOptionsSchema = v.omit(
v.strictObject({
...OutputOptionsSchema.entries,
...OutputCliOverrideSchema.entries,
}),
[
'sourcemapIgnoreList',
'sourcemapPathTransform',
'plugins',
'hoistTransitiveImports',
],
);
/// --- CliSchema ---
const CliOptionsSchema = v.strictObject({
config: v.pipe(
v.optional(v.union([v.string(), v.boolean()])),
v.description('Path to the config file (default: `rolldown.config.js`)'),
),
help: v.pipe(v.optional(v.boolean()), v.description('Show help')),
version: v.pipe(
v.optional(v.boolean()),
v.description('Show version number'),
),
watch: v.pipe(
v.optional(v.boolean()),
v.description('Watch files in bundle and rebuild on changes'),
),
...InputCliOptionsSchema.entries,
...OutputCliOptionsSchema.entries,
});
export function validateCliOptions<T>(options: T): [T, string[]?] {
let parsed = v.safeParse(CliOptionsSchema, options);
return [
parsed.output as T,
parsed.issues?.map((issue) => {
const option = issue.path?.map((pathItem) => pathItem.key).join(' ');
return `Invalid value for option ${option}: ${issue.message}`;
}),
];
}
type HelperMsgRecord = Record<string, { ignored?: boolean; msg?: string }>;
const inputHelperMsgRecord: HelperMsgRecord = {
output: { ignored: true }, // Ignore the output key
};
const outputHelperMsgRecord: HelperMsgRecord = {};
export function validateOption<T>(key: 'input' | 'output', options: T): void {
if (globalThis.process?.env?.ROLLUP_TEST) return;
let parsed = v.safeParse(
key === 'input' ? InputOptionsSchema : OutputOptionsSchema,
options,
);
if (!parsed.success) {
const errors = parsed.issues
.map((issue) => {
const issuePaths = issue.path!.map((path) => path.key);
let issueMsg = issue.message;
// For issue in union type, ref https://valibot.dev/guides/unions/
// - the received is not matched with the all the sub typing
// - one sub typing is matched, but it is has issue, we need to find the matched sub issue
if (issue.type === 'union') {
const subIssue = issue.issues?.find(
(i) => !(i.type !== issue.received && i.input === issue.input),
);
if (subIssue) {
if (subIssue.path) {
issuePaths.push(subIssue.path.map((path) => path.key));
}
issueMsg = subIssue.message;
}
}
const stringPath = issuePaths.join('.');
const helper = key === 'input'
? inputHelperMsgRecord[stringPath]
: outputHelperMsgRecord[stringPath];
if (helper && helper.ignored) {
return '';
}
return `- For the "${stringPath}". ${issueMsg}. ${
helper ? helper.msg : ''
}`;
})
.filter(Boolean);
if (errors.length) {
console.warn(`Warning validate ${key} options.\n` + errors.join('\n'));
}
}
}
export function getInputCliKeys(): string[] {
return v.keyof(InputCliOptionsSchema).options;
}
export function getOutputCliKeys(): string[] {
return v.keyof(OutputCliOptionsSchema).options;
}
export function getJsonSchema(): ObjectSchema {
return toJsonSchema(CliOptionsSchema, {
// errorMode: 'ignore' is set to ignore `never` schema
// there's no way to suppress the error one-by-one
// https://github.com/fabian-hiller/valibot/issues/1062
errorMode: 'ignore',
}) as ObjectSchema;
}

graphite-app[bot]
graphite-app bot reviewed Aug 6, 2025
View reviewed changes
@7086cmd 7086cmd requested a review from IWANABETHATGUY August 6, 2025 11:04
graphite-app[bot]
graphite-app bot reviewed Aug 7, 2025
View reviewed changes
@hyf0 hyf0 enabled auto-merge August 7, 2025 07:03
@hyf0 @graphite-app
Update crates/rolldown_error/src/events/invalid_option.rs
f671b8c 
Co-authored-by: graphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
@netlify
Copy link

netlify bot commented Aug 7, 2025

✅ Deploy Preview for rolldown-rs canceled.

Name Link
🔨 Latest commit f671b8c
🔍 Latest deploy log https://app.netlify.com/projects/rolldown-rs/deploys/68944fb7da7b2f000862f6e3

graphite-app[bot]
graphite-app bot reviewed Aug 7, 2025
View reviewed changes
@hyf0 hyf0 added this pull request to the merge queue Aug 7, 2025
Merged via the queue into rolldown:main with commit e2258c5 Aug 7, 2025
19 checks passed
@7086cmd 7086cmd deleted the feat/context-cjs branch August 7, 2025 08:15
@situ2001 situ2001 mentioned this pull request Aug 7, 2025
Merged
github-merge-queue bot pushed a commit that referenced this pull request Aug 8, 2025
@situ2001
test(rollup): enable testing for option.context (#5663)
cf2be26 
Enable Rollup testing for #5631
@github-actions github-actions bot mentioned this pull request Aug 11, 2025
Merged
shulaoda added a commit that referenced this pull request Aug 11, 2025
@github-actions @shulaoda
release: v1.0.0-beta.32 (#5699)
2705488 
## [1.0.0-beta.32] - 2025-08-11

### 💥 BREAKING CHANGES

- advanceChunks: remove interaction between `advanceChunks` and `preserveEntrySignatures` (#5629) by @hyf0
- types: align `TreeshakingOptions` type with Rollup (#5592) by @sapphi-red

### 🚀 Features

- rolldown_plugin_manifest: support legacy (#5694) by @shulaoda
- rolldown_plugin_vite_css: align load hook logic (#5667) by @shulaoda
- rolldown_plugin_transform: throw error for invalid tsconfig (#5657) by @shulaoda
- support `context` option (#5631) by @7086cmd
- rolldown: oxc v0.81.0 (#5642) by @Boshen
- include plugin name in the message of UNHANDLEABLE_ERRORs that happened in plugins (#5636) by @sapphi-red
- pass plugin name to log (#5635) by @sapphi-red
- rolldown_plugin_import_glob: support glob-safe paths (#5640) by @shulaoda
- rolldown_binding: Add configurable max_blocking_threads with environment variable override (#5559) by @Copilot
- output better error message for callable plugins (#5632) by @sapphi-red
- rolldown_plugin_manifest: support names for asset (#5627) by @shulaoda
- rolldown_plugin_manifest: align the logic related to css entries (#5626) by @shulaoda
- hmr: handle `import ... from 'external-module'` in rolldown's best (#5599) by @hyf0
- add array support for `treeshake.moduleSideEffects` option (#5593) by @sapphi-red

### 🐛 Bug Fixes

- ensure `./` prefix for relative imports starting with `.` (#5687) by @shulaoda
- hmr: fix regression test `deconflict_import_bindings` (#5684) by @hyf0
- hmr: only modules in the propagation chain need to re-execute (#5683) by @hyf0
- preserve empty `export {}` to ensure correct ESM detection (#5686) by @shulaoda
- vite test failed (#5675) by @IWANABETHATGUY
- incorrect module execution order with sideeffectful CJS module (#5661) by @IWANABETHATGUY
- rollup-tests: update ignored tests for `option.context` (#5669) by @situ2001
- hmr: ensure correctness of `typeof require === 'function'` (#5651) by @hyf0
- hmr: rewrite `this` to `exports` for cjs modules (#5641) by @hyf0
- don't generate namespace reexport code for reexport external record that has been moved to entry point (#5622) by @IWANABETHATGUY
- esm export * from 'externalized-dep' generates unnecessary code (#5612) by @IWANABETHATGUY
- hmr: correct runtime behavior for manual reexports (#5614) by @hyf0
- ci: resolve potential sync issue in `this.emitFile` (#5611) by @shulaoda
- hmr: support re-assignment on `module.exports` (#5607) by @hyf0
- hmr: rewrite `require(...)` to sensible form (#5604) by @hyf0
- align behavior when returning `undefined` from `treeshake.moduleSideEffects` function (#5595) by @sapphi-red

### 🚜 Refactor

- rolldown_binding: improve the use of `FxHashSet` and `FxHashMap` (#5665) by @shulaoda
- hmr: move constants to `constants.rs` (#5650) by @hyf0
- hmr: rewrite `exports,module` to `__rolldown_exports__,__rolldown_module__` (#5647) by @hyf0
- hmr: migrate `VisitMut` to `Traverse` (#5646) by @hyf0
- use `bit_index` function to get `RuntimeHelper` bit index (#5634) by @IWANABETHATGUY
- improve `JsCallback` and `MaybeAsyncJsCallback` (#5628) by @shulaoda
- use bitflags instead of boolean to represent module_namespace included reason (#5621) by @IWANABETHATGUY
- rolldown_debug,rolldown_tracing: remove `EnvFilter` (#5231) by @Boshen
- align parameter name for `treeshake.moduleSideEffects` (#5594) by @sapphi-red

### 📚 Documentation

- contrib-guide: add CPU profile steps (#5677) by @sapphi-red
- rollup-tests: update README to correct  commands (#5658) by @situ2001

### ⚡ Performance

- reduce memory usage when calc none wrapped modules implicit dependency (#5679) by @IWANABETHATGUY
- hmr: do codegen in parallel (#5590) by @hyf0

### 🧪 Testing

- Runtime error when using rolldown to build a page using tinymce (#5678) by @IWANABETHATGUY
- rollup: enable testing for `option.context` (#5663) by @situ2001
- hmr: run patch exectution after the normal execution (#5645) by @sapphi-red
- hmr: properly execute patch chunks (#5617) by @sapphi-red
- rust/hmr: hide unnecessary rolldown runtime, hmr module (#5606) by @hyf0
- rust/hmr: support writting assertion tests (#5598) by @hyf0
- rust: simplify global variable injection logic (#5597) by @hyf0

### ⚙️ Miscellaneous Tasks

- deps: lock file maintenance (#5693) by @renovate[bot]
- deps: lock file maintenance (#5692) by @renovate[bot]
- deps: lock file maintenance rust crates (#5691) by @renovate[bot]
- deps: update github-actions (#5688) by @renovate[bot]
- deps: lock file maintenance npm packages (#5690) by @renovate[bot]
- deps: update github-actions (major) (#5689) by @renovate[bot]
- upgrade NAPI-RS to 3.2 (#5680) by @Brooooooklyn
- deps: update dependency tsdown to v0.14.0 (#5681) by @renovate[bot]
- clean up basic-vue example (#5676) by @IWANABETHATGUY
- deps: update crate-ci/typos action to v1.35.3 (#5674) by @renovate[bot]
- remove duplicate hook tracing (#5673) by @IWANABETHATGUY
- deps: update dependency tsdown to v0.13.4 (#5668) by @renovate[bot]
- deps: update dependency rolldown-plugin-dts to v0.15.6 (#5666) by @renovate[bot]
- deps: update crate-ci/typos action to v1.35.2 (#5664) by @renovate[bot]
- deps: update dependency rust to v1.89.0 (#5652) by @renovate[bot]
- deps: update dependency rolldown-plugin-dts to v0.15.5 (#5649) by @renovate[bot]
- deps: update dependency rolldown-plugin-dts to v0.15.4 (#5638) by @renovate[bot]
- add `just debug-test` alias to run test without extended test case (#5633) by @IWANABETHATGUY
- update lable related to auto labeled documentation ci (#5630) by @IWANABETHATGUY
- clippy: allow `case_sensitive_file_extension_comparisons` (#5625) by @shulaoda
- fix wasi build failed (#5624) by @sapphi-red
- use env variable to control whether run extended tests (#5623) by @IWANABETHATGUY
- remove redundant track_caller (#5620) by @IWANABETHATGUY
- replace unmaintained goto-bus-stop/setup-zig with mlugg/setup-zig action (#5605) by @Copilot
- deps: update crate-ci/typos action to v1.35.1 (#5603) by @renovate[bot]
- deps: update crate-ci/typos action to v1.35.0 (#5601) by @renovate[bot]
- deps: update dependency tsdown to v0.13.3 (#5602) by @renovate[bot]
- deps: update dependency rolldown-plugin-dts to v0.15.3 (#5600) by @renovate[bot]

Co-authored-by: shulaoda <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@graphite-app graphite-app[bot] graphite-app[bot] left review comments

@IWANABETHATGUY IWANABETHATGUY IWANABETHATGUY approved these changes

@hyf0 hyf0 Awaiting requested review from hyf0

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[Feature Request]: support options.context

4 participants

@7086cmd @IWANABETHATGUY @hyf0 @shulaoda