rollipop 1.0.0-alpha.32 → 1.0.0-alpha.34

package/dist/common/transformer.js

@@ -1,13 +1,40 @@
+import * as swc from "@swc/core";
 import transform from "fast-flow-transform";
 //#region src/common/transformer.ts
 async function stripFlowTypes(id, code) {
-	return await transform({
-		filename: id,
-		source: code,
-		sourcemap: true,
-		dialect: "flow",
-		format: "pretty"
-	});
+	try {
+		return await transform({
+			filename: id,
+			source: code,
+			sourcemap: true,
+			dialect: "flow",
+			format: "pretty"
+		});
+	} catch {
+		const result = swc.transformSync(code, {
+			filename: id,
+			configFile: false,
+			swcrc: false,
+			sourceMaps: true,
+			inputSourceMap: false,
+			jsc: {
+				target: "esnext",
+				parser: {
+					syntax: "flow",
+					all: true,
+					jsx: true,
+					enums: true,
+					components: true,
+					patternMatching: true
+				},
+				minify: { format: { comments: false } }
+			}
+		});
+		return {
+			code: result.code,
+			map: result.map ? JSON.parse(result.map) : void 0
+		};
+	}
 }
 //#endregion
 export { stripFlowTypes };

package/dist/config/defaults.js

@@ -1,8 +1,8 @@
 import { stripFlowTypes } from "../common/transformer.js";
-import { DEFAULT_ANALYZE_FILE, DEFAULT_ANALYZE_REPORT_FILE, DEFAULT_ASSET_EXTENSIONS, DEFAULT_ASSET_REGISTRY_PATH, DEFAULT_ENV_FILE, DEFAULT_ENV_PREFIX, DEFAULT_HMR_CLIENT_PATH, DEFAULT_RESOLVER_ALIAS_FIELDS, DEFAULT_RESOLVER_CONDITION_NAMES, DEFAULT_RESOLVER_MAIN_FIELDS, DEFAULT_RUNTIME_TARGET, DEFAULT_SOURCE_EXTENSIONS } from "../constants.js";
+import { DEFAULT_ANALYZE_FILE, DEFAULT_ANALYZE_REPORT_FILE, DEFAULT_ASSET_EXTENSIONS, DEFAULT_ENV_FILE, DEFAULT_ENV_PREFIX, DEFAULT_HMR_CLIENT_PATH, DEFAULT_RESOLVER_ALIAS_FIELDS, DEFAULT_RESOLVER_CONDITION_NAMES, DEFAULT_RESOLVER_MAIN_FIELDS, DEFAULT_RUNTIME_TARGET, DEFAULT_SOURCE_EXTENSIONS } from "../constants.js";
 import { ClientLogReporter } from "../events/builtin-reporters.js";
-import { getInitializeCorePath, getPolyfillScriptPaths } from "../internal/react-native.js";
 import { resolvePackagePath } from "../utils/node-resolve.js";
+import { resolveAssetRegistryPath, resolveInitializeCorePath, resolvePolyfillScriptPaths } from "../internal/react-native.js";
 import fs from "node:fs";
 //#region src/config/defaults.ts
 async function getDefaultConfig(projectRoot, mode) {
@@ -26,8 +26,8 @@ async function getDefaultConfig(projectRoot, mode) {
 			symlinks: true
 		},
 		transform: { swc: { native: { externalHelpers: true } } },
-		prelude: [getInitializeCorePath(projectRoot)],
-		polyfills: await Promise.all(getPolyfillScriptPaths(reactNativePath).map(async (path) => {
+		prelude: [resolveInitializeCorePath(projectRoot)],
+		polyfills: await Promise.all(resolvePolyfillScriptPaths(projectRoot, reactNativePath).map(async (path) => {
 			const code = fs.readFileSync(path, "utf-8");
 			return {
 				type: "iife",
@@ -38,7 +38,7 @@ async function getDefaultConfig(projectRoot, mode) {
 		treeshake: true,
 		reactNative: {
 			reactNativePath,
-			assetRegistryPath: DEFAULT_ASSET_REGISTRY_PATH,
+			assetRegistryPath: resolveAssetRegistryPath(projectRoot),
 			hmrClientPath: DEFAULT_HMR_CLIENT_PATH
 		},
 		dev: {

package/dist/config/types.d.ts

@@ -5,11 +5,11 @@ import "../core/plugins/index.js";
 import { InteractiveCommand } from "../node/commands/start/setup-interactive-mode.js";
 import "../node/cli-utils.js";
 import { Plugin } from "../core/plugins/types.js";
+import * as swc from "@swc/core";
 import { DevWatchOptions, RollipopReactNativeFlowConfig, RollipopReactNativeSwcConfig, RollipopReactNativeWorkletsConfig } from "@rollipop/rolldown/experimental";
 import * as rolldown from "@rollipop/rolldown";
 import { TopLevelFilterExpression } from "@rollipop/rolldown/filter";
 import * as babel from "@babel/core";
-import * as swc from "@swc/core";
 //#region src/config/types.d.ts
 type RolldownExperimentalOptions = NonNullable<rolldown.InputOptions['experimental']>;
 type RolldownTransformOptions = NonNullable<rolldown.InputOptions['transform']>;
@@ -267,7 +267,8 @@ export interface ReactNativeConfig {
   /**
    * Path to asset registry file.
    *
-   * Defaults to: `react-native/Libraries/Image/AssetRegistry.js`
+   * Defaults to: `react-native/asset-registry`,
+   * with the legacy `react-native/Libraries/Image/AssetRegistry.js` path as a fallback.
    */
   assetRegistryPath?: string | ((root: string) => MaybePromise<string>);
   /**

package/dist/constants.js

@@ -20,7 +20,7 @@ var constants_exports = /* @__PURE__ */ __exportAll({
 	ROLLIPOP_VIRTUAL_ENTRY_ID: () => ROLLIPOP_VIRTUAL_ENTRY_ID,
 	ROLLIPOP_VIRTUAL_PREFIX: () => ROLLIPOP_VIRTUAL_PREFIX
 });
-const ROLLIPOP_VERSION = "1.0.0-alpha.32";
+const ROLLIPOP_VERSION = "1.0.0-alpha.34";
 const ROLLIPOP_VIRTUAL_PREFIX = "\0rollipop/";
 const ROLLIPOP_VIRTUAL_BOOTSTRAP_ID = `${ROLLIPOP_VIRTUAL_PREFIX}bootstrap`;
 const ROLLIPOP_VIRTUAL_ENTRY_ID = `${ROLLIPOP_VIRTUAL_PREFIX}entry`;

package/dist/core/plugins/react-native-plugin.d.ts

@@ -5,6 +5,7 @@ import * as rolldown from "@rollipop/rolldown";
 export interface ReactNativePluginOptions {
   context: BundlerContext;
   projectRoot: string;
+  reactNativePath: string;
   platform: string;
   preferNativePlatform: boolean;
   buildType: BuildType;

package/dist/core/plugins/react-native-plugin.js

@@ -1,10 +1,32 @@
 import { copyAssetsToDestination, generateAssetRegistryCode, resolveScaledAssets } from "../assets.js";
 import { setFlag } from "./utils/transform-utils.js";
+import path from "node:path";
 import { rollipopReactNativePlugin } from "@rollipop/rolldown/experimental";
 import { id, include } from "@rollipop/rolldown/filter";
 //#region src/core/plugins/react-native-plugin.ts
 function reactNativePlugin(options) {
-	const { projectRoot, platform, preferNativePlatform, buildType, context, assetsDir, assetExtensions, assetRegistryPath, builtinPluginConfig } = options;
+	const { projectRoot, reactNativePath, platform, preferNativePlatform, buildType, context, assetsDir, assetExtensions, assetRegistryPath, builtinPluginConfig } = options;
+	const privateModulePlugin = {
+		name: "rollipop:react-native-private-module",
+		resolveId: {
+			order: "post",
+			filter: [include(id(new RegExp(`^react-native/src/private/`)))],
+			async handler(source, importer, extraOptions) {
+				const resolved = await this.resolve(source, importer, {
+					...extraOptions,
+					skipSelf: true
+				});
+				if (resolved != null) return resolved;
+				const candidate = path.resolve(reactNativePath, source.slice(13));
+				const relativeCandidate = path.relative(reactNativePath, candidate);
+				if (relativeCandidate.startsWith("..") || path.isAbsolute(relativeCandidate)) return null;
+				return this.resolve(candidate, importer, {
+					...extraOptions,
+					skipSelf: true
+				});
+			}
+		}
+	};
 	const assets = [];
 	const assetPlugin = {
 		name: "rollipop:react-native-asset",
@@ -42,7 +64,11 @@ function reactNativePlugin(options) {
 			}
 		}
 	};
-	return [rollipopReactNativePlugin(builtinPluginConfig), assetPlugin];
+	return [
+		privateModulePlugin,
+		rollipopReactNativePlugin(builtinPluginConfig),
+		assetPlugin
+	];
 }
 //#endregion
 export { reactNativePlugin as reactNative };

package/dist/core/plugins/swc-plugin.js

@@ -1,9 +1,9 @@
 import { getFlag } from "./utils/transform-utils.js";
 import { ROLLDOWN_RUNTIME_EXCLUDE_FILTER, withRuntimeExclude } from "./shared/filters.js";
 import { mergeSwcOptions } from "../../utils/swc.js";
+import * as swc from "@swc/core";
 import { partition } from "es-toolkit";
 import { id, include } from "@rollipop/rolldown/filter";
-import * as swc from "@swc/core";
 //#region src/core/plugins/swc-plugin.ts
 function swcPlugin({ context, transformConfig }) {
 	const { rules = [] } = transformConfig ?? {};

package/dist/core/rolldown.js

@@ -2,8 +2,8 @@ import { ROLLIPOP_VIRTUAL_ENTRY_ID } from "../constants.js";
 import { isDebugEnabled } from "../common/env.js";
 import { CompatStatusReporter, ProgressBarStatusReporter } from "../events/builtin-reporters.js";
 import { asLiteral, iife, nodeEnvironment } from "../common/code.js";
-import { getGlobalVariables } from "../internal/react-native.js";
 import { resolveFrom, resolvePackageJson } from "../utils/node-resolve.js";
+import { getGlobalVariables } from "../internal/react-native.js";
 import { printPluginLog } from "./plugins/context.js";
 import { applyRolldownOptionsConfig } from "../config/compose-override.js";
 import { createVirtualModuleId, escapeVirtualModuleId } from "../utils/id.js";
@@ -200,6 +200,7 @@ async function resolveReactNativePluginOptions(config, context, buildOptions) {
 	return {
 		context,
 		projectRoot: config.root,
+		reactNativePath: config.reactNative.reactNativePath,
 		platform: buildOptions.platform,
 		preferNativePlatform: config.resolve.preferNativePlatform,
 		buildType: context.buildType,

package/dist/hmr-runtime.iife.js

@@ -261,6 +261,14 @@ var __rolldown_runtime__ = (function() {
 		} });
 		if (t) _set_prototype_of(e, t);
 	}
+	function _is_native_reflect_construct() {
+		try {
+			var e = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function() {}));
+		} catch (e) {}
+		return (_is_native_reflect_construct = function() {
+			return !!e;
+		})();
+	}
 	function _iterable_to_array(e) {
 		if (typeof Symbol !== "undefined" && e[Symbol.iterator] != null || e["@@iterator"] != null) return Array.from(e);
 	}
@@ -289,10 +297,10 @@ var __rolldown_runtime__ = (function() {
 		return n;
 	}
 	function _non_iterable_rest() {
-		throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+		throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 	}
 	function _non_iterable_spread() {
-		throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+		throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 	}
 	function _possible_constructor_return(e, t) {
 		if (t && (_type_of(t) === "object" || typeof t === "function")) return t;
@@ -311,26 +319,6 @@ var __rolldown_runtime__ = (function() {
 	function _to_consumable_array(e) {
 		return _array_without_holes(e) || _iterable_to_array(e) || _unsupported_iterable_to_array(e) || _non_iterable_spread();
 	}
-	function _type_of(e) {
-		"@swc/helpers - typeof";
-		return e && typeof Symbol !== "undefined" && e.constructor === Symbol ? "symbol" : typeof e;
-	}
-	function _unsupported_iterable_to_array(e, t) {
-		if (!e) return;
-		if (typeof e === "string") return _array_like_to_array(e, t);
-		var r = Object.prototype.toString.call(e).slice(8, -1);
-		if (r === "Object" && e.constructor) r = e.constructor.name;
-		if (r === "Map" || r === "Set") return Array.from(r);
-		if (r === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(r)) return _array_like_to_array(e, t);
-	}
-	function _is_native_reflect_construct() {
-		try {
-			var e = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function() {}));
-		} catch (e) {}
-		return (_is_native_reflect_construct = function() {
-			return !!e;
-		})();
-	}
 	function _ts_generator(e, t) {
 		var r, n, o, a = {
 			label: 0,
@@ -411,6 +399,18 @@ var __rolldown_runtime__ = (function() {
 			};
 		}
 	}
+	function _type_of(e) {
+		"@swc/helpers - typeof";
+		return e && typeof Symbol !== "undefined" && e.constructor === Symbol ? "symbol" : typeof e;
+	}
+	function _unsupported_iterable_to_array(e, t) {
+		if (!e) return;
+		if (typeof e === "string") return _array_like_to_array(e, t);
+		var r = Object.prototype.toString.call(e).slice(8, -1);
+		if (r === "Object" && e.constructor) r = e.constructor.name;
+		if (r === "Map" || r === "Set") return Array.from(r);
+		if (r === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(r)) return _array_like_to_array(e, t);
+	}
 	var _globalThis;
 	var ___rollipop_runtime__;
 	var BaseDevRuntime = DevRuntime;
@@ -616,14 +616,14 @@ var __rolldown_runtime__ = (function() {
 		]);
 		return e;
 	}();
-	var ReactNativeDevRuntime = /*#__PURE__*/ function(BaseDevRuntime1) {
+	var ReactNativeDevRuntime = /*#__PURE__*/ function(BaseDevRuntime) {
 		"use strict";
-		_inherits(ReactNativeDevRuntime1, BaseDevRuntime1);
-		function ReactNativeDevRuntime1() {
-			_class_call_check(this, ReactNativeDevRuntime1);
+		_inherits(ReactNativeDevRuntime, BaseDevRuntime);
+		function ReactNativeDevRuntime() {
+			_class_call_check(this, ReactNativeDevRuntime);
 			var e;
 			var t = new SocketHolder();
-			e = _call_super(this, ReactNativeDevRuntime1, [createClientId()]), e.moduleHotContexts = /* @__PURE__ */ new Map(), e.moduleHotContextsToBeUpdated = /* @__PURE__ */ new Map(), e.moduleHotData = /* @__PURE__ */ new Map(), e.applyQueue = Promise.resolve(), e.updatesEnabled = Promise.resolve(), e.reloadRequested = false, e.lastSeq = 0;
+			e = _call_super(this, ReactNativeDevRuntime, [createClientId()]), e.moduleHotContexts = /* @__PURE__ */ new Map(), e.moduleHotContextsToBeUpdated = /* @__PURE__ */ new Map(), e.moduleHotData = /* @__PURE__ */ new Map(), e.applyQueue = Promise.resolve(), e.updatesEnabled = Promise.resolve(), e.reloadRequested = false, e.lastSeq = 0;
 			e.socketHolder = t;
 			e.hooks = {
 				createModuleHotContext: function t(t) {
@@ -635,7 +635,7 @@ var __rolldown_runtime__ = (function() {
 			};
 			return e;
 		}
-		_create_class(ReactNativeDevRuntime1, [
+		_create_class(ReactNativeDevRuntime, [
 			{
 				key: "createHotContext",
 				value: function e(e) {
@@ -756,7 +756,6 @@ var __rolldown_runtime__ = (function() {
 					}
 					this.lastSeq = o;
 					var i = this.computeHmrUpdate(t);
-					if (i.type === "noop") return;
 					if (i.type === "full-reload") {
 						this.reload(i.reason);
 						return;
@@ -766,7 +765,7 @@ var __rolldown_runtime__ = (function() {
 						type: "hmr:payload-delivered",
 						filename: n
 					}));
-					this.applyUpdate(i);
+					if (i.type === "boundaries") this.applyUpdate(i);
 				}
 			},
 			{
@@ -1025,7 +1024,7 @@ var __rolldown_runtime__ = (function() {
 				}
 			}
 		]);
-		return ReactNativeDevRuntime1;
+		return ReactNativeDevRuntime;
 	}(BaseDevRuntime);
 	function createClientId() {
 		return "".concat(Date.now().toString(36), "-").concat(Math.random().toString(36).slice(2));

package/dist/internal/react-native.js

@@ -1,14 +1,45 @@
-import { __require } from "../_virtual/_rolldown/runtime.js";
 import { asLiteral } from "../common/code.js";
+import { resolvePackagePath } from "../utils/node-resolve.js";
+import { createRequire } from "node:module";
 import path from "node:path";
 import { isNotNil } from "es-toolkit";
 //#region src/internal/react-native.ts
-function getInitializeCorePath(basePath) {
-	return __require.resolve("react-native/Libraries/Core/InitializeCore", { paths: [basePath] });
+const ASSET_REGISTRY_PATH = "react-native/asset-registry";
+const LEGACY_ASSET_REGISTRY_PATH = "react-native/Libraries/Image/AssetRegistry.js";
+const require = createRequire(import.meta.url);
+function resolveInitializeCorePath(basePath) {
+	return resolveOptional("react-native/setup-env", [basePath]) ?? require.resolve("react-native/Libraries/Core/InitializeCore", { paths: [basePath] });
 }
-function getPolyfillScriptPaths(reactNativePath) {
-	const scriptPath = path.join(reactNativePath, "rn-get-polyfills");
-	return __require(scriptPath)();
+function resolveAssetRegistryPath(basePath) {
+	return resolveOptional(ASSET_REGISTRY_PATH, [basePath]) ? ASSET_REGISTRY_PATH : LEGACY_ASSET_REGISTRY_PATH;
+}
+function resolvePolyfillScriptPaths(basePath, reactNativePath) {
+	const polyfillPath = resolveOptional("@react-native/js-polyfills", [reactNativePath, basePath]);
+	if (polyfillPath) return loadPolyfillScriptPaths(polyfillPath);
+	let metroConfigPath;
+	try {
+		metroConfigPath = resolvePackagePath(basePath, "@react-native/metro-config");
+	} catch {}
+	if (metroConfigPath) {
+		const requireFromMetroConfig = createRequire(path.join(metroConfigPath, "package.json"));
+		const metroPolyfillPath = resolveOptionalWith(() => requireFromMetroConfig.resolve("@react-native/js-polyfills"));
+		if (metroPolyfillPath) return loadPolyfillScriptPaths(metroPolyfillPath, requireFromMetroConfig);
+	}
+	return loadPolyfillScriptPaths(require.resolve(path.join(reactNativePath, "rn-get-polyfills")));
+}
+function loadPolyfillScriptPaths(modulePath, load = require) {
+	return load(modulePath)();
+}
+function resolveOptional(moduleId, paths) {
+	return resolveOptionalWith(() => require.resolve(moduleId, { paths }));
+}
+function resolveOptionalWith(resolve) {
+	try {
+		return resolve();
+	} catch (error) {
+		if (error instanceof Error && "code" in error && (error.code === "MODULE_NOT_FOUND" || error.code === "ERR_PACKAGE_PATH_NOT_EXPORTED")) return;
+		throw error;
+	}
 }
 function getGlobalVariables(dev) {
 	return [
@@ -20,4 +51,4 @@ function getGlobalVariables(dev) {
 	].filter(isNotNil);
 }
 //#endregion
-export { getGlobalVariables, getInitializeCorePath, getPolyfillScriptPaths };
+export { getGlobalVariables, resolveAssetRegistryPath, resolveInitializeCorePath, resolvePolyfillScriptPaths };

package/dist/node/commands/agent/action.js

@@ -17,6 +17,10 @@ function getAgentGuide(baseUrl = defaultBaseUrl) {
 		"  rollipop skills get <name>",
 		"",
 		"Rollipop exposes build events, diagnostics, and client logs through Devframe MCP.",
+		"MCP requires the optional @devframes/agentic peer dependency:",
+		"",
+		"  yarn add -D @devframes/agentic@1.0.0",
+		"",
 		"Keep the dev server running while your agent uses the MCP tools.",
 		"",
 		"Start the dev server:",
@@ -27,8 +31,7 @@ function getAgentGuide(baseUrl = defaultBaseUrl) {
 		"",
 		`  MCP server:       ${baseUrl}/__rollipop/__mcp`,
 		"",
-		"If you start Rollipop with custom --host, --port, or --https options,",
-		"adjust these URLs to match the running dev server.",
+		"For a custom loopback --host or --port, adjust both the MCP URL and Origin.",
 		"",
 		"MCP setup:",
 		"",
@@ -44,13 +47,12 @@ function getAgentGuide(baseUrl = defaultBaseUrl) {
 		"      }",
 		"    }",
 		"",
-		"  Devframe accepts loopback origins only; keep the MCP URL and Origin on loopback.",
+		"  Devframe requires a loopback Origin and a connection from the same machine.",
 		"",
 		"  Tool discovery:",
 		"    MCP clients discover supported tools by calling tools/list.",
 		"    The response includes tool names, descriptions, and input schemas.",
-		"    For Streamable HTTP, initialize first, then call tools/list with",
-		"    the returned mcp-session-id header.",
+		"    The endpoint is stateless; no mcp-session-id header is returned or required.",
 		"",
 		"External debugging:",
 		"",
@@ -65,9 +67,11 @@ function getAgentGuide(baseUrl = defaultBaseUrl) {
 		"Agent workflow:",
 		"",
 		"  1. Run rollipop start and keep it running while using MCP tools.",
-		"  2. Use get_build_events before and after edits; bundler-scoped events include bundlerId.",
+		"  2. Start get_build_events, then make edits while it is listening.",
+		"     Only new events are collected; bundler-scoped events include bundlerId.",
 		"  3. Wait for bundle_build_done or bundle_build_failed for bundle builds.",
-		"     For HMR edits, watch for watch_change, hmr_failed, and HMR client messages.",
+		"     For HMR edits, watch for watch_change and hmr_failed.",
+		"     Use build_logs and build_errors when events occurred before listening.",
 		"  4. Use get_bundler_status when you need the latest state for a known bundlerId.",
 		"  5. Use get_console_logs, clear_console_logs, and clear_build_* for focused diagnostics.",
 		"  6. Use bundleFilePath from bundle_build_done when bundle-level debugging is needed.",

package/dist/package.js

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "1.0.0-alpha.32";
+var version = "1.0.0-alpha.34";
 //#endregion
 export { version };

package/dist/server/bundler-pool.d.ts

@@ -44,19 +44,22 @@ export declare class BundlerDevEngine {
   getBundle(): Promise<BundleStore>;
   getSourceMap(): Promise<string | undefined>;
   triggerFullBuild(): Promise<void>;
+  close(): Promise<void>;
 }
 export declare class BundlerPool {
   private readonly config;
   private readonly resolvedServerOptions;
   private readonly eventBus;
-  private static readonly instances;
+  private readonly instances;
+  private closeTask;
   readonly hotUpdateStore: HotUpdateStore;
   constructor(config: ResolvedConfig, resolvedServerOptions: Required<Pick<ServerOptions, 'host' | 'port'>> & Pick<ServerOptions, 'buildOptions'>, eventBus: EventBus);
-  get(bundleName: string, buildOptions: Pick<BuildOptions, 'platform' | 'dev'>): BundlerDevEngine;
+  get(bundleName: string, buildOptions: Pick<BuildOptions, 'platform' | 'dev' | 'minify'>): BundlerDevEngine;
   /**
    * Look up a cached bundler by the id carried as `bundlerId` in events such as `bundle_build_done`. Returns `undefined` when no instance with that id has been created yet.
    */
   getInstanceById(id: string): BundlerDevEngine | undefined;
   getInstances(): BundlerDevEngine[];
+  close(): Promise<void>;
 }
 //#endregion

package/dist/server/bundler-pool.js

@@ -218,12 +218,19 @@ var BundlerDevEngine = class {
 		await this.ensureInitialized;
 		this.devEngine.triggerFullBuild();
 	}
+	async close() {
+		await this.initializeTask.catch(() => {});
+		const devEngine = this._devEngine;
+		this._devEngine = null;
+		await devEngine?.close();
+	}
 };
-var BundlerPool = class BundlerPool {
+var BundlerPool = class {
 	config;
 	resolvedServerOptions;
 	eventBus;
-	static instances = /* @__PURE__ */ new Map();
+	instances = /* @__PURE__ */ new Map();
+	closeTask;
 	hotUpdateStore;
 	constructor(config, resolvedServerOptions, eventBus) {
 		this.config = config;
@@ -233,13 +240,14 @@ var BundlerPool = class BundlerPool {
 		this.hotUpdateStore.clear();
 	}
 	get(bundleName, buildOptions) {
+		invariant(this.closeTask == null, "Bundler pool is closed");
 		const baseBundleName = getBaseBundleName(bundleName);
 		const resolvedBuildOptions = resolveBuildOptions(this.config, {
 			...this.resolvedServerOptions.buildOptions,
 			...buildOptions
 		});
 		const key = `${baseBundleName}-${Bundler.createId(this.config, resolvedBuildOptions)}`;
-		const instance = BundlerPool.instances.get(key);
+		const instance = this.instances.get(key);
 		if (instance) return instance;
 		else {
 			logger.debug("Preparing new bundler instance", {
@@ -248,7 +256,7 @@ var BundlerPool = class BundlerPool {
 			});
 			const instance = new BundlerDevEngine(baseBundleName, { server: this.resolvedServerOptions }, this.config, resolvedBuildOptions, this.eventBus, this.hotUpdateStore);
 			logger.debug("Setting new bundler instance", { key });
-			BundlerPool.instances.set(key, instance);
+			this.instances.set(key, instance);
 			return instance;
 		}
 	}
@@ -256,10 +264,19 @@ var BundlerPool = class BundlerPool {
 	* Look up a cached bundler by the id carried as `bundlerId` in events such as `bundle_build_done`. Returns `undefined` when no instance with that id has been created yet.
 	*/
 	getInstanceById(id) {
-		for (const instance of BundlerPool.instances.values()) if (instance.id === id && instance.projectRoot === this.config.root) return instance;
+		for (const instance of this.instances.values()) if (instance.id === id && instance.projectRoot === this.config.root) return instance;
 	}
 	getInstances() {
-		return Array.from(BundlerPool.instances.values());
+		return Array.from(this.instances.values());
+	}
+	close() {
+		this.closeTask ??= (async () => {
+			const instances = this.getInstances();
+			this.instances.clear();
+			const errors = (await Promise.allSettled(instances.map((instance) => instance.close()))).flatMap((result) => result.status === "rejected" ? [result.reason] : []);
+			if (errors.length > 0) throw new AggregateError(errors, "Failed to close bundler engines");
+		})();
+		return this.closeTask;
 	}
 };
 //#endregion

package/dist/server/create-dev-server.js

@@ -17,6 +17,7 @@ import { DevServerState } from "./state/store.js";
 import { getWebSocketUpgradeHandler } from "./wss/server.js";
 import { HMRServer } from "./wss/hmr-server.js";
 import url from "node:url";
+import { format } from "node:util";
 import { createDevServerMiddleware } from "@react-native-community/cli-server-api";
 import { createDevMiddleware } from "@react-native/dev-middleware";
 import Fastify, { LogController } from "fastify";
@@ -61,10 +62,14 @@ async function createDevServer(config, options) {
 		logger: {
 			info(...args) {
 				if (args[0].includes("JavaScript logs have moved")) return;
-				logger.info(...args);
+				logger.info(format(...args));
 			},
-			warn: logger.warn.bind(logger),
-			error: logger.error.bind(logger)
+			warn(...args) {
+				logger.warn(format(...args));
+			},
+			error(...args) {
+				logger.error(format(...args));
+			}
 		},
 		unstable_experiments: {
 			enableNetworkInspector: true,
@@ -142,6 +147,7 @@ async function createDevServer(config, options) {
 			server.close(() => resolve());
 		})));
 	});
+	fastify.addHook("onClose", () => bundlerPool.close());
 	await invokePostConfigureServer();
 	eventBus.emit({
 		type: "server_ready",

package/dist/server/devframe/index.js

@@ -4,27 +4,23 @@ import { parseUrl } from "../../utils/url.js";
 import { symbolicate } from "../symbolicate.js";
 import { toDevframeEvent } from "./events.js";
 import { registerAgentTools } from "./agent/tools/index.js";
-import { getBuildSummary, getBundlers, getConfigInfo, getDevice, getFeatureFlags, getProjectInfo, getSnapshot } from "./data.js";
+import { getConfigInfo, getDevice, getFeatureFlags, getSnapshot } from "./data.js";
 import { defineDevframe, defineRpcFunction } from "devframe";
 //#region src/server/devframe/index.ts
 const ROLLIPOP_DEVFRAME_SCOPE = "rollipop";
-const DASHBOARD_SHARED_STATE_KEY = "dashboard";
+const DASHBOARD_EVENTS_STATE_KEY = "events";
 var RollipopDevframeController = class {
 	context;
 	sequence = 0;
-	lastEvent = null;
-	updateSharedState;
+	updateEventState;
 	unsubscribeEventBus;
-	refreshQueue;
 	definition;
 	constructor(context, agentToolContext) {
 		this.context = context;
-		const initialState = createInitialDashboardState(context);
-		this.refreshQueue = Promise.resolve(initialState);
 		this.definition = defineDevframe({
 			id: "rollipop",
 			name: "Rollipop",
-			version: "1.0.0-alpha.32",
+			version: "1.0.0-alpha.34",
 			packageName: "rollipop",
 			homepage: "https://github.com/rollipop-dev/rollipop",
 			description: "React Native development dashboard powered by Rollipop.",
@@ -34,13 +30,10 @@ var RollipopDevframeController = class {
 			},
 			setup: async (devframeContext) => {
 				const scope = devframeContext.scope(ROLLIPOP_DEVFRAME_SCOPE);
-				const sharedState = await scope.rpc.sharedState(DASHBOARD_SHARED_STATE_KEY, { initialValue: initialState });
-				this.updateSharedState = (state) => {
+				const sharedState = await scope.rpc.sharedState(DASHBOARD_EVENTS_STATE_KEY, { initialValue: { lastEvent: null } });
+				this.updateEventState = (event) => {
 					sharedState.mutate((current) => {
-						current.snapshot = state.snapshot;
-						current.builds = state.builds;
-						current.featureFlags = state.featureFlags;
-						current.lastEvent = state.lastEvent;
+						current.lastEvent = event;
 					});
 				};
 				registerDashboardRpcFunctions(scope.rpc, this);
@@ -48,26 +41,19 @@ var RollipopDevframeController = class {
 				this.unsubscribeEventBus = context.eventBus.subscribe((event) => {
 					const data = toDevframeEvent(event);
 					if (data == null) return;
-					this.lastEvent = {
-						sequence: ++this.sequence,
-						data
-					};
-					this.refresh();
+					this.notify(data);
 				});
 			}
 		});
 	}
-	async refresh() {
-		const lastEvent = this.lastEvent;
-		this.refreshQueue = this.refreshQueue.catch(() => createInitialDashboardState(this.context)).then(async () => {
-			const state = await this.readDashboardState(lastEvent);
-			this.updateSharedState?.(state);
-			return state;
+	notify(data) {
+		this.updateEventState?.({
+			sequence: ++this.sequence,
+			data
 		});
-		return this.refreshQueue;
 	}
-	async getSnapshot() {
-		return (await this.refresh()).snapshot;
+	getSnapshot() {
+		return getSnapshot(this.context);
 	}
 	getBuilds() {
 		return this.context.state.getBuilds();
@@ -78,9 +64,8 @@ var RollipopDevframeController = class {
 		if (this.context.bundlerPool.getInstanceById(bundlerId) == null) throw new Error(`Build logs not found: ${bundlerId}`);
 		return [];
 	}
-	async deleteBuildLogs(bundlerId) {
+	deleteBuildLogs(bundlerId) {
 		if (!this.context.state.clearBuildLogs(bundlerId) && this.context.bundlerPool.getInstanceById(bundlerId) == null) throw new Error(`Build logs not found: ${bundlerId}`);
-		await this.refresh();
 	}
 	getConfig() {
 		return getConfigInfo(this.context);
@@ -98,7 +83,8 @@ var RollipopDevframeController = class {
 		if (pathname == null || query.platform == null || query.dev == null) throw new Error("Bundle URL must include pathname, platform, and dev query parameters");
 		const bundle = await this.context.bundlerPool.get(getBaseBundleName(pathname), {
 			platform: String(query.platform),
-			dev: query.dev === "true"
+			dev: query.dev === "true",
+			...query.minify == null ? {} : { minify: query.minify === "true" }
 		}).getBundle();
 		return symbolicate(bundle, [{
 			file: bundleUrl,
@@ -111,33 +97,21 @@ var RollipopDevframeController = class {
 		if (bundler == null) throw new Error(`Bundler not found: ${bundlerId}`);
 		setTimeout(() => this.context.message.broadcast("reload"), 0);
 		await bundler.triggerFullBuild();
-		await this.refresh();
 	}
-	async reload() {
+	reload() {
 		this.context.message.broadcast("reload");
-		await this.refresh();
 	}
 	async resetCache() {
 		await resetCache();
 		this.context.eventBus.emit({ type: "cache_reset" });
-		await this.refresh();
 	}
-	async resetBundlerState() {
+	resetBundlerState() {
 		this.context.state.resetBufferedState();
-		await this.refresh();
 	}
 	dispose() {
 		this.unsubscribeEventBus?.();
 		this.unsubscribeEventBus = void 0;
 	}
-	async readDashboardState(lastEvent) {
-		return {
-			snapshot: await getSnapshot(this.context),
-			builds: this.context.state.getBuilds(),
-			featureFlags: getFeatureFlags(this.context),
-			lastEvent
-		};
-	}
 };
 function registerDashboardRpcFunctions(rpc, controller) {
 	rpc.register(defineRpcFunction({
@@ -201,18 +175,5 @@ function registerDashboardRpcFunctions(rpc, controller) {
 		handler: () => controller.resetBundlerState()
 	}));
 }
-function createInitialDashboardState(context) {
-	return {
-		snapshot: {
-			project: getProjectInfo(context),
-			bundlers: getBundlers(context),
-			devices: [],
-			buildSummary: getBuildSummary(context)
-		},
-		builds: context.state.getBuilds(),
-		featureFlags: getFeatureFlags(context),
-		lastEvent: null
-	};
-}
 //#endregion
-export { DASHBOARD_SHARED_STATE_KEY, ROLLIPOP_DEVFRAME_SCOPE, RollipopDevframeController };
+export { DASHBOARD_EVENTS_STATE_KEY, ROLLIPOP_DEVFRAME_SCOPE, RollipopDevframeController };

package/dist/server/devframe/setup.js

@@ -16,7 +16,7 @@ async function setupDevframe(context, server, inspectorDeviceServer) {
 	const controller = new RollipopDevframeController(context, createAgentToolContext(context));
 	const devtools = initHub({
 		name: DEVFRAME_NAME,
-		version: "1.0.0-alpha.32",
+		version: "1.0.0-alpha.34",
 		base: ROLLIPOP_DEVFRAME_BASE,
 		cwd: context.config.root,
 		ui: createUi({
@@ -44,11 +44,11 @@ async function setupDevframe(context, server, inspectorDeviceServer) {
 		}
 	});
 	await devtools.ready;
-	const refreshDevices = () => {
-		controller.refresh();
+	const notifyDevicesChanged = () => {
+		controller.notify({ type: "devices_changed" });
 	};
 	const onDeviceConnection = (socket) => {
-		socket.once("close", refreshDevices);
+		socket.once("close", notifyDevicesChanged);
 	};
 	inspectorDeviceServer?.on("connection", onDeviceConnection);
 	server.instance.addHook("onListen", () => {
@@ -56,11 +56,10 @@ async function setupDevframe(context, server, inspectorDeviceServer) {
 			const mcpUrl = getServerDisplayUrl(server.instance.listeningOrigin, "/__rollipop/__mcp");
 			logger.info(`MCP server listening at ${mcpUrl}`);
 		}
-		controller.refresh();
 	});
 	server.instance.addHook("preClose", async () => {
 		inspectorDeviceServer?.off("connection", onDeviceConnection);
-		for (const socket of inspectorDeviceServer?.clients ?? []) socket.off("close", refreshDevices);
+		for (const socket of inspectorDeviceServer?.clients ?? []) socket.off("close", notifyDevicesChanged);
 		controller.dispose();
 		await devtools.close();
 	});

package/dist/server/middlewares/symbolicate.js

@@ -55,7 +55,8 @@ function getBundleStoresByFrameUrl(stack, context) {
 		const bundleName = getBaseBundleName(pathname);
 		const bundler = context.bundlerPool.get(bundleName, {
 			platform,
-			dev
+			dev,
+			...query.minify == null ? {} : { minify: query.minify === "true" }
 		});
 		bundleStores.set(file, bundler.getBundle());
 	}

package/dist/server/wss/hmr-server.js

@@ -4,6 +4,16 @@ import { WebSocketServer } from "./server.js";
 import { invariant } from "es-toolkit";
 //#region src/server/wss/hmr-server.ts
 const MAX_PENDING_PAYLOADS_PER_CLIENT = 8;
+const RESERVED_WEBSOCKET_EVENTS = /* @__PURE__ */ new Set([
+	"close",
+	"connection",
+	"error",
+	"headers",
+	"listening",
+	"wsClientError",
+	"newListener",
+	"removeListener"
+]);
 var HMRServer = class extends WebSocketServer {
 	bundlerPool;
 	eventBus;
@@ -19,9 +29,9 @@ var HMRServer = class extends WebSocketServer {
 	}
 	parseClientMessage(data) {
 		const parsedData = JSON.parse(this.rawDataToString(data));
-		const clientMessage = "type" in parsedData ? parsedData : null;
-		invariant(clientMessage, "Invalid HMR client message");
-		return clientMessage;
+		invariant(typeof parsedData?.type === "string", "Invalid HMR client message");
+		invariant(!RESERVED_WEBSOCKET_EVENTS.has(parsedData.type), `Reserved HMR event name: ${parsedData.type}`);
+		return parsedData;
 	}
 	async handleConnected(client, runtimeClientId, platform, bundleEntry) {
 		const connectionToken = Symbol();

package/dist/storage/file-storage.js

@@ -28,7 +28,7 @@ var FileStorage = class FileStorage {
 		this.dataFilePath = path.join(FileStorage.getPath(basePath, { prepare: true }), DATA_FILENAME);
 		if (fs.existsSync(this.dataFilePath)) {
 			const loadedData = JSON.parse(fs.readFileSync(this.dataFilePath, "utf-8"));
-			if ("version" in loadedData && loadedData.version === "1.0.0-alpha.32") this.data = loadedData;
+			if ("version" in loadedData && loadedData.version === "1.0.0-alpha.34") this.data = loadedData;
 			else {
 				this.data = createDefaultData();
 				this.flush();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rollipop",
-  "version": "1.0.0-alpha.32",
+  "version": "1.0.0-alpha.34",
   "homepage": "https://github.com/rollipop-dev/rollipop#readme",
   "bugs": {
     "url": "https://github.com/rollipop-dev/rollipop/issues"
@@ -67,9 +67,9 @@
     "@react-native-community/cli-server-api": "20.2.0",
     "@react-native-community/cli-types": "20.2.0",
     "@react-native/dev-middleware": "0.87.1",
-    "@rollipop/dashboard": "1.0.0-alpha.32",
-    "@rollipop/rolldown": "1.0.32",
-    "@swc/core": "1.15.43",
+    "@rollipop/dashboard": "1.0.0-alpha.34",
+    "@rollipop/rolldown": "1.0.34",
+    "@swc/core": "1.16.13",
     "@swc/helpers": "0.5.23",
     "@types/ws": "8.18.1",
     "arktype": "2.2.3",
@@ -117,7 +117,7 @@
     }
   },
   "engines": {
-    "node": ">=22.12.0"
+    "node": "^22.18.0 || ^24.11.0 || >=26.0.0"
   },
   "installConfig": {
     "hoistingLimits": "none"

package/skills/configuration.md

@@ -18,7 +18,7 @@ Use https://rollipop.dev/docs/features/env.md when changing env file loading, pr
 
 ## Experimental Features
 
-Use https://rollipop.dev/docs/features/experimental.md before enabling experimental options. Keep the change explicit and mention stability/version risk. For worklets specifically, read https://rollipop.dev/docs/features/reanimated-worklets.md.
+Use https://rollipop.dev/docs/experimental/overview.md before enabling experimental options. Keep the change explicit and mention stability/version risk. For worklets specifically, read https://rollipop.dev/docs/experimental/reanimated-worklets.md.
 
 ## Resolve Changes
 
@@ -27,5 +27,5 @@ When changing module resolution behavior, verify package metadata (`exports`, `r
 ## Watchpoints
 
 - Translate intent from existing Metro config instead of copying Metro fields mechanically.
-- Overriding arrays can accidentally remove React Native defaults; check docs before replacing prelude or resolve extension lists.
+- Configured `prelude`, `polyfills`, `plugins`, `resolve.sourceExtensions`, and `resolve.assetExtensions` arrays are appended to the defaults with duplicates removed. Supplying an empty array does not remove the defaults.
 - If config is produced dynamically, inspect both the source config and the resolved behavior through dev-server diagnostics when available.

package/skills/debugging.md

@@ -10,7 +10,7 @@ Use this skill when Rollipop is installed or running and the task needs diagnost
 
 ## MCP Server
 
-Devframe MCP exposes structured Rollipop diagnostics whenever the dev server is running. Use it for build events, logs, cache actions, app logs, device status, reloads, build info, and symbolication. Read https://rollipop.dev/docs/features/mcp.md.
+Devframe MCP exposes structured Rollipop diagnostics while the dev server is running when the optional `@devframes/agentic` peer dependency is installed. Use it for build events, logs, cache actions, app logs, device status, reloads, build info, and symbolication. Read https://rollipop.dev/docs/features/mcp.md for installation and setup.
 
 ## React Native DevTools
 

package/skills/dev-server.md

@@ -18,7 +18,7 @@ Use Rollipop's dev server for React Native HMR, source maps, multi-platform deve
 
 ## MCP Server
 
-The Devframe MCP endpoint is available whenever the dev server is running. Read https://rollipop.dev/docs/features/mcp.md.
+The Devframe MCP endpoint is available while the dev server is running when the optional `@devframes/agentic` peer dependency is installed. Read https://rollipop.dev/docs/features/mcp.md for installation and setup.
 
 ## Interactive Tools
 
@@ -26,6 +26,6 @@ React Native DevTools and custom terminal commands belong to the dev-server work
 
 ## Watchpoints
 
-- Keep server options consistent with device/app URLs: host, port, HTTPS, key, and cert must match the running target.
+- Keep the host and port consistent with device/app URLs. HTTPS is not supported; `--https` fails even though the CLI accepts it alongside `--key` and `--cert`.
 - Interactive mode is useful for humans; disable it for automation when needed.
 - If dev-server startup or HMR fails, switch to `troubleshooting.md`; use `debugging.md` when diagnostics tooling is needed.

package/src/runtime/__tests__/hmr-runtime.spec.ts

@@ -522,10 +522,14 @@ describe('HMR runtime', () => {
     expect(reload).not.toHaveBeenCalled();
   });
 
-  it('does not evaluate or acknowledge changes for modules that were not executed', async () => {
-    const evaluate = vi.fn();
+  it('updates unexecuted modules without executing them until their first import', async () => {
+    // oxlint-disable-next-line no-eval
+    const evaluate = vi.fn((source: string) => (0, eval)(source));
     globalThis.globalEvalWithSourceUrl = evaluate;
-    const { socket } = await setupRuntime();
+    const { runtime, socket } = await setupRuntime();
+    runtime.registerFactory('dep.js', 'esm', (id) => {
+      runtime.registerModule(id, { exports: { value: 'before' } });
+    });
 
     socket.emit('message', {
       data: JSON.stringify({
@@ -539,8 +543,13 @@ describe('HMR runtime', () => {
     });
 
     await new Promise((resolve) => setTimeout(resolve, 0));
-    expect(evaluate).not.toHaveBeenCalled();
-    expect(socket.sent).toEqual([]);
+    expect(runtime.isExecuted('dep.js')).toBe(false);
+    expect(runtime.initModule('dep.js')).toEqual({ value: 'after' });
+    expect(runtime.getImporters('dep.js')).toEqual(['entry.js']);
+    expect(evaluate).toHaveBeenCalledOnce();
+    expect(socket.sent.map((message) => JSON.parse(message))).toEqual([
+      { type: 'hmr:payload-delivered', filename: 'hmr_patch_1.js' },
+    ]);
     expect(reload).not.toHaveBeenCalled();
   });
 

package/src/runtime/hmr-runtime.ts

@@ -299,9 +299,6 @@ class ReactNativeDevRuntime extends BaseDevRuntime {
     this.lastSeq = seq;
 
     const update = this.computeHmrUpdate(changedIds);
-    if (update.type === 'noop') {
-      return;
-    }
     if (update.type === 'full-reload') {
       this.reload(update.reason);
       return;
@@ -311,7 +308,9 @@ class ReactNativeDevRuntime extends BaseDevRuntime {
     this.socketHolder.send(
       JSON.stringify({ type: 'hmr:payload-delivered', filename } satisfies HMRClientMessage),
     );
-    this.applyUpdate(update);
+    if (update.type === 'boundaries') {
+      this.applyUpdate(update);
+    }
   }
 
   private applyInvalidate(moduleId: string, firstInvalidatedBy: string) {