rip-lang 1.0.0 → 1.1.1

package/.cursor/rules/rip-agent-onboarding.md

@@ -31,7 +31,7 @@ echo 'your code' | ./bin/rip -s  # S-expressions (parser)
 echo 'your code' | ./bin/rip -c  # JavaScript (codegen)
 
 # Run tests
-bun run test                              # All 854 tests
+bun run test                              # All tests
 bun test/runner.js test/rip/FILE.rip     # Specific file
 bun --no-cache test/runner.js test/rip   # Clear Bun cache
 
@@ -47,13 +47,13 @@ bun run parser  # Regenerates src/parser.js from grammar.rip
 ```bash
 gh issue list
 git branch -a
-cat ISSUE-*.md  # Handoff docs for complex issues
+cat ISSUE-*.md  # Handoff docs for complex issues (if any exist)
 ```
 
-**If resuming Issue #11 (nested comprehension IIFEs):**
-- Read `ISSUE-11.md` for complete analysis
-- Branch: `fix/nested-comprehension-context`
-- See "Recommended Approach" section
+**If resuming an existing issue:**
+- Read any `ISSUE-*.md` handoff documentation
+- Check for an existing feature branch
+- Review the analysis and recommended approach
 
 ---
 
@@ -114,11 +114,11 @@ fail "name", "invalid syntax"
 test/rip/
 ├── assignment.rip       (43 tests)
 ├── async.rip            (29 tests)
-├── comprehensions.rip   (24 tests) ← Nested comprehension tests here
+├── comprehensions.rip   (24 tests)
 ├── functions.rip        (71 tests)
 ├── loops.rip            (25 tests)
 ... 15 more files
-Total: 854 tests (100% passing)
+Total: 850+ tests (100% passing)
 ```
 
 ### Test-Driven Development
@@ -174,7 +174,7 @@ bun run test
 ### Modify Parser Runtime Behavior
 
 ```bash
-# Example: Improve error messages (Issue #7)
+# Example: Improve error messages or parser behavior
 
 # 1. Edit solar.rip (NOT parser.js!)
 vim src/grammar/solar.rip
@@ -351,21 +351,22 @@ gh pr merge <number> --squash --delete-branch
 ## 🎯 Current Project Status
 
 **Version:** 1.0.0
-**Tests:** 854/854 passing (100%)
+**Tests:** 854+ passing (100%)
 **Status:** Production-ready, actively maintained
 
-**Recent Achievements:**
-- ✅ Postfix comprehensions with `by` step (Issue #1)
-- ✅ Parser error locations (Issue #7)
-- ✅ Range loops without variable (Issue #9)
-- ✅ bar.coffee compiles successfully
-- ✅ 48% smaller output than CoffeeScript
-
-**Open Issues:**
-- Issue #11: Nested comprehension IIFEs (in progress, see ISSUE-11.md)
+**Check current status:**
+```bash
+gh issue list                    # See open issues
+git branch -a                    # See active branches
+bun run test                     # Verify test count and status
+cat README.md | grep "Tests:"    # Current test count
+```
 
-**Active Branches:**
-- `fix/nested-comprehension-context` - Issue #11 work
+**Key achievements:**
+- ✅ Full CoffeeScript compatibility
+- ✅ 48% smaller output than CoffeeScript
+- ✅ Comprehensive test coverage
+- ✅ Production-ready compiler
 
 ---
 
@@ -379,7 +380,7 @@ gh pr merge <number> --squash --delete-branch
 
 **Technical Reference:**
 - `docs/CODEGEN.md` - All 110+ node types
-- `docs/COMPREHENSIONS.md` - Context rules (CRITICAL for Issue #11!)
+- `docs/COMPREHENSIONS.md` - Context rules for comprehensions
 - `docs/SOLAR.md` - Parser generator guide
 - `docs/STRING.md` - String metadata
 - `docs/REGEX-PLUS.md` - Ruby-style regex
@@ -391,7 +392,7 @@ gh pr merge <number> --squash --delete-branch
 
 ## 🎨 Code Style Principles
 
-From today's session:
+Follow these principles:
 
 1. **Keep it clean** - No ugly hacks, readable code
 2. **Keep it simple** - S-expressions over complex AST
@@ -413,16 +414,21 @@ case '+': return this.buildBinaryExpression(rest[0], rest[1], '+', {precedence:
 
 ---
 
-## 🏆 Session History
+## 🏆 Workflow Example
 
-**Today (2025-10-31):** Completed 5 full GitHub workflows
-- Issue #1/PR #2: Postfix `by` step support
-- Issue #3/PR #4: Refactor step handling
-- Issue #5/PR #6: Comprehension context fix
-- Issue #7+#9/PR #10: Parser errors + range loops
-- Issue #11: Analysis complete, implementation pending
+**Complete workflow for any issue:**
+1. Identify the bug or feature need
+2. Create issue via `gh issue create`
+3. Create feature branch
+4. Write failing tests
+5. Implement the fix
+6. Verify all tests pass
+7. Build browser bundle (if needed)
+8. Commit with `Fixes #N` reference
+9. Create PR with `gh pr create`
+10. Merge with `gh pr merge --squash --delete-branch`
 
-**All issues auto-closed via `Fixes #N` in PR descriptions!**
+**All issues auto-close via `Fixes #N` in PR descriptions!**
 
 ---
 
@@ -513,7 +519,7 @@ git commit -m "fix bug"  # WRONG - didn't run tests!
 
 ### ✅ Always Test First
 ```bash
-bun run test  # MUST be 854/854 passing
+bun run test  # MUST be 100% passing
 git commit
 ```
 
@@ -526,7 +532,7 @@ git commit -m "Fix comprehension bug"  # WRONG - issue won't auto-close!
 ```bash
 git commit -m "Fix: Description
 
-Fixes #11  # RIGHT - auto-closes issue!
+Fixes #N  # RIGHT - auto-closes issue!
 "
 ```
 
@@ -538,7 +544,7 @@ git commit anyway  # WRONG!
 
 ### ✅ Keep 100% Pass Rate
 ```bash
-bun run test  # Must be 854/854 passing
+bun run test  # Must be 100% passing
 # If tests fail, fix them or revert your change
 ```
 
@@ -595,12 +601,11 @@ Context-aware generation = smarter, more efficient code!
 
 **When you need deep knowledge:**
 
-### For Comprehension Work (Issue #11)
+### For Comprehension Work
 1. `docs/COMPREHENSIONS.md` - Complete context rules
-2. `ISSUE-11.md` - Nested IIFE problem analysis
-3. `test/rip/comprehensions.rip` - All test cases
-4. `src/codegen.js:2025-2230` - Comprehension IIFE generation
-5. `src/codegen.js:4080-4250` - Plain loop generation
+2. `test/rip/comprehensions.rip` - All test cases
+3. Search `src/codegen.js` for `case 'comprehension':` - IIFE generation
+4. Search `src/codegen.js` for `case 'for-in':` - Plain loop generation
 
 ### For Grammar Work
 1. `docs/SOLAR.md` - Parser generator guide
@@ -614,24 +619,24 @@ Context-aware generation = smarter, more efficient code!
 
 ---
 
-## 🎯 Your First Task
+## 🎯 Getting Started
 
 **Start here:**
 
-1. ✅ Read AGENT.md (you're ready after this!)
+1. ✅ Read `AGENT.md` (you're ready after this!)
 2. ✅ Run `bun run test` (verify everything passes)
 3. ✅ Check `gh issue list` (see what's open)
-4. ✅ If Issue #11 exists, read `ISSUE-11.md`
-5. ✅ Create branch: `git checkout fix/nested-comprehension-context`
-6. ✅ Implement Solution B from ISSUE-11.md
-7. ✅ Follow the workflow in `docs/WORKFLOW.md`
+4. ✅ If handoff docs exist, read any `ISSUE-*.md` files
+5. ✅ Create appropriate branch: `git checkout -b fix/descriptive-name`
+6. ✅ Follow the test-driven workflow
+7. ✅ Reference `docs/WORKFLOW.md` for the complete process
 
 ---
 
 ## 🌟 Success Criteria
 
 **Before committing:**
-- ✅ All tests pass (854/854 or higher)
+- ✅ All tests pass (100% pass rate)
 - ✅ Code follows existing patterns
 - ✅ Documentation updated
 - ✅ Browser bundle rebuilt (if codegen changed)
@@ -649,9 +654,9 @@ Context-aware generation = smarter, more efficient code!
 
 **Resources available:**
 1. Read the docs (comprehensive!)
-2. Check closed PRs (#2, #4, #6, #10) for examples
+2. Check closed PRs for workflow examples: `gh pr list --state closed`
 3. Review test files for patterns
-4. Use debug flags extensively
+4. Use debug flags extensively (`-t`, `-s`, `-c`)
 
 **The docs are excellent** - trust them! Everything you need is documented.
 
@@ -665,9 +670,9 @@ Context-aware generation = smarter, more efficient code!
 > - Keep the IR simple (s-expressions)
 > - Keep the pipeline clear (lex → parse → generate)
 > - Keep the code minimal (pattern matching)
-> - Test everything (854/854 tests passing)
+> - Test everything (100% tests passing)
 
-**From today's session:**
+**Core practices:**
 
 > Follow the workflow.
 > Write tests first.

package/.github/ISSUE_TEMPLATE/coffeescript_compatibility.yml

@@ -53,7 +53,7 @@ body:
       options:
         - Blocking migration
         - High - affects many files
-        - Medium - affects some files  
+        - Medium - affects some files
         - Low - easy to work around
     validations:
       required: false
@@ -83,4 +83,3 @@ body:
           required: true
         - label: I've tested with the latest version of Rip
           required: false
-

package/.github/ISSUE_TEMPLATE/config.yml

@@ -6,4 +6,3 @@ contact_links:
   - name: 💬 Discussions
     url: https://github.com/shreeve/rip-lang/discussions
     about: Ask questions, share ideas, and discuss Rip with the community
-

package/.github/ISSUE_TEMPLATE/question.yml

@@ -52,4 +52,3 @@ body:
         - label: docs/COMPREHENSIONS.md
         - label: docs/SOLAR.md
         - label: Other docs in docs/ folder
-

package/.github/pull_request_template.md

@@ -22,8 +22,8 @@
 
 <!-- List the specific changes -->
 
-- 
-- 
+-
+-
 
 ## Testing
 
@@ -81,4 +81,3 @@
 ## Additional Notes
 
 <!-- Any other context, concerns, or discussion points -->
-

package/CHANGELOG.md

@@ -0,0 +1,82 @@
+# Changelog
+
+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).
+
+## [1.1.1] - 2025-11-01
+
+### Fixed
+- **Browser REPL launcher (`rip -w`)** - Port fallback now works correctly
+  - Fixed `ReferenceError: assignedPort is not defined`
+  - Server tries port 3000, falls back to OS-assigned port if busy
+  - Browser opens with correct port automatically
+  - Works when installed globally via `npm install -g rip-lang` or `bun install -g rip-lang`
+
+### Changed
+- Refactored serve.js to eliminate code duplication
+- Improved port detection by parsing server output
+
+## [1.1.0] - 2025-11-01
+
+### Added
+- **Beautiful s-expression formatter** - Canonical format with proper indentation
+  - Deployed in CLI (`-s` flag), browser REPL, and as standalone utility
+  - 80% more compact than JSON, fully parenthesized
+  - Heregex patterns collapsed to single line
+  - Meta-circular: Rip code formatting Rip's data structures!
+- **Script execution** - `rip script.rip` now executes directly (no explicit `bun` needed)
+  - Auto-detects .rip files and uses Bun loader
+  - Passes arguments correctly
+  - Shebang support: `#!/usr/bin/env rip`
+- **Browser REPL launcher** - `rip -w` starts local server and opens browser
+  - One-command workflow
+  - Works offline with local changes
+  - Cross-platform (macOS, Windows, Linux)
+- **Resizable REPL panes** - Drag slider between Rip source and JavaScript output
+- **Local time display** - Build timestamp shown in user's timezone
+- **Friendly error messages** - Clear "File not found" instead of stack traces
+
+### Fixed
+- **Postfix `by` step in comprehensions** - `for i in [0..10] by 2` now works
+- **Nested IIFE elimination** - Major code generation optimization (37% smaller)
+- **Throw in expressions** - Properly wrapped in IIFE
+- **Rest parameters in middle position** - Both functions and array destructuring
+  - `def fn(first, ...middle, last)` works
+  - `[first, ...middle, last] = arr` works
+- **Parser error messages** - Now show line and column numbers
+- **Range loops without variable** - `for [1..10]` optimization
+- **Comprehension context detection** - Smart IIFE vs plain loop decisions
+- **Step handling refactoring** - Unified logic, 37% code reduction
+- **Global installation** - `rip -w` works correctly when installed via npm/bun
+
+### Changed
+- Version bumped to 1.1.0
+- Test count: 843 → 864 (+21 tests, all passing)
+- Documentation updated throughout
+- Package.json prepared for NPM publishing
+
+### Documentation
+- Complete GitHub workflow system (issues, PRs, templates)
+- AI agent onboarding guide
+- CONTRIBUTING.md with real examples
+- Updated README, AGENT.md, COFFEESCRIPT-COMPARISON.md
+- All stats current (864 tests)
+
+### Infrastructure
+- 10 complete GitHub workflows (issue → branch → test → fix → PR → merge)
+- Comprehensive test coverage (100% passing)
+- Ready for NPM publish
+
+## [1.0.0] - 2025-10-31
+
+### Initial Release
+- Complete Rip language compiler
+- CoffeeScript-inspired syntax with modern ES2022 output
+- Zero dependencies (includes SLR(1) parser generator)
+- Self-hosting capability
+- 843/843 tests passing
+- Terminal REPL
+- Browser bundle (43KB brotli-compressed)
+- Complete documentation

package/CONTRIBUTING.md

@@ -316,7 +316,7 @@ All tests passing: X/Y (100%)
 ## Getting Help
 
 - Read [AGENT.md](AGENT.md) for AI assistant guide
-- Check [docs/](docs/) for detailed documentation  
+- Check [docs/](docs/) for detailed documentation
 - Open a [Question issue](https://github.com/shreeve/rip-lang/issues/new/choose)
 - Look at existing tests in `test/rip/` for examples
 - Review closed PRs for workflow examples
@@ -328,4 +328,3 @@ Open an issue or discussion. We're happy to help!
 ---
 
 **Philosophy:** Keep it simple. Keep it tested. Keep it elegant. ✨
-

package/README.md

@@ -9,7 +9,7 @@
 </p>
 
 <p align="center">
-  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-1.0.0-blue.svg" alt="Version"></a>
+  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-1.1.1-blue.svg" alt="Version"></a>
   <a href="#es2022-target"><img src="https://img.shields.io/badge/target-ES2022-blue.svg" alt="Target"></a>
   <a href="#current-status"><img src="https://img.shields.io/badge/tests-864%2F864-brightgreen.svg" alt="Tests"></a>
   <a href="#current-status"><img src="https://img.shields.io/badge/coverage-100%25-brightgreen.svg" alt="Coverage"></a>
@@ -1123,7 +1123,7 @@ for (let i = 0; i < obj.length; i += 2) {
 
 ## Current Status
 
-**Version:** 1.0.0 - **STABLE RELEASE!** 🎉
+**Version:** 1.1.0 - **ENHANCED RELEASE!** 🎉
 
 **⚡ NEW: DUAL SYNTAX SUPPORT - CoffeeScript Compatibility!**
 

package/bin/rip

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 
 import { readFileSync, writeFileSync, existsSync } from 'fs';
-import { execSync } from 'child_process';
+import { execSync, spawn } from 'child_process';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import { Compiler } from '../src/compiler.js';
@@ -32,9 +32,11 @@ Options:
   -s, --sexpr         Show s-expressions
   -t, --tokens        Show token stream
   -v, --version       Show version number
+  -w, --web           Launch browser REPL (auto-shutdown server)
 
 Examples:
-  rip                           # Interactive REPL
+  rip                           # Interactive REPL (terminal)
+  rip -w                        # Launch browser REPL (auto-opens)
   rip script.rip                # Execute script (auto-detects .rip)
   rip script.rip arg1 arg2      # Execute with arguments
   rip -c example.rip            # Compile to stdout
@@ -62,6 +64,45 @@ async function main() {
     process.exit(0);
   }
 
+  // Launch local browser REPL (starts server + opens browser)
+  if (args.includes('-w') || args.includes('--web')) {
+    console.log('🚀 Starting Rip browser REPL...\n');
+
+    // Start the server and capture output to get the actual port
+    const servePath = join(__dirname, '../scripts/serve.js');
+    const serverProcess = spawn('bun', [servePath], {
+      stdio: ['inherit', 'pipe', 'inherit'],
+      detached: false
+    });
+
+    let actualPort = null;
+
+    // Capture server output and extract port
+    serverProcess.stdout.on('data', (data) => {
+      const output = data.toString();
+      process.stdout.write(output);
+
+      // Parse port from "Server running at http://localhost:PORT"
+      if (!actualPort) {
+        const match = output.match(/localhost:(\d+)/);
+        if (match) {
+          actualPort = match[1];
+
+          // Open browser once we know the port
+          setTimeout(() => {
+            const openCmd = process.platform === 'darwin' ? 'open' :
+                            process.platform === 'win32' ? 'start' : 'xdg-open';
+            execSync(`${openCmd} http://localhost:${actualPort}/`);
+            console.log('\n📱 Press Ctrl+C to stop server\n');
+          }, 300);
+        }
+      }
+    });
+
+    // Keep server running (don't exit)
+    return;
+  }
+
   // Check if REPL should be started
   // Launch REPL if: no args AND stdin is a TTY (not piped), OR explicit -r flag
   const isTTY = process.stdin.isTTY;

package/docs/dist/rip.browser.js

@@ -6736,7 +6736,7 @@ function compileToJS(source, options = {}) {
 }
 // src/browser.js
 var VERSION = "1.0.0";
-var BUILD_DATE = "2025-11-01@05:15:36GMT";
+var BUILD_DATE = "2025-11-01@08:21:02GMT";
 var dedent = (s) => {
   const m = s.match(/^[ \t]*(?=\S)/gm);
   const i = Math.min(...(m || []).map((x) => x.length));

package/docs/dist/rip.browser.min.js

@@ -239,4 +239,4 @@ _setDataSection();
 function _setDataSection() {
   DATA = ${JSON.stringify(U)};
 }`;F.push(J),A=F.join(`
-`)}return{tokens:E,sexpr:R,code:A,data:U}}compileToJS(Y){return this.compile(Y).code}compileToSExpr(Y){return this.compile(Y).sexpr}}function o2(Y,U={}){return new N1(U).compile(Y)}function K1(Y,U={}){return new N1(U).compileToJS(Y)}var G3="1.0.0",Z3="2025-11-01@05:15:36GMT",t2=(Y)=>{let U=Y.match(/^[ \t]*(?=\S)/gm),M=Math.min(...(U||[]).map((_)=>_.length));return Y.replace(RegExp(`^[ 	]{${M}}`,"gm"),"").trim()};async function v2(){let Y=document.querySelectorAll('script[type="text/rip"]');for(let U of Y){if(U.hasAttribute("data-rip-processed"))continue;try{let M=t2(U.textContent),_=K1(M);(0,eval)(_),U.setAttribute("data-rip-processed","true")}catch(M){console.error("Error compiling Rip script:",M),console.error("Script content:",U.textContent)}}}if(typeof document!=="undefined")if(document.readyState==="loading")document.addEventListener("DOMContentLoaded",v2);else v2();function e2(Y){try{let M=K1(Y).replace(/^let\s+[^;]+;\s*\n\s*/m,"");M=M.replace(/^const\s+/gm,"var ");let _=(0,eval)(M);if(_!==void 0)globalThis._=_;return _}catch(U){console.error("Rip compilation error:",U.message);return}}if(typeof globalThis!=="undefined")globalThis.rip=e2;export{e2 as rip,v2 as processRipScripts,R1 as parser,K1 as compileToJS,o2 as compile,G3 as VERSION,x1 as Lexer,N1 as Compiler,A1 as CodeGenerator,Z3 as BUILD_DATE};
+`)}return{tokens:E,sexpr:R,code:A,data:U}}compileToJS(Y){return this.compile(Y).code}compileToSExpr(Y){return this.compile(Y).sexpr}}function o2(Y,U={}){return new N1(U).compile(Y)}function K1(Y,U={}){return new N1(U).compileToJS(Y)}var G3="1.0.0",Z3="2025-11-01@08:21:02GMT",t2=(Y)=>{let U=Y.match(/^[ \t]*(?=\S)/gm),M=Math.min(...(U||[]).map((_)=>_.length));return Y.replace(RegExp(`^[ 	]{${M}}`,"gm"),"").trim()};async function v2(){let Y=document.querySelectorAll('script[type="text/rip"]');for(let U of Y){if(U.hasAttribute("data-rip-processed"))continue;try{let M=t2(U.textContent),_=K1(M);(0,eval)(_),U.setAttribute("data-rip-processed","true")}catch(M){console.error("Error compiling Rip script:",M),console.error("Script content:",U.textContent)}}}if(typeof document!=="undefined")if(document.readyState==="loading")document.addEventListener("DOMContentLoaded",v2);else v2();function e2(Y){try{let M=K1(Y).replace(/^let\s+[^;]+;\s*\n\s*/m,"");M=M.replace(/^const\s+/gm,"var ");let _=(0,eval)(M);if(_!==void 0)globalThis._=_;return _}catch(U){console.error("Rip compilation error:",U.message);return}}if(typeof globalThis!=="undefined")globalThis.rip=e2;export{e2 as rip,v2 as processRipScripts,R1 as parser,K1 as compileToJS,o2 as compile,G3 as VERSION,x1 as Lexer,N1 as Compiler,A1 as CodeGenerator,Z3 as BUILD_DATE};

package/docs/index.html

@@ -58,8 +58,8 @@
     <p class="note">If not redirected, <a href="repl.html">click here</a></p>
   </div>
   <script>
-    // Immediate redirect to REPL
-    window.location.href = 'repl.html';
+    // Immediate redirect to REPL (preserve query params)
+    window.location.href = 'repl.html' + window.location.search;
   </script>
 </body>
 </html>

package/docs/repl.html

@@ -4,6 +4,7 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Rip REPL - Interactive Browser Environment</title>
+  <link rel="icon" href="data:,">
   <style>
     * {
       margin: 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rip-lang",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "A lightweight scripting language that compiles to modern JavaScript",
   "type": "module",
   "main": "src/compiler.js",

package/scripts/serve.js

@@ -1,10 +1,17 @@
 #!/usr/bin/env bun
 // Simple static file server with brotli support
 import { readFileSync, existsSync } from 'fs';
-import { join, extname } from 'path';
+import { join, extname, dirname } from 'path';
+import { fileURLToPath } from 'url';
 
-const PORT = 3000;
-const ROOT = 'docs';
+// Get the directory where this script lives
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Serve from docs/ relative to script location (works when globally installed)
+const ROOT = process.env.SERVE_DIR || join(__dirname, '../docs');
+// Try port 3000 first, fallback to 0 (OS-assigned)
+const PORT = process.env.PORT || 3000;
 
 const MIME_TYPES = {
   '.html': 'text/html; charset=utf-8',
@@ -17,55 +24,67 @@ const MIME_TYPES = {
   '.ico': 'image/x-icon'
 };
 
-Bun.serve({
-  port: PORT,
-
-  fetch(req) {
-    const url = new URL(req.url);
-    let pathname = url.pathname;
-
-    // Default to index.html for directory requests
-    if (pathname.endsWith('/')) {
-      pathname += 'index.html';
-    }
+// Request handler for serving files
+function handleRequest(req) {
+  const url = new URL(req.url);
+  let pathname = url.pathname;
 
-    const filePath = join(ROOT, pathname);
-    const ext = extname(pathname);
-    const acceptEncoding = req.headers.get('accept-encoding') || '';
+  // Default to index.html for directory requests
+  if (pathname.endsWith('/')) {
+    pathname += 'index.html';
+  }
 
-    // Check for brotli compressed version (.br)
-    if (acceptEncoding.includes('br') && existsSync(filePath + '.br')) {
-      try {
-        const compressed = readFileSync(filePath + '.br');
-        return new Response(compressed, {
-          headers: {
-            'Content-Type': MIME_TYPES[ext] || 'application/octet-stream',
-            'Content-Encoding': 'br',
-            'Cache-Control': 'public, max-age=31536000'
-          }
-        });
-      } catch (e) {
-        // Fall through to regular file
-      }
-    }
+  const filePath = join(ROOT, pathname);
+  const ext = extname(pathname);
+  const acceptEncoding = req.headers.get('accept-encoding') || '';
 
-    // Serve regular file
+  // Check for brotli compressed version (.br)
+  if (acceptEncoding.includes('br') && existsSync(filePath + '.br')) {
     try {
-      const file = readFileSync(filePath);
-      return new Response(file, {
+      const compressed = readFileSync(filePath + '.br');
+      return new Response(compressed, {
         headers: {
-          'Content-Type': MIME_TYPES[ext] || 'application/octet-stream'
+          'Content-Type': MIME_TYPES[ext] || 'application/octet-stream',
+          'Content-Encoding': 'br',
+          'Cache-Control': 'public, max-age=31536000'
         }
       });
     } catch (e) {
-      return new Response('404 Not Found', { status: 404 });
+      // Fall through to regular file
     }
   }
-});
 
-console.log(`🚀 Server running at http://localhost:${PORT}`);
+  // Serve regular file
+  try {
+    const file = readFileSync(filePath);
+    return new Response(file, {
+      headers: {
+        'Content-Type': MIME_TYPES[ext] || 'application/octet-stream'
+      }
+    });
+  } catch (e) {
+    return new Response('404 Not Found', { status: 404 });
+  }
+}
+
+// Try to start server on preferred port, fallback to OS-assigned port
+let server;
+try {
+  server = Bun.serve({ port: PORT, fetch: handleRequest });
+} catch (err) {
+  if (err.code === 'EADDRINUSE') {
+    // Port in use, let OS assign one
+    server = Bun.serve({ port: 0, fetch: handleRequest });
+  } else {
+    throw err;
+  }
+}
+
+const actualPort = server.port;
+
+console.log(`🚀 Server running at http://localhost:${actualPort}`);
 console.log(`📁 Serving from: ${ROOT}/`);
 console.log(`🗜️  Brotli compression: enabled`);
 console.log('');
-console.log(`✨ Rip REPL:   http://localhost:${PORT}/`);
-console.log(`📚 Examples:   http://localhost:${PORT}/examples/`);
+console.log(`✨ Rip REPL:   http://localhost:${actualPort}/`);
+console.log(`📚 Examples:   http://localhost:${actualPort}/examples/`);

package/src/grammar/solar.rip

@@ -816,7 +816,7 @@ class Generator
       text = if hash.text then " near '#{hash.text}'" else ''
       location = "line #{line}, column #{col}"
       message = "Parse error at #{location}#{token}#{text}: #{str}"
-      
+
       error = new Error message
       error.hash = hash
       throw error