rollipop 1.0.0-alpha.33 → 1.0.0-alpha.34

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.33";
+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/hmr-runtime.iife.js

@@ -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);
 				}
 			},
 			{

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.33";
+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

@@ -147,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

@@ -20,7 +20,7 @@ var RollipopDevframeController = class {
 		this.definition = defineDevframe({
 			id: "rollipop",
 			name: "Rollipop",
-			version: "1.0.0-alpha.33",
+			version: "1.0.0-alpha.34",
 			packageName: "rollipop",
 			homepage: "https://github.com/rollipop-dev/rollipop",
 			description: "React Native development dashboard powered by Rollipop.",
@@ -83,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,

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.33",
+		version: "1.0.0-alpha.34",
 		base: ROLLIPOP_DEVFRAME_BASE,
 		cwd: context.config.root,
 		ui: createUi({

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.33") 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.33",
+  "version": "1.0.0-alpha.34",
   "homepage": "https://github.com/rollipop-dev/rollipop#readme",
   "bugs": {
     "url": "https://github.com/rollipop-dev/rollipop/issues"
@@ -67,8 +67,8 @@
     "@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.33",
-    "@rollipop/rolldown": "1.0.32",
+    "@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",
@@ -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) {