rip-lang 1.5.7 → 2.5.0

package/CHANGELOG.md

@@ -1,3 +1,5 @@
+<p><img src="docs/rip.svg" alt="Rip Logo" width="100"></p>
+
 # Changelog
 
 All notable changes to Rip will be documented in this file.
@@ -5,6 +7,320 @@ 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).
 
+## [2.5.0] - 2026-01-16
+
+### Major Release - Parser Optimization + Complete Framework
+
+This release consolidates all improvements since 2.2.1 into a polished, well-documented package. Rip is now a complete language AND reactive framework in just 51KB (Brotli compressed).
+
+---
+
+### 🚀 Parser Optimization
+
+**Interleaved Delta-Encoded Parse Table** - Major size reduction for the generated parser:
+- New format in `solar.rip`: `[count, Δkey₁, Δkey₂..., val₁, val₂...]` per state
+- **31% smaller Brotli** for parser alone (19.2KB → 13.2KB)
+- **17% faster module load** time
+- Identical runtime performance (same data structure after decode)
+- Solar parser generator now **250× faster** than Jison
+
+---
+
+### ✨ New Language Features
+
+**Ruby-Style Constructor Syntax**:
+```coffee
+# Both are equivalent
+counter = new Counter()
+counter = Counter.new()     # Ruby-style - elegant!
+
+# Works with arguments
+user = User.new("Alice", 30)
+
+# Chainable
+Counter.new().mount("#app")
+```
+
+**"Equal, Dammit!" Operator (`=!`)**:
+```coffee
+# Regular assignment → let (can reassign)
+host = "localhost"
+host = "example.com"    # OK
+
+# Equal, dammit! → const (can't reassign)
+API_URL =! "https://api.example.com"
+API_URL = "other"       # Error! const cannot be reassigned
+```
+Note: `=!` compiles to plain `const` - does NOT pull in the reactive runtime.
+
+**Smart Two-Way Binding**:
+```coffee
+# Automatically uses valueAsNumber for number/range inputs
+input type: "number", value <=> count    # No .valueAsNumber needed!
+input type: "range", value <=> volume    # Just works!
+```
+
+---
+
+### 🎨 Template & Component Improvements
+
+**Pug-Style Shorthand**:
+```coffee
+# Implicit div for class-only selectors
+.card             # → <div class="card">
+.btn.primary      # → <div class="btn primary">
+
+# Nested shorthand works correctly
+.container
+  .row
+    .col "Content"
+```
+
+**Dynamic Class Syntax**:
+```coffee
+div.("bg-white rounded-lg shadow-md")     # Static Tailwind classes
+button.(active && "bg-blue-500")          # Conditional classes
+```
+
+**Component Mount with Selectors**:
+```coffee
+# Both work
+Counter.new().mount(document.body)
+Counter.new().mount("#app")               # Selector string support
+```
+
+---
+
+### 🖥️ Browser REPL Enhancements
+
+**Live Demo Tab** (now default):
+- Interactive component demos
+- Temperature converter, counter examples
+- Real-time reactive updates
+
+**UI Improvements**:
+- Tab state persists in URL hash
+- No flash of wrong tab on page load
+- Consistent pane header heights
+- GitHub icon link in header
+
+**Demo Improvements**:
+- Shows `@prop` syntax for component props
+- Uses Ruby-style `.new()` syntax
+- Fat arrows for proper `this` binding
+
+---
+
+### 📚 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/PHILOSOPHY.md` - Design principles, CoffeeScript comparison
+- `docs/BROWSER.md` - Browser usage, REPL, deployment
+
+**Kept Separate** (referenced from PHILOSOPHY.md):
+- `docs/WHY-NOT-COFFEESCRIPT.md` - The case against CoffeeScript
+- `docs/WHY-YES-RIP.md` - The case for Rip
+
+**Updated Statistics**:
+- ~14,000 LOC total (smaller than CoffeeScript's 17,760, yet includes full reactive framework)
+- 51KB browser bundle (compiler + reactive runtime + templates + components)
+- 1046 tests passing
+- Solar: ~1,000 LOC, 250× faster than Jison
+
+---
+
+### 🔧 Internal Improvements
+
+**Compiler Consolidation**:
+- Merged `codegen.js` into `compiler.js` (single file for all code generation)
+- Renamed `docs/CODEGEN.md` to `docs/COMPILER.md`
+
+**Project Cleanup**:
+- Deleted unused `src/runtime.js` (runtime now embedded in compiler output)
+- Deleted redundant `docs/demo.html`
+- Overhauled `AGENT.md` for accuracy
+- Added `notes.txt` to `.gitignore`
+
+**Bug Fixes**:
+- Fixed `<=>` two-way binding in components
+- Fixed reactive variable shadowing in function bodies
+- Fixed nested Pug-style shorthand in render blocks
+- Fixed `generateParam` bug
+- Consistent name handling in `generateReadonly`
+
+---
+
+### 📊 Updated Scores
+
+| Category | Score | Notes |
+|----------|-------|-------|
+| **Reactivity** | A+ | Fine-grained, signals, effects |
+| **Templates** | A | S-expressions, Pug shorthand |
+| **Components** | A | Props, lifecycle, context API |
+| **Performance** | A | 250× faster parser gen, 51KB bundle |
+
+---
+
+### Summary
+
+**What's in 51KB?**
+- Complete compiler (lexer, parser, code generator)
+- Reactive runtime (signals, derived values, effects)
+- Template engine (S-expression syntax, dynamic classes)
+- Component system (props, lifecycle, fine-grained updates)
+- Zero dependencies
+
+**Comparison**:
+- React (min+gzip): ~42KB (just the library, no compiler)
+- Vue (min+gzip): ~34KB (just the library, no compiler)
+- **Rip: 51KB (complete language + framework, runs anywhere!)**
+
+---
+
+## [2.2.1] - 2026-01-15
+
+### Added - Context API & Error Primitives
+
+**Context API** - Pass data through component trees without prop drilling:
+- `setContext(key, value)` - Set context in current component
+- `getContext(key)` - Get context from nearest ancestor
+- `hasContext(key)` - Check if context exists
+
+**Error Primitives** - Low-level building blocks for error handling:
+- `__catchErrors(fn)` - Wrap function to route errors to handler
+- `__handleError(error)` - Route error to handler or rethrow
+- `__setErrorHandler(fn)` - Set current error handler
+
+**Dynamic Class Syntax** - Cleaner Tailwind support:
+```coffee
+div.("bg-white rounded-lg shadow-md")  # Static classes
+button.(active && "bg-blue-500")       # Conditional classes
+```
+
+**Other Improvements**:
+- Components now track parent via `_parent` pointer
+- Batching optimization with `__batch()` for grouped updates
+- Improved reactive runtime documentation (~330 lines total)
+
+**Updated Scores**:
+- Components: B+ → A- (Context API implemented)
+- Tests: 1017 → 1033
+
+---
+
+## [2.2.0] - 2026-01-15
+
+### Added - Keyed Reconciliation & Per-Item Effects
+
+**The Final Boss: True Svelte-Class Performance**
+
+Lists now have O(1) performance for ALL operations:
+- **Add item**: Create 1 node (not rebuild all)
+- **Remove item**: Remove 1 node (not rebuild all)
+- **Reorder**: Move existing nodes (not recreate)
+- **Selection change**: Per-item effects update independently
+
+**Key Features**:
+- Keyed reconciliation via `key:` attribute
+- Per-item effects with proper cleanup
+- Conditional effect cleanup (no memory leaks)
+- Effect disposal on item removal
+
+**Example**:
+```coffee
+for item, i in items
+  li key: item.id, class: (i == selected && "selected"), item.name
+```
+
+Each item gets its own effect. Changing `selected` updates ONLY the affected classes, not the whole list.
+
+---
+
+## [2.1.0] - 2026-01-15
+
+### Added - Fine-Grained Reactivity
+
+**MAJOR PERFORMANCE IMPROVEMENT**: Components now update only specific DOM nodes that changed, not the entire tree. This brings Rip to Svelte-class performance.
+
+**Architecture Change**:
+- Before: `render()` recreates all DOM on every state change
+- After: `_create()` builds DOM once, `_setup()` wires minimal effects
+
+**Performance**:
+- Text binding: O(1) instead of O(n)
+- Attribute binding: O(1) instead of O(n)
+- **30-40x faster** for typical reactive updates
+
+**New Features**:
+- Fine-grained text bindings: `span count` → effect updates just that text node
+- Fine-grained attribute bindings: `div class: active` → effect updates just that attribute
+- Fine-grained conditionals: `if show` → anchor-based content swapping
+- Fine-grained loops: `for item in items` → tracked node list
+- Named slots: Props can be DOM nodes (`@header`, `@footer`, etc.)
+
+**Updated Scores**:
+- Reactivity: A → A+
+- Templates: A- → A
+- Components: A- → A
+
+---
+
+## [2.0.0] - 2026-01-14
+
+### Added - Reactive UI Framework
+
+**Phase 1: Reactivity** (previously released)
+- Signal-based reactivity: `count = 0` creates reactive state
+- Derived values: `doubled ~= count * 2` auto-tracks dependencies
+- Effects: `effect -> console.log count` runs on changes
+- Runtime: `__signal()`, `__computed()`, `__effect()`, `__batch()`, `__readonly()`
+
+**Phase 2: Templates**
+- Indentation-based template syntax in `render` blocks
+- CSS-style selectors: `div#main.card.active`
+- Event handlers: `@click: handler`
+- Event modifiers: `@click.prevent.stop: handler`
+- Two-way binding: `input value <=> username`
+- Spread attributes: `div ...props`
+- Dynamic classes: `div.('btn', isActive && 'active')` (clsx-style)
+- Control flow: `if`/`else`, `for` loops in templates
+- Special attributes: `key:`, `ref:`
+- Multiple roots via `DocumentFragment`
+- Runtime helpers: `h()`, `frag()`, `txt()`, `cx()`
+
+**Phase 3: Components**
+- `component` keyword for defining UI components
+- Props system:
+  - Required: `@label`
+  - Optional: `@label?`
+  - Default: `@label = "default"`
+  - Rest: `@...rest`
+- Reactive state within components (auto-signals)
+- Derived values within components (auto-computed)
+- Component composition: `Button label: "Click"` inside render
+- Children/slots: `@children` prop for nested content
+- Lifecycle hooks: `mounted:`, `unmounted:`
+- Reactive re-rendering via effect-based mount
+
+### Changed
+- Grammar extended with `component`, `render`, `style` keywords
+- Lexer handles template contexts (ID selectors, arrow injection)
+- Codegen generates ES6 classes for components
+
+### Technical Details
+- Components compile to ES6 classes with constructor, render, mount, unmount
+- Props validated at construction (required props throw if missing)
+- State variables become `__signal()` calls
+- Derived values become `__computed()` calls
+- `mount()` wraps render in `__effect()` for reactive updates
+- PascalCase names in templates trigger component instantiation
+
+All 1033 tests passing (100%) ✅
+
+---
+
 ## [1.5.7] - 2025-11-16
 
 ### Changed

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Steve Shreeve
+Copyright (c) 2026 Steve Shreeve
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal