gelang 0.1.0

package/python/pyeffic/widgets.py

@@ -0,0 +1,87 @@
+"""Widget DSL stubs.
+
+These exist so a UI Python file is valid and importable in pure Python (you can
+even render a text preview). pyeffic does NOT execute them at build time — it
+interprets the `build()` function's AST directly (see ui.py). But importing this
+module lets you run your UI file as plain Python for quick checking.
+
+The `style` parameter accepts a CSS-like string on ALL widgets:
+    Text("Hello", style="fontSize:20; bold:true; color:#2196F3")
+    Container(child=..., style="bg:#f0f0f0; radius:12; padding:16; border:1,#ccc")
+    Column([...], style="align:spaceBetween")
+
+Named shortcuts still work: style="headline", "title", "subtitle", "body".
+The same style dict emits to Flutter (now), Slint/Rust/C++ GUI (later) — one
+syntax, multiple native targets. See pyeffic/styling.py.
+"""
+from __future__ import annotations
+
+
+class Widget:
+    def __init__(self, **kwargs):
+        self.kwargs = kwargs
+
+    def __repr__(self):
+        return f"{type(self).__name__}({self.kwargs})"
+
+
+class Text(Widget):
+    def __init__(self, text: str = "", *, style: str = "body", state: str = ""):
+        super().__init__(text=text, style=style, state=state)
+
+
+class Column(Widget):
+    def __init__(self, children, *, align: str = "center"):
+        super().__init__(children=children, align=align)
+
+
+class Row(Widget):
+    def __init__(self, children, *, align: str = "center"):
+        super().__init__(children=children, align=align)
+
+
+class Container(Widget):
+    def __init__(self, child=None, *, padding: int = 8, color: str = ""):
+        super().__init__(child=child, padding=padding, color=color)
+
+
+class ElevatedButton(Widget):
+    def __init__(self, label: str = "", *, on_click=None, style: str = ""):
+        super().__init__(label=label, on_click=on_click, style=style)
+
+
+class SizedBox(Widget):
+    """Explicit spacing widget. height=N or width=N."""
+    def __init__(self, *, height: float = 0, width: float = 0, style: str = ""):
+        super().__init__(height=height, width=width, style=style)
+
+
+class Divider(Widget):
+    """A horizontal line separator."""
+    def __init__(self, *, style: str = ""):
+        super().__init__(style=style)
+
+
+class Expanded(Widget):
+    """Expands to fill available space in a Row/Column."""
+    def __init__(self, child=None, *, flex: int = 1, style: str = ""):
+        super().__init__(child=child, flex=flex, style=style)
+
+
+class Action:
+    """Declares a button handler: call an FFI function, store result in state.
+
+    on_click can be a single Action or a LIST of Actions (multi-action: one
+    button click triggers several FFI calls and updates several state fields).
+    """
+    def __init__(self, call: str, args, update: str = ""):
+        self.call = call
+        self.args = args
+        self.update = update
+
+    def __repr__(self):
+        return f"Action(call={self.call!r}, args={self.args!r}, update={self.update!r})"
+
+
+__all__ = ["Widget", "Text", "Column", "Row", "Container", "ElevatedButton",
+           "SizedBox", "Divider", "Expanded", "Action"]

package/scripts/README.md

@@ -0,0 +1,42 @@
+# scripts/
+
+Build, packaging, and release tooling. Nothing here is part of the compiler.
+
+| Script | Purpose |
+|---|---|
+| `build-npm.js` | Assemble the npm payload — copies `pyeffic/` into `python/` so the published tarball is self-contained. Runs automatically via `prepublishOnly`. |
+| `release.js` | Run every guard, assemble, pack, and print the publish commands. `--publish` publishes for real. |
+| `check-toolchains.py` | Toolchain report for CI. `--json`, `--require rust,cpp`. |
+| `build-binary.py` | PyInstaller standalone binary (optional distribution). |
+| `ge_entry.py` | Entry point for the standalone binary. |
+| `installer/` | Inno Setup script for the Windows installer. |
+
+## Usage
+
+```bash
+node scripts/build-npm.js            # assemble the payload
+node scripts/build-npm.js --check    # verify without writing
+node scripts/release.js              # dry run: all guards + pack
+node scripts/release.js --publish    # publish to npm (needs `npm login`)
+python scripts/check-toolchains.py --require rust,cpp
+```
+
+## The npm payload
+
+The compiler is Python, so the npm package ships the Python source and a
+Node shim runs it:
+
+```
+gelang-0.1.0.tgz
+  bin/ge.js            finds Python 3.10+, sets PYTHONPATH, spawns the CLI
+  python/pyeffic/      the compiler (generated by build-npm.js)
+  scripts/check-toolchains.py
+  README.md  LICENSE  CHANGELOG.md
+```
+
+`python/` is generated and gitignored. `prepublishOnly` rebuilds it, so the
+tarball can never ship stale compiler code.
+
+The shim deliberately does **not** pip-install anything: no network access at
+install time, no virtualenv to manage, and the compiler version is pinned to
+the npm version by construction.

package/scripts/check-toolchains.py

@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+"""Report available toolchains in a CI-friendly form.
+
+    python scripts/check-toolchains.py            human-readable, exit 0/1
+    python scripts/check-toolchains.py --json     machine-readable
+    python scripts/check-toolchains.py --require rust,cpp
+
+Exits non-zero only when a *required* backend is missing, so a CI matrix can
+install what it needs and fail fast otherwise.
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+
+from pyeffic.config import detect_compilers  # noqa: E402
+
+BACKENDS = ("rust", "cpp", "csharp", "zig", "go", "kotlin")
+
+
+def snapshot() -> dict:
+    info = detect_compilers()
+    paths = {
+        "rust": info.rustc,
+        "cpp": info.cpp,
+        "csharp": info.dotnet,
+        "zig": info.zig,
+        "go": info.go,
+        "kotlin": info.kotlinc,
+    }
+    return {
+        "python": f"{sys.version_info.major}.{sys.version_info.minor}."
+                  f"{sys.version_info.micro}",
+        "python_ok": sys.version_info >= (3, 10),
+        "backends": {name: bool(p) for name, p in paths.items()},
+        "paths": {name: (p or "") for name, p in paths.items()},
+        "versions": info.versions,
+    }
+
+
+def main(argv: list[str] | None = None) -> int:
+    p = argparse.ArgumentParser(description=__doc__)
+    p.add_argument("--json", action="store_true")
+    p.add_argument("--require", default="",
+                   help="comma-separated backends that must be present")
+    args = p.parse_args(argv)
+
+    snap = snapshot()
+    required = [b.strip() for b in args.require.split(",") if b.strip()]
+
+    if args.json:
+        snap["required"] = required
+        snap["missing_required"] = [b for b in required
+                                    if not snap["backends"].get(b)]
+        print(json.dumps(snap, indent=2))
+    else:
+        print(f"python {snap['python']}"
+              + ("" if snap["python_ok"] else "  (needs 3.10+)"))
+        for name in BACKENDS:
+            ok = snap["backends"][name]
+            mark = "OK" if ok else "--"
+            detail = snap["paths"][name] or "not found"
+            print(f"  [{mark}] {name:<8} {detail}")
+
+    problems = []
+    if not snap["python_ok"]:
+        problems.append("python >= 3.10 is required")
+    for name in required:
+        if not snap["backends"].get(name):
+            problems.append(f"required backend '{name}' is not installed")
+
+    if problems:
+        print()
+        for msg in problems:
+            print(f"error: {msg}", file=sys.stderr)
+        return 1
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())