janofidel 1.0.0

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eyuel Getachew(EyuReaper)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,93 @@
+
+---
+ # ጃኖ ፊደል (Jano Fidel) ![ጃኖ ፊደል (Jano Fidel)](assets/favicon.ico)
+
+
+**A Native Amharic Programming Language built on Node.js.**
+
+ጃኖ ፊደል (Jano Fidel) is a high-level programming language that allows developers to write full-scale applications using the Ethiopic (Ge'ez) script. It transpiles directly to JavaScript, giving you the power of the Node.js ecosystem with a completely native writing experience.
+
+## ✨ ዋና ዋና ባህሪያት (Features)
+
+* **Native Keywords**: Use `ይሁን` (let), `ተግባር` (function), and `ከሆነ` (if) instead of English equivalents.
+* **Ethiopic Numerals**: Full support for Ge'ez numbers (፩, ፪, ፲፪...) with a built-in conversion engine.
+* **Amharic Built-ins**: Native aliases for common objects like `ሒሳብ` (Math), `ቀን` (Date), and `ያትም` (console.log).
+* **Asynchronous Support**: Full `ጊዜጠባቂ` (async) and `ጠብቅ` (await) support for modern development.
+* **CLI Tool**: Run your code globally with the `jano` command.
+
+---
+![ጃኖ ፊደል (Jano Fidel)](assets/logo.png)
+## 🚀 አጀማመር (Quick Start)
+
+### 1. Installation
+
+Clone the repository and link it to your global path:
+
+```bash
+cd JanoFidel
+npm install
+sudo npm link
+
+```
+
+### 2. Writing your first Jano file (`ሰላምታ.jf`)
+
+```javascript
+ተግባር ሰላምታ_ስጥ(ስም) {
+    መልስ "ሰላም " + ስም + " እንኳን ወደ ጃኖ ፊደል መጣህ!"፤
+}
+
+ያትም(ሰላምታ_ስጥ("ዮናስ"))፤
+
+// Math with Ge'ez numbers
+ይሁን ውጤት = ፲፪ + ፰፤
+ያትም("፲፪ + ፰ = " + ውጤት)፤
+
+```
+
+### 3. Running the code
+
+```bash
+jano ሰላምታ.jf
+
+```
+
+---
+
+## 📚 የቋንቋው መዝገበ-ቃላት (Dictionary Mapping)
+
+| Jano (ጃኖ) | JavaScript Equivalent |
+| --- | --- |
+| `ይሁን` | `let` / `var` |
+| `ቋሚ` | `const` |
+| `ተግባር` | `function` |
+| `መደብ` | `class` |
+| `ከሆነ` | `if` |
+| `ካልሆነ` | `else` |
+| `መልስ` | `return` |
+| `ያትም` | `console.log` |
+| `።` | `.` (Dot operator) |
+
+---
+
+## 🛠️ የቴክኒክ መዋቅር (Architecture)
+
+1. **Lexer**: Scans `.jf` files for Ethiopic characters and tokens.
+2. **Number Engine**: Converts additive Ethiopic numerals () into Arabic numerals for JavaScript.
+3. **Prelude**: A standard library injected at runtime to provide prototype aliases (e.g., adding `.ርዝመት` to Arrays).
+4. **Transpiler**: Maps the tokens to valid JavaScript and executes via the Node.js VM.
+
+---
+
+## 🤝 ማበረታቻ (Contributing)
+
+We welcome contributions! If you want to add more keywords to the `dictionary.js` or expand the `prelude.js` standard library, feel free to open a Pull Request.
+
+---
+
+## 📄 ፈቃድ (License)
+
+This project is licensed under the **MIT License**.
+
+---
+

package/bin/jano.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+const { processFile } = require('../src/engine'); // Assuming processFile handles reading + prelude
+const { runCode } = require('../src/runner');
+const path = require('path');
+
+// Branding
+const RED_BG = '\x1b[41m';
+const WHITE_TEXT = '\x1b[37m';
+const BOLD = '\x1b[1m';
+const RESET = '\x1b[0m';
+
+const logo = `${RED_BG}${WHITE_TEXT}${BOLD} ጃ ${RESET} ${RED_BG}${WHITE_TEXT}${BOLD} ፊ ${RESET}  ${BOLD}ጃኖ ፊደል (Jano Fidel)${RESET}\n`;
+
+const fileArg = process.argv[2];
+
+// 1. Show Help/Logo if no file provided
+if (!fileArg) {
+    console.log(logo);
+    console.log("አጠቃቀም: jano <ፋይል_ስም.jf>");
+    process.exit(1);
+}
+
+// 2. Resolve paths
+const filePath = path.resolve(process.cwd(), fileArg);
+
+if (!filePath.endsWith('.jf')) {
+    console.error("ስህተት: ፋይሉ በ '.jf' ማለቅ አለበት።");
+    process.exit(1);
+}
+
+// 3. The Execution Flow
+try {
+    // Note: Use your existing processFile which reads the code and adds the prelude
+    const jsCode = processFile(filePath); 
+    
+    // This calls your professional runner with the styled boxes
+    runCode(jsCode, filePath);
+
+} catch (err) {
+    // This catches high-level file reading errors
+    console.error(`\n[የጃኖ ስህተት]: ${err.message}`);
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "janofidel",
+  "version": "1.0.0",
+  "description": "Amharic Programming Language (Jano Fidel)",
+  "main": "src/engine.js",
+  "bin": {
+    "jano": "bin/jano.js"
+  },
+  "type": "commonjs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "scripts": {
+    "test": "mocha test/**/*.test.js"
+  },
+  "keywords": [
+    "amharic",
+    "ethiopia",
+    "ጃኖ",
+    "ፊደል",
+    "jano",
+    "fidel",
+    "language",
+    "compiler"
+  ],
+  "author": "EyuReaper",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EyuReaper/JanoFidel.git"
+  },
+  "bugs": {
+    "url": "https://github.com/EyuReaper/JanoFidel/issues"
+  },
+  "homepage": "https://github.com/EyuReaper/JanoFidel#readme",
+  "devDependencies": {
+    "mocha": "^11.7.5"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md",
+    "LICENSE.txt"
+  ]
+}

package/src/dictionary.js

@@ -0,0 +1,95 @@
+/**
+ * ጃኖ ፊደል (Jano Fidel) - Official Dictionary
+ * Mapping Amharic keywords to JavaScript equivalents.
+ * Optimized for DX (Developer Experience) and logical flow.
+ */
+
+const JANO_KEYWORDS = {
+  // --- Variables & Constants ---
+  'ተለዋጭ': 'var',      // Added: Traditional variable declaration
+  'ይሁን': 'let',        // Block-scoped variable
+  'ቋሚ': 'const',       // Constant
+  'ይህ': 'this',         // Current context reference
+
+  // --- Functions & Classes ---
+  'ተግባር': 'function',
+  'ግንባታ': 'constructor',
+  'መልስ': 'return',
+  'ተቀባይ' : 'resolve',
+  "መደብ": "class",
+  'አዲስ': 'new',
+  'ያራዝማል': 'extends',  // Updated: Logical for inheritance
+  'የበላይ': 'super',     // Updated: Logical for "the one above"
+  'አስገኝ': 'yield',      // Updated: Better DX for generators
+  'ቃልኪዳን': 'Promise',
+  'ቃልኪዳን': 'Promise',
+  "ክፍል": "module",         // Module
+    "ጠይቅ": "require",        // Require
+  // --- Logic & Flow Control ---
+  'ከሆነ': 'if',
+  'ካልሆነ': 'else',
+  'ምረጥ': 'switch',
+  'ሁኔታ': 'case',
+  'መደበኛ': 'default',
+  'ውጣ': 'break',
+  'ቀጥል': 'continue',
+
+  // --- Loops & Iteration ---
+  'ለእያንዳንዱ': 'for',
+  'እስከ': 'while',
+  'ውስጥ': 'in',
+  "የ": "of",
+
+  // --- Booleans & Types ---
+  'እውነት': 'true',
+  'ሀሰት': 'false',
+  'ባዶ': 'null',
+  'አይነት': 'typeof',
+  'ምሳሌ': 'instanceof',
+
+  // --- Exception Handling ---
+  'ሞክር': 'try',
+  'ያዝ': 'catch',
+  'በመጨረሻ': 'finally',
+
+  // --- Modules & Access Control (Strict/Future Use) ---
+  'የጋራ': 'public',     // Updated: Intuitive for shared access
+  'የግል': 'private',     // Hidden/Encapsulated
+  'የተጠበቀ': 'protected',
+  'ላክ': 'export',
+  'ውጤት': 'exports',
+  'አምጣ': 'import',
+  'ጠብቅ': 'await',
+  'መገናኛ': 'interface',
+  'ጥቅል': 'package',
+  'የማይንቀሳቀስ': 'static',
+  'ተከተል': 'enum',
+
+  // --- Punctuation & Operators ---
+  '።': '.',     // Updated: Now used as the Dot Operator
+  '፤': ';',     // Statement terminator
+  '፡': ':',     // Colon
+  '፦': ':',     // Preface colon
+  '፣': ',',     // Comma
+
+  // --- Math / ሒሳብ ---
+  'ሒሳብ': 'Math',
+  'ጣራ': 'ceil',
+  'ወለል': 'floor',
+  'ዘፈቀደ': 'random',
+  'ፍጹም': 'abs',
+  'ኃይል': 'pow',
+  'ሥር': 'sqrt',
+
+// --- Numbers ---
+  '፟': '0', '፩': '1', '፪': '2', '፫': '3', '፬': '4', '፭': '5',
+  '፮': '6', '፯': '7', '፰': '8', '፱': '9', '፲': '10', '፳': '20',
+  '፴': '30', '፵': '40', '፶': '50', '፷': '60', '፸': '70', '፹': '80', '፺': '90',
+  '፻': '100', '፼': '10000',  
+  // --- Built-in Utilities ---
+  'ያትም': 'console.log',
+  'ማንቂያ': 'alert',
+  'ጊዜጠባቂ': 'async'
+};
+
+module.exports = JANO_KEYWORDS;

package/src/engine.js

@@ -0,0 +1,75 @@
+const JANO_KEYWORDS = require('./dictionary');
+const { JANO_PRELUDE } = require('./prelude');
+const fs = require('fs');
+
+/**
+ * ጃኖ ፊደል (Jano Fidel) Transpiler Engine
+ */
+function transpile(inputCode) {
+    // This regex identifies words, strings, and Ethiopic symbols
+    const regex = /("[^"]*"|'[^']*'|`[^`]*`|\/\/[^\n]*|[።፤፡፦፣]|[ሀ-፟፩-፿]+|[a-zA-Z0-9_]+|[^\s])/g;
+    
+    return inputCode.replace(regex, (token) => {
+        if (token.startsWith('"') || token.startsWith("'") || token.startsWith("//")) {
+            return token;
+        }
+
+        // Check if the token is an Ethiopic Number (e.g., ፲፪)
+        if (/^[፩-፿]+$/.test(token)) {
+            return convertEthiopicToArabic(token);
+        }
+
+        return JANO_KEYWORDS[token] || token;
+    });
+}
+
+// Simple helper to turn Ethiopic numerals into JavaScript numbers
+function convertEthiopicToArabic(eth) {
+    const valueMap = {
+        '፩':1, '፪':2, '፫':3, '፬':4, '፭':5, '፮':6, '፯':7, '፰':8, '፱':9,
+        '፲':10, '፳':20, '፴':30, '፵':40, '፶':50, '፷':60, '፸':70, '፹':80, '፺':90,
+        '፟':0 // Zero, or acts as a separator
+    };
+    const multiplierMap = {
+        '፻': 100,
+        '፼': 10000
+    };
+
+    let total = 0;
+    let currentBlockValue = 0; // Stores the value of the current digit/tens before a multiplier
+
+    for (let i = 0; i < eth.length; i++) {
+        const char = eth[i];
+
+        if (multiplierMap[char]) {
+            // If it's a multiplier (፻ or ፼)
+            if (currentBlockValue === 0 && char === '፻') { // Handle cases like just '፻' meaning 100
+                 currentBlockValue = 1;
+            } else if (currentBlockValue === 0 && char === '፼') { // Handle cases like just '፼' meaning 10000
+                currentBlockValue = 1;
+            }
+
+            total += currentBlockValue * multiplierMap[char];
+            currentBlockValue = 0; // Reset for the next block of numbers
+        } else if (valueMap[char] !== undefined) {
+            // If it's a digit or ten
+            currentBlockValue += valueMap[char];
+        } else {
+            // Unknown character or invalid numeral sequence
+            // For robustness, returning NaN or throwing an error is better
+            return NaN; 
+        }
+    }
+    // Add any remaining units/tens that weren't followed by a multiplier
+    total += currentBlockValue;
+    return total.toString();
+}
+function processFile(filePath) {
+    const content = fs.readFileSync(filePath, 'utf8');
+    const transpiled = transpile(content);
+    // Combine the prelude (built-ins) with the user's code
+return `(function(){\n${JANO_PRELUDE}\n${transpiled}\n})();`;}
+
+
+
+module.exports = { transpile, processFile, JANO_PRELUDE, convertEthiopicToArabic };

package/src/hook.js

@@ -0,0 +1,17 @@
+const fs = require('fs');
+const { transpile, JANO_PRELUDE } = require('./engine');
+
+// WARNING: require.extensions is a deprecated API.
+// This usage is temporary and needs to be replaced with a more robust module
+// loading strategy (e.g., Node.js Loader Hooks for ESM or pre-transpilation)
+// in future versions to ensure long-term compatibility and stability with Node.js.
+// Tell Node.js to handle .jf files
+require.extensions['.jf'] = function (module, filename) {
+    const content = fs.readFileSync(filename, 'utf8');
+    const transpiled = transpile(content);
+    
+    // Inject prelude so the required file also has access to 'ያትም' etc.
+    const finalCode = `${JANO_PRELUDE}\n${transpiled}`;
+    
+    module._compile(finalCode, filename);
+};

package/src/prelude.js

@@ -0,0 +1,45 @@
+/**
+ * ጃኖ ፊደል (Jano Fidel) - Prelude (Standard Library)
+ */
+
+// 1. Node.js safe aliases (only things that exist in Node)
+const ሒሳብ = Math;
+const ጃነማ = JSON;
+const ቀን = Date;
+const ቃልኪዳን = Promise;
+const ያትም = console.log;
+
+// 2. Export the template for the transpiler
+// We put 'ማንቂያ' inside the string so it doesn't crash the Node.js process
+const JANO_PRELUDE = `
+    const ሒሳብ = Math;
+    const ጃነማ = JSON;
+    const ቀን = Date;
+    const ቃልኪዳን = Promise;
+    const ያትም = console.log;
+    const ማንቂያ = (typeof alert !== 'undefined') ? alert : console.log;
+    
+    // Global function aliases
+    const ቆይ = setTimeout;
+
+    // Safety Check for Prototypes
+    if (!Array.prototype.hasOwnProperty('ርዝመት')) {
+        Object.defineProperty(Array.prototype, 'ርዝመት', { 
+            get: function() { return this.length; },
+            configurable: true 
+        });
+    }
+    
+    if (!String.prototype.hasOwnProperty('ርዝመት')) {
+        Object.defineProperty(String.prototype, 'ርዝመት', { 
+            get: function() { return this.length; },
+            configurable: true 
+        });
+    }
+
+    if (!Date.prototype.ወደ_ጽሑፍ) {
+        Date.prototype.ወደ_ጽሑፍ = Date.prototype.toDateString;
+    }
+`;
+
+module.exports = { JANO_PRELUDE };

package/src/runner.js

@@ -0,0 +1,81 @@
+const { spawn } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const hookPath = require.resolve('./hook');
+
+// --- 1. Helpers (Top of the file) ---
+
+const style = {
+    red: (t) => `\x1b[31m${t}\x1b[0m`,
+    yellow: (t) => `\x1b[33m${t}\x1b[0m`,
+    bold: (t) => `\x1b[1m${t}\x1b[0m`,
+    reset: '\x1b[0m'
+};
+
+function getExitSummary(code) {
+    if (code === 1) return "ያልተጠበቀ ስህተት አጋጥሟል (Uncaught Error)";
+    if (code === 130) return "ተጠቃሚው ፕሮግራሙን አቋርጦታል (User Interrupted)";
+    return `ፕሮግራሙ በስህተት ተዘግቷል (Exit Code: ${code})`;
+}
+
+function remapStack(data, tempFilePath, originalFileName) {
+    const output = data.toString();
+    const escapedPath = tempFilePath.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const regex = new RegExp(escapedPath, 'g');
+    return output.replace(regex, originalFileName);
+}
+
+// --- 2. Main Execution Function ---
+
+function runCode(jsCode, originalFilePath) {
+    const fileName = path.basename(originalFilePath);
+    const dirName = path.dirname(path.resolve(originalFilePath));
+    const tempFile = path.join(dirName, `.${path.basename(originalFilePath, '.jf')}.tmp.js`);
+    
+    try {
+        fs.writeFileSync(tempFile, jsCode, 'utf8');
+
+        // Preload the hook to handle imports
+        const hookPath = require.resolve('./hook');
+        const child = spawn('node', ['-r', hookPath, tempFile], { 
+            stdio: ['inherit', 'inherit', 'pipe'], 
+            cwd: process.cwd() 
+        });
+
+        child.stderr.on('data', (data) => {
+            const remappedError = remapStack(data, tempFile, fileName);
+            process.stderr.write(remappedError);
+        });
+
+        // --- THE BOX UI LOGIC  HERE ---
+        child.on('close', (code) => {
+            if (fs.existsSync(tempFile)) {
+                try { fs.unlinkSync(tempFile); } catch(e) {}
+            }
+            
+            if (code !== 0 && code !== null) {
+                const summary = getExitSummary(code);
+                const border = style.red("┃");
+                
+                console.error(`\n` + style.red("┏" + "━".repeat(60) + "┓"));
+                console.error(`${border}  ${style.bold(style.red("⚠️  የጃኖ ማጠቃለያ (Jano Summary)"))}`.padEnd(74) + border);
+                console.error(style.red("┣" + "━".repeat(60) + "┫"));
+                console.error(`${border}  ${style.bold("ሁኔታ፦")} ${summary}`.padEnd(68) + border);
+                console.error(`${border}  ${style.bold("ፋይል፦")} ${fileName}`.padEnd(68) + border);
+                console.error(`${border}${' '.repeat(60)}${border}`);
+                console.error(`${border}  🔍 ${style.bold("ፍንጭ፦")} የመስመር ቁጥሩን በ ${style.bold(fileName)} ውስጥ ይዩ።`.padEnd(72) + border);
+                console.error(style.red("┗" + "━".repeat(60) + "┛") + `\n`);
+            }
+        });
+
+        process.on('SIGINT', () => {
+            if (fs.existsSync(tempFile)) fs.unlinkSync(tempFile);
+            process.exit();
+        });
+
+    } catch (err) {
+        console.error(`\n[የፋይል ስህተት]: ጊዜያዊ ፋይል መፍጠር አልተቻለም፦ ${err.message}`);
+    }
+}
+
+module.exports = { runCode };