english-lang 0.1.1 → 0.2.1

package/README.md

@@ -17,10 +17,10 @@ npm install -g english-lang
 ## Usage
 
 ```bash
-# Compile a single file
-engc screens/HomeScreen.eng
+# Scaffold a new project (React Native app + screens/ folder)
+engc init my-app
 
-# Compile a single file to a specific output directory
+# Compile a single file
 engc screens/HomeScreen.eng --out rn/src/
 
 # Compile all .eng files in a directory
@@ -108,22 +108,14 @@ my-app/
 **Quick start:**
 
 ```bash
-# 1. Create your project
-mkdir my-app && cd my-app
-npm init -y
-npm install --save-dev english-lang
-
-# 2. Create the React Native app
-npx @react-native-community/cli init rn
+# One command sets everything up
+engc init my-app
+cd my-app
 
-# 3. Create your screens folder
-mkdir screens
-
-# 4. Write .eng files in screens/
-# 5. Watch and compile
-engc watch screens/ --out rn/src/
+# Watch .eng files and compile to rn/src/ on every save
+npm run watch
 
-# 6. In a separate terminal, run the app
+# In a separate terminal, run the app
 cd rn && npx react-native run-ios
 ```
 

package/dist/cli/engc.js

@@ -4,6 +4,7 @@
 // engc — English (.eng) compiler CLI
 //
 // Usage:
+//   engc init <name>                     scaffold a new project
 //   engc <file.eng>                      compile → .tsx alongside source
 //   engc <file.eng> --out <dir>          compile → specific output dir
 //   engc <file.eng> -o <output.tsx>      compile → specific output file
@@ -47,8 +48,127 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const childProcess = __importStar(require("child_process"));
 const index_1 = require("../index");
-// ── Helpers ───────────────────────────────────────────────────
+// ── Starter .eng file ─────────────────────────────────────────
+const STARTER_ENG = `\
+screen HomeScreen:
+    title is "Home"
+
+    state:
+        message is "Hello from English!"
+        count is 0
+
+    when screen opens:
+        set count to 1
+
+    when "Say Hello" is pressed:
+        set message to "Hello!"
+
+    when "Reset" is pressed:
+        set message to "Hello from English!"
+        set count to 0
+
+    layout:
+        vertical stack spacing 16 padding 16:
+            show "Welcome" as heading
+            show message as body
+            show count
+            button "Say Hello"
+            button "Reset"
+`;
+// ── Dev ───────────────────────────────────────────────────────
+function devProject(projectDir) {
+    const screensDir = path.join(projectDir, 'screens');
+    const rnDir = path.join(projectDir, 'rn');
+    const rnSrcDir = path.join(rnDir, 'src');
+    if (!fs.existsSync(screensDir) || !fs.existsSync(rnDir)) {
+        console.error('[engc] Not an english-lang project. Run engc init <name> first.');
+        process.exit(1);
+    }
+    console.log('[engc] Starting dev mode ...\n');
+    // Spawn Metro bundler
+    const metro = childProcess.spawn('npx', ['react-native', 'start'], {
+        cwd: rnDir,
+        stdio: 'inherit',
+        shell: true,
+    });
+    metro.on('error', (err) => {
+        console.error('[engc] Metro error:', err.message);
+    });
+    // Watch .eng files
+    compileDir(screensDir, rnSrcDir);
+    console.log(`[engc] Watching screens/ ...\n`);
+    fs.watch(screensDir, { recursive: false }, (event, filename) => {
+        if (!filename || !filename.endsWith('.eng'))
+            return;
+        const filePath = path.join(screensDir, filename);
+        if (!fs.existsSync(filePath))
+            return;
+        compileFile(filePath, rnSrcDir);
+    });
+    // Keep alive — exit both on Ctrl+C
+    process.on('SIGINT', () => {
+        metro.kill();
+        process.exit(0);
+    });
+}
+// ── Init ──────────────────────────────────────────────────────
+function initProject(name) {
+    const projectDir = path.resolve(name);
+    if (fs.existsSync(projectDir)) {
+        console.error(`[engc] Directory already exists: ${projectDir}`);
+        process.exit(1);
+    }
+    console.log(`[engc] Creating project ${name} ...`);
+    // Create folder structure
+    const screensDir = path.join(projectDir, 'screens');
+    const rnSrcDir = path.join(projectDir, 'rn', 'src');
+    fs.mkdirSync(screensDir, { recursive: true });
+    fs.mkdirSync(rnSrcDir, { recursive: true });
+    // Write starter .eng file
+    fs.writeFileSync(path.join(screensDir, 'HomeScreen.eng'), STARTER_ENG, 'utf8');
+    console.log('[engc] Created screens/HomeScreen.eng');
+    // Write root package.json
+    const pkg = {
+        name,
+        version: '0.0.1',
+        private: true,
+        scripts: {
+            'dev': 'engc dev',
+            'compile': 'engc compile screens/ --out rn/src/',
+            'watch': 'engc watch screens/ --out rn/src/',
+        },
+        devDependencies: {
+            'english-lang': 'latest',
+        },
+    };
+    fs.writeFileSync(path.join(projectDir, 'package.json'), JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+    console.log('[engc] Created package.json');
+    // Scaffold React Native app inside rn/
+    console.log('[engc] Scaffolding React Native app in rn/ (this takes a minute) ...');
+    try {
+        childProcess.execSync('npx @react-native-community/cli init rn --skip-install', { cwd: projectDir, stdio: 'inherit' });
+    }
+    catch {
+        console.error('[engc] Failed to scaffold React Native app. Make sure Node and npx are available.');
+        process.exit(1);
+    }
+    // Install rn dependencies
+    console.log('[engc] Installing React Native dependencies ...');
+    childProcess.execSync('npm install', { cwd: path.join(projectDir, 'rn'), stdio: 'inherit' });
+    // Compile the starter screen
+    console.log('[engc] Compiling starter screens ...');
+    compileDir(screensDir, rnSrcDir);
+    console.log(`
+[engc] Done! Your project is ready.
+
+  cd ${name}
+  npm run dev            ← starts Metro + watches .eng files
+  cd rn && npx react-native run-ios
+  `);
+}
+// ── Compile helpers ───────────────────────────────────────────
 function compileFile(inputPath, outDir) {
     const source = fs.readFileSync(inputPath, 'utf8');
     const sourceFile = path.basename(inputPath);
@@ -80,7 +200,6 @@ function compileDir(srcDir, outDir) {
     }
 }
 function watchDir(srcDir, outDir) {
-    // Run once on start
     compileDir(srcDir, outDir);
     console.log(`[engc] Watching ${srcDir} ...`);
     fs.watch(srcDir, { recursive: false }, (event, filename) => {
@@ -100,6 +219,8 @@ function main() {
 English Compiler (engc)
 
 Usage:
+  engc init <name>                     scaffold a new project
+  engc dev                             start Metro + watch .eng files
   engc <file.eng>                      compile → .tsx alongside source
   engc <file.eng> --out <dir>          compile → specific output directory
   engc <file.eng> -o <output.tsx>      compile → specific output file
@@ -110,14 +231,30 @@ Usage:
   engc watch   <dir> [--out <dir>]     watch directory, recompile on save
 
 Examples:
-  engc screens/HomeScreen.eng
+  engc init my-app
+  engc dev
   engc screens/HomeScreen.eng --out rn/src/
   engc compile screens/ --out rn/src/
   engc watch   screens/ --out rn/src/
     `.trim());
         process.exit(0);
     }
-    // Sub-commands: compile <dir> | watch <dir>
+    // engc dev
+    if (args[0] === 'dev') {
+        devProject(process.cwd());
+        return;
+    }
+    // engc init <name>
+    if (args[0] === 'init') {
+        const name = args[1];
+        if (!name) {
+            console.error('[engc] Usage: engc init <project-name>');
+            process.exit(1);
+        }
+        initProject(name);
+        return;
+    }
+    // engc compile <dir> | engc watch <dir>
     if (args[0] === 'compile' || args[0] === 'watch') {
         const cmd = args[0];
         const srcDir = args[1] ? path.resolve(args[1]) : process.cwd();
@@ -151,7 +288,6 @@ Examples:
     }
     const source = fs.readFileSync(inputPath, 'utf8');
     const sourceFile = path.basename(inputPath);
-    // Debug modes — need raw Lexer/Parser
     if (dumpTokens || dumpAST) {
         const { Lexer } = require('../src/lexer/Lexer');
         const { Parser } = require('../src/parser/Parser');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "english-lang",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "The English (.eng) programming language compiler",
   "main": "./dist/index.js",
   "bin": {