feat(apps/chat): 新增 UI Schema 导航和路由导航工具

apps/lib/features/chat/ui/widgets/ui_schema_renderer.dart

@@ -4,6 +4,7 @@ import 'package:go_router/go_router.dart';
 import 'package:social_app/core/theme/design_tokens.dart';
 import 'package:social_app/shared/widgets/toast/toast.dart';
 import 'package:social_app/shared/widgets/toast/toast_type.dart';
+import '../navigation/ui_schema_navigation.dart';
 
 class UiSchemaRenderer {
   static Widget renderSchema(Map<String, dynamic>? schema) {
@@ -226,22 +227,16 @@ class UiSchemaRenderer {
     }
 
     final path = _asString(action['path']).trim();
-    if (!_isValidInternalPath(path)) {
+    if (!isValidInternalNavigationPath(path)) {
       Toast.show(context, '导航路径无效', type: ToastType.warning);
       return;
     }
 
     final params = _asMap(action['params']);
-    final replace = action['replace'] == true;
-    final queryParams = _extractNavigationQueryParams(params);
+    final shouldReplace = action['replace'] == true;
     try {
-      final baseUri = Uri.parse(path);
-      final mergedQueryParams = {...baseUri.queryParameters, ...queryParams};
-      final targetUri = baseUri.replace(
-        queryParameters: mergedQueryParams.isEmpty ? null : mergedQueryParams,
-      );
-      final target = targetUri.toString();
-      if (replace) {
+      final target = buildUiSchemaNavigationTarget(path: path, params: params);
+      if (shouldReplace) {
         context.replace(target);
         return;
       }
@@ -251,38 +246,6 @@ class UiSchemaRenderer {
     }
   }
 
-  static bool _isValidInternalPath(String path) {
-    if (path.isEmpty || !path.startsWith('/')) {
-      return false;
-    }
-    if (path.startsWith('//') || path.contains('://')) {
-      return false;
-    }
-    if (path.contains('?') || path.contains('#') || path.contains(':')) {
-      return false;
-    }
-    return true;
-  }
-
-  static Map<String, String> _extractNavigationQueryParams(
-    Map<String, dynamic>? params,
-  ) {
-    if (params == null || params.isEmpty) {
-      return const {};
-    }
-    final query = <String, String>{};
-    params.forEach((key, value) {
-      if (value is String && value.isNotEmpty) {
-        query[key] = value;
-        return;
-      }
-      if (value is num || value is bool) {
-        query[key] = value.toString();
-      }
-    });
-    return query;
-  }
-
   static Widget _renderKv(Map<String, dynamic> node) {
     final items = _asList(
       node['items'],
@@ -406,17 +369,14 @@ class UiSchemaRenderer {
   }
 
   static List<Widget> _withGap(List<Widget> widgets, double gap) {
-    if (widgets.isEmpty) {
-      return const [];
-    }
-    final result = <Widget>[];
-    for (var i = 0; i < widgets.length; i++) {
-      if (i > 0) {
-        result.add(SizedBox(height: gap));
-      }
-      result.add(widgets[i]);
-    }
-    return result;
+    if (widgets.isEmpty) return const [];
+    return [
+      widgets.first,
+      for (int i = 1; i < widgets.length; i++) ...[
+        SizedBox(height: gap),
+        widgets[i],
+      ],
+    ];
   }
 
   static Color _statusBackground(String status) {
@@ -454,13 +414,7 @@ class UiSchemaRenderer {
       return value;
     }
     if (value is Map) {
-      final result = <String, dynamic>{};
-      for (final entry in value.entries) {
-        if (entry.key is String) {
-          result[entry.key as String] = entry.value;
-        }
-      }
-      return result;
+      return Map<String, dynamic>.from(value);
     }
     return null;
   }