npm - rip-lang - Versions diffs - 3.13.11 → 3.13.13 - Mend

rip-lang 3.13.11 → 3.13.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (18) hide show

package/docs/dist/rip.min.js.br CHANGED Viewed

Binary file

package/docs/example/index.html CHANGED Viewed

@@ -3,7 +3,7 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <script type="module" src="../dist/rip.min.js"></script>
+  <script defer src="../dist/rip.min.js"></script>
 </head>
 <body>
   <div id="app"></div>

package/docs/index.html CHANGED Viewed

@@ -495,7 +495,7 @@
     body.light .repl-prompt-text { color: #007acc; }
   </style>
   <link rel="preload" href="https://cdn.jsdelivr.net/npm/monaco-editor@0.52.0/min/vs/loader.js" as="script">
-  <script type="module" src="dist/rip.min.js"></script>
+  <script defer src="dist/rip.min.js"></script>
 </head>
 <body>

package/docs/results/index.html CHANGED Viewed

@@ -7,7 +7,7 @@
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=Lato:ital,wght@0,400;0,500;0,700;1,400&family=Nothing+You+Could+Do&display=swap" rel="stylesheet">
-  <script type="module" src="../dist/rip.min.js"></script>
+  <script defer src="../dist/rip.min.js" data-mount="Home"></script>
   <style>
 /* ==========================================================================
    Lab Results — Styles
@@ -596,7 +596,7 @@ body {
 <!-- ===== Components ===== -->
-<script type="text/rip" data-name="index">
+<script type="text/rip">
 # Lab Results - Main Page
 export Home = component
@@ -758,7 +758,7 @@ export Home = component
           acceptable: (k, v) -> @acceptable(k, v)
 </script>
-<script type="text/rip" data-name="settings">
+<script type="text/rip">
 # Settings - Form panel with two-way bound inputs
 export Settings = component
@@ -831,7 +831,7 @@ export Settings = component
         @click: -> window.print()
 </script>
-<script type="text/rip" data-name="brochure">
+<script type="text/rip">
 # Brochure — Container composing all pages
 export Brochure = component
@@ -859,7 +859,7 @@ export Brochure = component
         DetailPage topic: topic, history: history, ranges: ranges, acceptable: acceptable
 </script>
-<script type="text/rip" data-name="cover">
+<script type="text/rip">
 # Cover — Brochure cover page
 export Cover = component
@@ -900,7 +900,7 @@ export Cover = component
           div poweredBy
 </script>
-<script type="text/rip" data-name="summary">
+<script type="text/rip">
 # Summary - Medical Summary table (Page 1)
 export Summary = component
@@ -996,7 +996,7 @@ export Summary = component
               td.value row.value
 </script>
-<script type="text/rip" data-name="detail-page">
+<script type="text/rip">
 # DetailPage - Reusable health detail page with gradient header and gauges
 export DetailPage = component
@@ -1068,7 +1068,7 @@ export DetailPage = component
           .detail__footer-image style: "background-image: url(#{topic.image})"
 </script>
-<script type="text/rip" data-name="gauge">
+<script type="text/rip">
 # Gauge — SVG semi-circular gauge with rotating needle
 export Gauge = component

package/docs/sierpinski.html CHANGED Viewed

@@ -32,7 +32,7 @@
     }
     .dot:hover { transform: scale(2.5); z-index: 1; }
   </style>
-  <script type="module" src="https://shreeve.github.io/rip-lang/dist/rip.min.js"></script>
+  <script defer src="https://shreeve.github.io/rip-lang/dist/rip.min.js"></script>
   <script>
     function updateScale() {
       var s = Math.min(window.innerWidth / 1350, window.innerHeight / 1250, 1);

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "rip-lang",
-  "version": "3.13.11",
+  "version": "3.13.13",
   "description": "A modern language that compiles to JavaScript",
   "type": "module",
   "main": "src/compiler.js",
@@ -31,9 +31,8 @@
     "CHANGELOG.md"
   ],
   "scripts": {
-    "build": "bun scripts/build-browser.js",
-    "build:debug": "bun scripts/build-browser.js --debug",
-    "bump": "bun scripts/bump-version.js",
+    "build": "bun scripts/build.js",
+    "bump": "bun scripts/bump.js",
     "parser": "bun src/grammar/solar.rip -o src/parser.js src/grammar/grammar.rip",
     "serve": "bun scripts/serve.js",
     "test": "bun test/runner.js",

package/scripts/serve.js CHANGED Viewed

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 // Simple static file server with brotli support
-import { readFileSync, existsSync } from 'fs';
+import { readFileSync, existsSync, statSync } from 'fs';
 import { join, extname, dirname } from 'path';
 import { fileURLToPath } from 'url';
@@ -37,6 +37,11 @@ function handleRequest(req) {
     pathname = pathname.slice('/rip-lang'.length);
   }
+  // Redirect /dir to /dir/ if it's a directory
+  if (!pathname.endsWith('/') && !extname(pathname)) {
+    try { if (statSync(join(ROOT, pathname)).isDirectory()) return Response.redirect(pathname + '/', 301); } catch {}
+  }
   // Default to index.html for directory requests
   if (pathname.endsWith('/')) {
     pathname += 'index.html';

package/src/app.rip CHANGED Viewed

@@ -876,11 +876,9 @@ connectWatch = (url) ->
 # ==============================================================================
 # Launch — fetch bundle, create stash, wire router + renderer, start app
 #
-# Entry point for Rip applications. Handles four bundle sources:
+# Entry point for Rip applications. Handles two bundle sources:
 #   1. Explicit bundle object (opts.bundle)
-#   2. Array of component URLs (opts.components)
-#   3. Inline <script type="text/rip" data-name="..."> tags
-#   4. Server fetch from {appBase}/bundle
+#   2. Fetch from URL (opts.bundleUrl) — used by serve middleware's data-launch
 #
 # Creates the app stash, sets up persistence if configured, builds the
 # component resolver, initializes the router and renderer, and optionally
@@ -908,33 +906,15 @@ export launch = (appBase = '', opts = {}) ->
     el.id = target.replace(/^#/, '')
     document.body.prepend el
-  # Get the app bundle — explicit object, literal URL, static files, inline DOM, or server fetch
+  # Get the app bundle — explicit object or fetch from URL
   if opts.bundle
     bundle = opts.bundle
   else if opts.bundleUrl
     res = await fetch(opts.bundleUrl, cache: 'no-cache')
     throw new Error "launch: #{opts.bundleUrl} (#{res.status})" unless res.ok
     bundle = res.json!
-  else if opts.components and Array.isArray(opts.components)
-    components = {}
-    for url in opts.components
-      res = await fetch(url)
-      if res.ok
-        name = url.split('/').pop()
-        components["components/#{name}"] = await res.text()
-    bundle = { components, data: {} }
-  else if typeof document isnt 'undefined' and document.querySelectorAll('script[type="text/rip"][data-name]').length > 0
-    components = {}
-    for script in document.querySelectorAll('script[type="text/rip"][data-name]')
-      name = script.getAttribute('data-name')
-      name += '.rip' unless name.endsWith('.rip')
-      components["components/#{name}"] = script.textContent
-    bundle = { components, data: {} }
   else
-    bundleUrl = "#{appBase}/bundle"
-    res = await fetch(bundleUrl, cache: 'no-cache')
-    throw new Error "launch: #{bundleUrl} (#{res.status})" unless res.ok
-    bundle = res.json!
+    throw new Error "launch: no bundle or bundleUrl provided"
   # Create the unified stash
   app = stash { components: {}, routes: {}, data: {} }

package/src/browser.js CHANGED Viewed

@@ -13,11 +13,11 @@ export const BUILD_DATE = "0000-00-00@00:00:00GMT";
 // Import compiler functions for use in rip() function and globalThis registration
 import { compile, compileToJS, formatSExpr, getReactiveRuntime, getComponentRuntime } from './compiler.js';
-// Eagerly register Rip's reactive primitives on globalThis so that
-// framework code (app.rip) can use them directly without the compiler
-// needing to detect reactive operators in the source
-if (typeof globalThis !== 'undefined' && !globalThis.__rip) {
-  new Function(getReactiveRuntime())();
+// Eagerly register Rip's reactive and component runtimes on globalThis so that
+// framework code (app.rip) and browser-compiled scripts can use them directly
+if (typeof globalThis !== 'undefined') {
+  if (!globalThis.__rip) new Function(getReactiveRuntime())();
+  if (!globalThis.__ripComponent) new Function(getComponentRuntime())();
 }
 const dedent = s => {
@@ -26,43 +26,88 @@ const dedent = s => {
   return s.replace(RegExp(`^[ \t]{${i}}`, 'gm'), '').trim();
 }
-// Browser runtime for executing <script type="text/rip"> tags
-// Supports both inline scripts and external files via src attribute
+// Browser runtime: collect all <script type="text/rip"> sources (inline + src)
+// plus any data-src URLs on the runtime tag, compile them all with shared-scope
+// options, and execute as one async IIFE. Then handle data-launch for server mode.
 async function processRipScripts() {
-  const scripts = document.querySelectorAll('script[type="text/rip"]');
-  for (const script of scripts) {
-    if (script.hasAttribute('data-rip-processed')) continue;
-    if (script.hasAttribute('data-name')) continue;
-    try {
-      let ripCode;
-      if (script.src) {
-        const response = await fetch(script.src);
-        if (!response.ok) {
-          console.error(`Rip: failed to fetch ${script.src} (${response.status})`);
-          continue;
+  const sources = [];
+  // Step 1: Collect data-src URLs from the runtime script tag
+  const runtimeTag = document.querySelector('script[src$="rip.min.js"], script[src$="rip.js"]');
+  const dataSrc = runtimeTag?.getAttribute('data-src');
+  if (dataSrc) {
+    for (const url of dataSrc.trim().split(/\s+/)) {
+      if (url) sources.push({ url });
+    }
+  }
+  // Step 2: Collect all <script type="text/rip"> tags (inline and external)
+  for (const script of document.querySelectorAll('script[type="text/rip"]')) {
+    if (script.src) {
+      sources.push({ url: script.src });
+    } else {
+      const code = dedent(script.textContent);
+      if (code) sources.push({ code });
+    }
+  }
+  // Step 3: Fetch externals, compile all, execute in shared scope
+  if (sources.length > 0) {
+    await Promise.all(sources.map(async (s) => {
+      if (!s.url) return;
+      try {
+        const res = await fetch(s.url);
+        if (!res.ok) {
+          console.error(`Rip: failed to fetch ${s.url} (${res.status})`);
+          return;
         }
-        ripCode = await response.text();
-      } else {
-        ripCode = dedent(script.textContent);
+        s.code = await res.text();
+      } catch (e) {
+        console.error(`Rip: failed to fetch ${s.url}:`, e.message);
       }
+    }));
-      let jsCode;
+    const opts = { skipRuntimes: true, skipExports: true };
+    const compiled = [];
+    for (const s of sources) {
+      if (!s.code) continue;
       try {
-        jsCode = compileToJS(ripCode);
-      } catch (compileError) {
-        console.error('Rip compile error:', compileError.message);
-        console.error('Source:', ripCode);
-        continue;
+        compiled.push(compileToJS(s.code, opts));
+      } catch (e) {
+        console.error('Rip compile error:', e.message);
       }
+    }
-      // Execute as async to support await (importRip!, etc.)
-      await (0, eval)(`(async()=>{\n${jsCode}\n})()`);
+    if (compiled.length > 0) {
+      let js = compiled.join('\n');
-      script.setAttribute('data-rip-processed', 'true');
-    } catch (error) {
-      console.error('Rip runtime error:', error);
+      // Step 4: Append data-mount call inside the shared IIFE
+      const mount = runtimeTag?.getAttribute('data-mount');
+      if (mount) {
+        const target = runtimeTag.getAttribute('data-target') || 'body';
+        js += `\n${mount}.mount(${JSON.stringify(target)});`;
+      }
+      try {
+        await (0, eval)(`(async()=>{\n${js}\n})()`);
+      } catch (e) {
+        console.error('Rip runtime error:', e);
+      }
+    }
+  }
+  // Step 5: data-launch triggers launch() for server mode
+  const cfg = document.querySelector('script[data-launch]');
+  if (cfg && !globalThis.__ripLaunched) {
+    const ui = importRip.modules?.['app.rip'];
+    if (ui?.launch) {
+      const url = cfg.getAttribute('data-launch') || '';
+      const hash = cfg.getAttribute('data-hash');
+      const persist = cfg.getAttribute('data-persist');
+      const opts = { hash: hash !== 'false' };
+      if (url) opts.bundleUrl = url;
+      if (persist != null) opts.persist = persist === 'local' ? 'local' : true;
+      await ui.launch('', opts);
     }
   }
 }
@@ -134,28 +179,12 @@ if (typeof globalThis !== 'undefined') {
   globalThis.__ripExports = { compile, compileToJS, formatSExpr, getStdlibCode, VERSION, BUILD_DATE, getReactiveRuntime, getComponentRuntime };
 }
-// Auto-launch: requires data-url or inline data-name scripts.
-// data-url is the literal fetch URL for the component bundle.
-async function autoLaunch() {
-  if (globalThis.__ripLaunched) return;
-  const ui = importRip.modules?.['app.rip'];
-  if (!ui?.launch) return;
-  const cfg = document.querySelector('script[data-url], script[data-hash]');
-  const tag = document.querySelectorAll('script[type="text/rip"][data-name]').length > 0;
-  if (!cfg && !tag) return;
-  const url = cfg?.getAttribute('data-url') || '';
-  const hash = cfg?.getAttribute('data-hash');
-  const opts = { hash: hash !== 'false' };
-  if (url) opts.bundleUrl = url;
-  await ui.launch('', opts);
-}
-// Auto-process <script type="text/rip"> blocks, then auto-launch if applicable.
+// Auto-process <script type="text/rip"> blocks and handle data-launch.
 // Deferred via queueMicrotask so bundled entry code (e.g. rip.min.js registering
 // importRip.modules) runs before script processing begins.
 if (typeof document !== 'undefined') {
   globalThis.__ripScriptsReady = new Promise(resolve => {
-    const run = () => processRipScripts().then(autoLaunch).then(resolve);
+    const run = () => processRipScripts().then(resolve);
     if (document.readyState === 'loading') {
       document.addEventListener('DOMContentLoaded', () => queueMicrotask(run));
     } else {

package/src/compiler.js CHANGED Viewed

@@ -636,6 +636,7 @@ export class CodeGenerator {
     }
     let skip = this.options.skipPreamble;
+    let skipRT = this.options.skipRuntimes;
     if (!skip) {
@@ -645,10 +646,12 @@ export class CodeGenerator {
       needsBlank = true;
       // On-demand helpers — only emitted when referenced
-      if (this.helpers.has('slice'      )) { code += 'const slice = [].slice;\n'; needsBlank = true; }
-      if (this.helpers.has('modulo'     )) { code += 'const modulo = (n, d) => { n = +n; d = +d; return (n % d + d) % d; };\n'; needsBlank = true; }
+      // Use var when skipRuntimes is set so helpers can be safely re-emitted across concatenated files
+      let helperDecl = skipRT ? 'var' : 'const';
+      if (this.helpers.has('slice'      )) { code += `${helperDecl} slice = [].slice;\n`; needsBlank = true; }
+      if (this.helpers.has('modulo'     )) { code += `${helperDecl} modulo = (n, d) => { n = +n; d = +d; return (n % d + d) % d; };\n`; needsBlank = true; }
       if (this.helpers.has('toMatchable')) {
-        code += 'const toMatchable = (v, allowNewlines) => {\n';
+        code += `${helperDecl} toMatchable = (v, allowNewlines) => {\n`;
         code += '  if (typeof v === "string") return !allowNewlines && /[\\n\\r]/.test(v) ? null : v;\n';
         code += '  if (v == null) return "";\n';
         code += '  if (typeof v === "number" || typeof v === "bigint" || typeof v === "boolean") return String(v);\n';
@@ -673,7 +676,9 @@ export class CodeGenerator {
     }
     if (this.usesReactivity && !skip) {
-      if (typeof globalThis !== 'undefined' && globalThis.__rip) {
+      if (skipRT) {
+        code += 'var { __state, __computed, __effect, __batch, __readonly, __setErrorHandler, __handleError, __catchErrors } = globalThis.__rip;\n';
+      } else if (typeof globalThis !== 'undefined' && globalThis.__rip) {
         code += 'const { __state, __computed, __effect, __batch, __readonly, __setErrorHandler, __handleError, __catchErrors } = globalThis.__rip;\n';
       } else {
         code += this.getReactiveRuntime();
@@ -682,7 +687,9 @@ export class CodeGenerator {
     }
     if (this.usesTemplates && !skip) {
-      if (typeof globalThis !== 'undefined' && globalThis.__ripComponent) {
+      if (skipRT) {
+        code += 'var { __pushComponent, __popComponent, setContext, getContext, hasContext, __clsx, __Component } = globalThis.__ripComponent;\n';
+      } else if (typeof globalThis !== 'undefined' && globalThis.__ripComponent) {
         code += 'const { __pushComponent, __popComponent, setContext, getContext, hasContext, __clsx, __Component } = globalThis.__ripComponent;\n';
       } else {
         code += this.getComponentRuntime();
@@ -1601,6 +1608,8 @@ export class CodeGenerator {
     if (rest.length === 3) tryCode += ' finally ' + this.generate(rest[2], 'statement');
+    if (rest.length === 1) tryCode += ' catch {}';
     if (needsReturns) {
       let isAsync = this.containsAwait(rest[0]) || (rest[1] && this.containsAwait(rest[1]));
       return `(${isAsync ? 'async ' : ''}() => { ${tryCode} })()`;
@@ -2024,6 +2033,11 @@ export class CodeGenerator {
   generateExport(head, rest) {
     let [decl] = rest;
+    if (this.options.skipExports) {
+      if (Array.isArray(decl) && decl.every(i => typeof i === 'string')) return '';
+      if (this.is(decl, '=')) return `const ${decl[1]} = ${this.generate(decl[2], 'value')}`;
+      return this.generate(decl, 'statement');
+    }
     if (Array.isArray(decl) && decl.every(i => typeof i === 'string')) return `export { ${decl.join(', ')} }`;
     if (this.is(decl, '=')) return `export const ${decl[1]} = ${this.generate(decl[2], 'value')}`;
     return `export ${this.generate(decl, 'statement')}`;
@@ -2031,6 +2045,10 @@ export class CodeGenerator {
   generateExportDefault(head, rest) {
     let [expr] = rest;
+    if (this.options.skipExports) {
+      if (this.is(expr, '=')) return `const ${expr[1]} = ${this.generate(expr[2], 'value')}`;
+      return this.generate(expr, 'statement');
+    }
     if (this.is(expr, '=')) {
       return `const ${expr[1]} = ${this.generate(expr[2], 'value')};\nexport default ${expr[1]}`;
     }
@@ -2038,10 +2056,12 @@ export class CodeGenerator {
   }
   generateExportAll(head, rest) {
+    if (this.options.skipExports) return '';
     return `export * from ${this.addJsExtensionAndAssertions(rest[0])}`;
   }
   generateExportFrom(head, rest) {
+    if (this.options.skipExports) return '';
     let [specifiers, source] = rest;
     let fixedSource = this.addJsExtensionAndAssertions(source);
     if (Array.isArray(specifiers)) {
@@ -3226,6 +3246,8 @@ export class Compiler {
     let generator = new CodeGenerator({
       dataSection,
       skipPreamble: this.options.skipPreamble,
+      skipRuntimes: this.options.skipRuntimes,
+      skipExports: this.options.skipExports,
       reactiveVars: this.options.reactiveVars,
       sourceMap,
     });

package/src/components.js CHANGED Viewed

@@ -570,8 +570,8 @@ export function installComponentSupport(CodeGenerator, Lexer) {
     }
     // Dot access: transform the object but not the property name
-    if (sexpr[0] === '.') {
-      return ['.', this.transformComponentMembers(sexpr[1]), sexpr[2]];
+    if (sexpr[0] === '.' || sexpr[0] === '?.') {
+      return [sexpr[0], this.transformComponentMembers(sexpr[1]), sexpr[2]];
     }
     // Force thin arrows to fat arrows inside components to preserve this binding
@@ -1914,6 +1914,9 @@ class __Component {
       this._root.parentNode.removeChild(this._root);
     }
   }
+  static mount(target = 'body') {
+    return new this().mount(target);
+  }
 }
 // Register on globalThis for runtime deduplication

package/docs/WEB-ROADMAP.md DELETED Viewed

@@ -1,126 +0,0 @@
-# Rip UI — Roadmap
-## What's There
-### Core Reactive System
-- **Reactive primitives** — `:=` (state), `~=` (computed), `~>` (effects) as
-  language syntax. Fine-grained dependency tracking, batching, readonly (`=!`).
-- **`__Component` base class** — mount, unmount, context push/pop, constructor
-  lifecycle all handled in the runtime. Components just override `_init`.
-- **`__state` signal passthrough** — if a value is already a signal, `__state`
-  returns it as-is. No separate `isSignal` check needed.
-- **Fine-grained DOM** — `_create` builds real DOM nodes, `_setup` wires
-  reactive effects that update individual text nodes and attributes.
-- **Timing primitives** — `delay`, `debounce`, `throttle`, `hold` as small
-  user-space functions composing `:=` + `~>` + cleanup. No framework API.
-### Component Model
-- **Component composition** — PascalCase identifiers in render blocks
-  instantiate child components. `card.rip` → `Card`. App-scoped, lazy-compiled,
-  cached after first use. No imports needed.
-- **Reactive props** — parent passes `:=` signals directly to children.
-  Child's `__state` passthrough returns the signal as-is. Two-way binding.
-- **Readonly props** — `=!` for props that children can read but not write.
-- **Children blocks** — `Card title: "Hello" -> p "content"` passes children
-  as a DOM node via the `@children` slot. `#content` for layout slots.
-- **Unmount cascade** — parent tracks child instances in `_children`.
-  `unmount()` cascades depth-first.
-- **Conditional rendering** — `if`/`else` in render blocks with anchor-based
-  conditional DOM.
-- **List rendering** — `for item in items` with keyed reconciliation.
-- **Event handling** — `@click: method` binds to `this.method` correctly.
-- **CSS classes** — `div.counter.active` compiles to static className.
-  Dynamic classes via `__clsx(...)`.
-- **Context** — `setContext`/`getContext`/`hasContext` for sharing data
-  between ancestor and descendant components without prop drilling.
-- **Lifecycle hooks** — `mounted`, `unmounted` work. `beforeMount`,
-  `beforeUnmount` are recognized.
-### State & Routing
-- **Reactive stash** — shared reactive store with proxy-based access.
-- **File-based router** — URL-to-component mapping with params, guards,
-  layouts, `_navigating` signal, keep-alive component cache.
-- **Hash routing** — `launch '/app', hash: true` for static single-file
-  deployment. Uses `readUrl()`/`writeUrl()` helpers. Back/forward and
-  direct URL loading work correctly.
-- **State persistence** — `persist: true` enables debounced auto-save of
-  `app.data` to sessionStorage. `_writeVersion` signal + `beforeunload` safety.
-- **Error boundaries** — catch mount-time errors.
-### Infrastructure
-- **Component store** — in-memory `.rip` file storage with compilation cache
-  and file watchers for hot reload via SSE.
-- **`launch bundle:`** — inline all components as heredoc strings in a single
-  HTML file. Zero-server deployment. `docs/demo.html` is a 337-line example.
-- **Combined bundle** — `rip-ui.min.js` (~52KB Brotli) packages the compiler
-  and pre-compiled UI framework in one file. Eliminates the `ui.rip` fetch
-  and its runtime compilation. `importRip('ui.rip')` is intercepted and returns
-  the pre-compiled module instantly.
-- **Parallel loading** — Monaco Editor preloaded via `<link rel="preload">`,
-  compiler exports available instantly via `globalThis.__ripExports`. All
-  synchronous setup runs in parallel with the Monaco CDN fetch.
-- **FOUC prevention** — playground pages use `body { opacity: 0 }` with a
-  `body.ready` fade-in transition after full initialization.
-- **Runtime deduplication** — both runtimes register on `globalThis.__rip`
-  and `globalThis.__ripComponent`. Multiple compilations share one runtime.
-- **Smooth app launch** — container fades in after first mount + font load.
-- **Navigation anti-flicker** — `_navigating` uses `delay 100` to suppress
-  brief loading indicators.
----
-## Where Rip UI Wins
-1. **Simplicity of the reactive model.** Three operators, minimal complete set. No hooks rules, no dependency arrays, no `.value` papercuts.
-2. **Zero-build development.** No other framework runs entirely in the browser with zero build tooling.
-3. **Timing primitives from composition.** `delay`, `debounce`, `throttle`, `hold` prove architectural correctness — hard problems dissolve into small functions.
-4. **Effect cleanup design.** Returning a function from an effect for cleanup is the cleanest pattern across all frameworks.
-5. **Syntax over API.** `:=` beats `ref()`. `~=` beats `computed()`. `~>` beats `watchEffect()`. Less ceremony, same power.
-6. **Static deployment.** Hash routing + `launch bundle:` = full SPA in a single HTML file on any static host.
-## Where Others Win
-1. **Ecosystem.** Zero component libraries, zero third-party integrations, zero community packages.
-2. **SSR.** No server-side rendering means no SEO, no progressive enhancement.
-3. **Performance proof.** No benchmarks, no published numbers.
-4. **TypeScript depth.** Framework exports have no `.d.ts` files.
-5. **Tooling.** No DevTools extension, no CLI scaffolding.
-6. **Battle-testing.** React serves billions. We serve a demo app.
----
-## The Path Forward
-### Must-have (blocks adoption)
-1. Named slots — multiple content projection points (header, body, footer)
-2. Framework `.d.ts` files — TypeScript definitions for all exports
-### Should-have (competitive parity)
-3. AOT compilation path — component-level ahead-of-time for production (framework AOT done in v0.3.2)
-4. SSR — server rendering for SEO
-5. js-framework-benchmark — published performance numbers
-6. Keyed list reconciliation — optimized array diffing for large datasets
-### Nice-to-have (ecosystem growth)
-7. DevTools extension — visual component/state inspector
-8. `create-rip-app` CLI — project scaffolding
-9. Headless UI primitives — accessible dropdown, modal, dialog
-10. State-preserving HMR — keep reactive state during hot reload
-11. Scoped slots and teleport — advanced composition patterns
----
-## Known Caveats
-- **`getCompiled`/`setCompiled` cache modules, not JS strings.** Same source
-  at two paths = two cached modules. No deduplication across paths.
-- **Stash proxy missing `getOwnPropertyDescriptor` trap.** Works in practice
-  but could cause issues with `Object.keys`/spread in strict environments.
-- **Router regex recreated on every `buildRoutes` call.** Not a problem with
-  small route tables. Could optimize with fingerprint comparison.
-- **`router.current` creates a new object on every read.** A cached object
-  that updates inside batch would reduce garbage.
-- **REPL reactive state doesn't persist across `rip()` calls.** Each call is
-  a separate compilation. All reactive code must be in a single call.
-- **Hash routing and path routing are mutually exclusive.** Set once at
-  `launch` time. No runtime switching between modes.