rip-lang 2.9.2 → 3.0.0

package/CHANGELOG.md

@@ -7,6 +7,49 @@ All notable changes to Rip will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.0.0] - 2026-02-07
+
+### Complete Rewrite
+
+Rip 3.0 is a ground-up rewrite of the entire compiler pipeline. Every component is new:
+
+- **Lexer + Rewriter** (`src/lexer.js`) — 1,542 LOC, down from 3,260
+- **Compiler + Codegen** (`src/compiler.js`) — 3,148 LOC, down from 6,016
+- **Grammar** (`src/grammar/grammar.rip`) — 887 LOC, updated for new syntax
+- **Parser** (`src/parser.js`) — 352 LOC, regenerated from new grammar
+- **REPL** (`src/repl.js`) — 654 LOC, rewritten for the new pipeline
+- **Browser** (`src/browser.js`) — 79 LOC, rewritten for the new pipeline
+- **CLI** (`bin/rip`) — 267 LOC, updated to use the new pipeline
+- **Total**: ~7,700 LOC (down from ~10,100)
+
+### Language Changes
+
+#### Removed
+- Postfix spread/rest (`x...`) — use prefix `...x` (ES6)
+- Prototype access (`x::y`, `x?::y`) — use `.prototype` or class syntax
+- Soak call sugar (`fn?(arg)`) — use `fn?.(arg)` (ES6 optional call)
+- Soak index sugar (`arr?[i]`) — use `arr?.[i]` (ES6 optional index)
+- `is not` contraction — use `isnt`
+
+#### Added
+- JS-style ternary operator: `x ? a : b`
+- `for...as` iteration: `for x as iterable` (replaces `for x from iterable`)
+- `as!` async shorthand: `for x as! iterable` (shorthand for `for await x as iterable`)
+
+#### Kept
+- Existence check: `x?` compiles to `(x != null)`
+- All reactive operators: `:=`, `~=`, `~>`, `=!`
+- Dammit operator: `x!` compiles to `await x()`
+- Optional chaining: `?.`, `?.[]`, `?.()` (ES6 dot-form only)
+- Nullish coalescing: `??`
+- All other CoffeeScript-compatible syntax
+
+### Tests
+- 1,048 tests passing (100%)
+- 25 test files across all language features
+
+---
+
 ## [2.9.0] - 2026-02-05
 
 ### Compiler Fix
@@ -220,8 +263,8 @@ Counter.new().mount("#app")               # Selector string support
 ### 📚 Documentation Overhaul
 
 **Consolidated Documentation** - 13 files merged into 4 main docs:
-- `docs/GUIDE.md` - Language features, reactivity, templates, components
-- `docs/INTERNALS.md` - Compiler architecture, S-expressions, Solar
+- `docs/RIP-LANG.md` - Language reference
+- `docs/RIP-INTERNALS.md` - Compiler architecture, S-expressions, Solar
 - `docs/PHILOSOPHY.md` - Design principles, CoffeeScript comparison
 - `docs/BROWSER.md` - Browser usage, REPL, deployment
 

package/README.md

@@ -9,15 +9,15 @@
 </p>
 
 <p align="center">
-  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-2.9.0-blue.svg" alt="Version"></a>
+  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-3.0.0-blue.svg" alt="Version"></a>
   <a href="#zero-dependencies"><img src="https://img.shields.io/badge/dependencies-ZERO-brightgreen.svg" alt="Dependencies"></a>
-  <a href="#"><img src="https://img.shields.io/badge/tests-1115%2F1115-brightgreen.svg" alt="Tests"></a>
+  <a href="#"><img src="https://img.shields.io/badge/tests-1048%2F1048-brightgreen.svg" alt="Tests"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License"></a>
 </p>
 
 ---
 
-Rip is a modern language inspired by CoffeeScript. It compiles to **ES2022** (classes, `?.`, `??`, modules), adds about a **dozen new operators**, includes **built-in reactivity**, and sports a self-hosting compiler with **zero dependencies** — all in about 10,000 lines of code.
+Rip is a modern language inspired by CoffeeScript. It compiles to **ES2022** (classes, `?.`, `??`, modules), adds about a **dozen new operators**, includes **built-in reactivity**, and sports a self-hosting compiler with **zero dependencies** — all in about 7,700 lines of code.
 
 > **No imports. No hooks. No dependency arrays. Just write code.**
 
@@ -28,6 +28,10 @@ squares = (x * x for x in [1..10])  # List comprehension
 
 str =~ /Hello, (\w+)/               # Regex match
 log "Found: #{_[1]}"                # Captures in _[1], _[2], etc.
+
+get '/users/:id' ->                 # RESTful API endpoint, comma-less
+  name = read 'name', 'string!'     # Required string
+  age  = read 'age' , [0, 105]      # Simple numeric validation
 ```
 
 ---
@@ -103,6 +107,22 @@ user?.profile?.name            # Optional chaining
 data = fetchData!              # Await shorthand
 ```
 
+### Iteration
+
+```coffee
+for item in [1, 2, 3]         # Array iteration (for-in)
+  console.log item
+
+for key, value of object       # Object iteration (for-of)
+  console.log "#{key}: #{value}"
+
+for x as iterable              # ES6 for-of on any iterable
+  console.log x
+
+for x as! asyncIterable        # Async iteration shorthand
+  console.log x                # Equivalent to: for await x as asyncIterable
+```
+
 ### Reactivity
 
 State, computed values, and effects as language operators:
@@ -117,32 +137,25 @@ State, computed values, and effects as language operators:
 
 ---
 
-## New Operators
+## Operators
 
 | Operator | Example | What it does |
 |----------|---------|--------------|
 | `!` (dammit) | `fetchData!` | Calls AND awaits |
 | `!` (void) | `def process!` | Suppresses implicit return |
 | `!?` (otherwise) | `val !? 5` | Default only if `undefined` |
+| `?` (existence) | `x?` | True if `x != null` |
 | `?:` (ternary) | `x > 0 ? 'yes' : 'no'` | JS-style ternary expression |
-| `?.` `?[]` | `a?.b` `a?[0]` | Optional chaining (both styles) |
-| `...` (spread) | `[...rest, last]` | Spread at start or end (JS: end only) |
-| `//` | `7 // 2` | Floor division → 3 |
-| `%%` | `-1 %% 3` | True modulo → 2 |
+| `?.` `?.[]` `?.()` | `a?.b` `a?.[0]` `a?.()` | Optional chaining (ES6) |
+| `??` | `a ?? b` | Nullish coalescing |
+| `...` (spread) | `[...items, last]` | Prefix spread (ES6) |
+| `//` | `7 // 2` | Floor division |
+| `%%` | `-1 %% 3` | True modulo |
 | `=~` | `str =~ /Hello, (\w+)/` | Match (captures in `_`) |
 | `[//, n]` | `str[/Hello, (\w+)/, 1]` | Extract capture n |
 | `.new()` | `Dog.new()` | Ruby-style constructor |
 | `or return` | `x = get() or return err` | Guard clause (Ruby-style) |
-| `?? throw` | `x = get() ?? throw err` | Nullish guard (null/undefined only) |
-
-**Optional chaining** — Both CoffeeScript and ES6 styles are supported:
-
-| Syntax | Style | Compiles to |
-|--------|-------|-------------|
-| `obj?[0]` | CoffeeScript | `(obj != null ? obj[0] : undefined)` |
-| `fn?(arg)` | CoffeeScript | `(typeof fn === 'function' ? fn(arg) : undefined)` |
-| `obj?.[0]` | ES6/JS | `obj?.[0]` |
-| `fn?.(arg)` | ES6/JS | `fn?.(arg)` |
+| `?? throw` | `x = get() ?? throw err` | Nullish guard |
 
 ### Heredoc & Heregex
 
@@ -154,7 +167,7 @@ html = '''
       <p>Hello</p>
     </div>
     '''
-# Closing ''' is at column 4 (same as content) → no leading whitespace
+# Closing ''' at column 4 (same as content) — no leading whitespace
 # Result: "<div>\n  <p>Hello</p>\n</div>"
 
 html = '''
@@ -162,21 +175,10 @@ html = '''
       <p>Hello</p>
     </div>
   '''
-# Closing ''' is at column 2 (2 less than content) → 2 spaces of leading whitespace
+# Closing ''' at column 2 — 2 spaces of leading whitespace preserved
 # Result: "  <div>\n    <p>Hello</p>\n  </div>"
 ```
 
-Use `"""` for interpolation, `'''` for literal strings. The same margin rule applies to both:
-
-```coffee
-name = "World"
-msg = """
-  Hello, #{name}!
-  Welcome to Rip.
-  """
-# Result: "Hello, World!\nWelcome to Rip."
-```
-
 **Heregex** — Extended regex with comments and whitespace:
 
 ```coffee
@@ -208,9 +210,9 @@ Rip's reactivity is framework-agnostic — use it with React, Vue, Svelte, or va
 | **Reactivity** | None | Built-in |
 | **Dependencies** | Multiple | Zero |
 | **Self-hosting** | No | Yes |
-| **Lexer** | 3,558 LOC | 3,250 LOC |
-| **Compiler** | 10,346 LOC | 5,878 LOC |
-| **Total** | 17,760 LOC | ~10,100 LOC |
+| **Lexer** | 3,558 LOC | 1,542 LOC |
+| **Compiler** | 10,346 LOC | 3,148 LOC |
+| **Total** | 17,760 LOC | ~7,700 LOC |
 
 Smaller codebase, modern output, built-in reactivity.
 
@@ -218,7 +220,7 @@ Smaller codebase, modern output, built-in reactivity.
 
 ## Browser
 
-Run Rip directly in the browser (51KB compressed):
+Run Rip directly in the browser:
 
 ```html
 <script src="https://shreeve.github.io/rip-lang/docs/dist/rip.browser.min.js"></script>
@@ -236,12 +238,23 @@ Run Rip directly in the browser (51KB compressed):
 ## Architecture
 
 ```
-Source → Lexer → Parser → S-Expressions → Codegen → JavaScript
-                          ["=", "x", 42]
+Source  ->  Lexer  ->  Parser  ->  S-Expressions  ->  Codegen  ->  JavaScript
+           (1,542)    (352)       ["=", "x", 42]     (3,148)
 ```
 
 Simple arrays instead of AST node classes. The compiler is self-hosting — `bun run parser` rebuilds from source.
 
+| Component | File | Lines |
+|-----------|------|-------|
+| Lexer + Rewriter | `src/lexer.js` | 1,542 |
+| Compiler + Codegen | `src/compiler.js` | 3,148 |
+| Parser (generated) | `src/parser.js` | 352 |
+| Grammar | `src/grammar/grammar.rip` | 887 |
+| Parser Generator | `src/grammar/solar.rip` | 1,001 |
+| REPL | `src/repl.js` | 654 |
+| Browser Entry | `src/browser.js` | 79 |
+| **Total** | | **7,663** |
+
 ---
 
 ## The Rip Stack
@@ -290,7 +303,7 @@ rip file.rip           # Run
 rip -c file.rip        # Compile
 rip -t file.rip        # Tokens
 rip -s file.rip        # S-expressions
-bun run test           # 1115 tests
+bun run test           # 1048 tests
 bun run parser         # Rebuild parser
 bun run browser        # Build browser bundle
 ```
@@ -301,9 +314,9 @@ bun run browser        # Build browser bundle
 
 | Guide | Description |
 |-------|-------------|
-| [docs/GUIDE.md](docs/GUIDE.md) | Language guide |
-| [docs/REACTIVITY.md](docs/REACTIVITY.md) | Reactivity deep dive |
-| [docs/INTERNALS.md](docs/INTERNALS.md) | Compiler architecture |
+| [docs/RIP-LANG.md](docs/RIP-LANG.md) | Language reference |
+| [docs/RIP-REACTIVITY.md](docs/RIP-REACTIVITY.md) | Reactivity deep dive |
+| [docs/RIP-INTERNALS.md](docs/RIP-INTERNALS.md) | Compiler internals |
 | [packages/](packages/README.md) | Full-stack packages |
 | [CONTRIBUTING.md](CONTRIBUTING.md) | How to contribute |
 
@@ -323,7 +336,7 @@ Everything included: compiler, parser generator, REPL, browser bundle, test fram
 
 > *Simplicity scales.*
 
-Simple IR (S-expressions), clear pipeline (lex → parse → generate), minimal code, comprehensive tests.
+Simple IR (S-expressions), clear pipeline (lex -> parse -> generate), minimal code, comprehensive tests.
 
 ---