jaclang 0.8.9__py3-none-any.whl → 0.8.10__py3-none-any.whl

jaclang/compiler/passes/ecmascript/tests/test_js_generation.py

@@ -0,0 +1,239 @@
+"""Test JavaScript code generation using consolidated Jac fixtures."""
+
+import os
+import subprocess
+import tempfile
+from pathlib import Path
+
+from jaclang.compiler.passes.ecmascript import EsastGenPass
+from jaclang.compiler.passes.ecmascript.es_unparse import es_to_js
+from jaclang.compiler.program import JacProgram
+from jaclang.utils.test import TestCase
+
+
+class JavaScriptGenerationTests(TestCase):
+    """Validate JavaScript generation for core and advanced Jac fixtures."""
+
+    CORE_FIXTURE = "core_language_features.jac"
+    ADVANCED_FIXTURE = "advanced_language_features.jac"
+    CLIENT_FIXTURE = "client_jsx.jac"
+
+    def get_fixture_path(self, filename: str) -> str:
+        """Return absolute path to a fixture file."""
+        fixtures_dir = Path(__file__).parent / "fixtures"
+        return str(fixtures_dir / filename)
+
+    def compile_fixture_to_js(self, fixture_name: str) -> str:
+        """Compile a Jac fixture to JavaScript and return the emitted source."""
+        fixture_path = fixture_name
+        if not Path(fixture_path).exists():
+            fixture_path = self.get_fixture_path(fixture_name)
+        prog = JacProgram()
+        ir = prog.compile(file_path=fixture_path, no_cgen=True)
+
+        self.assertFalse(
+            prog.errors_had,
+            f"Compilation errors in {fixture_name}: {[str(e) for e in prog.errors_had]}",
+        )
+
+        es_pass = EsastGenPass(ir, prog)
+        es_ir = es_pass.ir_out
+
+        self.assertTrue(hasattr(es_ir.gen, "es_ast"), "es_ast attribute missing")
+        self.assertIsNotNone(es_ir.gen.es_ast, "es_ast should not be None")
+
+        return es_to_js(es_ir.gen.es_ast)
+
+    def assert_balanced_syntax(self, js_code: str, fixture_name: str) -> None:
+        """Ensure generated JavaScript has balanced delimiters."""
+        pairs = [("{", "}"), ("(", ")"), ("[", "]")]
+        for open_char, close_char in pairs:
+            self.assertEqual(
+                js_code.count(open_char),
+                js_code.count(close_char),
+                f"{fixture_name} produced unbalanced {open_char}{close_char} pairs",
+            )
+
+    def assert_no_jac_keywords(self, js_code: str, fixture_name: str) -> None:
+        """Verify Jac-specific keywords are absent from generated JavaScript."""
+        jac_keywords = [
+            "can ",
+            "has ",
+            "obj ",
+            "walker ",
+            "node ",
+            "edge ",
+            "visit ",
+            "spawn ",
+            "disengage ",
+            "here ",
+            "root ",
+        ]
+
+        for keyword in jac_keywords:
+            self.assertNotIn(
+                keyword,
+                js_code,
+                f"Jac keyword '{keyword.strip()}' leaked into JavaScript for {fixture_name}",
+            )
+
+    def test_core_fixture_emits_expected_constructs(self) -> None:
+        """Core fixture should cover fundamental language constructs."""
+        js_code = self.compile_fixture_to_js(self.CORE_FIXTURE)
+
+        self.assertIn("const global_counter = 0;", js_code)
+        self.assertIn("function add", js_code)
+        self.assertIn("function greet", js_code)
+        self.assertIn("function fibonacci", js_code)
+        self.assertIn("for (const i of range(limit))", js_code)
+        self.assertIn("while (counter > 0)", js_code)
+
+        # Operators map to JavaScript equivalents
+        self.assertIn("===", js_code)
+        self.assertIn("!==", js_code)
+        self.assertIn("&&", js_code)
+        self.assertIn("||", js_code)
+
+        # Classes and enums materialize as expected
+        self.assertIn("class Person", js_code)
+        self.assertIn("class Employee extends Person", js_code)
+        self.assertIn("class Calculator", js_code)
+        self.assertIn("class MathUtils", js_code)
+        self.assertIn("const Status", js_code)
+        self.assertIn("const Priority", js_code)
+
+        # Exception handling remains intact
+        self.assertIn("try", js_code)
+        self.assertIn("catch (err)", js_code)
+        self.assertIn("finally", js_code)
+
+        self.assert_balanced_syntax(js_code, self.CORE_FIXTURE)
+        self.assert_no_jac_keywords(js_code, self.CORE_FIXTURE)
+        self.assertGreater(len(js_code), 200, "Core fixture generated suspiciously small output")
+
+    def test_advanced_fixture_emits_expected_constructs(self) -> None:
+        """Advanced fixture should exercise higher-level Jac features."""
+        js_code = self.compile_fixture_to_js(self.ADVANCED_FIXTURE)
+
+        self.assertIn("function lambda_examples", js_code)
+        self.assertIn("async function fetch_value", js_code)
+        self.assertIn("await fetch_value", js_code)
+        self.assertIn("async function gather_async", js_code)
+        self.assertIn("function generator_examples", js_code)
+        self.assertIn("function spread_and_rest_examples", js_code)
+        self.assertIn("...defaults", js_code)
+        self.assertIn("function template_literal_examples", js_code)
+        self.assertIn("score >= 60 ? \"pass\" : \"fail\"", js_code)
+        self.assertIn("function do_while_simulation", js_code)
+        self.assertIn("function build_advanced_report", js_code)
+
+        # Ensure pattern matching lowered into a callable
+        self.assertIn("function pattern_matching_examples", js_code)
+
+        self.assert_balanced_syntax(js_code, self.ADVANCED_FIXTURE)
+        self.assert_no_jac_keywords(js_code, self.ADVANCED_FIXTURE)
+        self.assertGreater(len(js_code), 150, "Advanced fixture output unexpectedly small")
+
+    def test_client_fixture_generates_client_bundle(self) -> None:
+        """Client-focused fixture should emit JSX-flavoured JavaScript."""
+        js_code = self.compile_fixture_to_js(self.CLIENT_FIXTURE)
+
+        self.assertIn('const API_URL = "https://api.example.com";', js_code)
+        self.assertIn("function component()", js_code)
+        self.assertIn('__jacJsx("div"', js_code)
+        self.assertIn("class ButtonProps", js_code)
+        self.assertIn("constructor(props", js_code)
+        self.assertNotIn("server_only", js_code, "Server-only code leaked into client bundle")
+
+        self.assert_balanced_syntax(js_code, self.CLIENT_FIXTURE)
+
+    def test_iife_fixture_generates_function_expressions(self) -> None:
+        """IIFE-heavy fixture should lower Jac function expressions for JS runtime."""
+        fixture_path = self.lang_fixture_abs_path("iife_functions_client.jac")
+        js_code = self.compile_fixture_to_js(fixture_path)
+
+        # Ensure representative IIFE constructs are present
+        self.assertIn("function get_value()", js_code)
+        self.assertIn("function calculate(x, y)", js_code)
+        self.assertIn("}();", js_code, "IIFE invocation pattern missing in generated JS")
+        self.assertIn("function outer()", js_code)
+        self.assertIn("return () => {\n    let count = count + 1;\n    return count;\n  };", js_code)
+        self.assertIn("All client-side IIFE tests completed!", js_code)
+
+    def test_cli_js_command_outputs_js(self) -> None:
+        """jac js CLI should emit JavaScript for the core fixture."""
+        fixture_path = self.get_fixture_path(self.CORE_FIXTURE)
+        env = os.environ.copy()
+        project_root = str(Path(__file__).resolve().parents[4])
+        existing = env.get("PYTHONPATH", "")
+        env["PYTHONPATH"] = f"{project_root}:{existing}" if existing else project_root
+
+        result = subprocess.run(
+            ["python3", "-m", "jaclang.cli.cli", "js", fixture_path],
+            capture_output=True,
+            text=True,
+            env=env,
+        )
+
+        self.assertEqual(result.returncode, 0, f"CLI command failed: {result.stderr}")
+        self.assertGreater(len(result.stdout), 0, "CLI produced no output")
+        self.assertIn("function add", result.stdout)
+
+    def test_empty_file_generates_minimal_js(self) -> None:
+        """Ensure an empty Jac file generates a minimal JavaScript stub."""
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".jac", delete=False) as tmp:
+            tmp.write('"""Empty file for smoke testing."""\n')
+            temp_path = tmp.name
+
+        try:
+            js_code = self.compile_fixture_to_js(temp_path)
+            self.assertLess(len(js_code), 100, "Empty file produced unexpectedly large output")
+            self.assert_balanced_syntax(js_code, temp_path)
+        finally:
+            os.unlink(temp_path)
+
+    def test_type_to_typeof_transformation(self) -> None:
+        """Test that type() calls transform to typeof operator in JavaScript."""
+        jac_code = '''"""Test type() to typeof conversion."""
+
+cl def check_types() {
+    let x = 42;
+    let y = "hello";
+    let obj = {"key": "value"};
+    let arr = [1, 2, 3];
+
+    let t1 = type(x);
+    let t2 = type(y);
+    let t3 = type(obj);
+    let t4 = type(arr[0]);
+
+    return t1;
+}
+'''
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".jac", delete=False) as tmp:
+            tmp.write(jac_code)
+            tmp.flush()
+            temp_path = tmp.name
+
+        try:
+            js_code = self.compile_fixture_to_js(temp_path)
+
+            # Verify typeof operator is present
+            self.assertIn("typeof", js_code, "typeof operator should be present in output")
+
+            # Verify specific transformations
+            self.assertIn("typeof x", js_code, "type(x) should become typeof x")
+            self.assertIn("typeof y", js_code, "type(y) should become typeof y")
+            self.assertIn("typeof obj", js_code, "type(obj) should become typeof obj")
+            self.assertIn("typeof arr[0]", js_code, "type(arr[0]) should become typeof arr[0]")
+
+            # Ensure no type() function calls remain
+            self.assertNotIn("type(", js_code, "No type() calls should remain in JavaScript")
+
+            # Count typeof occurrences - should have exactly 4
+            typeof_count = js_code.count("typeof")
+            self.assertEqual(typeof_count, 4, f"Expected 4 typeof occurrences, found {typeof_count}")
+
+            self.assert_balanced_syntax(js_code, temp_path)
+        finally:
+            os.unlink(temp_path)

jaclang/compiler/passes/main/__init__.py

@@ -2,7 +2,6 @@
 
 from ..transform import Alert, Transform  # noqa: I100
 from .annex_pass import JacAnnexPass  # noqa: I100
-from .binder_pass import BinderPass  # noqa: I100
 from .sym_tab_build_pass import SymTabBuildPass, UniPass  # noqa: I100
 from .def_use_pass import DefUsePass  # noqa: I100
 from .sem_def_match_pass import SemDefMatchPass  # noqa: I100
@@ -23,8 +22,6 @@ __all__ = [
     "UniPass",
     "JacAnnexPass",
     "JacImportDepsPass",
-    "PyImportDepsPass",
-    "BinderPass",
     "TypeCheckPass",
     "SymTabBuildPass",
     "DeclImplMatchPass",

jaclang/compiler/passes/main/annex_pass.py

@@ -34,6 +34,7 @@ class JacAnnexPass(Transform[uni.Module, uni.Module]):
         self.base_path = self.mod_path[:-4]
         self.impl_folder = self.base_path + ".impl"
         self.test_folder = self.base_path + ".test"
+        self.cl_folder = self.base_path + ".cl"
         self.directory = os.path.dirname(self.mod_path) or os.getcwd()
         self.load_annexes(jac_program=self.prog, node=ir_in)
         return ir_in
@@ -41,7 +42,7 @@ class JacAnnexPass(Transform[uni.Module, uni.Module]):
     def find_annex_paths(self) -> list[str]:
         """Return list of .impl.jac and .test.jac files related to base module."""
         paths = [os.path.join(self.directory, f) for f in os.listdir(self.directory)]
-        for folder in [self.impl_folder, self.test_folder]:
+        for folder in [self.impl_folder, self.test_folder, self.cl_folder]:
             if os.path.exists(folder):
                 paths += [os.path.join(folder, f) for f in os.listdir(folder)]
         return paths
@@ -66,6 +67,15 @@ class JacAnnexPass(Transform[uni.Module, uni.Module]):
                 if mod:
                     node.impl_mod.append(mod)
 
+            elif path.endswith(".cl.jac") and (
+                path.startswith(f"{self.base_path}.")
+                or os.path.dirname(path) == self.cl_folder
+            ):
+                mod = jac_program.compile(file_path=path, no_cgen=True)
+                if mod:
+                    self._mark_client_declarations(mod)
+                    node.impl_mod.append(mod)
+
             elif (
                 path.endswith(".test.jac")
                 and not settings.ignore_test_annex
@@ -77,3 +87,15 @@ class JacAnnexPass(Transform[uni.Module, uni.Module]):
                 mod = jac_program.compile(file_path=path, no_cgen=True)
                 if mod:
                     node.test_mod.append(mod)
+
+    def _mark_client_declarations(self, module: uni.Module) -> None:
+        """Recursively mark client-facing nodes in the module as client declarations."""
+
+        def _mark(node: uni.UniNode) -> None:
+            if isinstance(node, uni.ClientFacingNode):
+                node.is_client_decl = True
+            for child in getattr(node, "kid", []):
+                if child:
+                    _mark(child)
+
+        _mark(module)