rip-lang 3.5.0 → 3.6.1

package/CHANGELOG.md

@@ -7,14 +7,16 @@ 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.5.0] - 2026-02-10
+## [3.6.0] - 2026-02-10
 
-### Browser Runtime Enhancements
+### Browser Runtime — Full Async/Await Support
 
-- **`importRip(url)`** — New function to fetch, compile, and import `.rip` files as ES modules via blob URL. Registered on `globalThis` for use in `<script type="text/rip">` blocks.
-- **Async `<script type="text/rip">`** — `processRipScripts` now wraps compiled code in an async IIFE, enabling `await` (Rip's `!` operator) in inline scripts.
-- **Eager reactive runtime** — `globalThis.__rip` is registered when `rip.browser.js` loads, making reactive primitives available to framework code without the compiler needing to detect reactive operators.
-- **`compileToJS` on globalThis** — The compiler function is now globally accessible, enabling auto-detection by framework code like `launch()`.
+- **`rip()` console REPL** — Wraps user code in a Rip `do ->` block, so the compiler handles implicit return and auto-async natively. Sync code returns values directly; async code returns a Promise (use `await rip("...")` in the console). Variables persist on `globalThis` across calls.
+- **`importRip(url)`** — Fetch, compile, and import `.rip` files as ES modules via blob URL. Registered on `globalThis` for use in `<script type="text/rip">` blocks.
+- **Async `<script type="text/rip">`** — `processRipScripts` wraps compiled code in an async IIFE, enabling `await` (Rip's `!` operator) in inline scripts.
+- **Playground** — Run button uses async IIFE for `await` support. Cmd+Enter shortcut registered on Monaco editor.
+- **Eager reactive runtime** — `globalThis.__rip` is registered when `rip.browser.js` loads, making reactive primitives available to framework code.
+- **`compileToJS` on globalThis** — The compiler function is globally accessible for framework auto-detection.
 
 ## [3.4.3] - 2026-02-09
 

package/README.md

@@ -9,7 +9,7 @@
 </p>
 
 <p align="center">
-  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-3.5.0-blue.svg" alt="Version"></a>
+  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-3.6.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-1140%2F1140-brightgreen.svg" alt="Tests"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License"></a>
@@ -264,17 +264,25 @@ Smaller codebase, modern output, built-in reactivity.
 
 ## Browser
 
-Run Rip directly in the browser:
+Run Rip directly in the browser — inline scripts and the console REPL both support `await` via the `!` operator:
 
 ```html
-<script src="https://shreeve.github.io/rip-lang/docs/dist/rip.browser.min.js"></script>
+<script type="module" src="/rip/browser.js"></script>
 <script type="text/rip">
-  def greet(name)
-    console.log "Hello, #{name}!"
-  greet "World"
+  res = fetch! 'https://api.example.com/data'
+  data = res.json!
+  console.log data
 </script>
 ```
 
+The `rip()` function is available in the browser console:
+
+```javascript
+rip("42 * 10 + 8")                                         // → 428
+rip("(x * x for x in [1..5])")                             // → [1, 4, 9, 16, 25]
+await rip("res = fetch! 'https://api.example.com/todos/1'; res.json!")  // → {id: 1, ...}
+```
+
 **Try it live:** [shreeve.github.io/rip-lang](https://shreeve.github.io/rip-lang/)
 
 ---
@@ -299,7 +307,7 @@ Simple arrays (with `.loc`) instead of AST node classes. The compiler is self-ho
 | Grammar | `src/grammar/grammar.rip` | 935 |
 | Parser Generator | `src/grammar/solar.rip` | 916 |
 | REPL | `src/repl.js` | 707 |
-| Browser Entry | `src/browser.js` | 107 |
+| Browser Entry | `src/browser.js` | 119 |
 | Tags | `src/tags.js` | 63 |
 | **Total** | | **~10,325** |
 
@@ -311,7 +319,7 @@ Rip includes optional packages for full-stack development:
 
 | Package | Version | Purpose |
 |---------|---------|---------|
-| [rip-lang](https://www.npmjs.com/package/rip-lang) | 3.5.0 | Core language compiler |
+| [rip-lang](https://www.npmjs.com/package/rip-lang) | 3.6.0 | Core language compiler |
 | [@rip-lang/api](packages/api/) | 1.1.4 | HTTP framework (Sinatra-style routing, 37 validators) |
 | [@rip-lang/server](packages/server/) | 1.1.3 | Multi-worker app server (hot reload, HTTPS, mDNS) |
 | [@rip-lang/db](packages/db/) | 1.1.2 | DuckDB server with official UI (pure Bun FFI) |

package/docs/RIP-GUIDE.md

@@ -534,6 +534,57 @@ user.save!()
 
 ---
 
+## Browser
+
+Rip runs directly in the browser with full async/await support — no build step.
+
+### Inline Scripts
+
+Load the compiler, then write Rip:
+
+```html
+<script type="module" src="/rip/browser.js"></script>
+<script type="text/rip">
+  res = fetch! 'https://api.example.com/data'
+  data = res.json!
+  console.log data
+</script>
+```
+
+The `!` operator works in inline scripts — `processRipScripts` wraps
+compiled code in an async IIFE transparently.
+
+### Console REPL
+
+The `rip()` function is available in any browser console where `rip.browser.js`
+is loaded:
+
+```javascript
+rip("42 * 10 + 8")                  // → 428
+rip("name = 'Alice'")               // → 'Alice' (persists on globalThis)
+rip("(x * x for x in [1..5])")      // → [1, 4, 9, 16, 25]
+
+// Async — use await, Chrome displays the resolved value
+await rip("res = fetch! 'https://jsonplaceholder.typicode.com/todos/1'; res.json!")
+// → {userId: 1, id: 1, title: 'delectus aut autem', completed: false}
+```
+
+Sync code returns values directly. Async code (using `!`) returns a Promise
+that Chrome auto-awaits. Variables persist between calls on `globalThis`.
+
+### `importRip(url)`
+
+Fetch, compile, and import a `.rip` file as an ES module:
+
+```html
+<script type="text/rip">
+  { launch } = importRip! '/rip/ui.rip'
+  launch '/demo'
+</script>
+```
+
+---
+
 ## Full-Stack Example
 
 A complete API server in Rip:

package/docs/dist/rip.browser.js

@@ -7560,8 +7560,8 @@ function getComponentRuntime() {
   return new CodeGenerator({}).getComponentRuntime();
 }
 // src/browser.js
-var VERSION = "3.5.0";
-var BUILD_DATE = "2026-02-10@20:22:29GMT";
+var VERSION = "3.6.1";
+var BUILD_DATE = "2026-02-11@00:29:14GMT";
 if (typeof globalThis !== "undefined" && !globalThis.__rip) {
   new Function(getReactiveRuntime())();
 }
@@ -7612,10 +7612,19 @@ async function importRip(url) {
 }
 function rip(code) {
   try {
-    const js = compileToJS(code);
-    let persistentJs = js.replace(/^let\s+[^;]+;\s*\n\s*/m, "");
-    persistentJs = persistentJs.replace(/^const\s+/gm, "var ");
-    const result = (1, eval)(persistentJs);
+    const indented = code.replace(/^/gm, "  ");
+    const wrapped = compileToJS(`do ->
+${indented}`);
+    let js = wrapped.replace(/^let\s+[^;]+;\s*\n\s*/m, "");
+    js = js.replace(/^const\s+(\w+)\s*=/gm, "globalThis.$1 =");
+    const result = (0, eval)(js);
+    if (result && typeof result.then === "function") {
+      return result.then((v) => {
+        if (v !== undefined)
+          globalThis._ = v;
+        return v;
+      });
+    }
     if (result !== undefined)
       globalThis._ = result;
     return result;