rollipop 1.0.0-alpha.21 → 1.0.0-alpha.23

package/dist/internal/react-native.js

@@ -0,0 +1,24 @@
+import { __require } from "../_virtual/_rolldown/runtime.js";
+import { GLOBAL_IDENTIFIER } from "../constants.js";
+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] });
+}
+function getPolyfillScriptPaths(reactNativePath) {
+	return __require(path.join(reactNativePath, "rn-get-polyfills"))();
+}
+function getGlobalVariables(dev, buildType) {
+	const isDevServerMode = dev && buildType === "serve";
+	return [
+		`var __BUNDLE_START_TIME__=globalThis.nativePerformanceNow?nativePerformanceNow():Date.now();`,
+		`var __DEV__=${dev};`,
+		`var ${GLOBAL_IDENTIFIER}=typeof globalThis!=='undefined'?globalThis:typeof global !== 'undefined'?global:typeof window!=='undefined'?window:this;`,
+		`var process=globalThis.process||{};process.env=process.env||{};process.env.NODE_ENV=process.env.NODE_ENV||"${dev ? "development" : "production"}";`,
+		isDevServerMode ? `var $RefreshReg$ = () => {};` : null,
+		isDevServerMode ? `var $RefreshSig$ = () => (v) => v;` : null
+	].filter(isNotNil);
+}
+//#endregion
+export { getGlobalVariables, getInitializeCorePath, getPolyfillScriptPaths };

package/dist/logger.js

@@ -0,0 +1,5 @@
+import { Logger } from "./common/logger.js";
+//#region src/logger.ts
+const logger = new Logger("bundler");
+//#endregion
+export { logger };

package/dist/node/cli-utils.d.ts

@@ -0,0 +1,10 @@
+import { CommandDefinition } from "./types.js";
+import { InteractiveCommand, InteractiveCommandContext, InteractiveModeOptions, setupInteractiveMode } from "./commands/start/setup-interactive-mode.js";
+import { Command } from "@commander-js/extra-typings";
+import { Command as Command$1 } from "@react-native-community/cli-types";
+
+//#region src/node/cli-utils.d.ts
+declare function createCommand<T>(commandDefinition: CommandDefinition<T>): Command;
+declare function createReactNativeCliCommand<T>(commandDefinition: CommandDefinition<T>): Command$1;
+//#endregion
+export { createCommand, createReactNativeCliCommand };

package/dist/node/cli-utils.js

@@ -0,0 +1,28 @@
+import { Logo } from "../common/logo.js";
+import { withErrorHandler } from "./utils.js";
+import "./commands/start/setup-interactive-mode.js";
+import { omit } from "es-toolkit";
+import { Command } from "@commander-js/extra-typings";
+//#region src/node/cli-utils.ts
+function createCommand(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);
+	}));
+}
+function createReactNativeCliCommand(commandDefinition) {
+	return {
+		name: commandDefinition.name,
+		description: commandDefinition.description,
+		options: commandDefinition.options?.map((option) => omit(option, ["required"])),
+		func: (_argv, cliConfig, args) => {
+			Logo.printOnce();
+			return commandDefinition.action.call({ platforms: Object.keys(cliConfig.platforms) }, args);
+		}
+	};
+}
+//#endregion
+export { createCommand, createReactNativeCliCommand };

package/dist/node/cli.d.ts

@@ -0,0 +1,6 @@
+declare namespace cli_d_exports {
+  export { run };
+}
+declare function run(argv: string[]): void;
+//#endregion
+export { cli_d_exports };

package/dist/node/cli.js

@@ -0,0 +1,23 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import { Logo } from "../common/logo.js";
+import { version } from "../package.js";
+import { createCommand } from "./cli-utils.js";
+import { command } from "./commands/agent/command.js";
+import "./commands/agent/index.js";
+import { command as command$1 } from "./commands/bundle/command.js";
+import "./commands/bundle/index.js";
+import { command as command$2 } from "./commands/start/command.js";
+import "./commands/start/index.js";
+import { program } from "@commander-js/extra-typings";
+//#region src/node/cli.ts
+var cli_exports = /* @__PURE__ */ __exportAll({ run: () => run });
+function run(argv) {
+	Logo.printOnce();
+	const cli = program.name("rollipop").version(version);
+	cli.addCommand(createCommand(command));
+	cli.addCommand(createCommand(command$1));
+	cli.addCommand(createCommand(command$2));
+	cli.parse(argv);
+}
+//#endregion
+export { cli_exports };

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

@@ -0,0 +1,91 @@
+import { DEFAULT_HOST, DEFAULT_PORT } from "../../../server/constants.js";
+import "../../../server/index.js";
+//#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 events and client logs through SSE, with optional MCP tooling.",
+		"Keep the dev server running, then connect your agent to one of these endpoints.",
+		"",
+		"Start the dev server:",
+		"",
+		"  rollipop start --mcp --reset-cache",
+		"",
+		"Default endpoints:",
+		"",
+		`  SSE events:       ${baseUrl}/sse/events`,
+		`  SSE client logs:  ${baseUrl}/sse/client-logs`,
+		`  MCP server:       ${baseUrl}/mcp (requires start --mcp)`,
+		"",
+		"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`,
+		`  curl -N ${baseUrl}/sse/client-logs`,
+		"",
+		"  Event format:",
+		"    event: <event_type>",
+		"    data: <json_payload>",
+		"    bundler-scoped events include bundlerId",
+		"",
+		"  Useful event types:",
+		"    bundle_build_started, bundle_build_done, bundle_build_failed",
+		"    watch_change, hmr_failed, device_connected, device_disconnected",
+		"    server_ready, cache_reset",
+		"    client_log is streamed separately from /sse/client-logs",
+		"",
+		"  bundle_build_done includes bundleFilePath for the file-system bundle.",
+		"  Rollipop serves that file when it has been edited after the build,",
+		"  which lets agents inspect or patch the final bundle for debugging.",
+		"",
+		"MCP setup:",
+		"",
+		"  Add this to your project .mcp.json:",
+		"",
+		"    {",
+		"      \"mcpServers\": {",
+		"        \"rollipop\": {",
+		"          \"type\": \"http\",",
+		`          "url": "${baseUrl}/mcp"`,
+		"        }",
+		"      }",
+		"    }",
+		"",
+		"  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.",
+		"",
+		"External debugging:",
+		"",
+		"  CDP debugging, runtime evaluation, runtime errors, network inspection,",
+		"  and profiling can be handled by agent-cdp:",
+		"    https://github.com/callstackincubator/agent-cdp",
+		"",
+		"  React component tree inspection and React DevTools profiling can be",
+		"  handled by agent-react-devtools:",
+		"    https://github.com/callstackincubator/agent-react-devtools",
+		"",
+		"Agent workflow:",
+		"",
+		"  1. Run rollipop start and keep it running; add --mcp when using MCP tools.",
+		"  2. Use get_build_events or /sse/events before and after edits.",
+		"  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.",
+		"  4. Use get_bundler_status when you need the latest state for a known bundlerId.",
+		"  5. Use clear_build_* and clear_console_logs before focused diagnostics when old buffered data may be noisy.",
+		"  6. Use bundleFilePath from bundle_build_done when bundle-level debugging is needed.",
+		"  7. If the build fails, inspect the error payload, fix the code, and repeat.",
+		"  8. Use reset_cache when stale cache is suspected."
+	].join("\n");
+}
+const action = async () => {
+	console.log(getAgentGuide());
+};
+//#endregion
+export { action, getAgentGuide };

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

@@ -0,0 +1,10 @@
+import { action, getAgentGuide } from "./action.js";
+//#region src/node/commands/agent/command.ts
+const command = {
+	name: "agent",
+	description: "Print guidance for connecting LLM agents to Rollipop diagnostics.",
+	helpText: getAgentGuide(),
+	action
+};
+//#endregion
+export { command };

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

@@ -0,0 +1,2 @@
+import "./command.js";
+export {};

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

@@ -0,0 +1,33 @@
+import { loadConfig } from "../../../config/load-config.js";
+import { resetCache } from "../../../utils/reset-cache.js";
+import { runBuild } from "../../../utils/run-build.js";
+import { logger } from "../../logger.js";
+import "../../../index.js";
+//#region src/node/commands/bundle/action.ts
+const action = async function(options) {
+	if (!this.platforms.includes(options.platform)) throw new Error(`Unrecognized platform: ${options.platform}`);
+	const cwd = process.cwd();
+	const config = await loadConfig({
+		cwd,
+		mode: "production",
+		configFile: options.config,
+		context: { command: "bundle" }
+	});
+	if (options.resetCache) {
+		resetCache(cwd);
+		logger.info("The transform cache was reset");
+	}
+	if (options.entryFile) config.entry = options.entryFile;
+	await runBuild(config, {
+		platform: options.platform,
+		dev: options.dev,
+		minify: options.minify,
+		cache: options.cache,
+		...options.sourcemapOutput ? { sourcemap: true } : {},
+		outfile: options.bundleOutput,
+		sourcemapOutfile: options.sourcemapOutput,
+		assetsDir: options.assetsDest
+	});
+};
+//#endregion
+export { action };

package/dist/node/commands/bundle/command.js

@@ -0,0 +1,96 @@
+import { parseBoolean, resolvePath } from "../../utils.js";
+import { UNSUPPORTED_OPTION_DESCRIPTION } from "../../constants.js";
+import { action } from "./action.js";
+//#region src/node/commands/bundle/command.ts
+const command = {
+	name: "bundle",
+	description: "Build the bundle for the provided JavaScript entry file.",
+	action,
+	options: [
+		{
+			name: "--config <string>",
+			description: "Path to the CLI configuration file",
+			parse: resolvePath
+		},
+		{
+			name: "--entry-file <path>",
+			description: "Path to the root JS file, either absolute or relative to JS root"
+		},
+		{
+			name: "--platform <string>",
+			description: "Either \"ios\" or \"android\"",
+			default: "ios"
+		},
+		{
+			name: "--dev [boolean]",
+			description: "If false, warnings are disabled and the bundle is minified",
+			parse: parseBoolean
+		},
+		{
+			name: "--minify [boolean]",
+			description: "Allows overriding whether bundle is minified. This defaults to false if dev is true, and true if dev is false. Disabling minification can be useful for speeding up production builds for testing purposes.",
+			parse: parseBoolean
+		},
+		{
+			name: "--cache [boolean]",
+			description: "If false, the bundler will not load or store any cache",
+			parse: parseBoolean
+		},
+		{
+			name: "--bundle-output <string>",
+			description: "File name where to store the resulting bundle, ex. /tmp/groups.bundle",
+			required: true
+		},
+		{
+			name: "--sourcemap-output <string>",
+			description: "File name where to store the sourcemap file for resulting bundle, ex. /tmp/groups.map"
+		},
+		{
+			name: "--sourcemap-sources-root <string>",
+			description: `Path to make sourcemap's sources entries relative to, ex. /root/dir`
+		},
+		{
+			name: "--sourcemap-use-absolute-path",
+			description: "Report SourceMapURL using its full path"
+		},
+		{
+			name: "--assets-dest <string>",
+			description: "Directory name where to store assets referenced in the bundle"
+		},
+		{
+			name: "--reset-cache",
+			description: "Removes cached files",
+			default: false
+		},
+		{
+			name: "--transformer <string>",
+			description: UNSUPPORTED_OPTION_DESCRIPTION
+		},
+		{
+			name: "--bundle-encoding <string>",
+			description: UNSUPPORTED_OPTION_DESCRIPTION
+		},
+		{
+			name: "--max-workers <number>",
+			description: UNSUPPORTED_OPTION_DESCRIPTION
+		},
+		{
+			name: "--unstable-transform-profile <string>",
+			description: UNSUPPORTED_OPTION_DESCRIPTION
+		},
+		{
+			name: "--asset-catalog-dest [string]",
+			description: UNSUPPORTED_OPTION_DESCRIPTION
+		},
+		{
+			name: "--read-global-cache",
+			description: UNSUPPORTED_OPTION_DESCRIPTION
+		},
+		{
+			name: "--resolver-option <string...>",
+			description: UNSUPPORTED_OPTION_DESCRIPTION
+		}
+	]
+};
+//#endregion
+export { command };

package/dist/node/commands/bundle/index.js

@@ -0,0 +1,2 @@
+import "./command.js";
+export {};

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

@@ -0,0 +1,37 @@
+import { loadConfig } from "../../../config/load-config.js";
+import { resetCache } from "../../../utils/reset-cache.js";
+import { runServer } from "../../../utils/run-server.js";
+import { logger } from "../../logger.js";
+import { setupInteractiveMode } from "./setup-interactive-mode.js";
+import "../../../index.js";
+import { noop } from "es-toolkit";
+//#region src/node/commands/start/action.ts
+const action = async function(options) {
+	const cwd = process.cwd();
+	const config = await loadConfig({
+		cwd,
+		mode: "development",
+		configFile: options.config,
+		context: { command: "start" }
+	});
+	if (options.resetCache) {
+		resetCache(cwd);
+		logger.info("The transform cache was reset");
+	}
+	if (options.clientLogs === false) config.reporter = { update: noop };
+	const devServer = await runServer(config, {
+		buildOptions: { cache: options.cache },
+		port: options.port,
+		host: options.host,
+		https: options.https,
+		key: options.key,
+		cert: options.cert,
+		mcp: options.mcp
+	});
+	if (options.interactive) setupInteractiveMode({
+		devServer,
+		extraCommands: config.terminal?.extraCommands
+	});
+};
+//#endregion
+export { action };

package/dist/node/commands/start/command.js

@@ -0,0 +1,93 @@
+import { DEFAULT_HOST, DEFAULT_PORT } from "../../../server/constants.js";
+import "../../../server/index.js";
+import { parseBoolean, resolvePath } from "../../utils.js";
+import { UNSUPPORTED_OPTION_DESCRIPTION } from "../../constants.js";
+import { action } from "./action.js";
+//#region src/node/commands/start/command.ts
+const command = {
+	name: "start",
+	description: "Start the React Native development server.",
+	action,
+	options: [
+		{
+			name: "--config <string>",
+			description: "Path to the CLI configuration file",
+			parse: resolvePath
+		},
+		{
+			name: "--host <string>",
+			description: "Host to start the development server on",
+			default: DEFAULT_HOST
+		},
+		{
+			name: "--port <number>",
+			description: "Port to start the development server on",
+			default: DEFAULT_PORT,
+			parse: Number
+		},
+		{
+			name: "--reset-cache, --resetCache",
+			description: "Removes cached files"
+		},
+		{
+			name: "--https",
+			description: "Enables https connections to the server"
+		},
+		{
+			name: "--key <path>",
+			description: "Path to custom SSL key"
+		},
+		{
+			name: "--cert <path>",
+			description: "Path to custom SSL cert"
+		},
+		{
+			name: "--no-interactive",
+			description: "Disables interactive mode"
+		},
+		{
+			name: "--client-logs",
+			description: "[Deprecated] Enable plain text JavaScript log streaming for all connected apps. This feature is deprecated and will be removed in future.",
+			default: false
+		},
+		{
+			name: "--cache [boolean]",
+			description: "If false, the bundler will not load or store any cache",
+			parse: parseBoolean
+		},
+		{
+			name: "--mcp",
+			description: "Enable the MCP server at /mcp"
+		},
+		{
+			name: "--projectRoot <path>",
+			description: UNSUPPORTED_OPTION_DESCRIPTION
+		},
+		{
+			name: "--watchFolders <list>",
+			description: UNSUPPORTED_OPTION_DESCRIPTION
+		},
+		{
+			name: "--assetPlugins <list>",
+			description: UNSUPPORTED_OPTION_DESCRIPTION
+		},
+		{
+			name: "--sourceExts <list>",
+			description: UNSUPPORTED_OPTION_DESCRIPTION
+		},
+		{
+			name: "--max-workers <number>",
+			description: UNSUPPORTED_OPTION_DESCRIPTION
+		},
+		{
+			name: "--transformer <string>",
+			description: UNSUPPORTED_OPTION_DESCRIPTION
+		},
+		{
+			name: "--custom-log-reporter-path, --customLogReporterPath <string>",
+			description: UNSUPPORTED_OPTION_DESCRIPTION
+		}
+	]
+};
+//#endregion
+export { command };

package/dist/node/commands/start/debugger.js

@@ -0,0 +1,79 @@
+import { Logger } from "../../../common/logger.js";
+import { logger } from "../../logger.js";
+import { loadSettings, saveSettings } from "../../../core/settings.js";
+import { merge } from "es-toolkit";
+import { select } from "@inquirer/prompts";
+//#region src/node/commands/start/debugger.ts
+var DebuggerOpener = class DebuggerOpener {
+	projectRoot;
+	serverUrl;
+	static MAX_TARGETS_SHOWN = 10;
+	_prompting = false;
+	settings;
+	autoOpened = false;
+	static setAutoOpenEnabled(projectRoot, enabled) {
+		saveSettings(projectRoot, { devtools: { autoOpen: enabled } });
+	}
+	constructor(projectRoot, serverUrl) {
+		this.projectRoot = projectRoot;
+		this.serverUrl = serverUrl;
+		this.settings = loadSettings(projectRoot);
+	}
+	async openDebuggerForTarget(target) {
+		logger.debug(`Opening debugger for target: ${target.id}`);
+		try {
+			await fetch(new URL("/open-debugger?target=" + encodeURIComponent(target.id), this.serverUrl), { method: "POST" });
+		} catch (error) {
+			logger.error(`Failed to open debugger for ${target.title}`);
+			logger.debug("Reason", error);
+		}
+	}
+	async autoOpen() {
+		if (this.autoOpened) return;
+		this.autoOpened = true;
+		if (this.isAutoOpenEnabled()) await this.open();
+	}
+	async open() {
+		logger.debug("Fetching available debugging targets...");
+		const response = await fetch(new URL("/json/list", this.serverUrl), { method: "POST" });
+		if (response.status !== 200) throw new Error(`Unexpected status code: ${response.status}`);
+		const targets = await response.json();
+		if (!Array.isArray(targets)) throw new Error("Unexpected response format");
+		logger.debug(`Found ${targets.length} debugging targets:`);
+		if (targets.length === 0) logger.warn("No connected targets");
+		else if (targets.length === 1) {
+			const target = targets[0];
+			await this.openDebuggerForTarget(target);
+		} else {
+			if (targets.length > DebuggerOpener.MAX_TARGETS_SHOWN) logger.warn(`More than ${DebuggerOpener.MAX_TARGETS_SHOWN} debug targets available, showing the first ${DebuggerOpener.MAX_TARGETS_SHOWN}.`);
+			const slicedTargets = targets.slice(0, DebuggerOpener.MAX_TARGETS_SHOWN);
+			Logger.block();
+			this._prompting = true;
+			try {
+				const targetIndex = await select({
+					message: "Multiple debug targets available, please select:",
+					choices: slicedTargets.map((target, index) => ({
+						value: index,
+						name: `${target.title} (${target.description})`
+					}))
+				});
+				await this.openDebuggerForTarget(slicedTargets[targetIndex]);
+			} catch {} finally {
+				Logger.unblock();
+				this._prompting = false;
+			}
+		}
+	}
+	isPrompting() {
+		return this._prompting;
+	}
+	isAutoOpenEnabled() {
+		return this.settings.devtools?.autoOpen ?? false;
+	}
+	setAutoOpenEnabled(enabled) {
+		const newSettings = this.settings = merge(this.settings, { devtools: { autoOpen: enabled } });
+		saveSettings(this.projectRoot, newSettings);
+	}
+};
+//#endregion
+export { DebuggerOpener };

package/dist/node/commands/start/index.js

@@ -0,0 +1,2 @@
+import "./command.js";
+export {};

package/dist/node/commands/start/setup-interactive-mode.d.ts

@@ -0,0 +1,20 @@
+import { Logger } from "../../../common/logger.js";
+import { DevServer } from "../../../server/types.js";
+//#region src/node/commands/start/setup-interactive-mode.d.ts
+interface InteractiveCommand {
+  key: string;
+  shift?: boolean;
+  description: string | (() => string);
+  handler: (this: InteractiveCommandContext) => void;
+}
+interface InteractiveCommandContext {
+  server: DevServer;
+  logger: Logger;
+}
+interface InteractiveModeOptions {
+  devServer: DevServer;
+  extraCommands?: InteractiveCommand[];
+}
+declare function setupInteractiveMode(options: InteractiveModeOptions): void;
+//#endregion
+export { InteractiveCommand, InteractiveCommandContext, InteractiveModeOptions, setupInteractiveMode };