rollipop 0.1.0-alpha.8 → 0.1.0-dev.20260118070035

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # rollipop
 
+## 0.1.0-alpha.9
+
+### Patch Changes
+
+- 200e373: noop in `onHmrUpdates` when HMR is disabled
+- 099598b: esm only
+- 5b9fd00: update default `dev` option
+- 19c5b71: add built-in constants environment variables
+
 ## 0.1.0-alpha.8
 
 ### Patch Changes

package/client.d.ts

@@ -1,3 +1,8 @@
+interface ImportMetaEnv {
+  readonly MODE: 'development' | 'production';
+  readonly BASE_URL?: string;
+}
+
 interface ImportMeta {
   hot?: import('./dist').HMRContext;
   env: ImportMetaEnv;

package/dist/commands.cjs

@@ -696,7 +696,7 @@ function getDefaultConfig(basePath, mode) {
 	}
 	return {
 		root: basePath,
-		mode,
+		mode: mode ?? "development",
 		entry: "index.js",
 		resolver: {
 			sourceExtensions: DEFAULT_SOURCE_EXTENSIONS,
@@ -917,7 +917,6 @@ function resetCache(projectRoot) {
 //#endregion
 //#region src/utils/build-options.ts
 const DEFAULT_BUILD_OPTIONS = {
-	dev: true,
 	cache: true,
 	minify: false
 };
@@ -925,7 +924,7 @@ function resolveBuildOptions(config, buildOptions) {
 	if (buildOptions.outfile) buildOptions.outfile = node_path.default.resolve(config.root, buildOptions.outfile);
 	if (buildOptions.sourcemap) buildOptions.sourcemap = node_path.default.resolve(config.root, buildOptions.sourcemap);
 	return (0, es_toolkit.merge)(DEFAULT_BUILD_OPTIONS, {
-		dev: config.mode === "development",
+		dev: buildOptions.dev ?? config.mode === "development",
 		...buildOptions
 	});
 }
@@ -1390,9 +1389,9 @@ function bindReporter(config, eventSource) {
 	return config;
 }
 function resolveHmrConfig(config) {
-	if (config.devMode?.hmr == null) return null;
+	if (config.mode !== "development") return null;
 	const defaultRuntimeImplements = getDefaultRuntimeImplements();
-	if (typeof config.devMode?.hmr === "boolean") return config.devMode.hmr ? defaultRuntimeImplements : null;
+	if (typeof config.devMode.hmr === "boolean") return config.devMode.hmr ? defaultRuntimeImplements : null;
 	const { runtimeImplement = defaultRuntimeImplements.runtimeImplement, clientImplement = defaultRuntimeImplements.clientImplement } = config.devMode.hmr;
 	return {
 		runtimeImplement,
@@ -1408,6 +1407,18 @@ function getDefaultRuntimeImplements() {
 	return getDefaultRuntimeImplements.cache;
 }
 
+//#endregion
+//#region src/utils/env.ts
+function defineEnvFromObject(env) {
+	return Object.fromEntries(Object.entries(env).map(([key, value]) => [`import.meta.env.${key}`, asLiteral(value)]));
+}
+
+//#endregion
+//#region src/utils/server.ts
+function getBaseUrl(host, port, https) {
+	return `${https ? "https" : "http"}://${host}:${port}`;
+}
+
 //#endregion
 //#region src/core/env.ts
 function loadEnv(options) {
@@ -1618,6 +1629,7 @@ var InMemoryBundle = class {
 //#region src/server/bundler-pool.ts
 var BundlerDevEngine = class extends node_events.default {
 	initializeHandle;
+	isHmrEnabled;
 	_id;
 	bundle = null;
 	buildFailedError = null;
@@ -1630,6 +1642,7 @@ var BundlerDevEngine = class extends node_events.default {
 		this.buildOptions = buildOptions;
 		this._id = Bundler.createId(config, buildOptions);
 		this.initializeHandle = taskHandler();
+		this.isHmrEnabled = Boolean(config.mode === "development" && config.devMode.hmr);
 		this.initialize();
 	}
 	get id() {
@@ -1655,6 +1668,7 @@ var BundlerDevEngine = class extends node_events.default {
 			host: this.options.server.host,
 			port: this.options.server.port,
 			onHmrUpdates: (errorOrResult) => {
+				if (!this.isHmrEnabled) return;
 				if (errorOrResult instanceof Error) {
 					logger.error("Failed to handle HMR updates", {
 						bundlerId: this.id,
@@ -4692,10 +4706,16 @@ function getPreset() {
 //#endregion
 //#region src/core/rolldown.ts
 resolveRolldownOptions.cache = /* @__PURE__ */ new Map();
-async function resolveRolldownOptions(context, config, buildOptions) {
+async function resolveRolldownOptions(context, config, buildOptions, devEngineOptions) {
 	const cachedOptions = resolveRolldownOptions.cache.get(context.id);
 	if (cachedOptions != null) return cachedOptions;
+	const isDevServerMode = config.mode === "development" && context.buildType === "serve";
+	(0, es_toolkit.invariant)(isDevServerMode ? devEngineOptions != null : true, "devEngineOptions is required in dev server mode");
 	const env = loadEnv(config);
+	const builtInEnv = {
+		MODE: config.mode,
+		...isDevServerMode ? { BASE_URL: getBaseUrl(devEngineOptions.host, devEngineOptions.port, devEngineOptions.https) } : null
+	};
 	const { platform, dev: dev$1, cache, minify } = buildOptions;
 	const { sourceExtensions, assetExtensions, preferNativePlatform, ...rolldownResolve } = config.resolver;
 	const { prelude: preludePaths, polyfills } = config.serializer;
@@ -4722,13 +4742,14 @@ async function resolveRolldownOptions(context, config, buildOptions) {
 			global: asIdentifier(GLOBAL_IDENTIFIER),
 			"process.env.NODE_ENV": asLiteral(nodeEnvironment(dev$1)),
 			"process.env.DEBUG_ROLLIPOP": asLiteral(isDebugEnabled()),
-			...Object.fromEntries(Object.entries(env).map(([key, value]) => [`import.meta.env.${key}`, asLiteral(value)]))
+			...defineEnvFromObject(env),
+			...defineEnvFromObject(builtInEnv)
 		},
 		typescript: { removeClassFieldsWithoutInitializer: true },
 		assumptions: { setPublicClassFields: true },
 		helpers: { mode: "Runtime" }
 	}, rolldownTransform);
-	const devServerPlugins = config.mode === "development" && context.buildType === "serve" ? [reactRefreshPlugin()] : null;
+	const devServerPlugins = isDevServerMode ? [reactRefreshPlugin()] : null;
 	const { beforeTransform, afterTransform } = getPersistCachePlugins({
 		enabled: cache,
 		sourceExtensions,
@@ -4843,7 +4864,7 @@ var Bundler = class Bundler {
 		const buildType = "serve";
 		const resolvedBuildOptions = resolveBuildOptions(config, buildOptions);
 		const context = Bundler.createContext(buildType, config, resolvedBuildOptions);
-		const { input = {}, output = {} } = await resolveRolldownOptions(context, config, resolvedBuildOptions);
+		const { input = {}, output = {} } = await resolveRolldownOptions(context, config, resolvedBuildOptions, devEngineOptions);
 		const devServerOptions = getOverrideOptionsForDevServer(config);
 		const devEngine = await (0, _rollipop_rolldown_experimental.dev)((0, es_toolkit.merge)(input, devServerOptions.input), (0, es_toolkit.merge)(output, devServerOptions.output), {
 			watch: config.watcher,

package/dist/commands.js

@@ -646,7 +646,7 @@ function getDefaultConfig(basePath, mode) {
 	}
 	return {
 		root: basePath,
-		mode,
+		mode: mode ?? "development",
 		entry: "index.js",
 		resolver: {
 			sourceExtensions: DEFAULT_SOURCE_EXTENSIONS,
@@ -867,7 +867,6 @@ function resetCache(projectRoot) {
 //#endregion
 //#region src/utils/build-options.ts
 const DEFAULT_BUILD_OPTIONS = {
-	dev: true,
 	cache: true,
 	minify: false
 };
@@ -875,7 +874,7 @@ function resolveBuildOptions(config, buildOptions) {
 	if (buildOptions.outfile) buildOptions.outfile = path.resolve(config.root, buildOptions.outfile);
 	if (buildOptions.sourcemap) buildOptions.sourcemap = path.resolve(config.root, buildOptions.sourcemap);
 	return merge(DEFAULT_BUILD_OPTIONS, {
-		dev: config.mode === "development",
+		dev: buildOptions.dev ?? config.mode === "development",
 		...buildOptions
 	});
 }
@@ -1340,9 +1339,9 @@ function bindReporter(config, eventSource) {
 	return config;
 }
 function resolveHmrConfig(config) {
-	if (config.devMode?.hmr == null) return null;
+	if (config.mode !== "development") return null;
 	const defaultRuntimeImplements = getDefaultRuntimeImplements();
-	if (typeof config.devMode?.hmr === "boolean") return config.devMode.hmr ? defaultRuntimeImplements : null;
+	if (typeof config.devMode.hmr === "boolean") return config.devMode.hmr ? defaultRuntimeImplements : null;
 	const { runtimeImplement = defaultRuntimeImplements.runtimeImplement, clientImplement = defaultRuntimeImplements.clientImplement } = config.devMode.hmr;
 	return {
 		runtimeImplement,
@@ -1358,6 +1357,18 @@ function getDefaultRuntimeImplements() {
 	return getDefaultRuntimeImplements.cache;
 }
 
+//#endregion
+//#region src/utils/env.ts
+function defineEnvFromObject(env) {
+	return Object.fromEntries(Object.entries(env).map(([key, value]) => [`import.meta.env.${key}`, asLiteral(value)]));
+}
+
+//#endregion
+//#region src/utils/server.ts
+function getBaseUrl(host, port, https) {
+	return `${https ? "https" : "http"}://${host}:${port}`;
+}
+
 //#endregion
 //#region src/core/env.ts
 function loadEnv(options) {
@@ -1568,6 +1579,7 @@ var InMemoryBundle = class {
 //#region src/server/bundler-pool.ts
 var BundlerDevEngine = class extends EventEmitter {
 	initializeHandle;
+	isHmrEnabled;
 	_id;
 	bundle = null;
 	buildFailedError = null;
@@ -1580,6 +1592,7 @@ var BundlerDevEngine = class extends EventEmitter {
 		this.buildOptions = buildOptions;
 		this._id = Bundler.createId(config, buildOptions);
 		this.initializeHandle = taskHandler();
+		this.isHmrEnabled = Boolean(config.mode === "development" && config.devMode.hmr);
 		this.initialize();
 	}
 	get id() {
@@ -1605,6 +1618,7 @@ var BundlerDevEngine = class extends EventEmitter {
 			host: this.options.server.host,
 			port: this.options.server.port,
 			onHmrUpdates: (errorOrResult) => {
+				if (!this.isHmrEnabled) return;
 				if (errorOrResult instanceof Error) {
 					logger.error("Failed to handle HMR updates", {
 						bundlerId: this.id,
@@ -4642,10 +4656,16 @@ function getPreset() {
 //#endregion
 //#region src/core/rolldown.ts
 resolveRolldownOptions.cache = /* @__PURE__ */ new Map();
-async function resolveRolldownOptions(context, config, buildOptions) {
+async function resolveRolldownOptions(context, config, buildOptions, devEngineOptions) {
 	const cachedOptions = resolveRolldownOptions.cache.get(context.id);
 	if (cachedOptions != null) return cachedOptions;
+	const isDevServerMode = config.mode === "development" && context.buildType === "serve";
+	invariant(isDevServerMode ? devEngineOptions != null : true, "devEngineOptions is required in dev server mode");
 	const env = loadEnv(config);
+	const builtInEnv = {
+		MODE: config.mode,
+		...isDevServerMode ? { BASE_URL: getBaseUrl(devEngineOptions.host, devEngineOptions.port, devEngineOptions.https) } : null
+	};
 	const { platform, dev: dev$1, cache, minify } = buildOptions;
 	const { sourceExtensions, assetExtensions, preferNativePlatform, ...rolldownResolve } = config.resolver;
 	const { prelude: preludePaths, polyfills } = config.serializer;
@@ -4672,13 +4692,14 @@ async function resolveRolldownOptions(context, config, buildOptions) {
 			global: asIdentifier(GLOBAL_IDENTIFIER),
 			"process.env.NODE_ENV": asLiteral(nodeEnvironment(dev$1)),
 			"process.env.DEBUG_ROLLIPOP": asLiteral(isDebugEnabled()),
-			...Object.fromEntries(Object.entries(env).map(([key, value]) => [`import.meta.env.${key}`, asLiteral(value)]))
+			...defineEnvFromObject(env),
+			...defineEnvFromObject(builtInEnv)
 		},
 		typescript: { removeClassFieldsWithoutInitializer: true },
 		assumptions: { setPublicClassFields: true },
 		helpers: { mode: "Runtime" }
 	}, rolldownTransform);
-	const devServerPlugins = config.mode === "development" && context.buildType === "serve" ? [reactRefreshPlugin()] : null;
+	const devServerPlugins = isDevServerMode ? [reactRefreshPlugin()] : null;
 	const { beforeTransform, afterTransform } = getPersistCachePlugins({
 		enabled: cache,
 		sourceExtensions,
@@ -4793,7 +4814,7 @@ var Bundler = class Bundler {
 		const buildType = "serve";
 		const resolvedBuildOptions = resolveBuildOptions(config, buildOptions);
 		const context = Bundler.createContext(buildType, config, resolvedBuildOptions);
-		const { input = {}, output = {} } = await resolveRolldownOptions(context, config, resolvedBuildOptions);
+		const { input = {}, output = {} } = await resolveRolldownOptions(context, config, resolvedBuildOptions, devEngineOptions);
 		const devServerOptions = getOverrideOptionsForDevServer(config);
 		const devEngine = await dev(merge(input, devServerOptions.input), merge(output, devServerOptions.output), {
 			watch: config.watcher,

package/dist/hmr-client.d.ts

@@ -0,0 +1,6 @@
+import { HMRClientLogLevel } from "../types/hmr";
+
+//#region src/runtime/hmr-client.d.ts
+
+//#endregion
+export { u as default };

package/dist/hmr-runtime.d.ts

@@ -0,0 +1,2 @@
+//#endregion
+export { type c as DevRuntime };

package/dist/index.d.ts

@@ -157,6 +157,12 @@ type DevEngineOptions = Omit<DevOptions, 'watch'> & {
    * The port to run the dev server on.
    */
   port: number;
+  /**
+   * Whether to use HTTPS.
+   *
+   * Defaults to `false`.
+   */
+  https?: boolean;
 };
 interface BundlerContext {
   id: string;
@@ -521,8 +527,9 @@ type WatcherConfig = DevWatchOptions;
 interface DevModeConfig {
   /**
    * Hot Module Replacement configurations.
+   * This feature is only available in `development` mode.
    *
-   * Defaults to `true`
+   * Defaults to `true`.
    */
   hmr?: boolean | HmrConfig;
 }
@@ -591,7 +598,7 @@ declare function mergeConfig(baseConfig: DefaultConfig, ...overrideConfigs: Plug
 //#region src/config/defaults.d.ts
 declare function getDefaultConfig(basePath: string, mode?: Config['mode']): {
   root: string;
-  mode: "development" | "production" | undefined;
+  mode: "development" | "production";
   entry: string;
   resolver: {
     sourceExtensions: string[];
@@ -635,7 +642,7 @@ declare function getDefaultConfig(basePath: string, mode?: Config['mode']): {
     globalIdentifiers: string[];
   };
   devMode: {
-    hmr: true;
+    hmr: boolean | HmrConfig;
   };
   terminal: {
     status: "none" | "compat" | "progress" | undefined;
@@ -907,9 +914,34 @@ interface HMRServerError {
     description: string;
   }[];
 }
+interface DevRuntimeModule {
+  exportsHolder: {
+    exports: any;
+  };
+  id: string;
+  exports: any;
+}
+interface DevRuntimeInterface {
+  modules: Record<string, DevRuntimeModule>;
+  createModuleHotContext(moduleId: string): void;
+  applyUpdates(boundaries: [string, string][]): void;
+  registerModule(id: string, exportsHolder: DevRuntimeModule['exportsHolder']): void;
+  loadExports(id: string): void;
+}
+declare class DevRuntime implements DevRuntimeInterface {
+  constructor(messenger: DevRuntimeMessenger);
+  modules: Record<string, DevRuntimeModule>;
+  createModuleHotContext(moduleId: string): void;
+  applyUpdates(boundaries: [string, string][]): void;
+  registerModule(id: string, exportsHolder: DevRuntimeModule['exportsHolder']): void;
+  loadExports(id: string): void;
+}
+interface DevRuntimeMessenger {
+  send(message: HMRClientMessage): void;
+}
 declare namespace cli_d_exports {
   export { run };
 }
 declare function run(argv: string[]): void;
 //#endregion
-export { assets_d_exports as AssetUtils, AsyncResult, BabelTransformRule, BuildOptions, BuildType, BundleDetails, Bundler, BundlerContext, BundlerState, CodegenConfig, Config, DEFAULT_HOST, DEFAULT_PORT, DEV_SERVER_ASSET_PATH, DefaultConfig, DefineConfigContext, DevEngine, DevEngineOptions, DevModeConfig, DevServer, DevServerEvents, DynamicUserConfig, FlowConfig, FormattedError, HMRClientLogLevel, HMRClientMessage, HMRContext, HMRCustomHandler, HMRCustomMessage, HMRServerError, HMRServerMessage, HmrConfig, InteractiveCommand, InteractiveCommandContext, InteractiveModeOptions, LoadConfigOptions, LoadEnvOptions, MaybePromise, Middlewares, NullValue, type Plugin, type PluginConfig, PluginFlattenConfig, PluginOption, Polyfill, PolyfillType, PolyfillWithCode, PolyfillWithPath, ReactNativeConfig, ReportableEvent, Reporter, ResolvedConfig, ResolverConfig, RolldownConfig, SerializerConfig, ServerOptions, SwcTransformRule, TerminalConfig, TerminalReporter, TransformRule, TransformerConfig, UserConfig, WatcherConfig, cli_d_exports as cli, createCommand, createDevServer, createReactNativeCliCommand, defineConfig, flattenPluginOption, getDefaultConfig, invokeConfigResolved, loadConfig, loadEnv, mergeConfig, index_d_exports as plugins, resetCache, resolvePluginConfig, rolldown, rolldownExperimental, runBuild, runServer, setupInteractiveMode };
+export { assets_d_exports as AssetUtils, AsyncResult, BabelTransformRule, BuildOptions, BuildType, BundleDetails, Bundler, BundlerContext, BundlerState, CodegenConfig, Config, DEFAULT_HOST, DEFAULT_PORT, DEV_SERVER_ASSET_PATH, DefaultConfig, DefineConfigContext, DevEngine, DevEngineOptions, DevModeConfig, type DevRuntime, DevRuntimeInterface, DevRuntimeMessenger, DevRuntimeModule, DevServer, DevServerEvents, DynamicUserConfig, FlowConfig, FormattedError, HMRClientLogLevel, HMRClientMessage, HMRContext, HMRCustomHandler, HMRCustomMessage, HMRServerError, HMRServerMessage, HmrConfig, InteractiveCommand, InteractiveCommandContext, InteractiveModeOptions, LoadConfigOptions, LoadEnvOptions, MaybePromise, Middlewares, NullValue, type Plugin, type PluginConfig, PluginFlattenConfig, PluginOption, Polyfill, PolyfillType, PolyfillWithCode, PolyfillWithPath, ReactNativeConfig, ReportableEvent, Reporter, ResolvedConfig, ResolverConfig, RolldownConfig, SerializerConfig, ServerOptions, SwcTransformRule, TerminalConfig, TerminalReporter, TransformRule, TransformerConfig, UserConfig, WatcherConfig, cli_d_exports as cli, createCommand, createDevServer, createReactNativeCliCommand, defineConfig, flattenPluginOption, getDefaultConfig, invokeConfigResolved, loadConfig, loadEnv, mergeConfig, index_d_exports as plugins, resetCache, resolvePluginConfig, rolldown, rolldownExperimental, runBuild, runServer, setupInteractiveMode };

package/dist/index.js

@@ -190,7 +190,7 @@ function generateSourceFromAst(ast, id$1) {
 
 //#endregion
 //#region src/constants.ts
-const ROLLIPOP_VERSION = "0.1.0-alpha.8";
+const ROLLIPOP_VERSION = "0.1.0-dev.20260118070035";
 const GLOBAL_IDENTIFIER = "__ROLLIPOP_GLOBAL__";
 /**
 * @see {@link https://github.com/facebook/metro/blob/0.81.x/docs/Configuration.md#resolvermainfields}
@@ -365,7 +365,7 @@ function getDefaultConfig(basePath, mode) {
 	}
 	return {
 		root: basePath,
-		mode,
+		mode: mode ?? "development",
 		entry: "index.js",
 		resolver: {
 			sourceExtensions: DEFAULT_SOURCE_EXTENSIONS,
@@ -650,7 +650,6 @@ const Logo = {
 //#endregion
 //#region src/utils/build-options.ts
 const DEFAULT_BUILD_OPTIONS = {
-	dev: true,
 	cache: true,
 	minify: false
 };
@@ -658,7 +657,7 @@ function resolveBuildOptions(config, buildOptions) {
 	if (buildOptions.outfile) buildOptions.outfile = path.resolve(config.root, buildOptions.outfile);
 	if (buildOptions.sourcemap) buildOptions.sourcemap = path.resolve(config.root, buildOptions.sourcemap);
 	return merge(DEFAULT_BUILD_OPTIONS, {
-		dev: config.mode === "development",
+		dev: buildOptions.dev ?? config.mode === "development",
 		...buildOptions
 	});
 }
@@ -1123,9 +1122,9 @@ function bindReporter(config, eventSource) {
 	return config;
 }
 function resolveHmrConfig(config) {
-	if (config.devMode?.hmr == null) return null;
+	if (config.mode !== "development") return null;
 	const defaultRuntimeImplements = getDefaultRuntimeImplements();
-	if (typeof config.devMode?.hmr === "boolean") return config.devMode.hmr ? defaultRuntimeImplements : null;
+	if (typeof config.devMode.hmr === "boolean") return config.devMode.hmr ? defaultRuntimeImplements : null;
 	const { runtimeImplement = defaultRuntimeImplements.runtimeImplement, clientImplement = defaultRuntimeImplements.clientImplement } = config.devMode.hmr;
 	return {
 		runtimeImplement,
@@ -1141,6 +1140,18 @@ function getDefaultRuntimeImplements() {
 	return getDefaultRuntimeImplements.cache;
 }
 
+//#endregion
+//#region src/utils/env.ts
+function defineEnvFromObject(env) {
+	return Object.fromEntries(Object.entries(env).map(([key, value]) => [`import.meta.env.${key}`, asLiteral(value)]));
+}
+
+//#endregion
+//#region src/utils/server.ts
+function getBaseUrl(host, port, https) {
+	return `${https ? "https" : "http"}://${host}:${port}`;
+}
+
 //#endregion
 //#region src/core/env.ts
 function loadEnv(options) {
@@ -1351,6 +1362,7 @@ var InMemoryBundle = class {
 //#region src/server/bundler-pool.ts
 var BundlerDevEngine = class extends EventEmitter {
 	initializeHandle;
+	isHmrEnabled;
 	_id;
 	bundle = null;
 	buildFailedError = null;
@@ -1363,6 +1375,7 @@ var BundlerDevEngine = class extends EventEmitter {
 		this.buildOptions = buildOptions;
 		this._id = Bundler.createId(config, buildOptions);
 		this.initializeHandle = taskHandler();
+		this.isHmrEnabled = Boolean(config.mode === "development" && config.devMode.hmr);
 		this.initialize();
 	}
 	get id() {
@@ -1388,6 +1401,7 @@ var BundlerDevEngine = class extends EventEmitter {
 			host: this.options.server.host,
 			port: this.options.server.port,
 			onHmrUpdates: (errorOrResult) => {
+				if (!this.isHmrEnabled) return;
 				if (errorOrResult instanceof Error) {
 					logger$1.error("Failed to handle HMR updates", {
 						bundlerId: this.id,
@@ -4449,10 +4463,16 @@ var plugins_exports = /* @__PURE__ */ __exportAll({
 //#endregion
 //#region src/core/rolldown.ts
 resolveRolldownOptions.cache = /* @__PURE__ */ new Map();
-async function resolveRolldownOptions(context, config, buildOptions) {
+async function resolveRolldownOptions(context, config, buildOptions, devEngineOptions) {
 	const cachedOptions = resolveRolldownOptions.cache.get(context.id);
 	if (cachedOptions != null) return cachedOptions;
+	const isDevServerMode = config.mode === "development" && context.buildType === "serve";
+	invariant(isDevServerMode ? devEngineOptions != null : true, "devEngineOptions is required in dev server mode");
 	const env = loadEnv(config);
+	const builtInEnv = {
+		MODE: config.mode,
+		...isDevServerMode ? { BASE_URL: getBaseUrl(devEngineOptions.host, devEngineOptions.port, devEngineOptions.https) } : null
+	};
 	const { platform, dev: dev$1, cache, minify } = buildOptions;
 	const { sourceExtensions, assetExtensions, preferNativePlatform, ...rolldownResolve } = config.resolver;
 	const { prelude: preludePaths, polyfills } = config.serializer;
@@ -4479,13 +4499,14 @@ async function resolveRolldownOptions(context, config, buildOptions) {
 			global: asIdentifier(GLOBAL_IDENTIFIER),
 			"process.env.NODE_ENV": asLiteral(nodeEnvironment(dev$1)),
 			"process.env.DEBUG_ROLLIPOP": asLiteral(isDebugEnabled()),
-			...Object.fromEntries(Object.entries(env).map(([key, value]) => [`import.meta.env.${key}`, asLiteral(value)]))
+			...defineEnvFromObject(env),
+			...defineEnvFromObject(builtInEnv)
 		},
 		typescript: { removeClassFieldsWithoutInitializer: true },
 		assumptions: { setPublicClassFields: true },
 		helpers: { mode: "Runtime" }
 	}, rolldownTransform);
-	const devServerPlugins = config.mode === "development" && context.buildType === "serve" ? [reactRefreshPlugin()] : null;
+	const devServerPlugins = isDevServerMode ? [reactRefreshPlugin()] : null;
 	const { beforeTransform, afterTransform } = getPersistCachePlugins({
 		enabled: cache,
 		sourceExtensions,
@@ -4600,7 +4621,7 @@ var Bundler = class Bundler {
 		const buildType = "serve";
 		const resolvedBuildOptions = resolveBuildOptions(config, buildOptions);
 		const context = Bundler.createContext(buildType, config, resolvedBuildOptions);
-		const { input = {}, output = {} } = await resolveRolldownOptions(context, config, resolvedBuildOptions);
+		const { input = {}, output = {} } = await resolveRolldownOptions(context, config, resolvedBuildOptions, devEngineOptions);
 		const devServerOptions = getOverrideOptionsForDevServer(config);
 		const devEngine = await dev(merge(input, devServerOptions.input), merge(output, devServerOptions.output), {
 			watch: config.watcher,
@@ -4678,7 +4699,7 @@ async function runServer(config, options) {
 
 //#endregion
 //#region package.json
-var version = "0.1.0-alpha.8";
+var version = "0.1.0-dev.20260118070035";
 
 //#endregion
 //#region src/node/logger.ts

package/dist/pluginutils.d.cts

@@ -338,8 +338,9 @@ type WatcherConfig = DevWatchOptions;
 interface DevModeConfig {
   /**
    * Hot Module Replacement configurations.
+   * This feature is only available in `development` mode.
    *
-   * Defaults to `true`
+   * Defaults to `true`.
    */
   hmr?: boolean | HmrConfig;
 }
@@ -406,7 +407,7 @@ type PluginFlattenConfig = Omit<Config, 'plugins'> & {
 //#region src/config/defaults.d.ts
 declare function getDefaultConfig(basePath: string, mode?: Config['mode']): {
   root: string;
-  mode: "development" | "production" | undefined;
+  mode: "development" | "production";
   entry: string;
   resolver: {
     sourceExtensions: string[];
@@ -450,7 +451,7 @@ declare function getDefaultConfig(basePath: string, mode?: Config['mode']): {
     globalIdentifiers: string[];
   };
   devMode: {
-    hmr: true;
+    hmr: boolean | HmrConfig;
   };
   terminal: {
     status: "none" | "compat" | "progress" | undefined;

package/dist/pluginutils.d.ts

@@ -340,8 +340,9 @@ type WatcherConfig = DevWatchOptions;
 interface DevModeConfig {
   /**
    * Hot Module Replacement configurations.
+   * This feature is only available in `development` mode.
    *
-   * Defaults to `true`
+   * Defaults to `true`.
    */
   hmr?: boolean | HmrConfig;
 }
@@ -408,7 +409,7 @@ type PluginFlattenConfig = Omit<Config, 'plugins'> & {
 //#region src/config/defaults.d.ts
 declare function getDefaultConfig(basePath: string, mode?: Config['mode']): {
   root: string;
-  mode: "development" | "production" | undefined;
+  mode: "development" | "production";
   entry: string;
   resolver: {
     sourceExtensions: string[];
@@ -452,7 +453,7 @@ declare function getDefaultConfig(basePath: string, mode?: Config['mode']): {
     globalIdentifiers: string[];
   };
   devMode: {
-    hmr: true;
+    hmr: boolean | HmrConfig;
   };
   terminal: {
     status: "none" | "compat" | "progress" | undefined;

package/dist/runtime.d.cts

@@ -47,6 +47,31 @@ interface HMRServerError {
     description: string;
   }[];
 }
+interface DevRuntimeModule {
+  exportsHolder: {
+    exports: any;
+  };
+  id: string;
+  exports: any;
+}
+interface DevRuntimeInterface {
+  modules: Record<string, DevRuntimeModule>;
+  createModuleHotContext(moduleId: string): void;
+  applyUpdates(boundaries: [string, string][]): void;
+  registerModule(id: string, exportsHolder: DevRuntimeModule['exportsHolder']): void;
+  loadExports(id: string): void;
+}
+declare class DevRuntime implements DevRuntimeInterface {
+  constructor(messenger: DevRuntimeMessenger);
+  modules: Record<string, DevRuntimeModule>;
+  createModuleHotContext(moduleId: string): void;
+  applyUpdates(boundaries: [string, string][]): void;
+  registerModule(id: string, exportsHolder: DevRuntimeModule['exportsHolder']): void;
+  loadExports(id: string): void;
+}
+interface DevRuntimeMessenger {
+  send(message: HMRClientMessage): void;
+}
 //#endregion
 //#region src/runtime.d.ts
 declare global {

package/package.json

@@ -1,18 +1,14 @@
 {
   "name": "rollipop",
-  "version": "0.1.0-alpha.8",
+  "version": "0.1.0-dev.20260118070035",
   "type": "module",
   "bin": "./bin/index.js",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     },
     "./commands": {
       "import": {
@@ -87,8 +83,8 @@
     "@react-native-community/cli-types": "^20.1.0",
     "@react-native/babel-plugin-codegen": "^0.83.1",
     "@react-native/dev-middleware": "^0.83.1",
-    "@rollipop/rolldown": "0.0.0-beta.1",
-    "@rollipop/rolldown-pluginutils": "0.0.0-beta.1",
+    "@rollipop/rolldown": "0.0.0-beta.2",
+    "@rollipop/rolldown-pluginutils": "0.0.0-beta.2",
     "@svgr/core": "^8.1.0",
     "@svgr/plugin-jsx": "^8.1.0",
     "@swc/core": "^1.15.7",
@@ -128,5 +124,6 @@
     "tsdown": "0.20.0-beta.1",
     "typescript": "5.9.3",
     "vitest": "4.0.17"
-  }
+  },
+  "stableVersion": "0.1.0-alpha.9"
 }