feat(compiler): add dart gRPC codegen

.agents/languages/dart.md

@@ -22,6 +22,8 @@ Load this file when changing `dart/`.
 - Generated struct serializers should use serializer-owned field descriptors for runtime resolver decisions and emit direct field-specific write/read code for static schemas. Do not route generated hot writes through generic field-info value helpers such as `writeGeneratedStructFieldInfoValue`.
 - Dart xlang or runtime ownership changes need local Dart package tests plus the Java-driven `DartXlangTest`; package-only smoke tests are not enough.
 - When claiming non-VM Dart support, prove a relevant non-VM compile path such as `dart compile js` against active runtime or example code.
+- Generated Dart gRPC service companions (`<stem>_grpc.dart`) are compiler-owned files that depend on the application-provided `grpc` package, not `dart/packages/fory`. Keep gRPC dependencies out of the Fory Dart runtime package.
+- Dart generated schema modules (`<Stem>ForyModule`) are the source-file owners and own a ready `Fory` runtime: `getFory()` initializes a default runtime and registers the schema's types on first use, so generated gRPC companions never require a manual `install(...)`; `install(customFory)` stays optional injection. Keep `getFory()` ready by construction, and do not introduce package-derived aliases or duplicate serializer registration paths.
 
 ## Commands
 

.github/workflows/ci.yml

@@ -855,6 +855,55 @@ jobs:
           cd integration_tests/grpc_tests/java
           mvn -T16 --no-transfer-progress -Dtest=KotlinGrpcTest test
 
+  grpc_java_dart_tests:
+    name: Java/Dart gRPC Tests
+    needs: changes
+    if: needs.changes.outputs.grpc_tests == 'true'
+    runs-on: ubuntu-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: Set up Dart
+        uses: dart-lang/setup-dart@e51d8e571e22473a2ddebf0ef8a2123f0ab2c02c  # v1.7.1
+        with:
+          sdk: stable
+      - 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: Build Dart gRPC peer
+        run: |
+          cd integration_tests/grpc_tests/dart
+          dart pub get
+          dart run build_runner build
+      - name: Analyze and format-check generated Dart gRPC companions
+        run: |
+          cd integration_tests/grpc_tests/dart
+          dart analyze bin lib/generated/*/*_grpc.dart
+          dart format --output=none --set-exit-if-changed bin lib/generated/*/*_grpc.dart
+      - name: Run Java/Dart gRPC Tests
+        run: |
+          cd integration_tests/grpc_tests/java
+          mvn -T16 --no-transfer-progress -Dtest=DartGrpcTest test
+
   javascript:
     name: JavaScript CI
     needs: changes

compiler/fory_compiler/generators/dart.py

@@ -23,6 +23,7 @@
 
 from fory_compiler.frontend.utils import parse_idl_file
 from fory_compiler.generators.base import BaseGenerator, GeneratedFile
+from fory_compiler.generators.services.dart import DartServiceGeneratorMixin
 from fory_compiler.ir.ast import (
     ArrayType,
     Enum,
@@ -40,7 +41,7 @@
 from fory_compiler.ir.types import PrimitiveKind
 
 
-class DartGenerator(BaseGenerator):
+class DartGenerator(DartServiceGeneratorMixin, BaseGenerator):
     language_name = "dart"
     file_extension = ".dart"
 
@@ -1291,8 +1292,10 @@ def generate_module_type(self, indent: int) -> List[str]:
         lines.extend(
             [
                 f"{self.indent_str * (indent + 1)}static Fory getFory() {{",
-                f"{self.indent_str * (indent + 2)}final fory = _fory;",
-                f"{self.indent_str * (indent + 2)}if (fory == null) throw StateError('Call {self.module_type_name()}.install(...) before using generated helpers.');",
+                f"{self.indent_str * (indent + 2)}final existing = _fory;",
+                f"{self.indent_str * (indent + 2)}if (existing != null) return existing;",
+                f"{self.indent_str * (indent + 2)}final fory = Fory();",
+                f"{self.indent_str * (indent + 2)}install(fory);",
                 f"{self.indent_str * (indent + 2)}return fory;",
                 f"{self.indent_str * (indent + 1)}}}",
                 "",