@codemoreira/esad 2.0.1-4 → 2.0.1-5

package/README.md

@@ -1,82 +1,88 @@
-# ESAD (Easy Super App Development) 🚀
-
-Zero-Config CLI and DevTools for React Native Module Federation + Expo.
-
-ESAD is a unified toolkit designed to abstract all the complexity from Super App development using **Re.Pack (Rspack)** and **Expo**.
-
----
-
-## 🏗️ CLI Commands
-
-### 1. Initialize a Workspace
-```bash
-npx @codemoreira/esad init my-project
-```
-
-### 2. Create a Federated Module
-```bash
-npx esad create-module module-name
-```
-
-### 3. Create a Local CDN / Registry
-```bash
-npx esad create-cdn
-```
-
-### 4. Development & Native Automation
-Starts the Rspack server and **automatically patches** native files (Gradle, Entry Points) if necessary.
-```bash
-npx esad host dev  # Run the Host App
-npx esad dev --id module-name --port 9000  # Run a Module
-```
-
-### 5. Build for Production
-Prepares the bundle and chunks for deployment, generating a standardized `./build` directory.
-```bash
-npx esad build --id module-name --platform android
-```
-
-### 6. Deployment
-Packages the `./build` folder and uploads it to your configured Registry/CDN via multipart POST.
-```bash
-npx esad deploy --id module-name --version 1.0.0
-```
-
----
-
-## 🛠️ Library Usage
-
-### 🎨 Bundler Plugin (`@codemoreira/esad/plugin`)
-Wrap your configuration to enable ESAD's smart resolution and redirection logic:
-```javascript
-import { withESAD } from '@codemoreira/esad/plugin';
-
-export default withESAD({
-  type: 'module', // or 'host'
-  id: 'my-mini-app'
-});
-```
-
-### ⚡ Global State SDK (`@codemoreira/esad/client`)
-Share state across the Host and all Remote Modules reactively:
-```javascript
-import { useESADState } from '@codemoreira/esad/client';
-
-const [user, setUser] = useESADState('user');
-```
-
----
-
-## 🏠 Template Features (Host & Module)
-
-ESAD provides high-quality, boilerplate-free templates:
-- **🚀 Rspack + Re.Pack**: Blazing fast builds powered by Rspack.
-- **📱 Clean UI**: Modern, responsive designs built with **Vanilla StyleSheet** (No external CSS libraries required).
-- **🛤️ Dynamic Navigation**: Pre-configured Dashboard and Module Viewer with **Suspense** support.
-- **🔐 State-Driven Auth**: Built-in login and session management via the ESAD SDK.
-- **🔧 Automated Patching**: CLI-driven injection of Re.Pack extensions into Android and iOS native projects.
-
----
-
-## 🎨 Architecture & Workflow
-For technical diagrams and the modular deployment lifecycle, see [ESAD_ARCHITECTURE.md](./ESAD_ARCHITECTURE.md).
+# ESAD (Easy Super App Development) 🚀
+
+Zero-Config CLI and DevTools for React Native Module Federation + Expo.
+
+ESAD is a unified toolkit designed to abstract all the complexity from Super App development using **Re.Pack (Rspack)** and **Expo**. It provides a professional, linear workflow from scaffolding to deployment.
+
+---
+
+## 🏗️ CLI Workflow (V2)
+
+### 1. Initialize a Workspace
+Creates the project root, a programmable `esad.config.js`, and the Host Application.
+```bash
+npx @codemoreira/esad init my-project
+```
+
+### 2. Expand your Workspace
+Create new Federated Modules or a Local Registry/CDN.
+```bash
+esad create my-module   # Creates a new module (Feature)
+esad create --type cdn  # Scaffolds a local registry for testing
+```
+
+### 3. Development Manager (Unified)
+The `dev` command is the single entry point for development. It automatically detects if it should run the Host or a Module.
+
+**Run the Host App (Interactive):**
+```bash
+esad dev
+```
+*Allows selecting Android, iOS, or Bundler Only. Automatically patches native files.*
+
+**Run a specific Module:**
+```bash
+esad dev my-module --port 9000
+```
+*Starts the module server and updates the Host's local mapping automatically.*
+
+### 4. Build & Deploy
+Prepare and push your features to the registry.
+
+**Build for Production:**
+```bash
+esad build my-module --platform android
+```
+
+**Execute Programmable Deploy:**
+```bash
+esad deploy my-module --version 1.0.0
+```
+
+---
+
+## 🛠️ Library Usage
+
+### 🎨 Bundler Plugin (`@codemoreira/esad/plugin`)
+Wrap your configuration to enable ESAD's smart resolution and redirection logic:
+```javascript
+import { withESAD } from '@codemoreira/esad/plugin';
+
+export default withESAD({
+  type: 'module', // or 'host'
+  id: 'my-mini-app'
+});
+```
+
+### ⚡ Global State SDK (`@codemoreira/esad/client`)
+Share state across the Host and all Remote Modules reactively:
+```javascript
+import { useESADState } from '@codemoreira/esad/client';
+
+const [user, setUser] = useESADState('user');
+```
+
+---
+
+## 🏠 Template Features (Host & Module)
+ESAD templates provide a high-end starting point:
+- **🚀 Rspack + Re.Pack**: Blazing fast builds.
+- **📱 Professional Architecture**: Modular structure (`src/api`, `src/components`, `src/navigation`).
+- **🛤️ Dynamic Navigation**: Pre-configured Module Viewer with **Suspense** and **ErrorBoundary** support.
+- **🔐 State-Driven Auth**: Built-in login and session management via the ESAD SDK.
+- **🔧 Automated Native Patching**: Zero-config injection into Android/iOS projects.
+
+---
+
+## 🎨 Architecture & Workflow
+For technical diagrams and the full lifecycle, see [ESAD_ARCHITECTURE.md](./ESAD_ARCHITECTURE.md).

package/bin/esad.js

@@ -24,12 +24,13 @@ program
     await require('../src/cli/commands/create')(name, options);
   });
 
-// --- COMMAND: esad dev [moduleId] ---
+// --- COMMAND: esad dev [id] ---
 program
-  .command('dev [id]') // [id] as alias to -i for better UX
+  .command('dev [id]')
   .option('-i, --id <moduleId>', 'The Module ID to run in dev mode')
   .option('-p, --port <port>', 'The port to run the dev server on', '8081')
-  .description('Starts the development environment for a module or the host application')
+  .option('--platform <platform>', 'Platform for host: android, ios, bundler')
+  .description('Starts the development environment. Run without [id] for Host App or with [id] for a specific Module.')
   .action(async (id, options) => {
     const opts = { ...options, id: id || options.id };
     await require('../src/cli/commands/dev')(opts);
@@ -40,7 +41,7 @@ program
   .command('build [id]')
   .option('-i, --id <moduleId>', 'The Module ID to build')
   .option('-p, --platform <platform>', 'Platform: android, ios', 'android')
-  .description('Builds a production bundle')
+  .description('Builds a production bundle for a module or the host application')
   .action(async (id, options) => {
     const opts = { ...options, id: id || options.id };
     await require('../src/cli/commands/build')(opts);
@@ -57,14 +58,6 @@ program
     await require('../src/cli/commands/deploy')(opts);
   });
 
-// --- COMMAND: esad host <sub> ---
-program
-  .command('host <subcommand>')
-  .description('Manage host application (android, ios, login)')
-  .action(async (sub) => {
-    await require('../src/cli/commands/host')(sub);
-  });
-
 // --- COMMAND: esad doctor ---
 program
   .command('doctor')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemoreira/esad",
-  "version": "2.0.1-4",
+  "version": "2.0.1-5",
   "description": "Easy Super App Development - Zero-Config CLI and DevTools for React Native Module Federation",
   "main": "src/plugin/index.js",
   "types": "./src/plugin/index.d.ts",

package/src/cli/commands/dev.js

@@ -22,25 +22,29 @@ const isPortInUse = (port) => new Promise((resolve) => {
   req.end();
 });
 
-const runHostDevFlow = async (cwd) => {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-  const askQuestion = (query) => new Promise((resolve) => rl.question(query, resolve));
-
-  console.log(`\n${chalk.bold('ESAD Host Dev Manager')}`);
-  console.log(chalk.dim(`---------------------`));
-  console.log(`[a] Run on Android`);
-  console.log(`[i] Run on iOS`);
-  console.log(`[b] Bundler Only`);
-  console.log(`[c] Cancel`);
-  
-  const choice = (await askQuestion(`\nSelect platform: `)).toLowerCase();
+const runHostDevFlow = async (cwd, options = {}) => {
+  let choice = options.platform ? options.platform.charAt(0).toLowerCase() : null;
+
+  if (!choice) {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+    const askQuestion = (query) => new Promise((resolve) => rl.question(query, resolve));
+
+    console.log(`\n${chalk.bold('ESAD Host Dev Manager')}`);
+    console.log(chalk.dim(`---------------------`));
+    console.log(`[a] Run on Android`);
+    console.log(`[i] Run on iOS`);
+    console.log(`[b] Bundler Only`);
+    console.log(`[c] Cancel`);
+    
+    choice = (await askQuestion(`\nSelect platform: `)).toLowerCase();
+    rl.close();
+  }
   
   if (choice === 'c') {
     console.log(`\n❌ Cancelled.`);
-    rl.close();
     return;
   }
 
@@ -81,7 +85,6 @@ const runHostDevFlow = async (cwd) => {
 
     if (!(await waitForBundler())) {
       console.error(`\n❌ Timeout: Bundler did not respond.`);
-      rl.close();
       return;
     }
     console.log(`✅ Bundler ready!`);
@@ -93,9 +96,9 @@ const runHostDevFlow = async (cwd) => {
   } else if (choice === 'i') {
     console.log(`🍎 Launching iOS...`);
     await runProcess('react-native', ['run-ios', '--no-packager'], cwd);
+  } else if (choice === 'b') {
+    console.log(`✨ Bundler is active.`);
   }
-
-  rl.close();
 };
 
 module.exports = async (options) => {
@@ -164,7 +167,7 @@ module.exports = async (options) => {
 
   if (isHost) {
     await prepareNative(cwd, 'all');
-    await runHostDevFlow(cwd);
+    await runHostDevFlow(cwd, options);
   } else {
     console.error(chalk.red(`❌ Error: Could not detect Host or Module context.`));
     console.log(`👉 Try: esad dev <module-id>`);

package/src/cli/commands/init.js

@@ -75,7 +75,7 @@ export default {
     console.log(chalk.green(`\n🎉 ESAD Workspace Initialized successfully!`));
     console.log(chalk.cyan(`\n👉 Next steps:`));
     console.log(`   1. cd ${projectName}/${hostName}`);
-    console.log(`   2. esad host dev (to start Host)`);
+    console.log(`   2. esad dev (to start Host)`);
     console.log(`   3. esad dev (in a module folder to federate)\n`);
   } catch (err) {
     console.error(chalk.red(`\n❌ Failed to initialize workspace:`));

package/src/plugin/index.js

@@ -59,7 +59,7 @@ function withESAD(env, options) {
             {
               test: /\.[cm]?[jt]sx?$/,
               include: [
-                /node_modules[\\/](react-native|@react-native|expo|expo-modules-core|@expo|react-navigation|@react-navigation|@unimodules|unimodules|native-base)/,
+                /node_modules[\\/](react-native|@react-native|expo|expo-modules-core|@expo|react-navigation|@react-navigation|@unimodules|unimodules|native-base|react-native-screens|react-native-reanimated)/,
               ],
               type: 'javascript/auto',
               resolve: { fullySpecified: false },
@@ -67,10 +67,10 @@ function withESAD(env, options) {
                 loader: 'babel-loader',
                 options: {
                   presets: [
-                    [
-                      'babel-preset-expo',
-                      { native: { disableImportExportTransform: false } },
-                    ],
+                    '@react-native/babel-preset',
+                  ],
+                  plugins: [
+                    ['@babel/plugin-transform-react-jsx', { runtime: 'automatic' }],
                   ],
                   sourceType: 'unambiguous',
                   caller: { name: 'repack' },
@@ -80,6 +80,7 @@ function withESAD(env, options) {
             {
               test: /\.[cm]?[jt]sx?$/,
               include: [dirname],
+              exclude: [/node_modules/],
               type: 'javascript/auto',
               use: {
                 loader: 'babel-loader',

package/src/cli/commands/host.js

@@ -1,42 +0,0 @@
-const { runProcess } = require('../utils/process');
-const path = require('path');
-const fs = require('fs-extra');
-const { getWorkspaceConfig } = require('../utils/config');
-
-module.exports = async (subcommand) => {
-  let cwd = process.cwd();
-  let pkgPath = path.join(cwd, 'package.json');
-  
-  const configObj = getWorkspaceConfig();
-  if (configObj) {
-    const workspaceRoot = configObj.root;
-    const { projectName } = configObj.data;
-    const hostDir = path.join(workspaceRoot, `${projectName}-host`);
-    
-    if (fs.existsSync(hostDir)) {
-      cwd = hostDir;
-      pkgPath = path.join(cwd, 'package.json');
-    }
-  }
-
-  if (!fs.existsSync(pkgPath)) {
-    console.error(`❌ Error: Call this command from inside the Host App or the Workspace Root.`);
-    return;
-  }
-
-  // Handle direct platform commands
-  try {
-    if (subcommand === 'android') {
-      console.log(`🤖 Compiling and launching on Android...`);
-      await runProcess('react-native', ['run-android', '--no-packager'], cwd);
-    } else if (subcommand === 'ios') {
-      console.log(`🍎 Compiling and launching on iOS...`);
-      await runProcess('react-native', ['run-ios', '--no-packager'], cwd);
-    } else {
-      console.log(`\n💡 Tip: Use 'esad dev' for the interactive dev manager.`);
-      console.log(`   Or use 'esad host android' / 'esad host ios' for direct runs.`);
-    }
-  } catch (err) {
-    console.error(`❌ Error running host command: ${err.message}`);
-  }
-};