lumpiajs 1.0.4 → 1.0.6

package/README.md

@@ -1,13 +1,17 @@
 # 🥟 LumpiaJS
 
-**Framework Web MVC dengan Kearifan Lokal Semarangan.**  
-_Framework ini dibuat untuk seru-seruan (have fun), tapi diam-diam powerful seperti PHP Framework modern!_
+**Bahasa Pemrograman Web dengan Kearifan Lokal Semarangan.**  
+_Framework ini dibuat untuk seru-seruan (have fun) dan biar bikin web jadi lebih cepat dan menyenangkan!_ (Rencananya sih gitu... wkwkwk)
 
-## 🚀 Cara Mulai (Quick Start)
+## 🚀 Cara Pakai (Quick Start)
 
-### 1. Buat Project Baru
+Kamu bisa pilih cara yang paling enak buat mulai bikin (masak) web:
 
-Langsung gas pakai perintah ini:
+### 1. Langsung Gas (Tanpa Install)
+
+Kalau malas install-install, pastikan komputer kamu sudah ada Node.js, lalu langsung aja pakai `npx`:
+
+**Langkah 1: Buat Project**
 
 ```bash
 npx lumpiajs create-project warung-ku
@@ -15,116 +19,178 @@ npx lumpiajs create-project warung-ku
 
 _(Atau pakai istilah lokal: `npx lumpiajs buka-cabang warung-ku`)_
 
-### 2. Masuk & Install Bumbu
-
-Masuk ke foldernya dan install dependencies (wajib, biar kodingannya gurih):
+**Langkah 2: Masuk & Install Bumbu (Dependencies)**
+Penting! Kamu harus install dependencies biar `import` framework-nya jalan.
 
 ```bash
 cd warung-ku
 npm install
 ```
 
-### 3. Dodolan (Jalankan Server)
-
-Nyalakan server development:
+**Langkah 3: Nyalakan Kompor (Server)**
 
 ```bash
 npm start
 ```
 
-Atau pakai perintah manual: `npx lumpia dodolan`.  
+_(Atau manual: `npx lumpia dodolan`)_
 Websitemu bakal jalan di `http://localhost:3000`.
 
 ---
 
-## 🏗️ Struktur Project (MVL - Model View Logika)
+### 2. Install Global (Biar Bisa Dipakai Terus)
+
+Kalau kamu pengen perintah `lumpia` bisa dipanggil dari mana saja di terminal:
 
-LumpiaJS nggunake istilah sing luwih "Njawani" tapi tetep MVC:
+```bash
+# 1. Install dulu secara global
+npm install -g lumpiajs
+
+# 2. Bikin project baru
+lumpia create-project toko-lumpia
+
+# 3. Masuk folder & install npm
+cd toko-lumpia
+npm install
+
+# 4. Jalanin server
+lumpia dodolan
+```
+
+**Cara Update ke Versi Terbaru:**
+
+```bash
+npm install -g lumpiajs@latest
+```
+
+---
+
+## 🏗️ Struktur Project (Standar MVC)
+
+LumpiaJS sekarang menggunakan arsitektur **MVC (Model-View-Controller)** yang mengikuti standar internasional, jadi developer Laravel atau Express pasti langsung paham.
 
 ```
 warung-ku/
 ├── app/
-│   ├── logika/      # Logika Program (Controller)
-│   └── belakang/    # Data & Dapur (Model)
-├── jalur/
-│   └── web.js       # Rute URL (Routes)
-├── depan/           # Tampilan (View)
+│   ├── controllers/ # Otak Logika (Controller)
+│   └── models/      # Pengolah Data (Model)
+├── routes/
+│   └── web.js       # Rute URL
+├── views/           # Tampilan (.lmp)
 ├── package.json
 └── ...
 ```
 
-### 1. Jalur (Routes)
+### 1. Routes (`routes/web.js`)
 
-Atur URL di `jalur/web.js`:
+Tempat mengatur alamat URL web kamu.
 
 ```javascript
 import { Jalan } from "lumpiajs";
 
-// Nulis rute: Jalan.gawe(url, 'NamaLogika@method')
-Jalan.gawe("/", "BerandaLogika@index");
-Jalan.gawe("/api/produk", "ProdukLogika@index");
+// Jalan.gawe(url, 'NamaController@method')
+Jalan.gawe("/", "HomeController@index");
+Jalan.gawe("/api/products", "ProductController@index");
 ```
 
-### 2. Logika (Controller)
+### 2. Controllers (`app/controllers`)
 
-Bikin logika di `app/logika/BerandaLogika.js`.
-Class harus extend `Logika`.
+Otak dari aplikasimu. Class harus meng-extend `Controller`.
 
 ```javascript
-import { Logika } from "lumpiajs";
+import { Controller } from "lumpiajs";
 
-export default class BerandaLogika extends Logika {
+export default class HomeController extends Controller {
   index() {
-    // Tampilke file ning folder 'depan/beranda.lmp'
-    return this.tampil("beranda", {
-      pesan: "Sugeng Rawuh, Lur!",
+    // Tampilkan file di folder views/home.lmp
+    // Kirim data 'pesan' ke view
+    return this.tampil("home", {
+      pesan: "Halo Dunia!",
       tanggal: new Date().toLocaleDateString(),
     });
   }
 }
 ```
 
-### 3. Depan (View)
+### 3. Views (`views`)
 
-Bikin tampilan di `depan/beranda.lmp`.  
-Gunakan `{{ variabel }}` buat nampilin data.
+File `.lmp` adalah tempat kamu menulis HTML, CSS, dan JS Semarangan dalam satu file.
+Gunakan `{{ nama_variabel }}` untuk menampilkan data dari Controller.
 
 ```html
 <lump>
-  <klambi> h1 { color: red; } </klambi>
+  <klambi> /* CSS di sini */ h1 { color: #d35400; } </klambi>
 
   <kulit>
+    <!-- HTML di sini -->
     <h1>{{ pesan }}</h1>
-    <p>Saiki tanggal: {{ tanggal }}</p>
+    <p>Tanggal server: {{ tanggal }}</p>
   </kulit>
+
+  <isi>
+    // JavaScript Client-side (Bahasa Semarangan) gawe sapa() { alert("Halo,
+    Lur!"); }
+  </isi>
 </lump>
 ```
 
-### 4. Belakang (Model)
+### 4. Models (`app/models`)
 
-Simpen data utawa logika database ning `app/belakang/Produk.js`.
-Bisa nggunake `Model` ala Eloquent.
+Tempat mengolah data (Database/API). Mendukung gaya penulisan ala Eloquent.
 
 ```javascript
 import { Model } from "lumpiajs";
-// ... logika model ...
+
+// Contoh penggunaan di Controller:
+// Model.use(dataProduk).dimana('harga', '<', 5000).kabeh();
 ```
 
 ---
 
-## 🤝 Cara Lapor Masalah
+## 🧐 Kamus Bahasa (Transpiler)
+
+Khusus di dalam tag **`<isi>`** (pada file `.lmp`), kamu bisa menggunakan sintaks unik ini:
+
+- `ono` ➔ `let`
+- `paten` ➔ `const`
+- `gawe` ➔ `function`
+- `yen` ➔ `if`
+- `liyane` ➔ `else`
+- `mandek` ➔ `return`
+- `ora` ➔ `!`
+- `panjang()` ➔ `.length`
+
+---
+
+## 🤝 Cara Lapor Masalah atau Kasih Saran
+
+Baru nemu bug? Atau punya ide jenius biar LumpiaJS makin jos? Sampaikan saja!
 
-Nembe nemu bug? Atau punya ide jenius?
+Caranya gampang:
 
 1. Buka link ini: [https://github.com/fastroware/lumpiajs/issues](https://github.com/fastroware/lumpiajs/issues)
-2. Klik **"New Issue"**.
-3. Ceritakan keluh kesahmu.
+2. Klik tombol warna hijau bertuliskan **"New Issue"**.
+3. Isi Judul dengan jelas.
+4. Jelaskan masalah atau saranmu di kolom deskripsi.
+5. Klik **"Submit new issue"**.
+
+Selesai! Masukanmu akan saya baca pas lagi senggang.
 
 ---
 
-## ⚠️ DISCLAIMER
+## ⚠️ DISCLAIMER (PENTING BANGET, WAJIB DIBACA!) ⚠️
+
+**LumpiaJS ini 100% project _Have Fun_ & Eksperimen.**
 
-**LumpiaJS ini 100% project _Have Fun_.**
-Gunakan dengan bijak. Kalau ada error di production, jangan nyalahin kami ya! 🙏
+Kami **TIDAK BERTANGGUNG JAWAB** atas segala bentuk kerugian yang mungkin terjadi akibat penggunaan software ini, termasuk tapi tidak terbatas pada:
+
+- Kebocoran data.
+- Hilangnya file penting.
+- Komputer meledak (lebay, tapi tetap saja hati-hati).
+- Kerugian materiil maupun immateriil lainnya.
+
+Gunakan framework ini dengan resiko ditanggung sendiri (_Use at your own risk_). Kalau ada error di production karena nekat pakai ini, jangan nyalahin kami ya! 🙏
+
+---
 
 _Dibuat dengan ❤️ dan 🥟 dari Semarang._

package/index.js

@@ -1,4 +1,4 @@
 
 export { Jalan, routes } from './lib/core/Router.js';
 export { LumpiaModel as Model } from './lib/core/Model.js';
-export { Logika } from './lib/core/Controller.js'; // Export Logika instead of Kontroler
+export { Controller } from './lib/core/Controller.js'; 

package/lib/commands/create.js

@@ -4,101 +4,100 @@ import path from 'path';
 // --- TEMPLATES ---
 const routesTemplate = `import { Jalan } from 'lumpiajs';
 
-// Definisi Jalur (Routes)
-Jalan.gawe('/', 'BerandaLogika@index');
-Jalan.gawe('/profil', 'BerandaLogika@profil');
-Jalan.gawe('/api/produk', 'ProdukLogika@index');
+// Define Routes
+Jalan.gawe('/', 'HomeController@index');
+Jalan.gawe('/profile', 'HomeController@profile');
+Jalan.gawe('/api/products', 'ProductController@index');
 `;
 
-const controllerTemplate = `import { Logika, Model } from 'lumpiajs';
+const controllerTemplate = `import { Controller } from 'lumpiajs';
 
-export default class BerandaLogika extends Logika {
+export default class HomeController extends Controller {
     index() {
-        // Kirim data ke tampilan (view) ning folder 'depan'
-        return this.tampil('beranda', { 
-            pesan: 'Sugeng Rawuh di LumpiaJS!',
-            penulis: 'Pakdhe Koding'
+        // Render view in 'views' folder
+        return this.tampil('home', { 
+            message: 'Welcome to LumpiaJS MVC!',
+            author: 'Pakdhe Koding'
         });
     }
 
-    profil() {
-        return this.tampil('profil', { nama: 'User Setia' });
+    profile() {
+        return this.tampil('profile', { name: 'Loyal User' });
     }
 }
 `;
 
-const modelTemplate = `// Contoh dummy data 
-const dataProduk = [
-    { id: 1, jeneng: 'Lumpia Basah', rego: 5000 },
-    { id: 2, jeneng: 'Lumpia Goreng', rego: 6000 },
-    { id: 3, jeneng: 'Tahu Gimbal', rego: 12000 }
+const modelTemplate = `// Example dummy data
+const productData = [
+    { id: 1, name: 'Lumpia Basah', price: 5000 },
+    { id: 2, name: 'Lumpia Goreng', price: 6000 },
+    { id: 3, name: 'Tahu Gimbal', price: 12000 }
 ];
 
-export default dataProduk;
+export default productData;
 `;
 
-const produkControllerTemplate = `import { Logika, Model } from 'lumpiajs';
-import DataProduk from '../../belakang/Produk.js';
+const productControllerTemplate = `import { Controller, Model } from 'lumpiajs';
+import ProductData from '../../app/models/Product.js';
 
-export default class ProdukLogika extends Logika {
+export default class ProductController extends Controller {
     index() {
         // Eloquent-style: Model.use(data).dimana(...).jupuk()
-        const asil = Model.use(DataProduk)
-                        .dimana('rego', '>', 5500)
+        const result = Model.use(ProductData)
+                        .dimana('price', '>', 5500)
                         .jupuk();
 
         return this.json({
-            status: 'sukses',
-            data: asil
+            status: 'success',
+            data: result
         });
     }
 }
 `;
 
-const viewBerandaTemplate = `<lump>
+const viewHomeTemplate = `<lump>
   <klambi>
     h1 { color: #d35400; text-align: center; }
     .box { border: 1px solid #ddd; padding: 20px; text-align: center; margin-top: 20px; }
   </klambi>
 
   <kulit>
-    <h1>{{ pesan }}</h1>
+    <h1>{{ message }}</h1>
     <div class="box">
-        <p>Digawe karo tresno dening: <strong>{{ penulis }}</strong></p>
-        <button onclick="cekrego()">Cek Harga API</button>
+        <p>Created with love by: <strong>{{ author }}</strong></p>
+        <button onclick="checkPrice()">Check Price API</button>
         <br><br>
-        <a href="/profil">Menyang Profil</a>
+        <a href="/profile">Go to Profile</a>
     </div>
   </kulit>
 
   <isi>
-    gawe cekrego() {
-       fetch('/api/produk')
+    gawe checkPrice() {
+       fetch('/api/products')
          .then(res => res.json())
          .then(data => {
-            alert('Data seko API: ' + JSON.stringify(data));
+            alert('Data from API: ' + JSON.stringify(data));
          });
     }
   </isi>
 </lump>`;
 
-const viewProfilTemplate = `<lump>
+const viewProfileTemplate = `<lump>
   <kulit>
-    <h1>Profil Pengguna</h1>
-    <p>Halo, <strong>{{ nama }}</strong>!</p>
-    <a href="/">Bali Mulih</a>
+    <h1>User Profile</h1>
+    <p>Hello, <strong>{{ name }}</strong>!</p>
+    <a href="/">Back Home</a>
   </kulit>
 </lump>`;
 
 const packageJsonTemplate = (name) => `{
   "name": "${name}",
   "version": "1.0.0",
-  "main": "jalur/web.js",
+  "main": "routes/web.js",
   "type": "module",
   "scripts": {
     "start": "lumpia dodolan",
-    "serve": "lumpia dodolan",
-    "goreng": "lumpia goreng"
+    "serve": "lumpia dodolan"
   },
   "dependencies": {
     "lumpiajs": "latest"
@@ -107,42 +106,44 @@ const packageJsonTemplate = (name) => `{
 `;
 
 export function createProject(parameter) {
-    const namaProject = parameter;
-    if (!namaProject) {
-        console.log('❌ Eh, jeneng project-e opo?');
-        console.log('Contoh: lumpia create-project warung-baru');
+    const projectName = parameter;
+    if (!projectName) {
+        console.log('❌ Please specify project name.');
+        console.log('Example: lumpia create-project my-app');
         return;
     }
 
-    const root = path.join(process.cwd(), namaProject);
-    if (fs.existsSync(root)) return console.log(`❌ Folder ${namaProject} wis ono. Ganti jeneng liyo.`);
+    const root = path.join(process.cwd(), projectName);
+    if (fs.existsSync(root)) return console.log(`❌ Folder ${projectName} already exists.`);
 
-    console.log(`🔨 Mbangun pondasi warung MVC (Model-View-Logika) ing ${namaProject}...`);
+    console.log(`🔨 Building MVC foundation in ${projectName}...`);
     
     fs.mkdirSync(root);
-    // STRUCTURE UPDATE:
-    // app/logika (Controller)
-    // app/belakang (Model)
-    // depan (View)
     
-    fs.mkdirSync(path.join(root, 'app', 'logika'), { recursive: true });
-    fs.mkdirSync(path.join(root, 'app', 'belakang'), { recursive: true });
-    fs.mkdirSync(path.join(root, 'jalur'));
-    fs.mkdirSync(path.join(root, 'depan')); 
+    // STANDARD MVC STRUCTURE:
+    // app/controllers
+    // app/models
+    // views
+    // routes
+    
+    fs.mkdirSync(path.join(root, 'app', 'controllers'), { recursive: true });
+    fs.mkdirSync(path.join(root, 'app', 'models'), { recursive: true });
+    fs.mkdirSync(path.join(root, 'routes'));
+    fs.mkdirSync(path.join(root, 'views')); 
 
     // Write files
-    fs.writeFileSync(path.join(root, 'package.json'), packageJsonTemplate(namaProject));
-    fs.writeFileSync(path.join(root, 'jalur', 'web.js'), routesTemplate);
-    fs.writeFileSync(path.join(root, 'app', 'logika', 'BerandaLogika.js'), controllerTemplate);
-    fs.writeFileSync(path.join(root, 'app', 'logika', 'ProdukLogika.js'), produkControllerTemplate);
-    fs.writeFileSync(path.join(root, 'app', 'belakang', 'Produk.js'), modelTemplate);
-    fs.writeFileSync(path.join(root, 'depan', 'beranda.lmp'), viewBerandaTemplate);
-    fs.writeFileSync(path.join(root, 'depan', 'profil.lmp'), viewProfilTemplate);
-
-    console.log('✅ Warung siap! Struktur M-V-L wis ketata rapi.');
+    fs.writeFileSync(path.join(root, 'package.json'), packageJsonTemplate(projectName));
+    fs.writeFileSync(path.join(root, 'routes', 'web.js'), routesTemplate);
+    fs.writeFileSync(path.join(root, 'app', 'controllers', 'HomeController.js'), controllerTemplate);
+    fs.writeFileSync(path.join(root, 'app', 'controllers', 'ProductController.js'), productControllerTemplate);
+    fs.writeFileSync(path.join(root, 'app', 'models', 'Product.js'), modelTemplate);
+    fs.writeFileSync(path.join(root, 'views', 'home.lmp'), viewHomeTemplate);
+    fs.writeFileSync(path.join(root, 'views', 'profile.lmp'), viewProfileTemplate);
+
+    console.log('✅ Project ready! Standard MVC Structure.');
     console.log('----------------------------------------------------');
-    console.log(`cd ${namaProject}`);
-    console.log('npm install     <-- (Wajib ben lumpiajs ke-install)');
-    console.log('npm run serve   <-- (Kanggo dodolan/start server)');
+    console.log(`cd ${projectName}`);
+    console.log('npm install');
+    console.log('npm start');
     console.log('----------------------------------------------------');
 }

package/lib/commands/serve.js

@@ -6,18 +6,18 @@ import { renderLumpia } from '../core/View.js';
 
 export async function serveProject() {
     const root = process.cwd();
-    const routesFile = path.join(root, 'jalur', 'web.js');
+    const routesFile = path.join(root, 'routes', 'web.js');
 
-    if (!fs.existsSync(routesFile)) return console.log("❌ Iki dudu warung LumpiaJS MVC! (Ora nemu jalur/web.js)");
+    if (!fs.existsSync(routesFile)) return console.log("❌ This is not a LumpiaJS MVC project! (Cannot find routes/web.js)");
 
     console.log('🔄 Loading core framework...');
     
     try {
         // Load User Routes
-        const userRouteUrl =  path.join(root, 'jalur', 'web.js');
+        const userRouteUrl =  path.join(root, 'routes', 'web.js');
         await import('file://' + userRouteUrl);
 
-        console.log(`🛣️  Total jalur ditemu: ${routes.length}`);
+        console.log(`🛣️  Routes found: ${routes.length}`);
 
         // Start Server
         const server = http.createServer(async (req, res) => {
@@ -31,20 +31,20 @@ export async function serveProject() {
             
             if (match) {
                 try {
-                    // Action format: 'NamaLogika@method'
+                    // Action format: 'ControllerName@method'
                     const [controllerName, methodName] = match.action.split('@');
                     
-                    // Path ke folder 'app/logika'
-                    const controllerPath = path.join(root, 'app', 'logika', controllerName + '.js');
+                    // Path to 'app/controllers'
+                    const controllerPath = path.join(root, 'app', 'controllers', controllerName + '.js');
                     
-                    if (!fs.existsSync(controllerPath)) throw new Error(`Logika (Controller) ${controllerName} ora ketemu ning app/logika!`);
+                    if (!fs.existsSync(controllerPath)) throw new Error(`Controller ${controllerName} not found in app/controllers!`);
                     
                     const module = await import('file://' + controllerPath + '?update=' + Date.now()); 
                     const ControllerClass = module.default;
                     const instance = new ControllerClass();
                     
                     if (typeof instance[methodName] !== 'function') {
-                        throw new Error(`Method ${methodName} ora ono nang ${controllerName}`);
+                        throw new Error(`Method ${methodName} does not exist in ${controllerName}`);
                     }
 
                     const result = await instance[methodName](); 
@@ -62,21 +62,21 @@ export async function serveProject() {
                 } catch (e) {
                     console.error(e);
                     res.writeHead(500, {'Content-Type': 'text/html'});
-                    res.end(`<h1>500: Kompor Meleduk</h1><pre>${e.message}\n${e.stack}</pre>`);
+                    res.end(`<h1>500: Server Error</h1><pre>${e.message}\n${e.stack}</pre>`);
                 }
             } else {
                 res.writeHead(404, {'Content-Type': 'text/html'});
-                res.end('<h1>404: Dalane buntu, Mas.</h1>');
+                res.end('<h1>404: Not Found</h1>');
             }
         });
 
         const port = 3000;
         server.listen(port, () => {
-            console.log(`🚀 Warung buka ning http://localhost:${port}`);
-            console.log(`(Tekan Ctrl+C kanggo tutup warung)`);
+            console.log(`🚀 Server running at http://localhost:${port}`);
+            console.log(`(Press Ctrl+C to stop)`);
         });
 
     } catch (err) {
-        console.error('Fatal Error saat loading routes:', err);
+        console.error('Fatal Error loading routes:', err);
     }
 }

package/lib/core/Controller.js

@@ -2,15 +2,15 @@ import fs from 'fs';
 import path from 'path';
 import { renderLumpia } from './View.js';
 
-// 3. BASE LOGIKA (Controller)
-export class Logika {
+// 3. CONTROLLER BASE
+export class Controller {
     tampil(viewName, data = {}) {
-        // Cek lokasi view relative dari CWD user (folder 'depan')
-        const viewPath = path.join(process.cwd(), 'depan', `${viewName}.lmp`);
+        // Cek lokasi view relative dari CWD user (folder 'views')
+        const viewPath = path.join(process.cwd(), 'views', `${viewName}.lmp`);
         if (fs.existsSync(viewPath)) {
             return { type: 'html', content: renderLumpia(viewPath, data) };
         } else {
-            return { type: 'html', content: `<h1>404: Tampilan '${viewName}' ora ketemu ning folder 'depan', Lur.</h1>` };
+            return { type: 'html', content: `<h1>404: View '${viewName}' not found in 'views' folder.</h1>` };
         }
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumpiajs",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Bahasa Pemrograman Semarangan",
   "type": "module",
   "main": "index.js",