cajyu 1.2.0 → 1.2.1

package/ErrTable.md

@@ -0,0 +1,54 @@
+# Cajyu Error Table
+
+Complete list of all error codes in Cajyu (ERR001 – ERR040).
+
+| Code   | Name                          | Description |
+|--------|-------------------------------|-------------|
+| ERR001 | Syntax error                  | General syntax error in the source code |
+| ERR002 | Unexpected token              | The parser encountered a token it did not expect |
+| ERR003 | Missing closing brace         | A `{` was opened but never closed with `}` |
+| ERR004 | Type mismatch                 | A value does not match the declared type |
+| ERR005 | Undefined variable            | A variable was used before being declared |
+| ERR006 | Invalid function call         | Attempted to call something that is not a function |
+| ERR007 | Missing parentheses           | Expected `(` or `)` but it was missing |
+| ERR008 | Invalid import                | The import statement is malformed |
+| ERR009 | Unexpected end of file        | The file ended while the parser still expected more code |
+| ERR010 | Invalid operator              | An operator was used in an invalid context |
+| ERR011 | Missing semicolon or block    | Expected `;` or a `{ ... }` block |
+| ERR012 | Invalid type annotation       | The type after `:` is not recognized |
+| ERR013 | Keyword used as identifier    | A reserved keyword was used as a variable or function name |
+| ERR014 | Unterminated string           | A string was opened with `"` or `'` but never closed |
+| ERR015 | Invalid number                | A numeric literal is malformed |
+| ERR016 | Duplicate declaration         | A variable or function was declared more than once in the same scope |
+| ERR017 | Missing return value          | A function declared to return a value did not return anything |
+| ERR018 | Invalid class member          | A class contains an invalid member |
+| ERR019 | Async error                   | Error related to `sync` / `wait` |
+| ERR020 | Library not found             | The requested library does not exist in CajyuLibs |
+| ERR021 | Division by zero              | Attempted to divide by zero |
+| ERR022 | Index out of range            | Array or string index is outside valid bounds |
+| ERR023 | Invalid argument count        | A function was called with the wrong number of arguments |
+| ERR024 | Cannot call non-function      | Tried to call a value that is not callable |
+| ERR025 | Missing property              | Tried to access a property that does not exist |
+| ERR026 | Circular import               | An import cycle was detected |
+| ERR027 | Invalid range                 | `range()` received invalid arguments |
+| ERR028 | File not found                | A file operation targeted a non-existent file |
+| ERR029 | Permission denied             | The process does not have permission to access a resource |
+| ERR030 | Network error                 | A network request failed |
+| ERR031 | JSON parse error              | Failed to parse a JSON string |
+| ERR032 | Timeout                       | An operation took too long and timed out |
+| ERR033 | Invalid assignment            | Tried to assign to something that cannot be assigned |
+| ERR034 | Break outside loop            | `break` was used outside of a loop |
+| ERR035 | Continue outside loop         | `continue` was used outside of a loop |
+| ERR036 | Invalid class inheritance     | Class inheritance is malformed |
+| ERR037 | Abstract method not implemented | An abstract method was not implemented |
+| ERR038 | Stack overflow                | The call stack exceeded its limit |
+| ERR039 | Memory limit exceeded         | The program used too much memory |
+| ERR040 | Unknown builtin               | Called a builtin function that does not exist |
+
+All errors follow the format:
+
+```
+There is an <error name> in line <n>: ERR0xx.
+    <line content>
+   ^
+```

package/README.md

@@ -10,7 +10,7 @@ Cajyu gives you a simpler, more expressive syntax while staying fully compatible
 
 [![npm](https://img.shields.io/badge/npm-cajyu-blue)](https://www.npmjs.com/package/cajyu)
 [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
-[![Version](https://img.shields.io/badge/version-1.1.0-brightgreen)](package.json)
+[![Version](https://img.shields.io/badge/version-1.2.1-brightgreen)](package.json)
 
 ---
 

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.2.0",
+  "version": "1.2.1",
   "description": "Cajyu programming language - a custom language that compiles to JavaScript",
   "main": "src/compiler.js",
   "bin": {

package/src/compiler-ast-note.md

@@ -1,16 +0,0 @@
-# AST Migration in progress
-
-The compiler now has a real Tokenizer + recursive descent Parser that builds an AST.
-
-Current status:
-- Tokenizer handles strings, numbers, identifiers, keywords correctly
-- Parser builds AST for var, fn, if/elif/else, while, for, class, return, expressions
-- Code generator emits JavaScript from the AST
-
-Still being completed:
-- Full import resolution
-- Builtins (range, typeCheck)
-- Async (sync/wait)
-- One-liners and more edge cases
-
-This is the foundation for a robust parser.