catalyst-core 0.2.0-beta.3 → 0.3.0-beta.1

package/babel.native.config.cjs

@@ -0,0 +1,8 @@
+module.exports = {
+    presets: [
+        ["@babel/preset-env", { targets: { node: "current" } }],
+        ["@babel/preset-react", { runtime: "automatic" }],
+        ["@babel/preset-typescript", { isTSX: true, allExtensions: true }],
+    ],
+    compact: false,
+}

package/bin/catalyst.js

@@ -1,128 +1,72 @@
 #!/usr/bin/env node
-"use strict"
-process.on("unhandledRejection", (err) => {
-    throw err
-})
-const { spawnSync } = require("node:child_process")
-const args = process.argv.slice(2)
 
-// Array of valid commands
-const validCommands = [
-    "build",
-    "start",
-    "serve",
-    "devBuild",
-    "devServe",
-    "plugin",
-    "plugins",
-    "buildApp",
-    "buildApp:ios",
-    "buildApp:android",
-    "setupEmulator",
-    "setupEmulator:ios",
-    "setupEmulator:android",
-]
+import { spawnSync } from "node:child_process"
+import { dirname, resolve } from "node:path"
+import { fileURLToPath } from "node:url"
+
+process.on("unhandledRejection", (error) => {
+    throw error
+})
 
-// Map of platform-specific commands to their script paths
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const args = process.argv.slice(2)
+const webCommands = new Set(["build", "start", "serve", "serve:inspect", "plugin", "plugins"])
 const platformScripts = {
     "setupEmulator:ios": "../dist/native/setupEmulatorIos.js",
     "setupEmulator:android": "../dist/native/androidSetup.js",
     "buildApp:ios": "../dist/native/buildAppIos.js",
     "buildApp:android": "../dist/native/buildAppAndroid.js",
 }
+const validCommands = new Set([...webCommands, "buildApp", "setupEmulator", ...Object.keys(platformScripts)])
+
+const scriptIndex = args.findIndex((arg) => validCommands.has(arg))
+const script = scriptIndex === -1 ? args[0] : args[scriptIndex]
+const nodeArgs = scriptIndex > 0 ? args.slice(0, scriptIndex) : []
+const scriptArgs = args.slice(scriptIndex + 1)
 
-// Helper to check if arg is a platform command
-const isPlatformCommand = (arg, prefix) => {
-    if (!arg.startsWith(`${prefix}:`)) return false
-    const platform = arg.split(":")[1]
-    return ["ios", "android"].includes(platform) || platform === undefined
+function handleProcessResult(result) {
+    if (result.signal) {
+        if (result.signal === "SIGKILL") {
+            console.error("The Catalyst process was terminated with SIGKILL.")
+        } else if (result.signal === "SIGTERM") {
+            console.error("The Catalyst process was terminated with SIGTERM.")
+        }
+        process.exit(1)
+    }
+    process.exit(result.status ?? 1)
 }
 
-// Helper function to run a platform command
-const runPlatformCommand = (baseCommand, platform) => {
-    const command = `${baseCommand}:${platform}`
-    const result = spawnSync(
+function runScript(relativePath, extraArgs = []) {
+    return spawnSync(
         process.execPath,
-        nodeArgs.concat(require.resolve(platformScripts[command])).concat(args.slice(scriptIndex + 1)),
-        { stdio: "inherit" }
+        [...nodeArgs, resolve(__dirname, relativePath), ...extraArgs, ...scriptArgs],
+        {
+            stdio: "inherit",
+        }
     )
-    return result
 }
 
-// Helper function to run commands for all platforms
-const runAllPlatforms = (baseCommand) => {
-    const platforms = ["ios", "android"]
-    for (const platform of platforms) {
-        const result = runPlatformCommand(baseCommand, platform)
-        if (result.status !== 0) {
-            handleProcessResult(result)
-            return
-        }
+function runPlatformCommand(command) {
+    return runScript(platformScripts[command])
+}
+
+if (script === "buildApp" || script === "setupEmulator") {
+    for (const platform of ["ios", "android"]) {
+        const result = runPlatformCommand(`${script}:${platform}`)
+        if (result.status !== 0 || result.signal) handleProcessResult(result)
     }
     process.exit(0)
 }
 
-const scriptIndex = args.findIndex(
-    (x) =>
-        x === "build" ||
-        x === "start" ||
-        x === "serve" ||
-        x === "devBuild" ||
-        x === "devServe" ||
-        x === "plugin" ||
-        x === "plugins" ||
-        isPlatformCommand(x, "buildApp") ||
-        isPlatformCommand(x, "setupEmulator")
-)
-const script = scriptIndex === -1 ? args[0] : args[scriptIndex]
-const nodeArgs = scriptIndex > 0 ? args.slice(0, scriptIndex) : []
-const resolvedScript = script === "plugin" ? "plugins" : script
-
-if (validCommands.includes(script)) {
-    // Handle platform-specific or combined commands
-    if (script === "buildApp" || script === "setupEmulator") {
-        // Run for all platforms if no specific platform is specified
-        runAllPlatforms(script)
-    } else if (script in platformScripts) {
-        // Run for specific platform
-        const result = spawnSync(
-            process.execPath,
-            nodeArgs.concat(require.resolve(platformScripts[script])).concat(args.slice(scriptIndex + 1)),
-            { stdio: "inherit" }
-        )
-        handleProcessResult(result)
-    } else {
-        // Original commands
-        const result = spawnSync(
-            process.execPath,
-            nodeArgs
-                .concat(require.resolve("../dist/scripts/" + resolvedScript))
-                .concat(args.slice(scriptIndex + 1)),
-            { stdio: "inherit" }
-        )
-        handleProcessResult(result)
-    }
-} else {
-    console.log('Unknown script "' + script + '".')
+if (platformScripts[script]) {
+    handleProcessResult(runPlatformCommand(script))
 }
 
-// Helper function to handle process results
-function handleProcessResult(result) {
-    if (result.signal) {
-        if (result.signal === "SIGKILL") {
-            console.log(
-                "The build failed because the process exited too early. " +
-                    "This probably means the system ran out of memory or someone called " +
-                    "`kill -9` on the process."
-            )
-        } else if (result.signal === "SIGTERM") {
-            console.log(
-                "The build failed because the process exited too early. " +
-                    "Someone might have called `kill` or `killall`, or the system could " +
-                    "be shutting down."
-            )
-        }
-        process.exit(1)
-    }
-    process.exit(result.status)
+if (webCommands.has(script)) {
+    const scriptName = script === "plugin" ? "plugins" : script === "serve:inspect" ? "serve" : script
+    const extraArgs = script === "serve:inspect" ? ["--inspect"] : []
+    handleProcessResult(runScript(`../dist/scripts/${scriptName}.js`, extraArgs))
 }
+
+console.error(`Unknown script "${script}".`)
+process.exit(1)

package/changelog.md

@@ -1,3 +1,11 @@
+# 1.0.0-beta.1
+
+- Replaced the Webpack build and SSR pipeline with Vite and ESM.
+- Added React 19 Suspense-aware routing, split components, and manifest-based asset loading.
+- Added opt-in request, compression, flush, and bot-aware OpenTelemetry spans.
+- Preserved native application builds, internal plugins, Sentry exports, and safe-area SSR hydration.
+- Removed the legacy `devBuild` and `devServe` commands.
+
 # Changelog
 
 ## [0.1.0-beta.2] - 2026-05-06

package/dist/caching.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});var _apiCaching=require("@tata1mg/api-caching");Object.keys(_apiCaching).forEach(function(key){if(key==="default"||key==="__esModule")return;if(key in exports&&exports[key]===_apiCaching[key])return;Object.defineProperty(exports,key,{enumerable:true,get:function(){return _apiCaching[key];}});});
+export * from "@tata1mg/api-caching"

package/dist/index.jsx

@@ -0,0 +1,8 @@
+export * from "react-router-dom"
+export * from "./web-router/components/RouterDataProvider.jsx"
+export * from "./web-router/components/MetaTag.jsx"
+export { split, hydrationReady } from "./web-router/components/Split.jsx"
+export { split as default } from "./web-router/components/Split.jsx"
+export * from "./web-router/hooks.jsx"
+export * from "./web-router/utils/metaDataUtils.jsx"
+export * from "./server/renderer/document/index.jsx"

package/dist/logger.js

@@ -1,4 +1,10 @@
-"use strict";const pc=require("picocolors");const winston=require("winston");const DailyRotateFile=require("winston-daily-rotate-file");const{createLogger,format,transports}=winston;/**
+import pc from "picocolors"
+import winston from "winston"
+import DailyRotateFile from "winston-daily-rotate-file"
+
+const { createLogger, format, transports } = winston
+
+/**
  * @description Logger library with rotational strategy. Creates a logs folder in root.
  *              With debug, error and info log directories with their respective log files.
  *
@@ -6,5 +12,70 @@
  * @param config { @enableDebugLogs: Bool // default: true }
  * @returns loggerInstance
  *
- */const configureLogger=(config={})=>{const{enableDebugLogs=true,enableFileLogging=true,enableConsoleLogging=true}=config;const consoleTransport=new transports.Console({level:"debug"});const fileTransport=(type="info")=>{return new DailyRotateFile({filename:`${process.env.src_path}/logs/${type}/%DATE%.${type}.log`,datePattern:"YYYY-MM-DD",maxFiles:"3d",// Logs will be removed after 2days,
-loglevel:type,level:type});};const infoLogger=createLogger({format:format.combine(format.timestamp({format:"YYYY-MM-DD HH:mm:ss"}),format.json()),defaultMeta:{loglevel:"info"}});const debugLogger=createLogger({format:format.combine(format.timestamp({format:"YYYY-MM-DD HH:mm:ss"}),format.json()),defaultMeta:{loglevel:"debug"}});const errorLogger=createLogger({format:format.combine(format.timestamp({format:"YYYY-MM-DD HH:mm:ss"}),format.json()),defaultMeta:{loglevel:"error"}});if(enableConsoleLogging&&JSON.parse(enableConsoleLogging)){infoLogger.add(consoleTransport);debugLogger.add(consoleTransport);errorLogger.add(consoleTransport);}if(enableFileLogging&&JSON.parse(enableFileLogging)){infoLogger.add(fileTransport("info"));debugLogger.add(fileTransport("debug"));errorLogger.add(fileTransport("error"));}const Logger={debug:()=>{},error:msg=>{console.log(pc.red(pc.bold("ERROR: "+JSON.stringify(msg))));errorLogger.error(msg);},info:msg=>{console.log(pc.green(pc.bold("INFO: "+JSON.stringify(msg))));infoLogger.info(msg);}};if(enableDebugLogs&&JSON.parse(enableDebugLogs)){Logger.debug=msg=>{console.log(pc.yellow(pc.bold("DEBUG: "+JSON.stringify(msg))));debugLogger.debug(msg);};}if(global)global.logger=Logger;return Logger;};module.exports={configureLogger};
+ */
+const configureLogger = (config = {}) => {
+    const { enableDebugLogs = true, enableFileLogging = true, enableConsoleLogging = true } = config
+
+    const consoleTransport = new transports.Console({ level: "debug" })
+
+    const fileTransport = (type = "info") => {
+        return new DailyRotateFile({
+            filename: `${process.env.src_path}/logs/${type}/%DATE%.${type}.log`,
+            datePattern: "YYYY-MM-DD",
+            maxFiles: "3d", // Logs will be removed after 2days,
+            loglevel: type,
+            level: type,
+        })
+    }
+
+    const infoLogger = createLogger({
+        format: format.combine(format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), format.json()),
+        defaultMeta: { loglevel: "info" },
+    })
+
+    const debugLogger = createLogger({
+        format: format.combine(format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), format.json()),
+        defaultMeta: { loglevel: "debug" },
+    })
+
+    const errorLogger = createLogger({
+        format: format.combine(format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), format.json()),
+        defaultMeta: { loglevel: "error" },
+    })
+
+    if (enableConsoleLogging && JSON.parse(enableConsoleLogging)) {
+        infoLogger.add(consoleTransport)
+        debugLogger.add(consoleTransport)
+        errorLogger.add(consoleTransport)
+    }
+
+    if (enableFileLogging && JSON.parse(enableFileLogging)) {
+        infoLogger.add(fileTransport("info"))
+        debugLogger.add(fileTransport("debug"))
+        errorLogger.add(fileTransport("error"))
+    }
+
+    const Logger = {
+        debug: () => {},
+        error: (msg) => {
+            console.log(pc.red(pc.bold("ERROR: " + JSON.stringify(msg))))
+            errorLogger.error(msg)
+        },
+        info: (msg) => {
+            console.log(pc.green(pc.bold("INFO: " + JSON.stringify(msg))))
+            infoLogger.info(msg)
+        },
+    }
+
+    if (enableDebugLogs && JSON.parse(enableDebugLogs)) {
+        Logger.debug = (msg) => {
+            console.log(pc.yellow(pc.bold("DEBUG: " + JSON.stringify(msg))))
+            debugLogger.debug(msg)
+        }
+    }
+
+    if (global) global.logger = Logger
+    return Logger
+}
+
+export { configureLogger }

package/dist/native/androidSetup.js

@@ -1,9 +1,301 @@
-"use strict";var _fs=_interopRequireDefault(require("fs"));var _path=_interopRequireDefault(require("path"));var _child_process=require("child_process");var _utils=require("./utils.js");var _TerminalProgress=_interopRequireDefault(require("./TerminalProgress.js"));var _setupServer=require("./setupServer.js");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}const catalystCorePath=_path.default.dirname(require.resolve("catalyst-core/package.json"));const pwd=_path.default.join(catalystCorePath,"dist/native");const configPath=`${process.env.PWD}/config/config.json`;const steps={java:"Check Java Environment",config:"Initialize Configuration",androidTools:"Validate Android Tools",emulator:"Configure Android Emulator",properties:"Update Local Properties",saveConfig:"Save Configuration",setupServer:"Setup Server"};const progressPaddingConfig={titlePaddingTop:2,titlePaddingBottom:1,stepPaddingLeft:4,stepSpacing:1,errorPaddingLeft:6,bottomMargin:2};const progress=new _TerminalProgress.default(steps,"Catalyst Universal Android Setup",progressPaddingConfig);async function checkJavaInstallation(){try{(0,_utils.runCommand)("java -version");(0,_utils.runCommand)("javac -version");progress.log("Java is installed and configured","success");return true;}catch(error){progress.log("Java installation not found or not properly configured","error");return false;}}async function installJava(){progress.log("Installing Java (Zulu JDK 17)...");try{try{(0,_utils.runCommand)("brew --version");}catch(error){throw new Error("Homebrew is required but not installed. Please install Homebrew first.");}const javaHome="/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home";// Try installing Java
-try{await(0,_utils.runCommand)("brew install --cask zulu@17");}catch(error){if(error.message.includes("already installed")){progress.log("Attempting to reinstall Java...","info");try{await(0,_utils.runCommand)("brew reinstall --cask zulu@17");}catch(reinstallError){throw new Error(`Failed to reinstall Java: ${reinstallError.message}. Please run 'brew reinstall --cask zulu@17' manually.`);}}else{throw error;}}// Verify Java installation
-if(!_fs.default.existsSync(javaHome)){throw new Error(`Java installation not found at ${javaHome}. Please verify the installation manually.`);}// Set up environment variables
-const homeDir=process.env.HOME;const shellProfile=`${homeDir}/.zshrc`;const exportCommand=`\n# Java Configuration\nexport JAVA_HOME=${javaHome}\nexport PATH=$JAVA_HOME/bin:$PATH\n`;try{_fs.default.appendFileSync(shellProfile,exportCommand);}catch(error){throw new Error(`Failed to update ${shellProfile}: ${error.message}. Please add the following lines manually:\n${exportCommand}`);}// Set for current process
-process.env.JAVA_HOME=javaHome;process.env.PATH=`${javaHome}/bin:${process.env.PATH}`;// Verify Java configuration
-try{const javaVersion=(0,_utils.runCommand)("java -version");progress.log("Java installed and configured successfully","success");progress.log(`Java Version: ${javaVersion}`,"info");progress.log(`IMPORTANT: Please run the following commands to complete setup:`,"warning");progress.log(`1. source ${shellProfile}`,"info");progress.log(`2. echo $JAVA_HOME`,"info");return true;}catch(error){throw new Error(`Java installation verified but environment not configured. Please run:\n1. source ${shellProfile}\n2. echo $JAVA_HOME`);}}catch(error){progress.log(error.message,"error");progress.log("Manual Setup Instructions:","info");progress.log("1. Run: brew reinstall --cask zulu@17","info");progress.log("2. Add to ~/.zshrc:","info");progress.log("   export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home","info");progress.log("   export PATH=$JAVA_HOME/bin:$PATH","info");progress.log("3. Run: source ~/.zshrc","info");throw error;}}async function validateJavaEnvironment(){progress.start("java");const hasJava=await checkJavaInstallation();if(!hasJava){progress.log("Java installation required. Starting installation process...");const javaInstalled=await installJava();if(!javaInstalled){progress.fail("java","Failed to set up Java environment");throw new Error("Failed to set up Java environment");}}progress.complete("java");}async function initializeConfig(){const configFile=_fs.default.readFileSync(configPath,"utf8");const config=JSON.parse(configFile);const{WEBVIEW_CONFIG}=config;if(!WEBVIEW_CONFIG||Object.keys(WEBVIEW_CONFIG).length===0){progress.log("WebView Config missing in "+configPath,"error");process.exit(1);}if(!WEBVIEW_CONFIG.android){WEBVIEW_CONFIG.android={};}return{WEBVIEW_CONFIG};}async function saveConfig(newConfig){try{const existingConfigFile=_fs.default.readFileSync(configPath,"utf8");const existingConfig=JSON.parse(existingConfigFile);const updatedConfig={...existingConfig,WEBVIEW_CONFIG:{...existingConfig.WEBVIEW_CONFIG,android:newConfig.WEBVIEW_CONFIG.android}};_fs.default.writeFileSync(configPath,JSON.stringify(updatedConfig,null,2));progress.log("Configuration saved successfully","success");}catch(error){progress.log("Failed to save configuration: "+error.message,"error");process.exit(1);}}function validateAndroidTools(androidConfig){const ANDROID_SDK=androidConfig.sdkPath;const EMULATOR_PATH=`${ANDROID_SDK}/emulator/emulator`;const ADB_PATH=`${ANDROID_SDK}/platform-tools/adb`;if(!ANDROID_SDK){throw new Error("Android SDK path is not configured");}if(!_fs.default.existsSync(ANDROID_SDK)){throw new Error(`Android SDK path does not exist: ${ANDROID_SDK}`);}if(!_fs.default.existsSync(ADB_PATH)){throw new Error(`ADB not found at: ${ADB_PATH}`);}try{(0,_utils.runCommand)(`${ADB_PATH} version`);progress.log("ADB is valid","success");}catch(error){throw new Error(`ADB is not working properly: ${error.message}`);}if(!_fs.default.existsSync(EMULATOR_PATH)){throw new Error(`Emulator not found at: ${EMULATOR_PATH}`);}try{(0,_utils.runCommand)(`${EMULATOR_PATH} -version`);progress.log("Emulator is valid","success");}catch(error){throw new Error(`Emulator is not working properly: ${error.message}`);}try{const avdOutput=(0,_utils.runCommand)(`${EMULATOR_PATH} -list-avds`);if(!avdOutput.includes(androidConfig.emulatorName)){throw new Error(`Specified emulator "${androidConfig.emulatorName}" not found in available AVDs`);}progress.log(`Emulator "${androidConfig.emulatorName}" exists`,"success");}catch(error){throw new Error(`Error checking emulator AVD: ${error.message}`);}progress.log("Android tools validation completed successfully!","success");return{EMULATOR_PATH,ADB_PATH};}async function checkEmulator(ADB_PATH){try{const devices=(0,_utils.runCommand)(`${ADB_PATH} devices`);return devices.includes("emulator");}catch(error){progress.log(`Error checking emulator: ${error}`,"error");return false;}}async function startEmulator(EMULATOR_PATH,androidConfig){progress.log(`Starting emulator: ${androidConfig.emulatorName}...`);// eslint-disable-next-line security/detect-child-process
-// nosemgrep: javascript.lang.security.detect-child-process.detect-child-process - EMULATOR_PATH is derived from SDK configuration and emulatorName is local native setup config.
-(0,_child_process.exec)(`${EMULATOR_PATH} -avd ${androidConfig.emulatorName} -read-only > /dev/null &`,error=>{if(error){progress.log(`Error starting emulator: ${error}`,"error");}});}async function updateLocalProperties(sdkPath){progress.start("properties");try{(0,_utils.runCommand)(`cd ${pwd}/androidProject && ./gradlew updateSdkPath -PsdkPath="${sdkPath}"`);progress.log("Updated local.properties successfully","success");progress.complete("properties");}catch(error){progress.fail("properties",`Failed to update local.properties: ${error.message}`);throw error;}}async function setupAndroidEnvironment(){try{await validateJavaEnvironment();progress.start("config");await initializeConfig();const config=await(0,_utils.validateAndCompleteConfig)("android",configPath);progress.complete("config");progress.start("androidTools");const{EMULATOR_PATH,ADB_PATH}=validateAndroidTools(config.android);progress.complete("androidTools");progress.start("emulator");const emulatorRunning=await checkEmulator(ADB_PATH);if(!emulatorRunning){progress.log("No emulator running, attempting to start one...");await startEmulator(EMULATOR_PATH,config.android);}else{progress.log("Emulator already running, proceeding with installation...","success");}progress.complete("emulator");if(config.android?.sdkPath){await updateLocalProperties(config.android.sdkPath);}progress.start("saveConfig");await saveConfig({WEBVIEW_CONFIG:config});progress.complete("saveConfig");progress.start("setupServer");await(0,_setupServer.setupServer)(configPath);progress.complete("setupServer");progress.printTreeContent("Configuration Explanation",["WEBVIEW_CONFIG: Main configuration object for the WebView setup",{text:"port: Port number for the WebView server",indent:1,prefix:"├─ ",color:"gray"},{text:"android: Android-specific configuration",indent:1,prefix:"└─ ",color:"gray"},{text:"buildType: Build type (debug/release)",indent:2,prefix:"├─ ",color:"gray"},{text:"sdkPath: Android SDK path",indent:2,prefix:"├─ ",color:"gray"},{text:"emulatorName: Selected Android emulator name",indent:2,prefix:"└─ ",color:"gray"}]);progress.printTreeContent("Final Configuration",[JSON.stringify(config,null,2)]);process.exit(0);}catch(error){if(progress.currentStep){progress.fail(progress.currentStep.id,error.message);}process.exit(1);}}// Execute the main setup
+"use strict";
+
+var _fs = _interopRequireDefault(require("fs"));
+var _path = _interopRequireDefault(require("path"));
+var _child_process = require("child_process");
+var _utils = require("./utils.js");
+var _TerminalProgress = _interopRequireDefault(require("./TerminalProgress.js"));
+var _setupServer = require("./setupServer.js");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const catalystCorePath = _path.default.dirname(require.resolve("catalyst-core/package.json"));
+const pwd = _path.default.join(catalystCorePath, "dist/native");
+const configPath = `${process.env.PWD}/config/config.json`;
+const steps = {
+  java: "Check Java Environment",
+  config: "Initialize Configuration",
+  androidTools: "Validate Android Tools",
+  emulator: "Configure Android Emulator",
+  properties: "Update Local Properties",
+  saveConfig: "Save Configuration",
+  setupServer: "Setup Server"
+};
+const progressPaddingConfig = {
+  titlePaddingTop: 2,
+  titlePaddingBottom: 1,
+  stepPaddingLeft: 4,
+  stepSpacing: 1,
+  errorPaddingLeft: 6,
+  bottomMargin: 2
+};
+const progress = new _TerminalProgress.default(steps, "Catalyst Universal Android Setup", progressPaddingConfig);
+async function checkJavaInstallation() {
+  try {
+    (0, _utils.runCommand)("java -version");
+    (0, _utils.runCommand)("javac -version");
+    progress.log("Java is installed and configured", "success");
+    return true;
+  } catch (error) {
+    progress.log("Java installation not found or not properly configured", "error");
+    return false;
+  }
+}
+async function installJava() {
+  progress.log("Installing Java (Zulu JDK 17)...");
+  try {
+    try {
+      (0, _utils.runCommand)("brew --version");
+    } catch (error) {
+      throw new Error("Homebrew is required but not installed. Please install Homebrew first.");
+    }
+    const javaHome = "/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home";
+
+    // Try installing Java
+    try {
+      await (0, _utils.runCommand)("brew install --cask zulu@17");
+    } catch (error) {
+      if (error.message.includes("already installed")) {
+        progress.log("Attempting to reinstall Java...", "info");
+        try {
+          await (0, _utils.runCommand)("brew reinstall --cask zulu@17");
+        } catch (reinstallError) {
+          throw new Error(`Failed to reinstall Java: ${reinstallError.message}. Please run 'brew reinstall --cask zulu@17' manually.`);
+        }
+      } else {
+        throw error;
+      }
+    }
+
+    // Verify Java installation
+    if (!_fs.default.existsSync(javaHome)) {
+      throw new Error(`Java installation not found at ${javaHome}. Please verify the installation manually.`);
+    }
+
+    // Set up environment variables
+    const homeDir = process.env.HOME;
+    const shellProfile = `${homeDir}/.zshrc`;
+    const exportCommand = `\n# Java Configuration\nexport JAVA_HOME=${javaHome}\nexport PATH=$JAVA_HOME/bin:$PATH\n`;
+    try {
+      _fs.default.appendFileSync(shellProfile, exportCommand);
+    } catch (error) {
+      throw new Error(`Failed to update ${shellProfile}: ${error.message}. Please add the following lines manually:\n${exportCommand}`);
+    }
+
+    // Set for current process
+    process.env.JAVA_HOME = javaHome;
+    process.env.PATH = `${javaHome}/bin:${process.env.PATH}`;
+
+    // Verify Java configuration
+    try {
+      const javaVersion = (0, _utils.runCommand)("java -version");
+      progress.log("Java installed and configured successfully", "success");
+      progress.log(`Java Version: ${javaVersion}`, "info");
+      progress.log(`IMPORTANT: Please run the following commands to complete setup:`, "warning");
+      progress.log(`1. source ${shellProfile}`, "info");
+      progress.log(`2. echo $JAVA_HOME`, "info");
+      return true;
+    } catch (error) {
+      throw new Error(`Java installation verified but environment not configured. Please run:\n1. source ${shellProfile}\n2. echo $JAVA_HOME`);
+    }
+  } catch (error) {
+    progress.log(error.message, "error");
+    progress.log("Manual Setup Instructions:", "info");
+    progress.log("1. Run: brew reinstall --cask zulu@17", "info");
+    progress.log("2. Add to ~/.zshrc:", "info");
+    progress.log("   export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home", "info");
+    progress.log("   export PATH=$JAVA_HOME/bin:$PATH", "info");
+    progress.log("3. Run: source ~/.zshrc", "info");
+    throw error;
+  }
+}
+async function validateJavaEnvironment() {
+  progress.start("java");
+  const hasJava = await checkJavaInstallation();
+  if (!hasJava) {
+    progress.log("Java installation required. Starting installation process...");
+    const javaInstalled = await installJava();
+    if (!javaInstalled) {
+      progress.fail("java", "Failed to set up Java environment");
+      throw new Error("Failed to set up Java environment");
+    }
+  }
+  progress.complete("java");
+}
+async function initializeConfig() {
+  const configFile = _fs.default.readFileSync(configPath, "utf8");
+  const config = JSON.parse(configFile);
+  const {
+    WEBVIEW_CONFIG
+  } = config;
+  if (!WEBVIEW_CONFIG || Object.keys(WEBVIEW_CONFIG).length === 0) {
+    progress.log("WebView Config missing in " + configPath, "error");
+    process.exit(1);
+  }
+  if (!WEBVIEW_CONFIG.android) {
+    WEBVIEW_CONFIG.android = {};
+  }
+  return {
+    WEBVIEW_CONFIG
+  };
+}
+async function saveConfig(newConfig) {
+  try {
+    const existingConfigFile = _fs.default.readFileSync(configPath, "utf8");
+    const existingConfig = JSON.parse(existingConfigFile);
+    const updatedConfig = {
+      ...existingConfig,
+      WEBVIEW_CONFIG: {
+        ...existingConfig.WEBVIEW_CONFIG,
+        android: newConfig.WEBVIEW_CONFIG.android
+      }
+    };
+    _fs.default.writeFileSync(configPath, JSON.stringify(updatedConfig, null, 2));
+    progress.log("Configuration saved successfully", "success");
+  } catch (error) {
+    progress.log("Failed to save configuration: " + error.message, "error");
+    process.exit(1);
+  }
+}
+function validateAndroidTools(androidConfig) {
+  const ANDROID_SDK = androidConfig.sdkPath;
+  const EMULATOR_PATH = `${ANDROID_SDK}/emulator/emulator`;
+  const ADB_PATH = `${ANDROID_SDK}/platform-tools/adb`;
+  if (!ANDROID_SDK) {
+    throw new Error("Android SDK path is not configured");
+  }
+  if (!_fs.default.existsSync(ANDROID_SDK)) {
+    throw new Error(`Android SDK path does not exist: ${ANDROID_SDK}`);
+  }
+  if (!_fs.default.existsSync(ADB_PATH)) {
+    throw new Error(`ADB not found at: ${ADB_PATH}`);
+  }
+  try {
+    (0, _utils.runCommand)(`${ADB_PATH} version`);
+    progress.log("ADB is valid", "success");
+  } catch (error) {
+    throw new Error(`ADB is not working properly: ${error.message}`);
+  }
+  if (!_fs.default.existsSync(EMULATOR_PATH)) {
+    throw new Error(`Emulator not found at: ${EMULATOR_PATH}`);
+  }
+  try {
+    (0, _utils.runCommand)(`${EMULATOR_PATH} -version`);
+    progress.log("Emulator is valid", "success");
+  } catch (error) {
+    throw new Error(`Emulator is not working properly: ${error.message}`);
+  }
+  try {
+    const avdOutput = (0, _utils.runCommand)(`${EMULATOR_PATH} -list-avds`);
+    if (!avdOutput.includes(androidConfig.emulatorName)) {
+      throw new Error(`Specified emulator "${androidConfig.emulatorName}" not found in available AVDs`);
+    }
+    progress.log(`Emulator "${androidConfig.emulatorName}" exists`, "success");
+  } catch (error) {
+    throw new Error(`Error checking emulator AVD: ${error.message}`);
+  }
+  progress.log("Android tools validation completed successfully!", "success");
+  return {
+    EMULATOR_PATH,
+    ADB_PATH
+  };
+}
+async function checkEmulator(ADB_PATH) {
+  try {
+    const devices = (0, _utils.runCommand)(`${ADB_PATH} devices`);
+    return devices.includes("emulator");
+  } catch (error) {
+    progress.log(`Error checking emulator: ${error}`, "error");
+    return false;
+  }
+}
+async function startEmulator(EMULATOR_PATH, androidConfig) {
+  progress.log(`Starting emulator: ${androidConfig.emulatorName}...`);
+  // nosemgrep: javascript.lang.security.detect-child-process.detect-child-process - EMULATOR_PATH is derived from SDK configuration and emulatorName is local native setup config.
+  // eslint-disable-next-line security/detect-child-process
+  (0, _child_process.exec)(`${EMULATOR_PATH} -avd ${androidConfig.emulatorName} -read-only > /dev/null &`, error => {
+    if (error) {
+      progress.log(`Error starting emulator: ${error}`, "error");
+    }
+  });
+}
+async function updateLocalProperties(sdkPath) {
+  progress.start("properties");
+  try {
+    (0, _utils.runCommand)(`cd ${pwd}/androidProject && ./gradlew updateSdkPath -PsdkPath="${sdkPath}"`);
+    progress.log("Updated local.properties successfully", "success");
+    progress.complete("properties");
+  } catch (error) {
+    progress.fail("properties", `Failed to update local.properties: ${error.message}`);
+    throw error;
+  }
+}
+async function setupAndroidEnvironment() {
+  try {
+    await validateJavaEnvironment();
+    progress.start("config");
+    await initializeConfig();
+    const config = await (0, _utils.validateAndCompleteConfig)("android", configPath);
+    progress.complete("config");
+    progress.start("androidTools");
+    const {
+      EMULATOR_PATH,
+      ADB_PATH
+    } = validateAndroidTools(config.android);
+    progress.complete("androidTools");
+    progress.start("emulator");
+    const emulatorRunning = await checkEmulator(ADB_PATH);
+    if (!emulatorRunning) {
+      progress.log("No emulator running, attempting to start one...");
+      await startEmulator(EMULATOR_PATH, config.android);
+    } else {
+      progress.log("Emulator already running, proceeding with installation...", "success");
+    }
+    progress.complete("emulator");
+    if (config.android?.sdkPath) {
+      await updateLocalProperties(config.android.sdkPath);
+    }
+    progress.start("saveConfig");
+    await saveConfig({
+      WEBVIEW_CONFIG: config
+    });
+    progress.complete("saveConfig");
+    progress.start("setupServer");
+    await (0, _setupServer.setupServer)(configPath);
+    progress.complete("setupServer");
+    progress.printTreeContent("Configuration Explanation", ["WEBVIEW_CONFIG: Main configuration object for the WebView setup", {
+      text: "port: Port number for the WebView server",
+      indent: 1,
+      prefix: "├─ ",
+      color: "gray"
+    }, {
+      text: "android: Android-specific configuration",
+      indent: 1,
+      prefix: "└─ ",
+      color: "gray"
+    }, {
+      text: "buildType: Build type (debug/release)",
+      indent: 2,
+      prefix: "├─ ",
+      color: "gray"
+    }, {
+      text: "sdkPath: Android SDK path",
+      indent: 2,
+      prefix: "├─ ",
+      color: "gray"
+    }, {
+      text: "emulatorName: Selected Android emulator name",
+      indent: 2,
+      prefix: "└─ ",
+      color: "gray"
+    }]);
+    progress.printTreeContent("Final Configuration", [JSON.stringify(config, null, 2)]);
+    process.exit(0);
+  } catch (error) {
+    if (progress.currentStep) {
+      progress.fail(progress.currentStep.id, error.message);
+    }
+    process.exit(1);
+  }
+}
+
+// Execute the main setup
 setupAndroidEnvironment();