cajyu 1.0.1 → 1.1.0

package/README.md

@@ -15,7 +15,8 @@ Cajyu gives you a simpler, more expressive syntax while staying fully compatible
 - Clean syntax for variables, functions, classes, loops and conditionals
 - Transpiles to modern JavaScript
 - Real HTTP server with POST handlers, sleep/wake
-- Official libraries: `serial`, `fs`, `math`, `http`, `websocket`
+- WebSocket that automatically sends and receives JSON
+- Official libraries: `serial`, `fs`, `math`, `http`, `websocket`, `string`, `json`, `exec`, `fetch`
 - Optional runtime typing
 - Async with `sync fn` and `wait`
 - One-liners and stacking
@@ -121,16 +122,24 @@ server.post(fn b {
 })
 ```
 
-### WebSocket
+### WebSocket (JSON)
 ```cajyu
 import WS from CajyuLibs.websocket
 
 var wss = new WS.Server(8080)
-wss.on("connection", fn client {
-  print("client connected")
-})
 wss.on("message", fn msg, client {
-  wss.broadcast(msg)
+  wss.broadcast({ echo: msg })
+})
+```
+
+### Exec & Fetch
+```cajyu
+import exec from CajyuLibs.exec
+var files = exec.exec("ls -a")
+
+import fetch from CajyuLibs.fetch
+fetch.fetch("https://api.github.com", {}, null, fn result, ms {
+  print(result)
 })
 ```
 
@@ -146,6 +155,10 @@ cajyu inst fs
 cajyu inst math
 cajyu inst http
 cajyu inst websocket
+cajyu inst string
+cajyu inst json
+cajyu inst exec
+cajyu inst fetch
 ```
 
 ---

package/examples/comparison/README.md

@@ -0,0 +1,51 @@
+# Comparison: JavaScript vs TypeScript vs Cajyu
+
+Three identical features implemented in three languages.
+
+## 1. Simple HTML Server
+
+| Language   | File                              | Lines (approx) | Notes |
+|------------|-----------------------------------|----------------|-------|
+| JavaScript | `js/simple-server.js`            | 18             | Direct `http` module |
+| TypeScript | `ts/simple-server.ts`            | 18             | Same + types |
+| Cajyu      | `cajyu/simple-server.cjy`        | 10             | Uses `CajyuLibs.http` |
+
+**Cajyu is the shortest.** The HTTP library abstracts the boilerplate.
+
+## 2. Click Counter
+
+| Language   | File                              | Lines (approx) | Notes |
+|------------|-----------------------------------|----------------|-------|
+| JavaScript | `js/click-counter.js`            | 35             | Manual route + inline HTML/JS |
+| TypeScript | `ts/click-counter.ts`            | 35             | Same + types |
+| Cajyu      | `cajyu/click-counter.cjy`        | 16             | `server.post` + `server.file` |
+
+Again, Cajyu is more concise because of the built-in server abstraction.
+
+## 3. Live Chat (WebSocket)
+
+| Language   | File                              | Lines (approx) | Notes |
+|------------|-----------------------------------|----------------|-------|
+| JavaScript | `js/live-chat.js`                | 45             | Uses `ws` package + full HTML |
+| TypeScript | `ts/live-chat.ts`                | 45             | Same + types |
+| Cajyu      | `cajyu/live-chat.cjy`            | 12             | Uses `CajyuLibs.websocket` (broadcast only) |
+
+Cajyu version is shorter but currently only shows the WebSocket server side.
+
+## Summary
+
+| Aspect              | JavaScript      | TypeScript       | Cajyu                  |
+|---------------------|-----------------|------------------|------------------------|
+| Boilerplate         | Medium          | Medium           | Low                    |
+| Type safety         | None            | Strong           | Optional runtime       |
+| Learning curve      | Low             | Medium           | Low (if you know JS)   |
+| Ecosystem           | Huge            | Huge             | Small (growing)        |
+| Abstraction level   | Low-medium      | Low-medium       | Higher                 |
+| Best for            | Production      | Large projects   | Prototyping / learning |
+
+**Conclusion:**
+- **JavaScript** is the baseline.
+- **TypeScript** adds safety with almost no extra cost.
+- **Cajyu** reduces boilerplate the most, especially for servers, but is still a prototype language.
+
+All examples are in `examples/comparison/`.

package/examples/comparison/cajyu/click-counter.cjy

@@ -0,0 +1,17 @@
+import Server from CajyuLibs.http
+import print from CajyuLibs.serial
+
+var clicks = 0
+var server = new Server(3001)
+print("Cajyu click server at http://localhost:3001")
+
+var html = "<!DOCTYPE html><html><body><h1>Click Counter (Cajyu)</h1><button id='btn'>Click me</button><p>Total clicks: <span id='count'>0</span></p><script>const btn=document.getElementById('btn');const count=document.getElementById('count');btn.onclick=async()=>{const r=await fetch('/click',{method:'POST'});const data=await r.json();count.textContent=data.clicks;};</script></body></html>"
+
+server.file("/", html)
+server.file("index.html", html)
+
+server.post(fn b {
+  clicks = clicks + 1
+  print("Click #" + clicks)
+  return { code: 200, clicks: clicks }
+})

package/examples/comparison/cajyu/live-chat.cjy

@@ -0,0 +1,16 @@
+import WS from CajyuLibs.websocket
+import print from CajyuLibs.serial
+
+var wss = new WS.Server(3002)
+print("Cajyu live chat WebSocket on port 3002")
+
+wss.on("connection", fn client {
+  print("Client connected")
+})
+
+wss.on("message", fn msg, client {
+  print("Message: " + msg)
+  wss.broadcast(msg)
+})
+
+print("Open a WebSocket client to ws://localhost:3002 to chat")

package/examples/comparison/cajyu/simple-server.cjy

@@ -0,0 +1,10 @@
+import Server from CajyuLibs.http
+import print from CajyuLibs.serial
+
+var server = new Server(3000)
+print("Cajyu simple server running at http://localhost:3000")
+
+var html = "<!DOCTYPE html><html><head><title>Simple Server</title></head><body><h1>Hello from Cajyu!</h1><p>This is a simple text served by a Cajyu server.</p></body></html>"
+
+server.file("/", html)
+server.file("index.html", html)

package/examples/comparison/js/simple-server.js

@@ -0,0 +1,20 @@
+// Simple HTML server - JavaScript
+import http from 'http';
+
+const server = http.createServer((req, res) => {
+  res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+  res.end(`
+    <!DOCTYPE html>
+    <html>
+      <head><title>Simple Server</title></head>
+      <body>
+        <h1>Hello from JavaScript!</h1>
+        <p>This is a simple text served by a Node.js server.</p>
+      </body>
+    </html>
+  `);
+});
+
+server.listen(3000, () => {
+  console.log('JS server running at http://localhost:3000');
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cajyu",
-  "version": "1.0.01",
+  "version": "1.1.0",
   "description": "Cajyu programming language - a custom language that compiles to JavaScript",
   "main": "src/compiler.js",
   "bin": {

package/src/compiler.js

@@ -2,23 +2,64 @@ import fs from 'fs';
 import path from 'path';
 import { pathToFileURL } from 'url';
 
+// Error codes
+const ERRORS = {
+  ERR001: 'Syntax error',
+  ERR002: 'Unexpected token',
+  ERR003: 'Missing closing brace',
+  ERR004: 'Type mismatch',
+  ERR005: 'Undefined variable',
+  ERR006: 'Invalid function call',
+  ERR007: 'Missing parentheses',
+  ERR008: 'Invalid import',
+  ERR009: 'Unexpected end of file',
+  ERR010: 'Invalid operator',
+  ERR011: 'Missing semicolon or block',
+  ERR012: 'Invalid type annotation',
+  ERR013: 'Keyword used as identifier',
+  ERR014: 'Unterminated string',
+  ERR015: 'Invalid number',
+  ERR016: 'Duplicate declaration',
+  ERR017: 'Missing return value',
+  ERR018: 'Invalid class member',
+  ERR019: 'Async error',
+  ERR020: 'Library not found'
+};
+
+class CajyuError extends Error {
+  constructor(code, line, column, lineContent, message) {
+    const errName = ERRORS[code] || 'Unknown error';
+    const pointer = ' '.repeat(Math.max(0, column)) + '^';
+    super(`There is an ${errName.toLowerCase()} in line ${line}: ${code}.\n    ${lineContent.trim()}\n   ${pointer}`);
+    this.code = code;
+    this.line = line;
+    this.column = column;
+  }
+}
+
 export async function compileAndRun(filePath) {
   if (!fs.existsSync(filePath)) {
-    console.error(`Arquivo não encontrado: ${filePath}`);
+    console.error(`File not found: ${filePath}`);
     process.exit(1);
   }
   const source = fs.readFileSync(filePath, 'utf-8');
-  const jsCode = transpile(source, path.dirname(filePath));
-  const tempFile = path.join('/tmp', `cajyu_${Date.now()}.mjs`);
-  fs.writeFileSync(tempFile, jsCode);
   try {
-    await import(pathToFileURL(tempFile).href);
-    console.log('--- Execução Cajyu ---');
+    const jsCode = transpile(source, path.dirname(filePath));
+    const tempFile = path.join('/tmp', `cajyu_${Date.now()}.mjs`);
+    fs.writeFileSync(tempFile, jsCode);
+    try {
+      await import(pathToFileURL(tempFile).href);
+      console.log('--- Cajyu execution ---');
+    } finally {
+      try { fs.unlinkSync(tempFile); } catch {}
+    }
   } catch (err) {
-    console.error('Erro na execução:', err.message);
-    console.error(err.stack);
-  } finally {
-    try { fs.unlinkSync(tempFile); } catch {}
+    if (err instanceof CajyuError) {
+      console.error(err.message);
+    } else {
+      console.error('Runtime error:', err.message);
+    }
+    process.exit(1);
   }
 }
 
@@ -26,13 +67,21 @@ function transpile(source, baseDir) {
   const lines = source.split('\n');
   const imports = [];
   const codeLines = [];
-  for (const line of lines) {
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
     const m = line.match(/^\s*import\s+(\*|\w+)\s+from\s+['"]?([^\s'"]+)['"]?\s*;?\s*$/);
-    if (m) imports.push({ what: m[1], from: m[2] });
-    else codeLines.push(line);
+    if (m) {
+      imports.push({ what: m[1], from: m[2], line: i + 1 });
+    } else {
+      codeLines.push(line);
+    }
   }
+
   let code = codeLines.join('\n');
 
+  code = preprocessWithErrors(code, lines);
+
   let importCode = '';
   for (const imp of imports) {
     const libPath = resolveLib(imp.from, baseDir);
@@ -43,10 +92,11 @@ function transpile(source, baseDir) {
       } else {
         importCode += `const { CayjuLib: _lib${imp.what} } = await import('${url}'); const ${imp.what} = _lib${imp.what}.${imp.what} || _lib${imp.what};\n`;
       }
+    } else {
+      throw new CajyuError('ERR020', imp.line, 0, lines[imp.line - 1] || '', `Library not found: ${imp.from}`);
     }
   }
 
-  code = preprocessKeywords(code);
   code = transpileFunctions(code);
   code = transpileAnonymousFunctions(code);
   code = transpileControlFlow(code);
@@ -63,24 +113,95 @@ function _range(a, b, c) {
 function _typeCheck(val, type) {
   if (!type) return val;
   const t = String(type).toLowerCase();
-  if (t === 'string' && typeof val !== 'string') throw new Error('esperado String');
-  if ((t === 'number' || t === 'int' || t === 'float') && typeof val !== 'number') throw new Error('esperado Number');
-  if (t === 'boolean' && typeof val !== 'boolean') throw new Error('esperado Boolean');
-  if (t === 'array' && !Array.isArray(val)) throw new Error('esperado Array');
+  if (t === 'string' && typeof val !== 'string') throw new Error('ERR004: expected String');
+  if ((t === 'number' || t === 'int' || t === 'float') && typeof val !== 'number') throw new Error('ERR004: expected Number');
+  if (t === 'boolean' && typeof val !== 'boolean') throw new Error('ERR004: expected Boolean');
+  if (t === 'array' && !Array.isArray(val)) throw new Error('ERR004: expected Array');
+  if (t === 'object' && (typeof val !== 'object' || val === null)) throw new Error('ERR004: expected Object');
   return val;
 }
 `;
 
-  const final = `
+  return `
 ${importCode}
 ${builtins}
 (async () => {
 ${code}
-})().catch(console.error);
+})().catch(e => { console.error(e.message); process.exit(1); });
 `;
+}
+
+function preprocessWithErrors(code, originalLines) {
+  const result = [];
+  const lines = code.split('\n');
+
+  for (let i = 0; i < lines.length; i++) {
+    let line = lines[i];
+    let newLine = '';
+    let inString = false;
+    let stringChar = '';
 
-  fs.writeFileSync('/tmp/cajyu_debug.mjs', final);
-  return final;
+    for (let j = 0; j < line.length; j++) {
+      const ch = line[j];
+
+      if (!inString && (ch === '"' || ch === "'")) {
+        inString = true;
+        stringChar = ch;
+        newLine += ch;
+        continue;
+      }
+      if (inString && ch === stringChar && line[j - 1] !== '\\') {
+        inString = false;
+        newLine += ch;
+        continue;
+      }
+      if (inString) {
+        newLine += ch;
+        continue;
+      }
+
+      if (line.substr(j, 3) === 'and' && isWordBoundary(line, j, 3)) {
+        newLine += '&&';
+        j += 2;
+        continue;
+      }
+      if (line.substr(j, 2) === 'or' && isWordBoundary(line, j, 2)) {
+        newLine += '||';
+        j += 1;
+        continue;
+      }
+      if (line.substr(j, 3) === 'not' && isWordBoundary(line, j, 3)) {
+        newLine += '!';
+        j += 2;
+        continue;
+      }
+
+      newLine += ch;
+    }
+
+    if (inString) {
+      throw new CajyuError('ERR014', i + 1, line.length, line, 'Unterminated string');
+    }
+
+    newLine = newLine
+      .replace(/sync\s+fn\s+(\w+)/g, 'async function $1')
+      .replace(/\bwait\s+/g, 'await ')
+      .replace(/\belif\b/g, 'else if')
+      .replace(/\bSelf\./g, 'this.')
+      .replace(/\brange\(/g, '_range(')
+      .replace(/var\s+(\w+):(\w+)\s*=\s*(.+)/g, 'let $1 = _typeCheck($3, "$2")')
+      .replace(/var\s+(\w+)\s*=/g, 'let $1 =');
+
+    result.push(newLine);
+  }
+
+  return result.join('\n');
+}
+
+function isWordBoundary(line, index, len) {
+  const before = index === 0 || !/\w/.test(line[index - 1]);
+  const after = index + len >= line.length || !/\w/.test(line[index + len]);
+  return before && after;
 }
 
 function resolveLib(from, baseDir) {
@@ -100,21 +221,6 @@ function cleanParams(s) {
   return (s || '').trim().split(',').map(p => p.trim().split(':')[0].trim()).filter(Boolean).join(', ');
 }
 
-function preprocessKeywords(code) {
-  return code
-    .replace(/\band\b/g, '&&')
-    .replace(/\bor\b/g, '||')
-    .replace(/\bnot\b/g, '!')
-    .replace(/sync\s+fn\s+(\w+)/g, 'async function $1')
-    .replace(/\bwait\s+/g, 'await ')
-    .replace(/\belif\b/g, 'else if')
-    .replace(/\bSelf\./g, 'this.')
-    .replace(/\brange\(/g, '_range(')
-    .replace(/\/\/\s*private\s+(\w+)/g, '/* private $1 */')
-    .replace(/var\s+(\w+):(\w+)\s*=\s*(.+)/g, 'let $1 = _typeCheck($3, "$2")')
-    .replace(/var\s+(\w+)\s*=/g, 'let $1 =');
-}
-
 function transpileFunctions(code) {
   return code
     .replace(/^fn\s+(\w+)\s+([^{]*)\{/gm, (_, n, p) => `function ${n}(${cleanParams(p)}) {`)
@@ -145,5 +251,7 @@ function transpileControlFlow(code) {
 function transpileOneLiners(code) {
   return code
     .replace(/return\s+(\{[^}]*\}|.+?)\s+if\s+([^;]+);/g, 'if ($2) return $1;')
-    .replace(/if\s+([^:{;\n]+)\s+return\s+([^;\n{]+)/g, 'if ($1) return $2;');
+    .replace(/if\s+([^:{;\n]+)\s+return\s+([^;\n{]+)/g, 'if ($1) return $2;')
+    .replace(/while\s+([^:{;\n]+)\s+([^;\n{]+);?/g, 'while ($1) { $2; }')
+    .replace(/for\s+(\w+)\s+in\s+([^ {\n;]+)\s+([^;\n{]+);?/g, 'for (let $1 of $2) { $3; }');
 }