import '../terminal/terminal_layout.dart'; import 'settings_terminal_section.dart'; import '../../ui/adaptive/segmented_bar.dart'; import 'dart:async'; import 'package:flutter/foundation.dart' show kIsWeb; import 'package:flutter/material.dart'; import '../../core/transport/pipelines_client.dart' as transport; import '../attention/notify/notification_controller.dart'; import 'default_endpoint.dart'; import 'settings_controller.dart'; import 'settings_font_section.dart'; import 'settings_animation_section.dart'; import 'settings_scale_section.dart'; import '../../ui/motion/animation_speed.dart'; import '../../ui/theme/app_font_controller.dart'; import 'settings_group.dart'; import 'storage/settings_storage_section.dart'; import 'health/settings_health_section.dart'; import 'settings_page_body.dart'; import 'settings_tabs.dart'; import 'settings_notifications_section.dart'; import 'settings_ntfy_section.dart'; import 'settings_device_delivery_section.dart'; import '../notification_service/notification_service_bridge.dart'; import '../notification_service/notification_service_controller.dart'; import 'settings_android_download_section.dart'; import 'settings_schedules_section.dart'; import 'settings_sections.dart'; import 'settings_sign_in_section.dart'; import 'security/settings_security_section.dart'; import 'settings_updates_section.dart'; import '../updates/app_updates.dart'; import 'settings_store.dart'; import 'settings_templates_section.dart'; import 'server_connections.dart'; import 'saved_servers_section.dart'; import 'managed_connection_section.dart'; import 'settings_keyboard_shortcuts_section.dart'; part 'settings_topic_pages.dart'; /// The Settings destination: the server connection and the server-side /// workspace in native Material controls. /// /// The shared [transport.PipelinesClient] is supplied by the shell. This screen /// subscribes to it, connects/disconnects it and pings it on connected, but it /// never opens a connection on its own and never disposes the client. One /// controller is created in [initState], so rebuilding the screen cannot start /// a second connection. class SettingsScreen extends StatefulWidget { const SettingsScreen({ super.key, required this.client, this.initialEndpoint, this.store, this.ping, this.embedded = false, this.navigationScope, this.onOpenTemplates, this.onOpenSchedules, this.notifications, this.showSignIn = false, this.showAndroidDownload = false, this.servers, this.deliveryService, this.deliveryServiceController, this.fonts, this.animationSpeed, this.terminalLayout, }); /// The device's interface font; defaults to the app's shared controller. final AppFontController? fonts; final AnimationSpeedController? animationSpeed; /// The terminal surface's layout (its mode is chosen here); null is the /// device's own. final TerminalLayout? terminalLayout; /// Android background delivery; hidden when absent or unsupported. final NotificationServiceBridge? deliveryService; final NotificationServiceController? deliveryServiceController; final transport.PipelinesClient client; /// Whether to offer the web sign-in (the native app; a browser has its own). final bool showSignIn; /// A browser page links the Android app the server offers. final bool showAndroidDownload; final ServerConnections? servers; /// A fixture/preview seed for the URL field. Persisted settings still load; /// this value takes precedence for the draft and is never written by itself. final Uri? initialEndpoint; /// The feature's own persistence. Defaults to the `pipelines.next` keys. final SettingsStore? store; /// Test seam for the exact ping request. Production uses `client.call('ping')`. final PingCallback? ping; /// The application shell already owns the native navigation bar and safe area. final bool embedded; /// The logical server scope used to restore the last Settings category. final String? navigationScope; /// Opens the Templates gallery. Null keeps Settings standalone/incomplete /// without a dead row that would go nowhere. final VoidCallback? onOpenTemplates; /// Opens the saved-schedule list above Settings. final VoidCallback? onOpenSchedules; /// The app-level notification capability; absent in connection-only fixtures. final NotificationController? notifications; @override State createState() => _SettingsScreenState(); } class _SettingsScreenState extends State { final TextEditingController _serverUrlField = TextEditingController(); final TextEditingController _workspaceField = TextEditingController(); late final SettingsController _controller; @override void initState() { super.initState(); _controller = SettingsController( client: widget.client, store: widget.store ?? const SharedPreferencesSettingsStore(), initialEndpoint: widget.initialEndpoint, defaultEndpoint: defaultServerUrl(), ping: widget.ping, ); _controller.addListener(_onSettingsChanged); unawaited(_controller.initialize()); } void _onSettingsChanged() { if (!mounted) return; _syncField(_serverUrlField, _controller.serverUrl); _syncField(_workspaceField, _controller.workspaceDraft); setState(() {}); } /// Follow the controller's value (a restored value or the normalised URL) /// without disturbing a field the operator is already typing in. void _syncField(TextEditingController field, String value) { if (field.text == value) return; field.value = TextEditingValue( text: value, selection: TextSelection.collapsed(offset: value.length), ); } @override void dispose() { _controller.removeListener(_onSettingsChanged); _controller.dispose(); _serverUrlField.dispose(); _workspaceField.dispose(); // The shared client is owned by the shell and deliberately outlives this // screen, so it is not disposed here. super.dispose(); } String get _endpoint => widget.servers == null ? _controller.serverUrl : widget.client.endpoint?.toString() ?? ''; void _reconnectAfterSignIn() { final endpoint = widget.client.endpoint; if (endpoint != null) { widget.client.connectAny( widget.client.endpoints.isEmpty ? [endpoint] : widget.client.endpoints, ); } } @override Widget build(BuildContext context) { final content = SettingsTopicTabs( pages: _topicPages(), navigationScope: widget.navigationScope, ); if (widget.embedded) return content; return Scaffold( extendBodyBehindAppBar: true, appBar: const SegmentedBar(title: 'Settings'), body: content, ); } }