Aaron Sinclair
635d466874
MAJOR ACHIEVEMENT: Full working reactive framework! ## What's Working ✅ Python → AST → Ritz IR → LLVM IR → WASM pipeline ✅ Reactive signals stored in WASM memory (@signal_name = global i32) ✅ Event handlers exported from WASM and callable from JS ✅ Clean runtime with RitzLoader and debug tools ✅ Two working examples: HelloWorld and HighFive counter ## Core Components ### Parser (ritz/parser.py) - Uses Python's ast module to parse components - Handles @component decorator, signals, event handlers - Supports yield, with statements, f-strings, augmented assignment (+=) - Clean syntax: from ritz.syntax import * ### LLVM IR Code Generator (ritz/llvm_codegen_signals.py) - Generates LLVM IR directly (not C!) - Signals as global variables in WASM memory - Exports getter/setter functions for each signal - Exports event handler functions for JS to call - UTF-8 string handling ### Build System (ritz/build.py) - Python → AST → IR → LLVM IR → clang --target=wasm32 → WASM - Saves intermediate .ll files for inspection - Debug symbols support (-g flag) ### Runtime (runtime/ritz-runtime.js) - RitzRuntime class: DOM bridge for WASM - RitzLoader class: Simplified component loading - Debug bar with Ctrl+` toggle - Signal updates trigger DOM updates ## Examples ### HelloWorld.py Simple static content - renders <p>Hello World</p> ### HighFive.py Reactive counter with: - Signal in WASM memory (high_fives = signal(0)) - Event handler (increment function) - DOM updates on signal change ## Test Coverage - 4 parser tests (all passing) - 4 LLVM codegen tests (all passing) - 4 signal parsing tests (all passing) - Code formatted with black and ruff ## Next Steps - <script type="text/ritz"> in-browser compilation - Better signal-to-DOM binding tracking - More complex examples (TodoMVC, forms, lists) - Playwright browser tests --- This is a genuinely innovative framework: write Python, compile to WASM, run with reactive signals in WASM memory. No virtual DOM, no transpilation, just compiled Python with fine-grained reactivity. 🎉 Python → WASM → Reactive UI is REAL!
48 lines
1.5 KiB
HTML
48 lines
1.5 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
<title>{{TITLE}} - Ritz Framework</title>
|
||
<link rel="stylesheet" href="../runtime/ritz-debug.css">
|
||
<link rel="stylesheet" href="{{COMPONENT}}.css">
|
||
</head>
|
||
<body>
|
||
<div id="app"></div>
|
||
<div id="ritz-debug" class="ritz-debug hidden">
|
||
<div class="debug-header">
|
||
<h3>🎭 Ritz Debug</h3>
|
||
<button onclick="ritzDebug.toggle()">×</button>
|
||
</div>
|
||
<div id="status" class="status">Loading...</div>
|
||
<div class="debug-content">
|
||
<div class="debug-section">
|
||
<h4>Pipeline</h4>
|
||
<pre>{{COMPONENT}}.py → AST → IR → LLVM → WASM</pre>
|
||
</div>
|
||
<div class="debug-section">
|
||
<h4>Commands</h4>
|
||
<pre>ritzRuntime.getLog()
|
||
ritzInstance.exports</pre>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<script src="../runtime/ritz-runtime.js"></script>
|
||
<script src="../runtime/ritz-debug.js"></script>
|
||
<script>
|
||
// Load component
|
||
const loader = new RitzLoader({
|
||
rootElement: document.getElementById('app'),
|
||
statusElement: document.getElementById('status'),
|
||
onLoad: (runtime, instance) => {
|
||
console.log('✅ Component loaded');
|
||
console.log('Debug: ritzRuntime, ritzInstance');
|
||
}
|
||
});
|
||
|
||
loader.load('{{COMPONENT}}.wasm', '{{COMPONENT}}');
|
||
</script>
|
||
</body>
|
||
</html>
|