english-lang 0.1.0

package/README.md

@@ -0,0 +1,119 @@
+# English (.eng)
+
+> **Write what you mean. Build what you know.**
+
+A programming language where you write plain English that compiles directly to React Native — shipping real iOS and Android apps with zero JSX, zero hooks, and zero accidental complexity.
+
+---
+
+## Install
+
+```bash
+npm install -g english-lang
+```
+
+---
+
+## Usage
+
+```bash
+# Compile a single file
+engc screens/HomeScreen.eng
+
+# Compile a single file to a specific output directory
+engc screens/HomeScreen.eng --out rn/src/
+
+# Compile all .eng files in a directory
+engc compile screens/ --out rn/src/
+
+# Watch a directory and recompile on every save
+engc watch screens/ --out rn/src/
+```
+
+---
+
+## Example
+
+Write this in `screens/HomeScreen.eng`:
+
+```
+screen HomeScreen:
+    title is "Hello World"
+
+    state:
+        message is "Hello!"
+        count is 0
+
+    when screen opens:
+        set count to 1
+
+    when "Say Hello" is pressed:
+        set message to "Hello from English!"
+
+    layout:
+        vertical stack spacing 16 padding 16:
+            show message as heading
+            show count
+            button "Say Hello"
+```
+
+Run `engc screens/HomeScreen.eng --out rn/src/` and get this:
+
+```tsx
+export function HomeScreen({ navigation }: any) {
+  const [message, setMessage] = useState<string>("Hello!");
+  const [count, setCount] = useState<number>(0);
+
+  useEffect(() => {
+    setCount(1);
+  }, []);
+
+  const handleSayHello = () => {
+    setMessage("Hello from English!");
+  };
+
+  return (
+    <View style={styles.container}>
+      <View style={{ flexDirection: 'column', gap: 16, padding: 16 }}>
+        <Text style={styles.heading}>{message}</Text>
+        <Text style={styles.body}>{count}</Text>
+        <TouchableOpacity style={styles.button} onPress={handleSayHello}>
+          <Text style={styles.buttonText}>Say Hello</Text>
+        </TouchableOpacity>
+      </View>
+    </View>
+  );
+}
+```
+
+---
+
+## Project structure
+
+```
+my-app/
+  ├── package.json          ← devDependency: english-lang
+  ├── screens/              ← write your .eng files here
+  │   ├── HomeScreen.eng
+  │   └── ProductScreen.eng
+  └── rn/                   ← react native project
+      ├── src/              ← compiled .tsx files go here
+      ├── ios/
+      └── android/
+```
+
+---
+
+## Programmatic use
+
+```ts
+import { compile } from 'english-lang';
+
+const tsx = compile(engSource, 'HomeScreen.eng');
+```
+
+---
+
+## License
+
+MIT

package/dist/cli/engc.js

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+"use strict";
+// ============================================================
+// engc — English (.eng) compiler CLI
+//
+// Usage:
+//   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
+//   engc <file.eng> --print              print generated code to stdout
+//   engc compile <dir> --out <dir>       compile all .eng files in a dir
+//   engc watch   <dir> --out <dir>       watch dir, recompile on save
+// ============================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const index_1 = require("../index");
+// ── Helpers ───────────────────────────────────────────────────
+function compileFile(inputPath, outDir) {
+    const source = fs.readFileSync(inputPath, 'utf8');
+    const sourceFile = path.basename(inputPath);
+    let tsx;
+    try {
+        tsx = (0, index_1.compile)(source, sourceFile);
+    }
+    catch (err) {
+        console.error(`[engc] Parse error in ${sourceFile}:\n  ${err.message}\n`);
+        return;
+    }
+    const outputPath = outDir
+        ? path.join(outDir, sourceFile.replace(/\.eng$/, '.tsx'))
+        : inputPath.replace(/\.eng$/, '.tsx');
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    fs.writeFileSync(outputPath, tsx, 'utf8');
+    const relIn = path.relative(process.cwd(), inputPath);
+    const relOut = path.relative(process.cwd(), outputPath);
+    console.log(`[engc] ${relIn}  →  ${relOut}`);
+}
+function compileDir(srcDir, outDir) {
+    const engFiles = fs.readdirSync(srcDir).filter(f => f.endsWith('.eng'));
+    if (engFiles.length === 0) {
+        console.log(`[engc] No .eng files found in ${srcDir}`);
+        return;
+    }
+    for (const file of engFiles) {
+        compileFile(path.join(srcDir, file), outDir);
+    }
+}
+function watchDir(srcDir, outDir) {
+    // Run once on start
+    compileDir(srcDir, outDir);
+    console.log(`[engc] Watching ${srcDir} ...`);
+    fs.watch(srcDir, { recursive: false }, (event, filename) => {
+        if (!filename || !filename.endsWith('.eng'))
+            return;
+        const filePath = path.join(srcDir, filename);
+        if (!fs.existsSync(filePath))
+            return;
+        compileFile(filePath, outDir);
+    });
+}
+// ── CLI entry point ───────────────────────────────────────────
+function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+        console.log(`
+English Compiler (engc)
+
+Usage:
+  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
+  engc <file.eng> --print              print generated code, no file written
+  engc <file.eng> --tokens             dump token stream (debug)
+  engc <file.eng> --ast                dump parsed AST (debug)
+  engc compile <dir> [--out <dir>]     compile all .eng files in a directory
+  engc watch   <dir> [--out <dir>]     watch directory, recompile on save
+
+Examples:
+  engc screens/HomeScreen.eng
+  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>
+    if (args[0] === 'compile' || args[0] === 'watch') {
+        const cmd = args[0];
+        const srcDir = args[1] ? path.resolve(args[1]) : process.cwd();
+        const outIdx = args.indexOf('--out');
+        const outDir = outIdx !== -1 ? path.resolve(args[outIdx + 1]) : undefined;
+        if (!fs.existsSync(srcDir)) {
+            console.error(`[engc] Directory not found: ${srcDir}`);
+            process.exit(1);
+        }
+        if (cmd === 'compile') {
+            compileDir(srcDir, outDir);
+        }
+        else {
+            watchDir(srcDir, outDir);
+        }
+        return;
+    }
+    // Single file mode
+    const inputArg = args[0];
+    const printOnly = args.includes('--print');
+    const dumpTokens = args.includes('--tokens');
+    const dumpAST = args.includes('--ast');
+    const outDirIdx = args.indexOf('--out');
+    const outDir = outDirIdx !== -1 ? args[outDirIdx + 1] : undefined;
+    const outputIdx = args.indexOf('-o');
+    const explicitOutput = outputIdx !== -1 ? args[outputIdx + 1] : null;
+    const inputPath = path.resolve(inputArg);
+    if (!fs.existsSync(inputPath)) {
+        console.error(`[engc] File not found: ${inputPath}`);
+        process.exit(1);
+    }
+    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');
+        const tokens = new Lexer(source).tokenize();
+        if (dumpTokens) {
+            console.log('── Token stream ──────────────────────────────────────');
+            for (const tok of tokens) {
+                const val = tok.value ? ` "${tok.value}"` : '';
+                console.log(`  ${String(tok.line).padStart(3)}:${String(tok.col).padStart(3)}  ${tok.type.padEnd(14)}${val}`);
+            }
+            console.log('');
+        }
+        if (dumpAST) {
+            const program = new Parser(tokens).parse();
+            console.log('── AST ───────────────────────────────────────────────');
+            console.log(JSON.stringify(program, null, 2));
+            console.log('');
+        }
+        return;
+    }
+    let tsx;
+    try {
+        tsx = (0, index_1.compile)(source, sourceFile);
+    }
+    catch (err) {
+        console.error(`\n[engc] Parse error:\n  ${err.message}\n`);
+        process.exit(1);
+    }
+    if (printOnly) {
+        console.log(tsx);
+        return;
+    }
+    const outputPath = explicitOutput
+        ? path.resolve(explicitOutput)
+        : outDir
+            ? path.join(path.resolve(outDir), sourceFile.replace(/\.eng$/, '.tsx'))
+            : inputPath.replace(/\.eng$/, '.tsx');
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    fs.writeFileSync(outputPath, tsx, 'utf8');
+    const relIn = path.relative(process.cwd(), inputPath);
+    const relOut = path.relative(process.cwd(), outputPath);
+    console.log(`[engc] ${relIn}  →  ${relOut}`);
+}
+main();

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+// english-lang — public API
+// Import this if you want to use the compiler programmatically.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReactNativeBackend = exports.Parser = exports.Lexer = void 0;
+exports.compile = compile;
+var Lexer_1 = require("./src/lexer/Lexer");
+Object.defineProperty(exports, "Lexer", { enumerable: true, get: function () { return Lexer_1.Lexer; } });
+var Parser_1 = require("./src/parser/Parser");
+Object.defineProperty(exports, "Parser", { enumerable: true, get: function () { return Parser_1.Parser; } });
+var ReactNativeBackend_1 = require("./src/codegen/ReactNativeBackend");
+Object.defineProperty(exports, "ReactNativeBackend", { enumerable: true, get: function () { return ReactNativeBackend_1.ReactNativeBackend; } });
+const Lexer_2 = require("./src/lexer/Lexer");
+const Parser_2 = require("./src/parser/Parser");
+const ReactNativeBackend_2 = require("./src/codegen/ReactNativeBackend");
+function compile(source, sourceFile) {
+    const tokens = new Lexer_2.Lexer(source).tokenize();
+    const program = new Parser_2.Parser(tokens).parse();
+    return new ReactNativeBackend_2.ReactNativeBackend().emit(program, sourceFile);
+}

package/dist/src/ast/ASTNodes.js

@@ -0,0 +1,6 @@
+"use strict";
+// ============================================================
+// ASTNodes.ts — All node type definitions for the English compiler
+// Every node carries a `kind` discriminant for exhaustive switch.
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });