jac-client 0.2.10__py3-none-any.whl → 0.2.12__py3-none-any.whl

jac_client/plugin/utils/impl/bun_installer.impl.jac

@@ -0,0 +1,99 @@
+"""Implementation of Bun installer utility."""
+
+"""Check if bun is available, add to PATH if needed, or prompt to install."""
+impl ensure_bun_available -> bool {
+    import os;
+    import shutil;
+    # Check if bun is already in PATH
+    if shutil.which("bun") {
+        return True;
+    }
+    # Check if bun exists at ~/.bun/bin but not in PATH
+    bun_bin = os.path.expanduser("~/.bun/bin");
+    bun_path = os.path.join(bun_bin, "bun");
+    if os.path.exists(bun_path) {
+        # Add to PATH for current process
+        current_path = os.environ.get("PATH", "");
+        os.environ["PATH"] = f"{bun_bin}:{current_path}";
+        return True;
+    }
+    # Bun not found - prompt to install
+    return prompt_install_bun();
+}
+
+"""Prompt user to install Bun and install if confirmed."""
+impl prompt_install_bun -> bool {
+    import os;
+    import subprocess;
+    import sys;
+    import shutil;
+    print("\n  ⚠ Bun is required but not installed.", file=sys.stderr);
+    print(
+        "  Bun is a fast JavaScript runtime used for package management and bundling.",
+        file=sys.stderr
+    );
+    print("  Learn more: https://bun.sh\n", file=sys.stderr);
+    try {
+        response = input("  Install Bun now? [Y/n]: ").strip().lower();
+    } except (EOFError, KeyboardInterrupt) {
+        print("", file=sys.stderr);
+        return False;
+    }
+    if response and response not in ('y', 'yes', '') {
+        return False;
+    }
+    print("\n  ⏳ Installing Bun...", flush=True);
+    try {
+        # Check if curl is available
+        subprocess.run(
+            ["curl", "--version"], capture_output=True, check=True, timeout=5
+        );
+
+        # Install Bun via official script
+        result = subprocess.run(
+            ["sh", "-c", "curl -fsSL https://bun.sh/install | bash"],
+            timeout=120,
+            check=False
+        );
+
+        if result.returncode == 0 {
+            print("  ✔ Bun installed successfully!", flush=True);
+            # Add Bun to PATH for current session
+            bun_bin = os.path.expanduser("~/.bun/bin");
+            if os.path.exists(bun_bin) {
+                current_path = os.environ.get("PATH", "");
+                os.environ["PATH"] = f"{bun_bin}:{current_path}";
+                # Verify installation
+                if shutil.which("bun") {
+                    verify = subprocess.run(
+                        ["bun", "--version"], capture_output=True, text=True
+                    );
+                    if verify.returncode == 0 {
+                        print(f"  ✔ Verified: Bun {verify.stdout.strip()}", flush=True);
+                        return True;
+                    }
+                }
+            }
+            print(
+                "  ⚠ Bun installed but may require terminal restart.", file=sys.stderr
+            );
+            print("  Run: source ~/.bashrc (or restart terminal)", file=sys.stderr);
+            return True;
+        } else {
+            print("  ✖ Bun installation failed.", file=sys.stderr);
+            return False;
+        }
+    } except subprocess.TimeoutExpired {
+        print("  ✖ Installation timed out.", file=sys.stderr);
+        return False;
+    } except FileNotFoundError {
+        print(
+            "  ✖ curl not found. Please install Bun manually: https://bun.sh",
+            file=sys.stderr
+        );
+        return False;
+    } except Exception as e {
+        print(f"  ✖ Installation failed: {e}", file=sys.stderr);
+        return False;
+    }
+}

jac_client/plugin/utils/impl/client_deps.impl.jac

@@ -0,0 +1,73 @@
+"""Implementation of client dependency checker utility."""
+
+"""Check if client npm dependencies are configured, prompt to install if missing."""
+impl ensure_client_deps(config_loader: object) -> bool {
+    package_config = config_loader.get_package_config();
+    dependencies = package_config.get('dependencies', {});
+    dev_dependencies = package_config.get('devDependencies', {});
+    # If either deps or devDeps has entries, assume configured
+    if dependencies or dev_dependencies {
+        return True;
+    }
+    # No deps configured — prompt the user
+    return prompt_install_client_deps(config_loader);
+}
+
+"""Prompt user to install default jac-client npm dependencies."""
+def prompt_install_client_deps(config_loader: object) -> bool {
+    import sys;
+    print("\n  ⚠ Client dependencies are not configured.", file=sys.stderr);
+    print(
+        "  jac-client requires npm packages (react, vite, etc.) to build client pages.",
+        file=sys.stderr
+    );
+    print("  These will be added to your jac.toml file.\n", file=sys.stderr);
+    try {
+        response = input("  Install default client dependencies now? [Y/n]: ").strip().lower();
+    } except (EOFError, KeyboardInterrupt) {
+        print("", file=sys.stderr);
+        return False;
+    }
+    if response and response not in ('y', 'yes', '') {
+        print(
+            "\n  To configure manually, add [dependencies.npm] to your jac.toml.",
+            file=sys.stderr
+        );
+        print(
+            "  Or create a new project with: jac create --use client\n",
+            file=sys.stderr
+        );
+        return False;
+    }
+    # Default runtime dependencies
+    default_deps: dict[str, str] = {
+        'react': '^18.2.0',
+        'react-dom': '^18.2.0',
+        'react-router-dom': '^6.22.0',
+        'react-error-boundary': '^5.0.0'
+    };
+    # Default build infrastructure dependencies
+    default_dev_deps: dict[str, str] = {
+        'vite': '^6.4.1',
+        '@vitejs/plugin-react': '^4.2.1',
+        'typescript': '^5.3.3',
+        '@types/react': '^18.2.0',
+        '@types/react-dom': '^18.2.0'
+    };
+    print("\n  ⏳ Adding default client dependencies to jac.toml...", flush=True);
+    try {
+        for (name, version) in default_deps.items() {
+            config_loader.add_dependency(name, version, is_dev=False);
+        }
+        for (name, version) in default_dev_deps.items() {
+            config_loader.add_dependency(name, version, is_dev=True);
+        }
+        config_loader.save();
+        config_loader.invalidate();
+        print("  ✔ Default client dependencies added to jac.toml\n", flush=True);
+        return True;
+    } except Exception as e {
+        print(f"  ✖ Failed to add dependencies: {e}", file=sys.stderr);
+        return False;
+    }
+}

jac_client/templates/client.jacpack

@@ -33,10 +33,6 @@
     "assets",
     ".jac/client"
   ],
-  "gitignore_entries": [
-    "# Ignore all build artifacts in .jac directory",
-    "*"
-  ],
   "root_gitignore_entries": [
     "# Jac project",
     "packages/",

jac_client/templates/fullstack.jacpack

@@ -26,7 +26,7 @@
   "files": {
     "main.jac": "\"\"\"{{name}} - Entry Point.\n\nCombines server-side endpoints with client-side UI.\n\"\"\"\n\n# Import server-side data models and walkers\nsv {\n    import from endpoints { Todo, AddTodo, ListTodos, ToggleTodo, DeleteTodo }\n}\n\n# Client-side UI\ncl {\n    import from .frontend { app as ClientApp }\n\n    def:pub app -> any {\n        return\n            <ClientApp />;\n    }\n}\n",
     "endpoints.sv.jac": "\"\"\"Todo App - Server-Side Data Layer.\n\nEach user gets their own todo list automatically!\nWhen authenticated, `root spawn` uses the user's personal root node.\n\"\"\"\n\n# ========================================\n# Data Models\n# ========================================\nnode Todo {\n    has id: str,\n        title: str,\n        completed: bool = False;\n}\n\nglob todo_counter: int = 0;\n\n# ========================================\n# Walkers (API Operations)\n# ========================================\nwalker:priv AddTodo {\n    \"\"\"Add a new todo item to the user's list.\"\"\"\n    has title: str;\n\n    can create with `root entry {\n        global todo_counter;\n        todo_counter += 1;\n        new_id = \"todo_\" + str(todo_counter);\n        new_todo = here ++> Todo(id=new_id, title=self.title, completed=False);\n        if new_todo {\n            report new_todo[0] ;\n        }\n    }\n}\n\nwalker:priv ListTodos {\n    \"\"\"List all todo items for the current user.\"\"\"\n    has todos: list = [];\n\n    can collect with `root entry {\n        visit [-->];\n    }\n\n    can gather with Todo entry {\n        self.todos.append(\n            {\"id\": here.id, \"title\": here.title, \"completed\": here.completed}\n        );\n    }\n\n    can report_all with `root exit {\n        report self.todos ;\n    }\n}\n\nwalker:priv ToggleTodo {\n    \"\"\"Toggle a todo's completed status.\"\"\"\n    has todo_id: str;\n\n    can search with `root entry {\n        visit [-->];\n    }\n\n    can toggle with Todo entry {\n        if here.id == self.todo_id {\n            here.completed = not here.completed;\n            report {\"id\": here.id, \"completed\": here.completed} ;\n        }\n    }\n}\n\nwalker:priv DeleteTodo {\n    \"\"\"Delete a todo item.\"\"\"\n    has todo_id: str;\n\n    can search with `root entry {\n        visit [-->];\n    }\n\n    can delete with Todo entry {\n        if here.id == self.todo_id {\n            del here ;\n            report {\"deleted\": self.todo_id} ;\n        }\n    }\n}\n",
-    "frontend.cl.jac": "\"\"\"Todo App - Client-Side UI.\"\"\"\n\nimport from react { useEffect }\nimport from \"@jac-client/utils\" { jacSignup, jacLogin, jacLogout, jacIsLoggedIn }\n\nimport from .components.TodoItem { TodoItem }\nimport from .components.AuthForm { AuthForm }\n\nsv import from endpoints { AddTodo, ListTodos, ToggleTodo, DeleteTodo }\n\ndef:pub app -> any {\n    has isLoggedIn: bool = False,\n        checkingAuth: bool = True,\n        isSignup: bool = False,\n        username: str = \"\",\n        password: str = \"\",\n        error: str = \"\",\n        loading: bool = False,\n        todos: list = [],\n        newTodoText: str = \"\",\n        todosLoading: bool = True;\n\n    # Check login status on mount\n    useEffect(lambda -> None { isLoggedIn = jacIsLoggedIn();checkingAuth = False;}, []);\n\n    # Load todos when logged in\n    useEffect(\n        lambda -> None { if isLoggedIn {\n            fetchTodos();\n        }},\n        [isLoggedIn]\n    );\n\n    # Fetch todos from server\n    async def fetchTodos -> None {\n        todosLoading = True;\n        result = root spawn ListTodos();\n        todos = result.reports[0] if result.reports else [];\n        todosLoading = False;\n    }\n\n    # Add a new todo\n    async def addTodo -> None {\n        if not newTodoText.trim() {\n            return;\n        }\n        response = root spawn AddTodo(title=newTodoText);\n        newTodo = response.reports[0];\n        todos = todos.concat(\n            [\n                {\n                    \"id\": newTodo.id,\n                    \"title\": newTodo.title,\n                    \"completed\": newTodo.completed\n                }\n            ]\n        );\n        newTodoText = \"\";\n    }\n\n    # Toggle todo completion\n    async def toggleTodo(todoId: str) -> None {\n        root spawn ToggleTodo(todo_id=todoId);\n        todos = todos.map(\n            lambda t: any  -> any { if t.id == todoId {\n                return {\"id\": t.id, \"title\": t.title, \"completed\": not t.completed};\n            }return t; }\n        );\n    }\n\n    # Delete a todo\n    async def deleteTodo(todoId: str) -> None {\n        root spawn DeleteTodo(todo_id=todoId);\n        todos = todos.filter(lambda t: any  -> bool { return t.id != todoId; });\n    }\n\n    # Handle login\n    async def handleLogin -> None {\n        error = \"\";\n        if not username.trim() or not password {\n            error = \"Please fill in all fields\";\n            return;\n        }\n        loading = True;\n        success = await jacLogin(username, password);\n        loading = False;\n        if success {\n            isLoggedIn = True;\n            username = \"\";\n            password = \"\";\n        } else {\n            error = \"Invalid username or password\";\n        }\n    }\n\n    # Handle signup\n    async def handleSignup -> None {\n        error = \"\";\n        if not username.trim() or not password {\n            error = \"Please fill in all fields\";\n            return;\n        }\n        if password.length < 4 {\n            error = \"Password must be at least 4 characters\";\n            return;\n        }\n        loading = True;\n        result = await jacSignup(username, password);\n        loading = False;\n        if result[\"success\"] {\n            isLoggedIn = True;\n            username = \"\";\n            password = \"\";\n        } else {\n            error = result[\"error\"] if result[\"error\"] else \"Signup failed\";\n        }\n    }\n\n    # Handle logout\n    def handleLogout -> None {\n        jacLogout();\n        isLoggedIn = False;\n        todos = [];\n        username = \"\";\n        password = \"\";\n        error = \"\";\n    }\n\n    # Handle form submit\n    async def handleSubmit(e: any) -> None {\n        e.preventDefault();\n        if isSignup {\n            await handleSignup();\n        } else {\n            await handleLogin();\n        }\n    }\n\n    # Handle enter key for todo input\n    def handleTodoKeyPress(e: any) -> None {\n        if e.key == \"Enter\" {\n            addTodo();\n        }\n    }\n\n    # Loading screen\n    if checkingAuth {\n        return\n            <div\n                style={{\n                    \"display\": \"flex\",\n                    \"justifyContent\": \"center\",\n                    \"alignItems\": \"center\",\n                    \"height\": \"100vh\",\n                    \"fontFamily\": \"system-ui, -apple-system, sans-serif\",\n                    \"color\": \"#666\"\n                }}\n            >\n                Loading...\n            </div>;\n    }\n\n    # Logged in - Show Todo List\n    if isLoggedIn {\n        return\n            <div\n                style={{\n                    \"maxWidth\": \"600px\",\n                    \"margin\": \"2rem auto\",\n                    \"padding\": \"2rem\",\n                    \"fontFamily\": \"system-ui, -apple-system, sans-serif\"\n                }}\n            >\n                <div\n                    style={{\n                        \"display\": \"flex\",\n                        \"justifyContent\": \"space-between\",\n                        \"alignItems\": \"center\",\n                        \"marginBottom\": \"1.5rem\"\n                    }}\n                >\n                    <h1 style={{\"margin\": \"0\", \"color\": \"#1a1a2e\"}}>\n                        My Todos\n                    </h1>\n                    <button\n                        onClick={handleLogout}\n                        style={{\n                            \"padding\": \"0.5rem 1rem\",\n                            \"fontSize\": \"0.9rem\",\n                            \"backgroundColor\": \"#f8f9fa\",\n                            \"color\": \"#666\",\n                            \"border\": \"1px solid #ddd\",\n                            \"borderRadius\": \"6px\",\n                            \"cursor\": \"pointer\"\n                        }}\n                    >\n                        Log Out\n                    </button>\n                </div>\n                <div\n                    style={{\n                        \"display\": \"flex\",\n                        \"gap\": \"0.5rem\",\n                        \"marginBottom\": \"1.5rem\"\n                    }}\n                >\n                    <input\n                        type=\"text\"\n                        value={newTodoText}\n                        onChange={lambda e: any  -> None { newTodoText = e.target.value;}}\n                        onKeyPress={handleTodoKeyPress}\n                        placeholder=\"What needs to be done?\"\n                        style={{\n                            \"flex\": \"1\",\n                            \"padding\": \"0.75rem 1rem\",\n                            \"fontSize\": \"1rem\",\n                            \"border\": \"2px solid #e0e0e0\",\n                            \"borderRadius\": \"8px\",\n                            \"outline\": \"none\"\n                        }}\n                    />\n                    <button\n                        onClick={lambda -> None { addTodo();}}\n                        style={{\n                            \"padding\": \"0.75rem 1.5rem\",\n                            \"fontSize\": \"1rem\",\n                            \"backgroundColor\": \"#4CAF50\",\n                            \"color\": \"white\",\n                            \"border\": \"none\",\n                            \"borderRadius\": \"8px\",\n                            \"cursor\": \"pointer\"\n                        }}\n                    >\n                        Add\n                    </button>\n                </div>\n                {(\n                    <div style={{\"color\": \"#666\", \"textAlign\": \"center\"}}>\n                        Loading todos...\n                    </div>\n                )\n                if todosLoading\n                else None}\n                {(\n                    <div>\n                        {(\n                            <p\n                                style={{\n                                    \"color\": \"#888\",\n                                    \"textAlign\": \"center\",\n                                    \"padding\": \"2rem\"\n                                }}\n                            >\n                                No todos yet. Add one above!\n                            </p>\n                        )\n                        if todos.length == 0\n                        else None}{todos.map(\n                            lambda todo: any  -> any { return\n                                <TodoItem\n                                    key={todo.id}\n                                    todo={todo}\n                                    onToggle={toggleTodo}\n                                    onDelete={deleteTodo}\n                                />; }\n                        )}\n                    </div>\n                )\n                if not todosLoading\n                else None}\n                <div\n                    style={{\n                        \"marginTop\": \"2rem\",\n                        \"paddingTop\": \"1rem\",\n                        \"borderTop\": \"1px solid #eee\",\n                        \"color\": \"#888\",\n                        \"fontSize\": \"0.9rem\"\n                    }}\n                >\n                    {todos.filter(lambda t: any  -> bool { return not t.completed; }).length} items left\n                </div>\n            </div>;\n    }\n\n    # Not logged in - Show Auth Form\n    return\n        <AuthForm\n            isSignup={isSignup}\n            username={username}\n            password={password}\n            error={error}\n            loading={loading}\n            onUsernameChange={lambda e: any  -> None { username = e.target.value;}}\n            onPasswordChange={lambda e: any  -> None { password = e.target.value;}}\n            onSubmit={handleSubmit}\n            onToggleMode={lambda -> None { isSignup = not isSignup;error = \"\";}}\n        />;\n}\n",
+    "frontend.cl.jac": "\"\"\"Todo App - Client-Side UI.\"\"\"\n\nimport from react { useEffect }\nimport from \"@jac/runtime\" { jacSignup, jacLogin, jacLogout, jacIsLoggedIn }\n\nimport from .components.TodoItem { TodoItem }\nimport from .components.AuthForm { AuthForm }\n\nsv import from endpoints { AddTodo, ListTodos, ToggleTodo, DeleteTodo }\n\ndef:pub app -> any {\n    has isLoggedIn: bool = False,\n        checkingAuth: bool = True,\n        isSignup: bool = False,\n        username: str = \"\",\n        password: str = \"\",\n        error: str = \"\",\n        loading: bool = False,\n        todos: list = [],\n        newTodoText: str = \"\",\n        todosLoading: bool = True;\n\n    # Check login status on mount\n    useEffect(lambda -> None { isLoggedIn = jacIsLoggedIn();checkingAuth = False;}, []);\n\n    # Load todos when logged in\n    useEffect(\n        lambda -> None { if isLoggedIn {\n            fetchTodos();\n        }},\n        [isLoggedIn]\n    );\n\n    # Fetch todos from server\n    async def fetchTodos -> None {\n        todosLoading = True;\n        result = root spawn ListTodos();\n        todos = result.reports[0] if result.reports else [];\n        todosLoading = False;\n    }\n\n    # Add a new todo\n    async def addTodo -> None {\n        if not newTodoText.trim() {\n            return;\n        }\n        response = root spawn AddTodo(title=newTodoText);\n        newTodo = response.reports[0];\n        todos = todos.concat(\n            [\n                {\n                    \"id\": newTodo.id,\n                    \"title\": newTodo.title,\n                    \"completed\": newTodo.completed\n                }\n            ]\n        );\n        newTodoText = \"\";\n    }\n\n    # Toggle todo completion\n    async def toggleTodo(todoId: str) -> None {\n        root spawn ToggleTodo(todo_id=todoId);\n        todos = todos.map(\n            lambda t: any  -> any { if t.id == todoId {\n                return {\"id\": t.id, \"title\": t.title, \"completed\": not t.completed};\n            }return t; }\n        );\n    }\n\n    # Delete a todo\n    async def deleteTodo(todoId: str) -> None {\n        root spawn DeleteTodo(todo_id=todoId);\n        todos = todos.filter(lambda t: any  -> bool { return t.id != todoId; });\n    }\n\n    # Handle login\n    async def handleLogin -> None {\n        error = \"\";\n        if not username.trim() or not password {\n            error = \"Please fill in all fields\";\n            return;\n        }\n        loading = True;\n        success = await jacLogin(username, password);\n        loading = False;\n        if success {\n            isLoggedIn = True;\n            username = \"\";\n            password = \"\";\n        } else {\n            error = \"Invalid username or password\";\n        }\n    }\n\n    # Handle signup\n    async def handleSignup -> None {\n        error = \"\";\n        if not username.trim() or not password {\n            error = \"Please fill in all fields\";\n            return;\n        }\n        if password.length < 4 {\n            error = \"Password must be at least 4 characters\";\n            return;\n        }\n        loading = True;\n        result = await jacSignup(username, password);\n        loading = False;\n        if result[\"success\"] {\n            isLoggedIn = True;\n            username = \"\";\n            password = \"\";\n        } else {\n            error = result[\"error\"] if result[\"error\"] else \"Signup failed\";\n        }\n    }\n\n    # Handle logout\n    def handleLogout -> None {\n        jacLogout();\n        isLoggedIn = False;\n        todos = [];\n        username = \"\";\n        password = \"\";\n        error = \"\";\n    }\n\n    # Handle form submit\n    async def handleSubmit(e: any) -> None {\n        e.preventDefault();\n        if isSignup {\n            await handleSignup();\n        } else {\n            await handleLogin();\n        }\n    }\n\n    # Handle enter key for todo input\n    def handleTodoKeyPress(e: any) -> None {\n        if e.key == \"Enter\" {\n            addTodo();\n        }\n    }\n\n    # Loading screen\n    if checkingAuth {\n        return\n            <div\n                style={{\n                    \"display\": \"flex\",\n                    \"justifyContent\": \"center\",\n                    \"alignItems\": \"center\",\n                    \"height\": \"100vh\",\n                    \"fontFamily\": \"system-ui, -apple-system, sans-serif\",\n                    \"color\": \"#666\"\n                }}\n            >\n                Loading...\n            </div>;\n    }\n\n    # Logged in - Show Todo List\n    if isLoggedIn {\n        return\n            <div\n                style={{\n                    \"maxWidth\": \"600px\",\n                    \"margin\": \"2rem auto\",\n                    \"padding\": \"2rem\",\n                    \"fontFamily\": \"system-ui, -apple-system, sans-serif\"\n                }}\n            >\n                <div\n                    style={{\n                        \"display\": \"flex\",\n                        \"justifyContent\": \"space-between\",\n                        \"alignItems\": \"center\",\n                        \"marginBottom\": \"1.5rem\"\n                    }}\n                >\n                    <h1 style={{\"margin\": \"0\", \"color\": \"#1a1a2e\"}}>\n                        My Todos\n                    </h1>\n                    <button\n                        onClick={handleLogout}\n                        style={{\n                            \"padding\": \"0.5rem 1rem\",\n                            \"fontSize\": \"0.9rem\",\n                            \"backgroundColor\": \"#f8f9fa\",\n                            \"color\": \"#666\",\n                            \"border\": \"1px solid #ddd\",\n                            \"borderRadius\": \"6px\",\n                            \"cursor\": \"pointer\"\n                        }}\n                    >\n                        Log Out\n                    </button>\n                </div>\n                <div\n                    style={{\n                        \"display\": \"flex\",\n                        \"gap\": \"0.5rem\",\n                        \"marginBottom\": \"1.5rem\"\n                    }}\n                >\n                    <input\n                        type=\"text\"\n                        value={newTodoText}\n                        onChange={lambda e: any  -> None { newTodoText = e.target.value;}}\n                        onKeyPress={handleTodoKeyPress}\n                        placeholder=\"What needs to be done?\"\n                        style={{\n                            \"flex\": \"1\",\n                            \"padding\": \"0.75rem 1rem\",\n                            \"fontSize\": \"1rem\",\n                            \"border\": \"2px solid #e0e0e0\",\n                            \"borderRadius\": \"8px\",\n                            \"outline\": \"none\"\n                        }}\n                    />\n                    <button\n                        onClick={lambda -> None { addTodo();}}\n                        style={{\n                            \"padding\": \"0.75rem 1.5rem\",\n                            \"fontSize\": \"1rem\",\n                            \"backgroundColor\": \"#4CAF50\",\n                            \"color\": \"white\",\n                            \"border\": \"none\",\n                            \"borderRadius\": \"8px\",\n                            \"cursor\": \"pointer\"\n                        }}\n                    >\n                        Add\n                    </button>\n                </div>\n                {(\n                    <div style={{\"color\": \"#666\", \"textAlign\": \"center\"}}>\n                        Loading todos...\n                    </div>\n                )\n                if todosLoading\n                else None}\n                {(\n                    <div>\n                        {(\n                            <p\n                                style={{\n                                    \"color\": \"#888\",\n                                    \"textAlign\": \"center\",\n                                    \"padding\": \"2rem\"\n                                }}\n                            >\n                                No todos yet. Add one above!\n                            </p>\n                        )\n                        if todos.length == 0\n                        else None}{todos.map(\n                            lambda todo: any  -> any { return\n                                <TodoItem\n                                    key={todo.id}\n                                    todo={todo}\n                                    onToggle={toggleTodo}\n                                    onDelete={deleteTodo}\n                                />; }\n                        )}\n                    </div>\n                )\n                if not todosLoading\n                else None}\n                <div\n                    style={{\n                        \"marginTop\": \"2rem\",\n                        \"paddingTop\": \"1rem\",\n                        \"borderTop\": \"1px solid #eee\",\n                        \"color\": \"#888\",\n                        \"fontSize\": \"0.9rem\"\n                    }}\n                >\n                    {todos.filter(lambda t: any  -> bool { return not t.completed; }).length} items left\n                </div>\n            </div>;\n    }\n\n    # Not logged in - Show Auth Form\n    return\n        <AuthForm\n            isSignup={isSignup}\n            username={username}\n            password={password}\n            error={error}\n            loading={loading}\n            onUsernameChange={lambda e: any  -> None { username = e.target.value;}}\n            onPasswordChange={lambda e: any  -> None { password = e.target.value;}}\n            onSubmit={handleSubmit}\n            onToggleMode={lambda -> None { isSignup = not isSignup;error = \"\";}}\n        />;\n}\n",
     "components/AuthForm.cl.jac": "\"\"\"Authentication form component for login/signup.\"\"\"\n\ndef:pub AuthForm(\n    isSignup: bool,\n    username: str,\n    password: str,\n    error: str,\n    loading: bool,\n    onUsernameChange: any,\n    onPasswordChange: any,\n    onSubmit: any,\n    onToggleMode: any\n) -> any {\n    return\n        <div\n            style={{\n                \"maxWidth\": \"400px\",\n                \"margin\": \"4rem auto\",\n                \"padding\": \"2rem\",\n                \"fontFamily\": \"system-ui, -apple-system, sans-serif\",\n                \"backgroundColor\": \"#fff\",\n                \"borderRadius\": \"12px\",\n                \"boxShadow\": \"0 4px 6px rgba(0,0,0,0.1)\"\n            }}\n        >\n            <h1\n                style={{\n                    \"marginBottom\": \"0.5rem\",\n                    \"color\": \"#1a1a2e\",\n                    \"textAlign\": \"center\"\n                }}\n            >\n                Jac Todo App\n            </h1>\n            <p\n                style={{\n                    \"marginBottom\": \"1.5rem\",\n                    \"color\": \"#666\",\n                    \"textAlign\": \"center\"\n                }}\n            >\n                {(\"Create an account\" if isSignup else \"Sign in to your account\")}\n            </p>\n            {(\n                <div\n                    style={{\n                        \"padding\": \"0.75rem\",\n                        \"marginBottom\": \"1rem\",\n                        \"backgroundColor\": \"#fee\",\n                        \"color\": \"#c00\",\n                        \"borderRadius\": \"6px\",\n                        \"fontSize\": \"0.9rem\"\n                    }}\n                >\n                    {error}\n                </div>\n            )\n            if error\n            else None}\n            <form onSubmit={onSubmit}>\n                <input\n                    type=\"text\"\n                    value={username}\n                    onChange={onUsernameChange}\n                    placeholder=\"Username\"\n                    style={{\n                        \"width\": \"100%\",\n                        \"padding\": \"0.75rem 1rem\",\n                        \"marginBottom\": \"0.75rem\",\n                        \"fontSize\": \"1rem\",\n                        \"border\": \"2px solid #e0e0e0\",\n                        \"borderRadius\": \"8px\",\n                        \"outline\": \"none\",\n                        \"boxSizing\": \"border-box\"\n                    }}\n                />\n                <input\n                    type=\"password\"\n                    value={password}\n                    onChange={onPasswordChange}\n                    placeholder=\"Password\"\n                    style={{\n                        \"width\": \"100%\",\n                        \"padding\": \"0.75rem 1rem\",\n                        \"marginBottom\": \"1rem\",\n                        \"fontSize\": \"1rem\",\n                        \"border\": \"2px solid #e0e0e0\",\n                        \"borderRadius\": \"8px\",\n                        \"outline\": \"none\",\n                        \"boxSizing\": \"border-box\"\n                    }}\n                />\n                <button\n                    type=\"submit\"\n                    disabled={loading}\n                    style={{\n                        \"width\": \"100%\",\n                        \"padding\": \"0.75rem\",\n                        \"fontSize\": \"1rem\",\n                        \"backgroundColor\": (\"#999\" if loading else \"#4CAF50\"),\n                        \"color\": \"white\",\n                        \"border\": \"none\",\n                        \"borderRadius\": \"8px\",\n                        \"cursor\": (\"not-allowed\" if loading else \"pointer\"),\n                        \"marginBottom\": \"1rem\"\n                    }}\n                >\n                    {(\n                        (\n                            \"Processing...\"\n                            if loading\n                            else (\"Sign Up\" if isSignup else \"Log In\")\n                        )\n                    )}\n                </button>\n            </form>\n            <p style={{\"textAlign\": \"center\", \"color\": \"#666\", \"fontSize\": \"0.9rem\"}}>\n                {(\n                    \"Already have an account? \"\n                    if isSignup\n                    else \"Don't have an account? \"\n                )}\n                <span\n                    onClick={onToggleMode}\n                    style={{\n                        \"color\": \"#4CAF50\",\n                        \"cursor\": \"pointer\",\n                        \"fontWeight\": \"bold\"\n                    }}\n                >\n                    {(\"Log In\" if isSignup else \"Sign Up\")}\n                </span>\n            </p>\n        </div>;\n}\n",
     "components/TodoItem.cl.jac": "\"\"\"Todo item component for displaying a single todo.\"\"\"\n\ndef:pub TodoItem(todo: dict, onToggle: any, onDelete: any) -> any {\n    return\n        <div\n            key={todo.id}\n            style={{\n                \"display\": \"flex\",\n                \"alignItems\": \"center\",\n                \"gap\": \"0.75rem\",\n                \"padding\": \"1rem\",\n                \"marginBottom\": \"0.5rem\",\n                \"backgroundColor\": \"#f8f9fa\",\n                \"borderRadius\": \"8px\",\n                \"border\": \"1px solid #e9ecef\"\n            }}\n        >\n            <input\n                type=\"checkbox\"\n                checked={todo.completed}\n                onChange={lambda -> None { onToggle(todo.id);}}\n                style={{\"width\": \"20px\", \"height\": \"20px\", \"cursor\": \"pointer\"}}\n            />\n            <span\n                style={{\n                    \"flex\": \"1\",\n                    \"textDecoration\": (\"line-through\" if todo.completed else \"none\"),\n                    \"color\": (\"#888\" if todo.completed else \"#333\")\n                }}\n            >\n                {todo.title}\n            </span>\n            <button\n                onClick={lambda -> None { onDelete(todo.id);}}\n                style={{\n                    \"padding\": \"0.5rem\",\n                    \"backgroundColor\": \"transparent\",\n                    \"color\": \"#dc3545\",\n                    \"border\": \"none\",\n                    \"cursor\": \"pointer\",\n                    \"fontSize\": \"1.2rem\"\n                }}\n            >\n                x\n            </button>\n        </div>;\n}\n",
     "components/Button.cl.jac": "\"\"\"Button component for the Jac client application.\"\"\"\n\ndef:pub Button(\n    label: str, onClick: any, variant: str = \"primary\", disabled: bool = False\n) -> any {\n    base_styles = {\n        \"padding\": \"0.75rem 1.5rem\",\n        \"fontSize\": \"1rem\",\n        \"fontWeight\": \"600\",\n        \"borderRadius\": \"0.5rem\",\n        \"border\": \"none\",\n        \"cursor\": \"not-allowed\" if disabled else \"pointer\",\n        \"transition\": \"all 0.2s ease\"\n    };\n\n    variant_styles = {\n        \"primary\": {\n            \"backgroundColor\": \"#9ca3af\" if disabled else \"#3b82f6\",\n            \"color\": \"#ffffff\"\n        },\n        \"secondary\": {\n            \"backgroundColor\": \"#e5e7eb\" if disabled else \"#6b7280\",\n            \"color\": \"#ffffff\"\n        }\n    };\n\n    return\n        <button\n            style={{** base_styles, ** variant_styles[variant]}}\n            onClick={onClick}\n            disabled={disabled}\n        >\n            {label}\n        </button>;\n}\n",
@@ -36,10 +36,6 @@
     ".jac",
     "assets"
   ],
-  "gitignore_entries": [
-    "# Ignore all build artifacts in .jac directory",
-    "*"
-  ],
   "root_gitignore_entries": [
     "# Jac build artifacts",
     ".jac/",

jac_client/tests/conftest.py

@@ -1,9 +1,9 @@
 """Pytest configuration and shared fixtures for jac-client tests.
 
 This module provides session-scoped fixtures to optimize test execution by:
-1. Running npm install once per session and caching node_modules
+1. Running bun install once per session and caching node_modules
 2. Providing shared Vite build infrastructure
-3. Mocking npm install for tests that only need jac.toml manipulation
+3. Mocking bun install for tests that only need jac.toml manipulation
 """
 
 from __future__ import annotations
@@ -83,16 +83,15 @@ def _get_jac_command() -> list[str]:
     return [sys.executable, "-m", "jaclang"]
 
 
-def _get_env_with_npm() -> dict[str, str]:
-    """Get environment dict with npm in PATH."""
+def _get_env_with_bun() -> dict[str, str]:
+    """Get environment dict with bun in PATH."""
     env = os.environ.copy()
-    # npm might be installed via nvm, ensure PATH includes common locations
-    npm_path = shutil.which("npm")
-    if npm_path:
-        npm_dir = str(Path(npm_path).parent)
+    bun_path = shutil.which("bun")
+    if bun_path:
+        bun_dir = str(Path(bun_path).parent)
         current_path = env.get("PATH", "")
-        if npm_dir not in current_path:
-            env["PATH"] = f"{npm_dir}:{current_path}"
+        if bun_dir not in current_path:
+            env["PATH"] = f"{bun_dir}:{current_path}"
     return env
 
 
@@ -127,16 +126,16 @@ def reset_jac_machine(tmp_path: Path) -> Generator[None, None, None]:
     Jac.loaded_modules.clear()
 
 
-# Session-scoped cache for npm installation
-_npm_cache_dir: Path | None = None
+# Session-scoped cache for bun installation
+_bun_cache_dir: Path | None = None
 
 
 def _get_minimal_jac_toml() -> str:
-    """Get minimal jac.toml content for npm cache setup."""
+    """Get minimal jac.toml content for bun cache setup."""
     return """[project]
-name = "npm-cache"
+name = "bun-cache"
 version = "0.0.1"
-description = "Cached npm modules"
+description = "Cached bun modules"
 entry-point = "app.jac"
 
 [plugins.client.vite.build]
@@ -145,28 +144,28 @@ minify = false
 
 
 @pytest.fixture(scope="session")
-def npm_cache_dir() -> Generator[Path, None, None]:
-    """Session-scoped fixture that provides a directory with npm packages installed.
+def bun_cache_dir() -> Generator[Path, None, None]:
+    """Session-scoped fixture that provides a directory with bun packages installed.
 
-    This runs npm install once per test session and provides the path to the
+    This runs bun install once per test session and provides the path to the
     .jac/client/configs directory containing node_modules.
     """
-    global _npm_cache_dir
+    global _bun_cache_dir
 
-    if _npm_cache_dir is not None and _npm_cache_dir.exists():
-        yield _npm_cache_dir
+    if _bun_cache_dir is not None and _bun_cache_dir.exists():
+        yield _bun_cache_dir
         return
 
     # Create a persistent temp directory for the session
-    cache_dir = Path(tempfile.mkdtemp(prefix="jac_npm_cache_"))
+    cache_dir = Path(tempfile.mkdtemp(prefix="jac_bun_cache_"))
 
     # Create jac.toml
     jac_toml = cache_dir / "jac.toml"
     jac_toml.write_text(_get_minimal_jac_toml())
 
-    # Run jac add --npm to install packages
+    # Run jac add --npm to install packages (flag name unchanged for backward compatibility)
     jac_cmd = _get_jac_command()
-    env = _get_env_with_npm()
+    env = _get_env_with_bun()
     result = subprocess.run(
         [*jac_cmd, "add", "--npm"],
         cwd=cache_dir,
@@ -178,36 +177,44 @@ def npm_cache_dir() -> Generator[Path, None, None]:
     if result.returncode != 0:
         # Clean up on failure
         shutil.rmtree(cache_dir, ignore_errors=True)
-        pytest.skip(f"Failed to set up npm cache: {result.stderr}")
+        pytest.skip(f"Failed to set up bun cache: {result.stderr}")
 
-    _npm_cache_dir = cache_dir
+    _bun_cache_dir = cache_dir
     yield cache_dir
 
     # Cleanup after all tests complete
     shutil.rmtree(cache_dir, ignore_errors=True)
 
 
+# Backward compatibility alias
+@pytest.fixture(scope="session")
+def npm_cache_dir(bun_cache_dir: Path) -> Generator[Path, None, None]:
+    """Backward compatibility alias for bun_cache_dir."""
+    yield bun_cache_dir
+
+
 @pytest.fixture
-def vite_project_dir(npm_cache_dir: Path, tmp_path: Path) -> Path:
+def vite_project_dir(bun_cache_dir: Path, tmp_path: Path) -> Path:
     """Fixture that provides a project directory with pre-installed node_modules.
 
-    This copies node_modules from the session cache instead of running npm install.
+    This copies node_modules from the session cache instead of running bun install.
     """
     # Create jac.toml in the temp directory
     jac_toml = tmp_path / "jac.toml"
     jac_toml.write_text(_get_minimal_jac_toml())
 
     # Copy .jac/client/configs directory (contains package.json)
-    source_configs = npm_cache_dir / ".jac" / "client" / "configs"
+    source_configs = bun_cache_dir / ".jac" / "client" / "configs"
     dest_configs = tmp_path / ".jac" / "client" / "configs"
     if source_configs.exists():
         dest_configs.parent.mkdir(parents=True, exist_ok=True)
         shutil.copytree(source_configs, dest_configs, symlinks=True)
 
-    # Copy node_modules from project root (npm installs there, not in .jac/client/configs)
-    source_node_modules = npm_cache_dir / "node_modules"
-    dest_node_modules = tmp_path / "node_modules"
+    # Copy node_modules from .jac/client/ (bun installs there)
+    source_node_modules = bun_cache_dir / ".jac" / "client" / "node_modules"
+    dest_node_modules = tmp_path / ".jac" / "client" / "node_modules"
     if source_node_modules.exists():
+        dest_node_modules.parent.mkdir(parents=True, exist_ok=True)
         shutil.copytree(source_node_modules, dest_node_modules, symlinks=True)
 
     # Create required directories
@@ -219,7 +226,7 @@ def vite_project_dir(npm_cache_dir: Path, tmp_path: Path) -> Path:
 
 
 @pytest.fixture
-def vite_project_with_antd(npm_cache_dir: Path, tmp_path: Path) -> Path:
+def vite_project_with_antd(bun_cache_dir: Path, tmp_path: Path) -> Path:
     """Fixture that provides a project directory with antd pre-installed."""
     # Create jac.toml with antd dependency
     jac_toml_content = """[project]
@@ -238,21 +245,22 @@ antd = "^6.0.0"
     jac_toml.write_text(jac_toml_content)
 
     # Copy base .jac/client/configs first for faster install
-    source_configs = npm_cache_dir / ".jac" / "client" / "configs"
+    source_configs = bun_cache_dir / ".jac" / "client" / "configs"
     dest_configs = tmp_path / ".jac" / "client" / "configs"
     if source_configs.exists():
         dest_configs.parent.mkdir(parents=True, exist_ok=True)
         shutil.copytree(source_configs, dest_configs, symlinks=True)
 
-    # Copy base node_modules for faster install (npm will add antd on top)
-    source_node_modules = npm_cache_dir / "node_modules"
-    dest_node_modules = tmp_path / "node_modules"
+    # Copy base node_modules for faster install (bun will add antd on top)
+    source_node_modules = bun_cache_dir / ".jac" / "client" / "node_modules"
+    dest_node_modules = tmp_path / ".jac" / "client" / "node_modules"
     if source_node_modules.exists():
+        dest_node_modules.parent.mkdir(parents=True, exist_ok=True)
         shutil.copytree(source_node_modules, dest_node_modules, symlinks=True)
 
     # Install antd on top (uses cached node_modules as base)
     jac_cmd = _get_jac_command()
-    env = _get_env_with_npm()
+    env = _get_env_with_bun()
     result = subprocess.run(
         [*jac_cmd, "add", "--npm"],
         cwd=tmp_path,
@@ -272,10 +280,10 @@ antd = "^6.0.0"
 
 
 @pytest.fixture
-def mock_npm_install():
-    """Fixture that mocks npm install for tests that only test jac.toml manipulation.
+def mock_bun_install():
+    """Fixture that mocks bun install for tests that only test jac.toml manipulation.
 
-    Use this for CLI tests (add/remove commands) that don't need actual npm packages.
+    Use this for CLI tests (add/remove commands) that don't need actual packages.
     """
     with patch(
         "jac_client.plugin.src.package_installer.PackageInstaller._regenerate_and_install"
@@ -283,6 +291,13 @@ def mock_npm_install():
         yield mock
 
 
+# Backward compatibility alias
+@pytest.fixture
+def mock_npm_install(mock_bun_install: Generator) -> Generator:
+    """Backward compatibility alias for mock_bun_install."""
+    yield mock_bun_install
+
+
 @pytest.fixture
 def cli_test_dir(tmp_path: Path) -> Path:
     """Fixture that provides a minimal test directory for CLI tests."""

jac_client/tests/fixtures/spawn_test/app.jac

@@ -9,7 +9,7 @@ walker test_walker {
     has message: str = "Hello from walker";
 
     can execute with `root entry {
-        report {"result": self.message} ;
+        report {"result": self.message};
     }
 }
 
@@ -17,7 +17,7 @@ walker parameterized_walker {
     has value: int;
 
     can execute with `root entry {
-        report {"computed": self.value * 2} ;
+        report {"computed": self.value * 2};
     }
 }
 
@@ -27,15 +27,13 @@ walker positional_walker {
     has metadata: dict = {};
 
     can execute with `root entry {
-        report {"label": self.label, "count": self.count, "meta": self.metadata} ;
+        report {"label": self.label, "count": self.count, "meta": self.metadata};
     }
 }
 
 # Client-side code testing both spawn orderings
-cl import from react { useEffect }
-
 cl {
-    def app()  -> any {
+    def app() -> any {
         has standardResult: any = None;
         has standardComputed: any = None;
         has reverseResult: any = None;
@@ -44,7 +42,7 @@ cl {
         has positionalResult: any = None;
         has spreadResult: any = None;
 
-        async def loadData()  -> None {
+        async can with entry {
             # Test standard spawn order: node spawn walker()
             data1 = root spawn test_walker();
             standardResult = data1;
@@ -76,51 +74,50 @@ cl {
             spreadResult = data7;
         }
 
-        useEffect(lambda   -> None{ loadData();} , []);
-
-        return <div>
-            <h1>
-                Spawn Operator Test
-            </h1>
-            <h2>
-                Standard Order (node spawn walker)
-            </h2>
-            <div>
-                Result: {JSON.stringify(standardResult)}
-            </div>
-            <div>
-                Computed: {JSON.stringify(standardComputed)}
-            </div>
-            <h2>
-                Reverse Order (walker spawn node)
-            </h2>
-            <div>
-                Result: {JSON.stringify(reverseResult)}
-            </div>
-            <h2>
-                UUID Spawn (uuid spawn walker)
-            </h2>
-            <div>
-                Result: {JSON.stringify(uuidResult)}
-            </div>
-            <h2>
-                Reverse UUID Spawn (walker spawn uuid)
-            </h2>
-            <div>
-                Result: {JSON.stringify(reverseUuidResult)}
-            </div>
-            <h2>
-                Positional Walker Arguments
-            </h2>
-            <div>
-                Result: {JSON.stringify(positionalResult)}
-            </div>
-            <h2>
-                Spread Walker Arguments
-            </h2>
+        return
             <div>
-                Result: {JSON.stringify(spreadResult)}
-            </div>
-        </div>;
+                <h1>
+                    Spawn Operator Test
+                </h1>
+                <h2>
+                    Standard Order (node spawn walker)
+                </h2>
+                <div>
+                    Result: {JSON.stringify(standardResult)}
+                </div>
+                <div>
+                    Computed: {JSON.stringify(standardComputed)}
+                </div>
+                <h2>
+                    Reverse Order (walker spawn node)
+                </h2>
+                <div>
+                    Result: {JSON.stringify(reverseResult)}
+                </div>
+                <h2>
+                    UUID Spawn (uuid spawn walker)
+                </h2>
+                <div>
+                    Result: {JSON.stringify(uuidResult)}
+                </div>
+                <h2>
+                    Reverse UUID Spawn (walker spawn uuid)
+                </h2>
+                <div>
+                    Result: {JSON.stringify(reverseUuidResult)}
+                </div>
+                <h2>
+                    Positional Walker Arguments
+                </h2>
+                <div>
+                    Result: {JSON.stringify(positionalResult)}
+                </div>
+                <h2>
+                    Spread Walker Arguments
+                </h2>
+                <div>
+                    Result: {JSON.stringify(spreadResult)}
+                </div>
+            </div>;
     }
 }