feat(compiler): Add grpc support for Swift

.agents/languages/swift.md

@@ -13,6 +13,7 @@ Load this file when changing `swift/` or Swift xlang behavior.
 - Swift formatting uses `swift/.swift-format`; do not rely on SwiftLint for indentation or source
   formatting.
 - Use `ENABLE_FORY_DEBUG_OUTPUT=1` when debugging Swift tests.
+- Generated Swift gRPC companions are compiler-owned files targeting grpc-swift 1.x. Keep grpc-swift out of the `swift/` runtime package; it belongs only to generated user code and the compiler build fixture.
 - Prefer the user-requested or existing Foundation public value type when it is the intended Swift surface; do not invent Fory-prefixed wrappers only to avoid import ambiguity.
 - Preserve distinct temporal semantics. Timestamp values and day-only local dates should have protocol-accurate helper names and no stale aliases after a refactor.
 - When temporal or public-type refactors touch generated Swift code, sweep message fields, union payloads, macros, xlang harnesses, and integration fixtures together.

.github/workflows/ci.yml

@@ -1,3 +1,3 @@
 # Licensed to the Apache Software Foundation (ASF) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -196,6 +196,24 @@
           cd compiler
           pytest -q fory_compiler/tests
 
+  compiler_import:
+    name: Compiler Import ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.8", "3.9"]
+    steps:
+      - uses: actions/checkout@v5
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: "pip"
+      - name: Import the compiler CLI
+        run: |
+          cd compiler
+          python -c "import fory_compiler.cli"
+
   java:
     name: Java CI
     needs: changes
@@ -1056,6 +1074,45 @@
           cd integration_tests/grpc_tests/java
           mvn -T16 --no-transfer-progress -Dtest=DartGrpcTest test
 
+  grpc_java_swift_tests:
+    name: Java/Swift gRPC Tests
+    needs: changes
+    if: needs.changes.outputs.grpc_tests == 'true' || needs.changes.outputs.swift == 'true'
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v5
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          java-version: 21
+          distribution: "temurin"
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.11
+          cache: "pip"
+      - name: Cache Maven local repository
+        uses: actions/cache@v4
+        with:
+          path: ~/.m2/repository
+          key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
+          restore-keys: |
+            ${{ runner.os }}-maven-
+      - name: Install Java artifacts for gRPC tests
+        run: |
+          cd java
+          mvn -T16 --no-transfer-progress clean install -DskipTests -Dmaven.javadoc.skip=true -Dmaven.source.skip=true
+      - name: Generate gRPC test sources
+        run: python integration_tests/grpc_tests/generate_grpc.py
+      - name: Run Swift gRPC package tests
+        run: |
+          cd integration_tests/grpc_tests/swift/interop
+          swift test
+      - name: Run Java/Swift gRPC Tests
+        run: |
+          cd integration_tests/grpc_tests/java
+          mvn -T16 --no-transfer-progress -Dtest=SwiftGrpcTest test
+
   javascript:
     name: JavaScript CI
     needs: changes

compiler/fory_compiler/cli.py

@@ -26,11 +26,8 @@
 
 from fory_compiler.frontend.base import FrontendError
 from fory_compiler.frontend.utils import parse_idl_file, resolve_import_path
-from fory_compiler.ir.ast import Schema
-from fory_compiler.ir.emitter import FDLEmitter
-from fory_compiler.ir.validator import SchemaValidator
-from fory_compiler.generators.base import GeneratorOptions
 from fory_compiler.generators import GENERATORS
+from fory_compiler.generators.base import GeneratorOptions
 from fory_compiler.generators.csharp import validate_csharp_generation
 from fory_compiler.generators.kotlin import (
     kotlin_output_paths,
@@ -40,13 +37,15 @@
     scala_output_paths,
     scala_package_for_schema,
 )
+from fory_compiler.generators.swift import validate_swift_generation
+from fory_compiler.ir.ast import Schema
+from fory_compiler.ir.emitter import FDLEmitter
+from fory_compiler.ir.validator import SchemaValidator
 
 
 class ImportError(Exception):
     """Error during import resolution."""
 
-    pass
-
 
 GENERATED_MARKER = "This file is generated by Apache Fory compiler."
 SKIP_DIR_NAMES = {"build", "target"}
@@ -342,6 +341,27 @@ def validate_csharp_files(
         return False
 
 
+def validate_swift_files(
+    files: List[Path],
+    import_paths: List[Path],
+    namespace_style: Optional[str] = None,
+    grpc: bool = False,
+) -> bool:
+    """Preflight Swift output paths and top-level symbols before writing output."""
+    cache: Dict[Path, Schema] = {}
+    graph: List[Tuple[Path, Schema]] = []
+    for file_path in files:
+        file_graph = collect_schema_graph(file_path, import_paths, cache, set())
+        if file_graph is None:
+            return False
+        graph.extend(file_graph)
+    try:
+        return validate_swift_generation(graph, namespace_style, grpc=grpc)
+    except ValueError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        return False
+
+
 def validate_scala_import_packages(graph: List[Tuple[Path, Schema]]) -> bool:
     """Check package combinations that Scala source cannot compile."""
     packages = {scala_package_for_schema(schema) for _, schema in graph}
@@ -1023,7 +1043,7 @@ def cmd_compile(args: argparse.Namespace) -> int:
         return 1
 
     # Validate that all languages are supported
-    invalid = [lang for lang in lang_output_dirs.keys() if lang not in GENERATORS]
+    invalid = [lang for lang in lang_output_dirs if lang not in GENERATORS]
     if invalid:
         print(f"Error: Unknown language(s): {', '.join(invalid)}", file=sys.stderr)
         print(f"Available: {', '.join(GENERATORS.keys())}", file=sys.stderr)
@@ -1044,15 +1064,22 @@ def cmd_compile(args: argparse.Namespace) -> int:
                 )
             import_paths.append(resolved)
 
-    if "kotlin" in lang_output_dirs:
-        if not validate_kotlin_generation(args.files, import_paths, grpc=args.grpc):
-            return 1
-    if "csharp" in lang_output_dirs:
-        if not validate_csharp_files(args.files, import_paths, grpc=args.grpc):
-            return 1
-    if "scala" in lang_output_dirs:
-        if not validate_scala_generation(args.files, import_paths, grpc=args.grpc):
-            return 1
+    if "kotlin" in lang_output_dirs and not validate_kotlin_generation(
+        args.files, import_paths, grpc=args.grpc
+    ):
+        return 1
+    if "csharp" in lang_output_dirs and not validate_csharp_files(
+        args.files, import_paths, grpc=args.grpc
+    ):
+        return 1
+    if "scala" in lang_output_dirs and not validate_scala_generation(
+        args.files, import_paths, grpc=args.grpc
+    ):
+        return 1
+    if "swift" in lang_output_dirs and not validate_swift_files(
+        args.files, import_paths, args.swift_namespace_style, grpc=args.grpc
+    ):
+        return 1
 
     if args.grpc_web and "javascript" not in lang_output_dirs:
         print(

compiler/fory_compiler/frontend/fbs/lexer.py

@@ -19,7 +19,7 @@
 
 from dataclasses import dataclass
 from enum import Enum, auto
-from typing import List
+from typing import List, Tuple
 
 
 class TokenType(Enum):
@@ -217,7 +217,7 @@ def read_string(self) -> str:
         self.advance()  # closing quote
         return value
 
-    def read_number(self) -> tuple[TokenType, str]:
+    def read_number(self) -> Tuple[TokenType, str]:
         value = ""
         if self.peek() == "-":
             value += self.advance()

compiler/fory_compiler/frontend/fdl/parser.py

@@ -18,7 +18,7 @@
 """Recursive descent parser for FDL."""
 
 import warnings
-from typing import List, Set, Optional
+from typing import List, Set, Optional, Tuple
 
 from fory_compiler.ir.ast import (
     Schema,
@@ -258,7 +258,7 @@ def make_location(self, token: Token) -> SourceLocation:
             source_format=self.source_format,
         )
 
-    def parse_package(self) -> tuple[str, Optional[str]]:
+    def parse_package(self) -> Tuple[str, Optional[str]]:
         """Parse a package declaration: package foo.bar [alias baz];"""
         self.consume(TokenType.PACKAGE)
 

compiler/fory_compiler/frontend/proto/parser.py

@@ -17,7 +17,7 @@
 
 """Recursive descent parser for proto3."""
 
-from typing import List
+from typing import List, Tuple
 
 from fory_compiler.frontend.proto.ast import (
     ProtoSchema,
@@ -162,7 +162,7 @@ def parse_import(self) -> str:
         self.consume(TokenType.SEMI, "Expected ';' after import")
         return path
 
-    def parse_option_statement(self) -> tuple[str, object]:
+    def parse_option_statement(self) -> Tuple[str, object]:
         self.consume(TokenType.OPTION, "Expected 'option'")
         name = self.parse_option_name()
         self.consume(TokenType.EQUALS, "Expected '=' after option name")