rip-lang 3.0.2 → 3.1.1

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.1.0] - 2026-02-08
+
+### Rip UI — Zero-Build Reactive Web Framework
+
+Rip UI inverts the traditional web development model. Instead of building and
+bundling on the server, the 40KB Rip compiler ships to the browser. Components
+are delivered as `.rip` source files, stored in a browser-local Virtual File
+System, compiled on demand, and rendered with fine-grained DOM updates.
+
+**Component model** — Two keywords added to the language:
+
+- `component` — Declares an anonymous ES6 class with reactive props, computed
+  values, effects, methods, and lifecycle hooks. `@` properties become props
+  the parent can set. `:=` creates signals, `~=` creates computed values.
+- `render` — Defines a Pug/Jade-like template DSL inside a component. Tags are
+  bare identifiers, classes use dot notation (`div.card.active`), dynamic
+  classes use dot-parens (`div.("active" if @selected)`), and events use
+  `@click: handler`. No virtual DOM — each reactive binding creates a direct
+  effect that updates exactly the DOM nodes it touches.
+
+**Framework modules** (all in `packages/ui/`):
+
+| Module | Role |
+|--------|------|
+| `stash.js` | Deep reactive state tree with path-based navigation |
+| `vfs.js` | Browser-local Virtual File System with file watchers |
+| `router.js` | File-based router (URL ↔ VFS paths, History API) |
+| `renderer.js` | Component lifecycle, layout nesting, route transitions |
+| `ui.js` | `createApp` entry point, re-exports everything |
+
+**Compiler changes** (`src/components.js`, 1,193 lines):
+
+- 22 methods installed on `CodeGenerator.prototype` via `installComponentSupport()`
+- Categorizes component body into state, computed, readonly, methods, effects, render
+- Emits fine-grained DOM creation (`_create()`) and reactive setup (`_setup()`)
+- Block factories for conditionals and loops with disposable effects
+- Keyed reconciliation for list rendering
+- Component runtime emitted only when `component` keyword is used
+
+**No build step. No bundler. No configuration files.**
+
+---
+
 ## [3.0.0] - 2026-02-07
 
 ### Complete Rewrite
@@ -27,8 +70,6 @@ Rip 3.0 is a ground-up rewrite of the entire compiler pipeline. Every component
 #### 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
@@ -37,15 +78,16 @@ Rip 3.0 is a ground-up rewrite of the entire compiler pipeline. Every component
 - `as!` async shorthand: `for x as! iterable` (shorthand for `for await x as iterable`)
 
 #### Kept
-- Existence check: `x?` compiles to `(x != null)`
+- Existence check: `x?` compiles to `(x != null)` — works after any expression
 - All reactive operators: `:=`, `~=`, `~>`, `=!`
 - Dammit operator: `x!` compiles to `await x()`
-- Optional chaining: `?.`, `?.[]`, `?.()` (ES6 dot-form only)
+- Optional chaining: `?.`, `?.[]`, `?.()` (ES6 dot-form)
+- Optional chaining shorthand: `?[]`, `?()` (compiles to `?.[]`, `?.()`)
 - Nullish coalescing: `??`
 - All other CoffeeScript-compatible syntax
 
 ### Tests
-- 1,048 tests passing (100%)
+- 1,073 tests passing (100%)
 - 25 test files across all language features
 
 ---

package/README.md

@@ -9,9 +9,9 @@
 </p>
 
 <p align="center">
-  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-3.0.0-blue.svg" alt="Version"></a>
+  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-3.1.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-1048%2F1048-brightgreen.svg" alt="Tests"></a>
+  <a href="#"><img src="https://img.shields.io/badge/tests-1073%2F1073-brightgreen.svg" alt="Tests"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License"></a>
 </p>
 
@@ -147,6 +147,7 @@ State, computed values, and effects as language operators:
 | `?` (existence) | `x?` | True if `x != null` |
 | `?:` (ternary) | `x > 0 ? 'yes' : 'no'` | JS-style ternary expression |
 | `?.` `?.[]` `?.()` | `a?.b` `a?.[0]` `a?.()` | Optional chaining (ES6) |
+| `?[]` `?()` | `a?[0]` `a?(x)` | Optional chaining shorthand |
 | `??` | `a ?? b` | Nullish coalescing |
 | `...` (spread) | `[...items, last]` | Prefix spread (ES6) |
 | `//` | `7 // 2` | Floor division |
@@ -202,6 +203,27 @@ Rip's reactivity is framework-agnostic — use it with React, Vue, Svelte, or va
 
 ---
 
+## Rip UI
+
+Ship the 40KB Rip compiler to the browser. Components are `.rip` source files, compiled on demand, rendered with fine-grained reactivity. No build step. No bundler.
+
+```coffee
+Counter = component
+  @count := 0
+
+  render
+    div.counter
+      h1 "Count: #{@count}"
+      button @click: (-> @count++), "+"
+      button @click: (-> @count--), "-"
+```
+
+Two keywords — `component` and `render` — are all the language adds. Everything else (`:=` state, `~=` computed, methods, lifecycle) is standard Rip.
+
+See [@rip-lang/ui](packages/ui/) for the full framework: Virtual File System, file-based router, reactive stash, and component renderer.
+
+---
+
 ## vs CoffeeScript
 
 | Feature | CoffeeScript | Rip |
@@ -263,6 +285,7 @@ Rip includes optional packages for full-stack development:
 
 | Package | Purpose | Lines |
 |---------|---------|-------|
+| [@rip-lang/ui](packages/ui/) | Zero-build reactive web framework (VFS, router, components) | ~1,300 |
 | [@rip-lang/api](packages/api/) | HTTP framework (Sinatra-style routing, 37 validators) | ~1,050 |
 | [@rip-lang/server](packages/server/) | Multi-worker app server (hot reload, HTTPS, mDNS) | ~1,210 |
 | [@rip-lang/db](packages/db/) | DuckDB server with official UI (pure Bun FFI) | ~1,740 |
@@ -303,7 +326,7 @@ rip file.rip           # Run
 rip -c file.rip        # Compile
 rip -t file.rip        # Tokens
 rip -s file.rip        # S-expressions
-bun run test           # 1048 tests
+bun run test           # 1073 tests
 bun run parser         # Rebuild parser
 bun run browser        # Build browser bundle
 ```

package/docs/RIP-INTERNALS.md

@@ -63,7 +63,7 @@ console.log(code);
 
 | Feature | CoffeeScript | Rip |
 |---------|-------------|------|
-| Optional chaining | 4 soak operators | ES6 `?.` / `?.[]` / `?.()` |
+| Optional chaining | 4 soak operators | ES6 `?.` / `?.[]` / `?.()` + shorthand `?[]` / `?()` |
 | Ternary | No | `x ? a : b` |
 | Regex features | Basic | Ruby-style (`=~`, indexing, captures in `_`) |
 | Async shorthand | No | Dammit operator (`!`) |
@@ -298,8 +298,6 @@ The `!` suffix on `as` in for-loops (`as!`) emits `FORASAWAIT` instead of `FORAS
 |---------|-----------|-------------|
 | Postfix spread/rest | `x...` | `...x` (ES6 prefix only) |
 | Prototype access | `x::y`, `x?::y` | Direct `.prototype` or class syntax; `::` reserved for type annotations |
-| Soak call sugar | `x?(args)` | `x?.(args)` (ES6 optional call) |
-| Soak index sugar | `x?[i]` | `x?.[i]` (ES6 optional index) |
 | `is not` contraction | `x is not y` | `x isnt y` |
 
 ### Added
@@ -395,13 +393,15 @@ counter = ->
 | `x ?? y` | `x ?? y` |
 | `x ??= 10` | `x ??= 10` |
 
-Optional chaining uses ES6 syntax:
+Optional chaining uses ES6 syntax (both forms supported):
 
 | Syntax | Compiles To |
 |--------|-------------|
 | `obj?.prop` | `obj?.prop` |
 | `arr?.[0]` | `arr?.[0]` |
 | `fn?.(x)` | `fn?.(x)` |
+| `arr?[0]` | `arr?.[0]` |
+| `fn?(x)` | `fn?.(x)` |
 
 ## Range Optimization
 
@@ -458,8 +458,6 @@ The `Compiler` class's lexer adapter reconstructs `new String()` wrapping from t
 |-----------|--------|--------|
 | `generatePrototype` | `::` | Feature removed from lexer |
 | `generateOptionalPrototype` | `?::` | Feature removed from lexer |
-| `generateSoakIndex` | `?[]` | Replaced by `optindex` / `?.[]` |
-| `generateSoakCall` | `?call` | Replaced by `optcall` / `?.()` |
 
 ## Renamed: `for-from` → `for-as`
 
@@ -573,4 +571,4 @@ bun src/compare-compilers.js
 
 ---
 
-*Rip 3.0.0 — 1,048 tests passing — Zero dependencies — Self-hosting — ~7,700 LOC*
+*Rip 3.0 — 1,073 tests passing — Zero dependencies — Self-hosting — ~7,700 LOC*

package/docs/RIP-LANG.md

@@ -273,6 +273,7 @@ Multiple lines
 | `?` (postfix) | `a?` | Existence check (`a != null`) |
 | `?` (ternary) | `a ? b : c` | Ternary conditional |
 | `?.` `?.[]` `?.()` | `a?.b` `a?.[0]` `a?.()` | Optional chaining (ES6) |
+| `?[]` `?()` | `a?[0]` `a?(x)` | Optional chaining shorthand |
 | `??` | `a ?? b` | Nullish coalescing |
 
 ## Rip-Specific Operators
@@ -311,10 +312,14 @@ x ||= val    # x = x || val
 ## Optional Chaining
 
 ```coffee
-# ES6 optional chaining (dot required)
+# ES6 optional chaining (with dot)
 user?.profile?.name
 arr?.[0]
 fn?.(arg)
+
+# Shorthand (without dot — same behavior)
+arr?[0]       # Compiles to arr?.[0]
+fn?(arg)      # Compiles to fn?.(arg)
 ```
 
 ## Ternary Operator
@@ -1123,4 +1128,4 @@ count = 10  # Logs: "Count: 10, Doubled: 20"
 
 ---
 
-*Rip 3.0.0 — 1,048 tests passing — Zero dependencies — Self-hosting — ~7,700 LOC*
+*Rip 3.0 — 1,073 tests passing — Zero dependencies — Self-hosting — ~7,700 LOC*