feat: added a twist

backend/uframe/__init__.py

@@ -0,0 +1,74 @@
+"""µFrame — A DSL for rich terminal UIs rendered as ASCII and Micron.
+
+Public API:
+    compile(source, width=64) → CompileResult
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from uframe.errors import CompileWarning, UFrameError
+from uframe.parser import parse
+from uframe.measure import measure
+from uframe.layout import layout
+from uframe.paint import paint
+from uframe.borders import merge_borders
+from uframe.grid import CharGrid
+from uframe.emit_ascii import emit_ascii
+from uframe.emit_micron import emit_micron
+
+
+@dataclass
+class CompileResult:
+    """Result of compiling a .uf source."""
+    ascii: str = ""
+    micron: str = ""
+    warnings: list[CompileWarning] = field(default_factory=list)
+
+
+def compile(source: str, width: int = 64) -> CompileResult:
+    """Compile a µFrame .uf source string into ASCII and Micron output.
+
+    Args:
+        source: the .uf DSL source text
+        width: page width in characters (default 64)
+
+    Returns:
+        CompileResult with ascii, micron, and any warnings
+
+    Raises:
+        ParseError: if the source cannot be parsed
+        LayoutError: if layout constraints fail
+    """
+    warnings: list[CompileWarning] = []
+
+    # 1. Parse
+    page = parse(source)
+    if page.width == 64 and width != 64:
+        page.width = width
+
+    w = page.width
+
+    # 2. Measure
+    measure(page, w)
+
+    # 3. Layout
+    total_h = layout(page, 0, 0, w, page.pref_height + 100)
+
+    # 4. Create grid and paint
+    grid = CharGrid(w, max(total_h, 1))
+    paint(page, grid)
+
+    # 5. Merge borders
+    merge_borders(grid)
+
+    # 6. Emit
+    ascii_out = emit_ascii(grid)
+    micron_out = emit_micron(grid, page_title=page.title)
+
+    return CompileResult(
+        ascii=ascii_out,
+        micron=micron_out,
+        warnings=warnings,
+    )