feat(xlang): refine register by name api (#3739)

## Why?



## What does this PR do?



## Related issues



## AI Contribution Checklist



- [ ] Substantial AI assistance was used in this PR: `yes` / `no`
- [ ] If `yes`, I included a completed [AI Contribution
Checklist](https://github.com/apache/fory/blob/main/AI_POLICY.md#9-contributor-checklist-for-ai-assisted-prs)
in this PR description and the required `AI Usage Disclosure`.
- [ ] If `yes`, my PR description includes the required `ai_review`
summary and screenshot evidence of the final clean AI review results
from both fresh reviewers on the current PR diff or current HEAD after
the latest code changes.



## Does this PR introduce any user-facing change?



- [ ] Does this PR introduce any public API change?
- [ ] Does this PR introduce any binary protocol compatibility change?

## Benchmark

Author: chaokunyang

README.md

@@ -370,7 +370,7 @@ class Person:
     age: pyfory.Int32
 
 fory = pyfory.Fory(xlang=True)
-fory.register_type(Person, typename="example.Person")
+fory.register_type(Person, name="example.Person")
 
 data = fory.serialize(Person("Alice", 30))
 person = fory.deserialize(data)
@@ -421,7 +421,7 @@ struct Person {
 
 fn main() -> Result<(), Error> {
     let mut fory = Fory::builder().xlang(true).build();
-    fory.register_by_name::<Person>("example", "Person")?;
+    fory.register_by_name::<Person>("example.Person")?;
 
     let bytes = fory.serialize(&Person {
         name: "Alice".to_string(),
@@ -451,7 +451,7 @@ FORY_STRUCT(Person, name, age);
 
 int main() {
   auto fory = Fory::builder().xlang(true).build();
-  fory.register_struct<Person>("example", "Person");
+  fory.register_struct<Person>("example.Person");
 
   auto bytes = fory.serialize(Person{"Alice", 30}).value();
   Person person = fory.deserialize<Person>(bytes).value();
@@ -525,8 +525,7 @@ void main() {
   PersonFory.register(
     fory,
     Person,
-    namespace: 'example',
-    typeName: 'Person',
+    name: 'example.Person',
   );
 
   final bytes = fory.serialize(Person()
@@ -556,7 +555,7 @@ struct Person {
 }
 
 let fory = Fory()
-try fory.register(Person.self, namespace: "example", name: "Person")
+try fory.register(Person.self, name: "example.Person")
 
 let bytes = try fory.serialize(Person(name: "Alice", age: 30))
 let person: Person = try fory.deserialize(bytes)

compiler/fory_compiler/generators/dart.py

@@ -436,13 +436,15 @@ def _dart_string_literal(self, value: str) -> str:
         escaped = value.replace("\\", "\\\\").replace("'", "\\'")
         return f"'{escaped}'"
 
-    def _registration_defaults(self, type_def: object) -> Tuple[str, str, str]:
+    def _registration_defaults(self, type_def: object) -> Tuple[str, str]:
         if self.should_register_by_id(type_def):
-            return str(type_def.type_id), "null", "null"
+            return str(type_def.type_id), "null"
+        name = self.registration_type_name(type_def)
+        if self.package:
+            name = f"{self.package}.{name}"
         return (
             "null",
-            self._dart_string_literal(self.package or ""),
-            self._dart_string_literal(self.registration_type_name(type_def)),
+            self._dart_string_literal(name),
         )
 
     def _supports_direct_container_cast(
@@ -1300,12 +1302,10 @@ def generate_module_type(self, indent: int) -> List[str]:
 
         def registration_lines(type_def: object, call_line: str) -> List[str]:
             n = self.local_name(type_def)
-            default_id, default_namespace, default_type_name = (
-                self._registration_defaults(type_def)
-            )
+            default_id, default_name = self._registration_defaults(type_def)
             return [
                 f"{self.indent_str * (indent + 2)}if (type == {n}) {{",
-                f"{self.indent_str * (indent + 3)}{call_line.format(id=default_id, namespace=default_namespace, type_name=default_type_name)}",
+                f"{self.indent_str * (indent + 3)}{call_line.format(id=default_id, name=default_name)}",
                 f"{self.indent_str * (indent + 3)}return;",
                 f"{self.indent_str * (indent + 2)}}}",
             ]
@@ -1318,7 +1318,7 @@ def registration_lines(type_def: object, call_line: str) -> List[str]:
             lines.extend(
                 registration_lines(
                     enum,
-                    f"registerGeneratedEnum(fory, {schema_name}, id: {{id}}, namespace: {{namespace}}, typeName: {{type_name}});",
+                    f"registerGeneratedEnum(fory, {schema_name}, id: {{id}}, name: {{name}});",
                 )
             )
         for union in self.schema.unions:
@@ -1328,7 +1328,7 @@ def registration_lines(type_def: object, call_line: str) -> List[str]:
             lines.extend(
                 registration_lines(
                     union,
-                    f"fory.registerSerializer({n}, const _{n}ForySerializer(), id: {{id}}, namespace: {{namespace}}, typeName: {{type_name}});",
+                    f"fory.registerSerializer({n}, const _{n}ForySerializer(), id: {{id}}, name: {{name}});",
                 )
             )
 
@@ -1340,7 +1340,7 @@ def visit_message(message: Message):
             lines.extend(
                 registration_lines(
                     message,
-                    f"registerGeneratedStruct(fory, {schema_name}, id: {{id}}, namespace: {{namespace}}, typeName: {{type_name}});",
+                    f"registerGeneratedStruct(fory, {schema_name}, id: {{id}}, name: {{name}});",
                 )
             )
             for enum in message.nested_enums:
@@ -1349,15 +1349,15 @@ def visit_message(message: Message):
                 lines.extend(
                     registration_lines(
                         enum,
-                        f"registerGeneratedEnum(fory, {schema_name}, id: {{id}}, namespace: {{namespace}}, typeName: {{type_name}});",
+                        f"registerGeneratedEnum(fory, {schema_name}, id: {{id}}, name: {{name}});",
                     )
                 )
             for union in message.nested_unions:
                 un = self.local_name(union)
                 lines.extend(
                     registration_lines(
                         union,
-                        f"fory.registerSerializer({un}, const _{un}ForySerializer(), id: {{id}}, namespace: {{namespace}}, typeName: {{type_name}});",
+                        f"fory.registerSerializer({un}, const _{un}ForySerializer(), id: {{id}}, name: {{name}});",
                     )
                 )
             for nested in message.nested_messages:

compiler/fory_compiler/generators/python.py

@@ -1031,7 +1031,7 @@ def generate_enum_registration(
         else:
             ns = self.package or "default"
             lines.append(
-                f'    fory.register_type({class_ref}, namespace="{ns}", typename="{type_name}")'
+                f'    fory.register_type({class_ref}, name="{ns}.{type_name}")'
             )
 
     def generate_message_registration(
@@ -1048,7 +1048,7 @@ def generate_message_registration(
         else:
             ns = self.package or "default"
             lines.append(
-                f'    fory.register_type({class_ref}, namespace="{ns}", typename="{type_name}")'
+                f'    fory.register_type({class_ref}, name="{ns}.{type_name}")'
             )
 
         # Register nested enums
@@ -1081,5 +1081,5 @@ def generate_union_registration(
         else:
             ns = self.package or "default"
             lines.append(
-                f'    fory.register_union({class_ref}, namespace="{ns}", typename="{type_name}", serializer={serializer_ref}(fory.type_resolver))'
+                f'    fory.register_union({class_ref}, name="{ns}.{type_name}", serializer={serializer_ref}(fory.type_resolver))'
             )

compiler/fory_compiler/generators/swift.py

@@ -1262,16 +1262,12 @@ def generate_module_type(self, indent: int = 0) -> List[str]:
                 continue
 
             schema_type_name = self.schema_type_name(type_def)
-            escaped_name = schema_type_name.replace('"', '\\"')
             if namespace:
-                escaped_ns = namespace.replace('"', '\\"')
-                lines.append(
-                    f'{ind}{self.indent_str * 2}try fory.register({type_name}.self, namespace: "{escaped_ns}", name: "{escaped_name}")'
-                )
-            else:
-                lines.append(
-                    f'{ind}{self.indent_str * 2}try fory.register({type_name}.self, name: "{escaped_name}")'
-                )
+                schema_type_name = f"{namespace}.{schema_type_name}"
+            escaped_name = schema_type_name.replace('"', '\\"')
+            lines.append(
+                f'{ind}{self.indent_str * 2}try fory.register({type_name}.self, name: "{escaped_name}")'
+            )
         lines.append(f"{ind}{self.indent_str}" + "}")
 
         lines.append(f"{ind}" + "}")

compiler/fory_compiler/tests/test_dart_generator.py

@@ -68,7 +68,7 @@ def test_dart_generator_emits_annotated_structs_and_generated_part_registration(
     assert "int fixedValue = 0;" in file.content
     assert "Uint64 taggedValue = Uint64(0);" in file.content
     assert (
-        "registerGeneratedStruct(fory, _scalarForySchema, id: 100, namespace: null, typeName: null);"
+        "registerGeneratedStruct(fory, _scalarForySchema, id: 100, name: null);"
         in file.content
     )
     assert "abstract final class DemoForyModule" in file.content
@@ -98,7 +98,7 @@ def test_dart_generator_keeps_enum_helpers_in_source_and_uses_generated_enum_reg
     assert "static Status fromRawValue(int value) => switch (value) {" in file.content
     assert "_StatusForySerializer" not in file.content
     assert (
-        "registerGeneratedEnum(fory, _statusForySchema, id: 101, namespace: null, typeName: null);"
+        "registerGeneratedEnum(fory, _statusForySchema, id: 101, name: null);"
         in file.content
     )
 
@@ -140,7 +140,7 @@ def test_dart_generator_keeps_union_serializers_direct_and_marks_union_types():
     assert "void write(" not in file.content
     assert "Animal read(" not in file.content
     assert (
-        "fory.registerSerializer(Animal, const _AnimalForySerializer(), id: 101, namespace: null, typeName: null);"
+        "fory.registerSerializer(Animal, const _AnimalForySerializer(), id: 101, name: null);"
         in file.content
     )
 
@@ -330,11 +330,11 @@ def test_dart_generator_uses_name_registration_when_auto_id_disabled():
     )
 
     assert (
-        "registerGeneratedStruct(fory, _envelopeForySchema, id: null, namespace: 'demo', typeName: 'Envelope');"
+        "registerGeneratedStruct(fory, _envelopeForySchema, id: null, name: 'demo.Envelope');"
         in file.content
     )
     assert (
-        "registerGeneratedStruct(fory, _envelopePayloadForySchema, id: null, namespace: 'demo', typeName: 'Envelope.Payload');"
+        "registerGeneratedStruct(fory, _envelopePayloadForySchema, id: null, name: 'demo.Envelope.Payload');"
         in file.content
     )
 

compiler/fory_compiler/tests/test_generated_code.py

@@ -613,6 +613,77 @@ def test_java_nested_name_registration_uses_owner_namespace():
     )
 
 
+def test_generated_registration_uses_single_name_for_dart_python_swift():
+    schema = parse_fdl(
+        """
+        option enable_auto_type_id = false;
+        package demo;
+
+        message Envelope {
+            message Payload {
+                int32 value = 1;
+            }
+
+            enum Kind {
+                UNKNOWN = 0;
+                ACTIVE = 1;
+            }
+
+            union Choice {
+                Payload payload = 1;
+                string note = 2;
+            }
+
+            Payload payload = 1;
+            Kind kind = 2;
+            Choice choice = 3;
+        }
+        """
+    )
+
+    dart_output = render_files(generate_files(schema, DartGenerator))
+    assert (
+        "registerGeneratedStruct(fory, _envelopeForySchema, id: null, name: 'demo.Envelope');"
+        in dart_output
+    )
+    assert (
+        "registerGeneratedEnum(fory, _envelopeKindForySchema, id: null, name: 'demo.Envelope.Kind');"
+        in dart_output
+    )
+    assert (
+        "fory.registerSerializer(Envelope_Choice, const _Envelope_ChoiceForySerializer(), id: null, name: 'demo.Envelope.Choice');"
+        in dart_output
+    )
+    assert "namespace:" not in dart_output
+    assert "typeName:" not in dart_output
+
+    python_output = render_files(generate_files(schema, PythonGenerator))
+    assert 'fory.register_type(Envelope, name="demo.Envelope")' in python_output
+    assert (
+        'fory.register_type(Envelope.Kind, name="demo.Envelope.Kind")' in python_output
+    )
+    assert (
+        'fory.register_union(Envelope.Choice, name="demo.Envelope.Choice", serializer=Envelope.ChoiceSerializer(fory.type_resolver))'
+        in python_output
+    )
+    assert "namespace=" not in python_output
+    assert "typename=" not in python_output
+
+    swift_output = render_files(generate_files(schema, SwiftGenerator))
+    assert (
+        'try fory.register(Demo.Envelope.self, name: "demo.Envelope")' in swift_output
+    )
+    assert (
+        'try fory.register(Demo.Envelope.Kind.self, name: "demo.Envelope.Kind")'
+        in swift_output
+    )
+    assert (
+        'try fory.register(Demo.Envelope.Choice.self, name: "demo.Envelope.Choice")'
+        in swift_output
+    )
+    assert "namespace:" not in swift_output
+
+
 def test_java_default_package_import_registers_dependency(tmp_path):
     common = tmp_path / "common.fdl"
     common.write_text(