rollipop 0.1.0-dev.20260424074146 → 1.0.0-alpha.21

package/dist/index.js

@@ -9,7 +9,7 @@ import wrapAnsi from "wrap-ansi";
 import * as c12 from "c12";
 import * as rolldown from "@rollipop/rolldown";
 import * as rolldownExperimental from "@rollipop/rolldown/experimental";
-import { dev, rollipopReactRefreshWrapperPlugin } from "@rollipop/rolldown/experimental";
+import { dev, rollipopReactNativePlugin, rollipopReactRefreshWrapperPlugin } from "@rollipop/rolldown/experimental";
 import gradient from "gradient-string";
 import crypto, { randomUUID } from "node:crypto";
 import "@node-rs/xxhash";
@@ -37,7 +37,6 @@ import mime from "mime";
 import Ajv from "ajv";
 import { codeFrameColumns } from "@babel/code-frame";
 import * as ws from "ws";
-import { transform as transform$1 } from "@svgr/core";
 import * as babel from "@babel/core";
 import * as swc from "@swc/core";
 import { Command, program } from "@commander-js/extra-typings";
@@ -89,8 +88,25 @@ async function stripFlowTypes(id, code) {
 }
 //#endregion
 //#region src/constants.ts
-const ROLLIPOP_VERSION = "0.1.0-dev.20260424074146";
-const GLOBAL_IDENTIFIER = "__ROLLIPOP_GLOBAL__";
+var constants_exports = /* @__PURE__ */ __exportAll({
+	DEFAULT_ASSET_EXTENSIONS: () => DEFAULT_ASSET_EXTENSIONS,
+	DEFAULT_ASSET_REGISTRY_PATH: () => DEFAULT_ASSET_REGISTRY_PATH,
+	DEFAULT_ENV_FILE: () => DEFAULT_ENV_FILE,
+	DEFAULT_ENV_PREFIX: () => DEFAULT_ENV_PREFIX,
+	DEFAULT_HMR_CLIENT_PATH: () => DEFAULT_HMR_CLIENT_PATH,
+	DEFAULT_IMAGE_EXTENSIONS: () => DEFAULT_IMAGE_EXTENSIONS,
+	DEFAULT_REACT_NATIVE_GLOBAL_IDENTIFIERS: () => DEFAULT_REACT_NATIVE_GLOBAL_IDENTIFIERS,
+	DEFAULT_RESOLVER_ALIAS_FIELDS: () => DEFAULT_RESOLVER_ALIAS_FIELDS,
+	DEFAULT_RESOLVER_CONDITION_NAMES: () => DEFAULT_RESOLVER_CONDITION_NAMES,
+	DEFAULT_RESOLVER_MAIN_FIELDS: () => DEFAULT_RESOLVER_MAIN_FIELDS,
+	DEFAULT_RUNTIME_TARGET: () => DEFAULT_RUNTIME_TARGET,
+	DEFAULT_SOURCE_EXTENSIONS: () => DEFAULT_SOURCE_EXTENSIONS,
+	GLOBAL_IDENTIFIER: () => GLOBAL_IDENTIFIER,
+	IMAGE_EXTENSIONS: () => IMAGE_EXTENSIONS,
+	ROLLIPOP_VERSION: () => ROLLIPOP_VERSION
+});
+const ROLLIPOP_VERSION = "1.0.0-alpha.21";
+const GLOBAL_IDENTIFIER = "global";
 /**
 * @see {@link https://github.com/facebook/metro/blob/0.81.x/docs/Configuration.md#resolvermainfields}
 */
@@ -99,11 +115,8 @@ const DEFAULT_RESOLVER_MAIN_FIELDS = [
 	"browser",
 	"main"
 ];
-const DEFAULT_RESOLVER_CONDITION_NAMES = [
-	"react-native",
-	"import",
-	"require"
-];
+const DEFAULT_RESOLVER_ALIAS_FIELDS = [["react-native"], ["browser"]];
+const DEFAULT_RESOLVER_CONDITION_NAMES = ["react-native"];
 /**
 * Unlike the Metro bundler configuration, this prioritizes resolving TypeScript and ESM first.
 *
@@ -119,7 +132,7 @@ const DEFAULT_SOURCE_EXTENSIONS = [
 	"cjs",
 	"json"
 ];
-const DEFAULT_ASSET_EXTENSIONS = [
+const DEFAULT_IMAGE_EXTENSIONS = [
 	"bmp",
 	"gif",
 	"jpg",
@@ -127,7 +140,15 @@ const DEFAULT_ASSET_EXTENSIONS = [
 	"png",
 	"psd",
 	"svg",
-	"webp",
+	"webp"
+];
+const IMAGE_EXTENSIONS = [
+	...DEFAULT_IMAGE_EXTENSIONS,
+	"tiff",
+	"ktx"
+];
+const DEFAULT_ASSET_EXTENSIONS = [
+	...DEFAULT_IMAGE_EXTENSIONS,
 	"xml",
 	"m4v",
 	"mov",
@@ -152,6 +173,7 @@ const DEFAULT_ASSET_EXTENSIONS = [
 const DEFAULT_ASSET_REGISTRY_PATH = "react-native/Libraries/Image/AssetRegistry.js";
 const DEFAULT_HMR_CLIENT_PATH = "react-native/Libraries/Utilities/HMRClient.js";
 const DEFAULT_REACT_NATIVE_GLOBAL_IDENTIFIERS = [
+	GLOBAL_IDENTIFIER,
 	"Promise",
 	"regeneratorRuntime",
 	"XMLHttpRequest",
@@ -206,6 +228,7 @@ const DEFAULT_REACT_NATIVE_GLOBAL_IDENTIFIERS = [
 	"TaskAttributionTiming"
 ];
 const DEFAULT_ENV_PREFIX = "ROLLIPOP_";
+const DEFAULT_ENV_FILE = ".env";
 const DEFAULT_RUNTIME_TARGET = "hermes-v1";
 //#endregion
 //#region src/internal/react-native.ts
@@ -244,6 +267,16 @@ function resolvePackagePath(basePath, packageName) {
 	} catch {}
 	throw new Error(`Failed to resolve package path for '${packageName}'`);
 }
+function resolvePackageJson(basePath, packageName) {
+	try {
+		const packagePath = resolvePackagePath(basePath, packageName);
+		const packageJsonPath = path.join(packagePath, "package.json");
+		const rawPackageJson = fs.readFileSync(packageJsonPath, "utf-8");
+		return JSON.parse(rawPackageJson);
+	} catch {
+		return null;
+	}
+}
 function resolvePackagePathWithNodeRequire(basePath, packageName, subpath) {
 	const resolvedPath = __require.resolve(subpath ? `${packageName}/${subpath}` : packageName, { paths: [basePath] });
 	const root = path.parse(resolvedPath).root;
@@ -669,17 +702,15 @@ async function getDefaultConfig(projectRoot, mode) {
 			sourceExtensions: DEFAULT_SOURCE_EXTENSIONS,
 			assetExtensions: DEFAULT_ASSET_EXTENSIONS,
 			mainFields: DEFAULT_RESOLVER_MAIN_FIELDS,
+			aliasFields: DEFAULT_RESOLVER_ALIAS_FIELDS,
 			conditionNames: DEFAULT_RESOLVER_CONDITION_NAMES,
 			preferNativePlatform: true,
 			symlinks: true
 		},
-		transformer: {
-			svg: true,
-			flow: { filter: {
-				id: /\.jsx?$/,
-				code: /@flow/
-			} }
-		},
+		transformer: { flow: { filter: {
+			id: /\.jsx?$/,
+			code: /@flow/
+		} } },
 		serializer: {
 			prelude: [getInitializeCorePath(projectRoot)],
 			polyfills: await Promise.all(getPolyfillScriptPaths(reactNativePath).map(async (path) => {
@@ -710,8 +741,10 @@ async function getDefaultConfig(projectRoot, mode) {
 			return "compat";
 		})() },
 		envDir: projectRoot,
+		envFile: DEFAULT_ENV_FILE,
 		envPrefix: DEFAULT_ENV_PREFIX,
-		runtimeTarget: DEFAULT_RUNTIME_TARGET
+		runtimeTarget: DEFAULT_RUNTIME_TARGET,
+		experimental: { nativeTransformPipeline: false }
 	};
 }
 //#endregion
@@ -741,6 +774,22 @@ function printPluginLog(level, log, pluginName = "unknown") {
 	else pluginLogger[level](pluginLabel, log.stack ?? log.message);
 }
 //#endregion
+//#region src/config/compose-override.ts
+async function applyOverrideRolldownOptions(override, rolldownOptions) {
+	if (typeof override === "function") return await override(rolldownOptions);
+	return {
+		input: merge(rolldownOptions.input ?? {}, override.input ?? {}),
+		output: merge(rolldownOptions.output ?? {}, override.output ?? {})
+	};
+}
+function composeOverrideRolldownOptions(target, source) {
+	if (source == null) return target;
+	if (target == null) return source;
+	return async (rolldownOptions) => {
+		return await applyOverrideRolldownOptions(source, await applyOverrideRolldownOptions(target, rolldownOptions));
+	};
+}
+//#endregion
 //#region src/config/merge-config.ts
 function mergeConfig(baseConfig, ...overrideConfigs) {
 	let mergedConfig = baseConfig;
@@ -753,6 +802,7 @@ function mergeConfig(baseConfig, ...overrideConfigs) {
 			"plugins"
 		].includes(key)) return Array.from(new Set([...target ?? [], ...source ?? []]));
 		if (key === "reporter") return source ?? target;
+		if (key === "dangerously_overrideRolldownOptions") return composeOverrideRolldownOptions(target, source);
 	});
 	return mergedConfig;
 }
@@ -779,11 +829,13 @@ async function loadConfig(options = {}) {
 		...commonOptions
 	});
 	const plugins = await flattenPluginOption(userConfig.plugins);
-	const pluginConfig = await resolvePluginConfig(userConfig, plugins);
-	const resolvedConfig = mergeConfig(defaultConfig, ...[{
-		...userConfig,
+	const resolvedConfig = {
+		...await resolvePluginConfig(mergeConfig(defaultConfig, {
+			...userConfig,
+			plugins
+		}), plugins),
 		plugins
-	}, pluginConfig]);
+	};
 	await invokeConfigResolved(resolvedConfig, plugins);
 	return resolvedConfig;
 }
@@ -794,13 +846,16 @@ async function flattenPluginOption(pluginOption) {
 	return [awaitedPluginOption];
 }
 async function resolvePluginConfig(baseConfig, plugins) {
-	let mergedConfig = omit(baseConfig, ["plugins", "dangerously_overrideRolldownOptions"]);
+	let mergedConfig = omit(baseConfig, ["plugins"]);
 	for (const plugin of plugins) {
 		const context = createPluginContext(plugin.name);
+		const overrideBefore = mergedConfig.dangerously_overrideRolldownOptions;
 		if (typeof plugin.config === "function") {
 			const config = await plugin.config.call(context, mergedConfig);
 			if (config != null) mergedConfig = mergeConfig(mergedConfig, config);
 		} else if (typeof plugin.config === "object") mergedConfig = mergeConfig(mergedConfig, plugin.config);
+		const overrideAfter = mergedConfig.dangerously_overrideRolldownOptions;
+		if (overrideAfter != null && overrideAfter !== overrideBefore) context.debug({ message: `set 'dangerously_overrideRolldownOptions'` });
 	}
 	return mergedConfig;
 }
@@ -974,9 +1029,6 @@ function indent(text, indent, space = " ") {
 function asLiteral(value) {
 	return JSON.stringify(value);
 }
-function asIdentifier(name) {
-	return name;
-}
 function nodeEnvironment(dev) {
 	return dev ? "development" : "production";
 }
@@ -1040,6 +1092,14 @@ function defineEnvFromObject(env) {
 	return Object.fromEntries(Object.entries(env).map(([key, value]) => [`import.meta.env.${key}`, asLiteral(value)]));
 }
 //#endregion
+//#region src/utils/runtime-target.ts
+function resolveRuntimeTarget(target) {
+	switch (target) {
+		case "hermes": return "Hermes";
+		default: return "HermesV1";
+	}
+}
+//#endregion
 //#region src/utils/server.ts
 function getBaseUrl(host, port, https) {
 	return `${https ? "https" : "http"}://${host}:${port}`;
@@ -1052,17 +1112,18 @@ function getBuildTotalModules(storage, id) {
 //#endregion
 //#region src/core/env.ts
 function loadEnv(options) {
-	const { envDir, envPrefix, mode } = options;
+	const { envDir, envPrefix, envFile, mode } = options;
 	invariant(envPrefix.length > 0, "`envPrefix` is required");
+	invariant(envFile.length > 0, "`envFile` is required");
 	const env = {};
 	const envFilesToLoad = [
-		`.env`,
-		`.env.local`,
-		mode ? `.env.${mode}` : null,
-		mode ? `.env.${mode}.local` : null
+		envFile,
+		`${envFile}.local`,
+		mode ? `${envFile}.${mode}` : null,
+		mode ? `${envFile}.${mode}.local` : null
 	].filter(isNotNil);
-	for (const envFile of envFilesToLoad) {
-		const envPath = path.resolve(envDir, envFile);
+	for (const file of envFilesToLoad) {
+		const envPath = path.resolve(envDir, file);
 		if (!fs.existsSync(envPath)) continue;
 		logger$2.trace(`Loading environment variables from ${envPath}`);
 		const parsed = dotenv.parse(fs.readFileSync(envPath, "utf-8"));
@@ -1208,7 +1269,7 @@ var FileSystemBundleStore = class {
 			code,
 			mtimeMs: stats.mtimeMs
 		};
-		logger$2.info(`File system bundle created at ${bundleFilePath}`);
+		logger$2.debug(`File system bundle created at ${bundleFilePath}`);
 	}
 	update() {
 		this.holder = {
@@ -2423,6 +2484,7 @@ var assets_exports = /* @__PURE__ */ __exportAll({
 	stripSuffix: () => stripSuffix
 });
 const SCALE_PATTERN = "@(\\d+\\.?\\d*)x";
+const IMAGE_ASSET_TYPES = new Set(IMAGE_EXTENSIONS);
 /**
 * key: platform,
 * value: allowed scales
@@ -2452,6 +2514,7 @@ async function resolveScaledAssets(options) {
 		preferNativePlatform
 	};
 	const extension = path.extname(assetPath);
+	const type = extension.substring(1);
 	const relativePath = path.relative(projectRoot, assetPath);
 	const dirname = path.dirname(assetPath);
 	const files = fs.readdirSync(dirname);
@@ -2469,7 +2532,7 @@ async function resolveScaledAssets(options) {
 	}
 	if (!(Object.keys(scaledAssets).length && scaledAssets[1])) throw new Error(`cannot resolve base asset of ${assetPath}`);
 	const imageData = fs.readFileSync(assetPath);
-	const dimensions = imageSize(imageData);
+	const dimensions = IMAGE_ASSET_TYPES.has(type) ? imageSize(imageData) : void 0;
 	const filteredScaledAssets = Object.entries(scaledAssets).map(([scale, file]) => ({
 		scale: parseFloat(scale),
 		file
@@ -2485,9 +2548,9 @@ async function resolveScaledAssets(options) {
 		__packager_asset: true,
 		id: assetPath,
 		name: stripedBasename.replace(extension, ""),
-		type: extension.substring(1),
-		width: dimensions.width,
-		height: dimensions.height,
+		type,
+		width: dimensions?.width,
+		height: dimensions?.height,
 		files: filteredScaledAssets.files,
 		scales: filteredScaledAssets.scales,
 		fileSystemLocation: path.dirname(assetPath),
@@ -2690,8 +2753,8 @@ function withTransformBoundary(context, plugins) {
 }
 //#endregion
 //#region src/core/plugins/react-native-plugin.ts
-function reactNativePlugin(config, options) {
-	const { buildType, flowFilter, codegenFilter, assetsDir, assetExtensions, assetRegistryPath, hmrClientPath } = options;
+function reactNativePlugin(options) {
+	const { projectRoot, platform, preferNativePlatform, buildType, assetsDir, assetExtensions, assetRegistryPath, flowFilter, codegenFilter, builtinPluginConfig } = options;
 	const codegenPlugin = {
 		name: "rollipop:react-native-codegen-marker",
 		transform: {
@@ -2728,10 +2791,10 @@ function reactNativePlugin(config, options) {
 			async handler(id) {
 				this.debug(`Asset ${id} found`);
 				const assetData = await resolveScaledAssets({
-					projectRoot: config.root,
+					projectRoot,
 					assetPath: id,
-					platform: options.platform,
-					preferNativePlatform: config.resolver.preferNativePlatform
+					platform,
+					preferNativePlatform
 				});
 				assets.push(assetData);
 				return {
@@ -2751,33 +2814,13 @@ function reactNativePlugin(config, options) {
 				await copyAssetsToDestination({
 					assets,
 					assetsDir,
-					platform: options.platform,
-					preferNativePlatform: config.resolver.preferNativePlatform
+					platform,
+					preferNativePlatform
 				});
 			}
 		}
 	};
-	const defaultRuntimeImplements = getDefaultRuntimeImplements();
-	const hmrConfig = resolveHmrConfig(config);
-	const replaceHMRClientPlugin = {
-		name: "rollipop:react-native-replace-hmr-client",
-		load: {
-			filter: [include(id(exactRegex(hmrClientPath)))],
-			handler(id) {
-				this.debug(`Replacing HMR client: ${id}`);
-				return {
-					code: hmrConfig?.clientImplement ?? defaultRuntimeImplements.clientImplement,
-					moduleType: "ts"
-				};
-			}
-		}
-	};
-	return [
-		codegenPlugin,
-		stripFlowSyntaxPlugin,
-		assetPlugin,
-		...(buildType === "serve" ? [replaceHMRClientPlugin] : null) ?? []
-	];
+	return [...builtinPluginConfig ? [rollipopReactNativePlugin(builtinPluginConfig)] : [codegenPlugin, stripFlowSyntaxPlugin], assetPlugin];
 }
 //#endregion
 //#region src/core/plugins/prelude-plugin.ts
@@ -2830,42 +2873,9 @@ function jsonPlugin() {
 	};
 }
 //#endregion
-//#region src/core/plugins/svg-plugin.ts
-function svgPlugin(options) {
-	if (!options.enabled) return null;
-	return {
-		name: "rollipop:svg",
-		load: {
-			filter: { id: /\.svg$/ },
-			async handler(id) {
-				return {
-					code: await transform$1(fs.readFileSync(id, "utf-8"), {
-						template: defaultTemplate,
-						plugins: [__require.resolve("@svgr/plugin-jsx")],
-						native: true
-					}, { filePath: id }),
-					moduleType: "jsx"
-				};
-			}
-		}
-	};
-}
-const SVG_COMPONENT_NAME = "SvgLogo";
-const defaultTemplate = (variables, { tpl }) => {
-	return tpl`${variables.imports};
-
-${variables.interfaces};
-
-const ${SVG_COMPONENT_NAME} = (${variables.props}) => (
-  ${variables.jsx}
-);
-
-export default ${SVG_COMPONENT_NAME};`;
-};
-//#endregion
 //#region src/utils/babel.ts
-function mergeBabelOptions(baseOptions, ...options) {
-	return options.reduce((acc, options) => mergeWith(acc, options, merge$2), baseOptions);
+function mergeBabelOptions(options) {
+	return options.reduce((acc, options) => mergeWith(acc, options, merge$2), {});
 }
 function merge$2(target, source, key) {
 	if (key === "plugins") return [...target ?? [], ...source ?? []];
@@ -2882,8 +2892,8 @@ function isJSX(id) {
 }
 //#endregion
 //#region src/core/plugins/babel-plugin.ts
-function babelPlugin(options) {
-	const { rules = [] } = options ?? {};
+function babelPlugin({ useNativeTransformPipeline, transformConfig }) {
+	const { rules = [] } = transformConfig ?? {};
 	const babelOptionsById = /* @__PURE__ */ new Map();
 	const babelRules = rules.map(({ filter, options }, index) => {
 		return {
@@ -2907,14 +2917,14 @@ function babelPlugin(options) {
 			const flags = getFlag(this, id);
 			if (flags & TransformFlag.SKIP_ALL) return;
 			const babelOptions = babelOptionsById.get(id) ?? [];
-			if (!(flags & TransformFlag.CODEGEN_REQUIRED || babelOptions.length > 0)) return;
-			const baseOptions = getPreset(flags, id);
+			if (!(useNativeTransformPipeline ? babelOptions.length > 0 : flags & TransformFlag.CODEGEN_REQUIRED || babelOptions.length > 0)) return;
+			const baseOptions = useNativeTransformPipeline ? [] : [getPreset(flags, id)];
 			const result = babel.transformSync(code, {
 				filename: id,
 				babelrc: false,
 				configFile: false,
 				sourceMaps: true,
-				...mergeBabelOptions(baseOptions, ...babelOptions)
+				...mergeBabelOptions([...baseOptions, ...babelOptions])
 			});
 			invariant(result?.code, `Failed to transform with babel: ${id}`);
 			return {
@@ -2949,8 +2959,8 @@ function getPreset(flags, id) {
 }
 //#endregion
 //#region src/utils/swc.ts
-function mergeSwcOptions(baseOptions, ...options) {
-	return options.reduce((acc, options) => mergeWith(acc, options, merge$1), baseOptions);
+function mergeSwcOptions(options) {
+	return options.reduce((acc, options) => mergeWith(acc, options, merge$1), {});
 }
 function merge$1(target, source, key) {
 	if (key === "plugins") return [...target ?? [], ...source ?? []];
@@ -2960,8 +2970,8 @@ function merge$1(target, source, key) {
 const ROLLDOWN_RUNTIME_EXCLUDE_FILTER = exclude(or(id(/rolldown\/runtime/), id(/@oxc-project\+runtime/)));
 //#endregion
 //#region src/core/plugins/swc-plugin.ts
-function swcPlugin(runtimeTarget, options) {
-	const { rules = [] } = options ?? {};
+function swcPlugin({ useNativeTransformPipeline, runtimeTarget, transformConfig }) {
+	const { rules = [] } = transformConfig ?? {};
 	const swcOptionsById = /* @__PURE__ */ new Map();
 	const swcHelpersResolvePlugin = {
 		name: "rollipop:swc-helpers-resolve",
@@ -2986,7 +2996,7 @@ function swcPlugin(runtimeTarget, options) {
 			}
 		};
 	});
-	const getSwcPreset = presets[runtimeTarget];
+	const getSwcPreset = useNativeTransformPipeline ? null : presets[runtimeTarget];
 	const swcPlugin = {
 		name: "rollipop:swc",
 		buildStart() {
@@ -2997,14 +3007,15 @@ function swcPlugin(runtimeTarget, options) {
 			handler(code, id) {
 				if (getFlag(this, id) & TransformFlag.SKIP_ALL) return;
 				const swcOptions = swcOptionsById.get(id) ?? [];
-				const baseOptions = getSwcPreset(id);
+				if (getSwcPreset == null && swcOptions.length === 0) return;
+				const baseOptions = getSwcPreset != null ? [getSwcPreset(id)] : [];
 				const result = swc.transformSync(code, {
 					filename: id,
 					configFile: false,
 					swcrc: false,
 					sourceMaps: true,
 					inputSourceMap: false,
-					...mergeSwcOptions(baseOptions, ...swcOptions)
+					...mergeSwcOptions([...baseOptions, ...swcOptions])
 				});
 				return {
 					code: result.code,
@@ -3109,14 +3120,37 @@ function reporterPlugin(options) {
 	};
 }
 //#endregion
+//#region src/core/plugins/dev-server-plugin.ts
+async function devServerPlugin(options) {
+	const { cwd, hmrClientPath, hmrConfig } = options;
+	if (hmrConfig == null) return null;
+	return [{
+		name: "rollipop:replace-hmr-client",
+		load: {
+			filter: [include(id(exactRegex(resolveFrom(cwd, typeof hmrClientPath === "function" ? await hmrClientPath(cwd) : hmrClientPath))))],
+			handler(id) {
+				this.debug(`Replacing HMR client: ${id}`);
+				return {
+					code: hmrConfig.clientImplement,
+					moduleType: "ts"
+				};
+			}
+		}
+	}, rollipopReactRefreshWrapperPlugin({
+		cwd,
+		include: [/\.[tj]sx?(?:$|\?)/],
+		exclude: [/\/node_modules\//]
+	})];
+}
+//#endregion
 //#region src/core/plugins/index.ts
 var plugins_exports = /* @__PURE__ */ __exportAll({
 	babel: () => babelPlugin,
+	devServer: () => devServerPlugin,
 	json: () => jsonPlugin,
 	prelude: () => preludePlugin,
 	reactNative: () => reactNativePlugin,
 	reporter: () => reporterPlugin,
-	svg: () => svgPlugin,
 	swc: () => swcPlugin
 });
 //#endregion
@@ -3133,18 +3167,18 @@ async function resolveRolldownOptions(context, config, buildOptions, devEngineOp
 		MODE: config.mode,
 		...isDevServerMode ? { BASE_URL: getBaseUrl(devEngineOptions.host, devEngineOptions.port, devEngineOptions.https) } : null
 	};
+	const hmrConfig = resolveHmrConfig(config);
+	const hmrEnabled = hmrConfig != null;
 	const { sourceExtensions, assetExtensions, preferNativePlatform, external: rolldownExternal, ...rolldownResolve } = config.resolver;
-	const { polyfills, prelude: preludePaths, banner: rolldownBanner, footer: rolldownFooter, postBanner: rolldownPostBanner, postFooter: rolldownPostFooter, intro: rolldownIntro, outro: rolldownOutro, shimMissingExports: rolldownShimMissingExports } = config.serializer;
-	const { flow, babel: babelConfig, swc: swcConfig, ...rolldownTransform } = config.transformer;
+	const { polyfills, banner: rolldownBanner, footer: rolldownFooter, postBanner: rolldownPostBanner, postFooter: rolldownPostFooter, intro: rolldownIntro, outro: rolldownOutro, shimMissingExports: rolldownShimMissingExports } = config.serializer;
+	const { flow: _flow, babel: _babel, swc: _swc, ...rolldownTransform } = config.transformer;
 	const { treeshake: rolldownTreeshake, minify: rolldownMinify, lazyBarrel: rolldownLazyBarrel, ...rolldownOptimization } = config.optimization;
-	const { codegen, assetRegistryPath, hmrClientPath, globalIdentifiers: rolldownGlobalIdentifiers } = config.reactNative;
+	const { globalIdentifiers: rolldownGlobalIdentifiers } = config.reactNative;
 	const { sourcemap: rolldownSourcemap, sourcemapBaseUrl: rolldownSourcemapBaseUrl, sourcemapDebugIds: rolldownSourcemapDebugIds, sourcemapIgnoreList: rolldownSourcemapIgnoreList, sourcemapPathTransform: rolldownSourcemapPathTransform } = config;
-	const transformSvg = config.transformer.svg;
-	const resolvedSourceExtensions = transformSvg ? [...sourceExtensions, "svg"] : sourceExtensions;
-	const resolvedAssetExtensions = transformSvg ? assetExtensions.filter((extension) => extension !== "svg") : assetExtensions;
+	const userPlugins = config.plugins;
 	const mergedResolveOptions = merge({ extensions: getResolveExtensions({
-		sourceExtensions: resolvedSourceExtensions,
-		assetExtensions: resolvedAssetExtensions,
+		sourceExtensions,
+		assetExtensions,
 		platform,
 		preferNativePlatform
 	}) }, rolldownResolve);
@@ -3157,29 +3191,20 @@ async function resolveRolldownOptions(context, config, buildOptions, devEngineOp
 		},
 		define: {
 			__DEV__: asLiteral(dev),
-			global: asIdentifier(GLOBAL_IDENTIFIER),
 			"process.env.NODE_ENV": asLiteral(nodeEnvironment(dev)),
 			"process.env.DEBUG_ROLLIPOP": asLiteral(isDebugEnabled()),
+			...hmrEnabled ? null : { "import.meta.hot": "{}" },
 			...defineEnvFromObject(env),
 			...defineEnvFromObject(builtInEnv)
 		},
 		helpers: { mode: "Runtime" }
 	}, rolldownTransform);
-	const devServerPlugins = isDevServerMode ? [rollipopReactRefreshWrapperPlugin({
-		cwd: config.root,
-		include: [/\.[tj]sx?(?:$|\?)/],
-		exclude: [/\/node_modules\//]
-	})] : null;
-	const defaultReporters = [(() => {
-		switch (config.terminal.status) {
-			case "compat": return new CompatStatusReporter();
-			case "progress": return new ProgressBarStatusReporter(context.id, `[${platform}, ${buildOptions.dev ? "dev" : "prod"}]`, getBuildTotalModules(context.storage, context.id));
-		}
-	})()];
-	const reporterOptions = {
-		initialTotalModules: getBuildTotalModules(context.storage, context.id),
-		reporter: mergeReporters([...defaultReporters, config.reporter].filter(isNotNil))
-	};
+	const preludePluginOptions = resolvePreludePluginOptions(config);
+	const reactNativePluginOptions = await resolveReactNativePluginOptions(config, context, buildOptions);
+	const babelPluginOptions = resolveBabelPluginOptions(config);
+	const swcPluginOptions = resolveSwcPluginOptions(config);
+	const devServerPluginOptions = resolveDevServerPluginOptions(config, hmrConfig);
+	const reporterPluginOptions = resolveReporterPluginOptions(config, context, buildOptions);
 	const finalOptions = await applyDangerouslyOverrideOptionsFinalizer(config, {
 		platform: "neutral",
 		cwd: config.root,
@@ -3190,31 +3215,20 @@ async function resolveRolldownOptions(context, config, buildOptions, devEngineOp
 		treeshake: rolldownTreeshake,
 		external: rolldownExternal,
 		shimMissingExports: rolldownShimMissingExports,
-		optimization: {
-			...rolldownOptimization,
-			inlineConst: false
+		optimization: rolldownOptimization,
+		experimental: {
+			lazyBarrel: rolldownLazyBarrel,
+			...isDevServerMode ? { devMode: hmrConfig ? { implement: hmrConfig.runtimeImplement } : false } : null
 		},
-		experimental: { lazyBarrel: rolldownLazyBarrel },
 		plugins: withTransformBoundary(context, [
-			preludePlugin({ modulePaths: preludePaths }),
-			reactNativePlugin(config, {
-				dev,
-				platform,
-				buildType: context.buildType,
-				codegenFilter: codegen.filter,
-				flowFilter: flow.filter,
-				assetsDir: buildOptions.assetsDir,
-				assetExtensions: resolvedAssetExtensions,
-				assetRegistryPath: resolveFrom(config.root, typeof assetRegistryPath === "function" ? await assetRegistryPath(config.root) : assetRegistryPath),
-				hmrClientPath: resolveFrom(config.root, typeof hmrClientPath === "function" ? await hmrClientPath(config.root) : hmrClientPath)
-			}),
+			preludePlugin(preludePluginOptions),
+			reactNativePlugin(reactNativePluginOptions),
 			jsonPlugin(),
-			svgPlugin({ enabled: transformSvg }),
-			babelPlugin(babelConfig),
-			swcPlugin(config.runtimeTarget, swcConfig),
-			reporterPlugin(reporterOptions),
-			devServerPlugins,
-			config.plugins
+			babelPlugin(babelPluginOptions),
+			swcPlugin(swcPluginOptions),
+			devServerPlugin(devServerPluginOptions),
+			reporterPlugin(reporterPluginOptions),
+			userPlugins
 		]),
 		checks: {
 			eval: false,
@@ -3246,7 +3260,7 @@ async function resolveRolldownOptions(context, config, buildOptions, devEngineOp
 		sourcemapBaseUrl: rolldownSourcemapBaseUrl,
 		sourcemapDebugIds: rolldownSourcemapDebugIds,
 		sourcemapIgnoreList: rolldownSourcemapIgnoreList,
-		sourcemapPathTransform: rolldownSourcemapPathTransform,
+		sourcemapPathTransform: rolldownSourcemapPathTransform ?? createProjectRootSourcemapPathTransform(config.root),
 		codeSplitting: false,
 		strictExecutionOrder: true,
 		globalIdentifiers: rolldownGlobalIdentifiers,
@@ -3255,12 +3269,98 @@ async function resolveRolldownOptions(context, config, buildOptions, devEngineOp
 	resolveRolldownOptions.cache.set(context.id, finalOptions);
 	return finalOptions;
 }
+function resolvePreludePluginOptions(config) {
+	return { modulePaths: config.serializer.prelude };
+}
+async function resolveReactNativePluginOptions(config, context, buildOptions) {
+	return {
+		projectRoot: config.root,
+		platform: buildOptions.platform,
+		preferNativePlatform: config.resolver.preferNativePlatform,
+		buildType: context.buildType,
+		assetsDir: buildOptions.assetsDir,
+		assetExtensions: config.resolver.assetExtensions,
+		assetRegistryPath: await resolveAssetRegistryPath(config),
+		flowFilter: config.transformer.flow?.filter ?? [],
+		codegenFilter: config.reactNative.codegen?.filter ?? [],
+		builtinPluginConfig: resolveReactNativeBuiltinPluginConfig(config)
+	};
+}
+async function resolveAssetRegistryPath(config) {
+	const { assetRegistryPath } = config.reactNative;
+	const path = typeof assetRegistryPath === "function" ? await assetRegistryPath(config.root) : assetRegistryPath;
+	return resolveFrom(config.root, path);
+}
+function resolveReactNativeBuiltinPluginConfig(config) {
+	if (!config.experimental?.nativeTransformPipeline) return null;
+	return {
+		envName: config.mode,
+		runtimeTarget: resolveRuntimeTarget(config.runtimeTarget),
+		flow: config.experimental.flow,
+		worklets: resolveWorkletsConfig(config)
+	};
+}
+function resolveWorkletsConfig(config) {
+	const { worklets } = config.experimental ?? {};
+	if (worklets == null) return;
+	return merge({
+		isRelease: config.mode === "production",
+		pluginVersion: resolvePackageJson(config.root, "react-native-worklets")?.version
+	}, worklets);
+}
+function resolveBabelPluginOptions(config) {
+	return {
+		useNativeTransformPipeline: config.experimental?.nativeTransformPipeline,
+		transformConfig: config.transformer.babel
+	};
+}
+function resolveSwcPluginOptions(config) {
+	return {
+		useNativeTransformPipeline: config.experimental?.nativeTransformPipeline,
+		runtimeTarget: config.runtimeTarget,
+		transformConfig: config.transformer.swc
+	};
+}
+function resolveDevServerPluginOptions(config, hmrConfig) {
+	return {
+		cwd: config.root,
+		hmrClientPath: config.reactNative.hmrClientPath,
+		hmrConfig
+	};
+}
+function resolveReporterPluginOptions(config, context, buildOptions) {
+	const statusReporter = createStatusReporter(config, context, buildOptions);
+	return {
+		initialTotalModules: getBuildTotalModules(context.storage, context.id),
+		reporter: mergeReporters([statusReporter, config.reporter].filter(isNotNil))
+	};
+}
+function createStatusReporter(config, context, buildOptions) {
+	switch (config.terminal.status) {
+		case "compat": return new CompatStatusReporter();
+		case "progress": return new ProgressBarStatusReporter(context.id, `[${buildOptions.platform}, ${buildOptions.dev ? "dev" : "prod"}]`, getBuildTotalModules(context.storage, context.id));
+	}
+}
 function getResolveExtensions({ platform, sourceExtensions, assetExtensions, preferNativePlatform }) {
 	const supportedExtensions = [...sourceExtensions, ...assetExtensions];
 	return [...[platform, preferNativePlatform ? "native" : null].filter(isNotNil).map((platform) => {
 		return supportedExtensions.map((extension) => `.${platform}.${extension}`);
 	}), ...supportedExtensions.map((extension) => `.${extension}`)].flat();
 }
+/**
+* Default sourcemap path transform.
+*
+* Rolldown emits `sources` relative to the bundle output's directory, which
+* yields paths like `../App.tsx` when the bundle lives under e.g. `dist/`.
+* RN tooling (symbolication, devtools) expects project-root-relative paths,
+* so this rewrites each entry to be relative to `projectRoot`.
+*/
+function createProjectRootSourcemapPathTransform(projectRoot) {
+	return (source, sourcemapPath) => {
+		const absolute = path.resolve(path.dirname(sourcemapPath), source);
+		return path.relative(projectRoot, absolute);
+	};
+}
 function loadPolyfills(polyfills) {
 	return polyfills.map((polyfill) => {
 		if (typeof polyfill === "string") return fs.readFileSync(polyfill, "utf-8");
@@ -3270,22 +3370,21 @@ function loadPolyfills(polyfills) {
 	});
 }
 async function applyDangerouslyOverrideOptionsFinalizer(config, inputOptions, outputOptions) {
-	if (typeof config.dangerously_overrideRolldownOptions === "function") return await config.dangerously_overrideRolldownOptions({
+	const override = config.dangerously_overrideRolldownOptions;
+	if (override == null) return {
 		input: inputOptions,
 		output: outputOptions
-	});
-	return {
-		input: merge(inputOptions, config.dangerously_overrideRolldownOptions?.input ?? {}),
-		output: merge(outputOptions, config.dangerously_overrideRolldownOptions?.output ?? {})
 	};
+	return await applyOverrideRolldownOptions(override, {
+		input: inputOptions,
+		output: outputOptions
+	});
 }
-function getOverrideOptionsForDevServer(config, buildOptions) {
-	const hmrConfig = resolveHmrConfig(config);
+function getOverrideOptionsForDevServer(buildOptions) {
 	return {
 		input: {
 			transform: { jsx: { development: true } },
 			experimental: {
-				devMode: hmrConfig ? { implement: hmrConfig.runtimeImplement } : false,
 				incrementalBuild: true,
 				nativeMagicString: true
 			},
@@ -3309,7 +3408,7 @@ var Bundler = class Bundler {
 		const resolvedBuildOptions = resolveBuildOptions(config, buildOptions);
 		const context = Bundler.createContext(buildType, config, resolvedBuildOptions);
 		const { input = {}, output = {} } = await resolveRolldownOptions(context, config, resolvedBuildOptions, devEngineOptions);
-		const devServerOptions = getOverrideOptionsForDevServer(config, resolvedBuildOptions);
+		const devServerOptions = getOverrideOptionsForDevServer(resolvedBuildOptions);
 		const devEngine = await dev(merge(input, devServerOptions.input), merge(output, devServerOptions.output), {
 			watch: config.watcher,
 			...devEngineOptions
@@ -3381,7 +3480,7 @@ async function runServer(config, options) {
 }
 //#endregion
 //#region package.json
-var version = "0.1.0-dev.20260424074146";
+var version = "1.0.0-alpha.21";
 //#endregion
 //#region src/node/logger.ts
 const logger = new Logger("cli");
@@ -3593,9 +3692,10 @@ function assertHasNoDuplicateCommands(defaultCommands, commands) {
 //#endregion
 //#region src/node/cli-utils.ts
 function createCommand(commandDefinition) {
-	const { name, description, options, action } = commandDefinition;
+	const { name, description, helpText, options, action } = commandDefinition;
 	const command = new Command(name).description(description);
 	if (options != null) for (const option of options) (option.required ? command.requiredOption.bind(command) : command.option.bind(command))(option.name, option.description ?? "", (value) => option.parse != null ? option.parse(value) : value, option.default);
+	if (helpText != null) command.addHelpText("after", `\n${helpText}`);
 	return command.action(withErrorHandler(async function(args) {
 		await action.call({ platforms: ["android", "ios"] }, args);
 	}));
@@ -3612,6 +3712,80 @@ function createReactNativeCliCommand(commandDefinition) {
 	};
 }
 //#endregion
+//#region src/node/commands/agent/action.ts
+const defaultBaseUrl = `http://${DEFAULT_HOST}:${DEFAULT_PORT}`;
+function getAgentGuide(baseUrl = defaultBaseUrl) {
+	return [
+		"Rollipop Agent Guide",
+		"",
+		"Rollipop exposes build and runtime diagnostics through SSE and MCP.",
+		"Keep the dev server running, then connect your agent to one of these endpoints.",
+		"",
+		"Start the dev server:",
+		"",
+		"  rollipop start --reset-cache",
+		"",
+		"Default endpoints:",
+		"",
+		`  SSE events:      ${baseUrl}/sse/events`,
+		`  MCP server:      ${baseUrl}/mcp`,
+		`  Reset cache:     ${baseUrl}/reset-cache`,
+		`  Bundler status:  ${baseUrl}/bundlers/<id>/status`,
+		"",
+		"If you start Rollipop with custom --host, --port, or --https options,",
+		"adjust these URLs to match the running dev server.",
+		"",
+		"SSE usage:",
+		"",
+		`  curl -N ${baseUrl}/sse/events`,
+		"",
+		"  Event format:",
+		"    event: <event_type>",
+		"    data: <json_payload>",
+		"",
+		"  Useful event types:",
+		"    bundle_build_started, bundle_build_done, bundle_build_failed",
+		"    watch_change, client_log, device_connected, device_disconnected",
+		"    server_ready, cache_reset",
+		"",
+		"MCP setup:",
+		"",
+		"  Add this to your project .mcp.json:",
+		"",
+		"    {",
+		"      \"mcpServers\": {",
+		"        \"rollipop\": {",
+		"          \"type\": \"http\",",
+		`          "url": "${baseUrl}/mcp"`,
+		"        }",
+		"      }",
+		"    }",
+		"",
+		"  Available tools:",
+		"    get_build_events({ \"duration\": 10000 })",
+		"    reset_cache()",
+		"",
+		"Agent workflow:",
+		"",
+		"  1. Run rollipop start and keep it running.",
+		"  2. Use get_build_events or subscribe to SSE before and after edits.",
+		"  3. Wait for bundle_build_done or bundle_build_failed.",
+		"  4. If the build fails, inspect the error payload, fix the code, and repeat.",
+		"  5. Use reset_cache or /reset-cache when stale cache is suspected."
+	].join("\n");
+}
+const action$2 = async () => {
+	console.log(getAgentGuide());
+};
+//#endregion
+//#region src/node/commands/agent/command.ts
+const command$2 = {
+	name: "agent",
+	description: "Print guidance for connecting LLM agents to Rollipop diagnostics.",
+	helpText: getAgentGuide(),
+	action: action$2
+};
+//#endregion
 //#region src/node/constants.ts
 const UNSUPPORTED_OPTION_DESCRIPTION = "This option is not supported by Rollipop.";
 //#endregion
@@ -3849,9 +4023,10 @@ var cli_exports = /* @__PURE__ */ __exportAll({ run: () => run });
 function run(argv) {
 	Logo.printOnce();
 	const cli = program.name("rollipop").version(version);
+	cli.addCommand(createCommand(command$2));
 	cli.addCommand(createCommand(command$1));
 	cli.addCommand(createCommand(command));
 	cli.parse(argv);
 }
 //#endregion
-export { assets_exports as AssetUtils, Bundler, DEFAULT_HOST, DEFAULT_PORT, DEV_SERVER_ASSET_PATH, cli_exports as cli, createCommand, createDevServer, createReactNativeCliCommand, defineConfig, flattenPluginOption, getDefaultConfig, invokeConfigResolved, loadConfig, loadEnv, mergeConfig, plugins_exports as plugins, resetCache, resolvePluginConfig, rolldown, rolldownExperimental, runBuild, runServer, setupInteractiveMode };
+export { assets_exports as AssetUtils, Bundler, constants_exports as Constants, DEFAULT_HOST, DEFAULT_PORT, DEV_SERVER_ASSET_PATH, cli_exports as cli, createCommand, createDevServer, createReactNativeCliCommand, defineConfig, flattenPluginOption, getDefaultConfig, invokeConfigResolved, loadConfig, loadEnv, mergeConfig, plugins_exports as plugins, resetCache, resolvePluginConfig, rolldown, rolldownExperimental, runBuild, runServer, setupInteractiveMode };