english-lang 0.1.0 → 0.2.0

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
@@ -96,10 +96,27 @@ my-app/
   ├── screens/              ← write your .eng files here
   │   ├── HomeScreen.eng
   │   └── ProductScreen.eng
-  └── rn/                   ← react native project
-      ├── src/              ← compiled .tsx files go here
+  └── rn/                   ← react native project (npx react-native init rn)
+      ├── src/              ← engc compiles .tsx here automatically
+      │   ├── HomeScreen.tsx
+      │   └── ProductScreen.tsx
       ├── ios/
-      └── android/
+      ├── android/
+      └── package.json
+```
+
+**Quick start:**
+
+```bash
+# One command sets everything up
+engc init my-app
+cd my-app
+
+# Watch .eng files and compile to rn/src/ on every save
+npm run watch
+
+# 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,90 @@ 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"
+`;
+// ── 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: {
+            '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 watch          ← recompiles .eng files on save
+  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 +163,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 +182,7 @@ function main() {
 English Compiler (engc)
 
 Usage:
+  engc init <name>                     scaffold a new project
   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 +193,24 @@ Usage:
   engc watch   <dir> [--out <dir>]     watch directory, recompile on save
 
 Examples:
-  engc screens/HomeScreen.eng
+  engc init my-app
   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 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 +244,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.0",
+  "version": "0.2.0",
   "description": "The English (.eng) programming language compiler",
   "main": "./dist/index.js",
   "bin": {
@@ -10,8 +10,8 @@
     "dist"
   ],
   "scripts": {
-    "build":   "tsc",
-    "dev":     "tsc --watch",
+    "build": "tsc",
+    "dev": "tsc --watch",
     "prepare": "tsc"
   },
   "devDependencies": {