import '../../ui/adaptive/segmented_bar.dart'; import 'dart:async'; import 'package:flutter/cupertino.dart'; import 'package:flutter/material.dart'; import '../../core/transport/pipelines_client.dart' as transport; import '../attention/notify/notification_controller.dart'; import '../attention/notify/notification_models.dart'; import 'default_endpoint.dart'; import 'settings_controller.dart'; import 'settings_controls.dart'; import 'settings_layout.dart'; import 'settings_notifications_section.dart'; import 'settings_ntfy_section.dart'; import 'settings_android_download_section.dart'; import 'settings_schedules_section.dart'; import 'settings_sections.dart'; import 'settings_sign_in_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'; /// The Settings destination: the server connection and the server-side /// workspace, in native Material (native platforms) or Cupertino (iOS) 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.onOpenTemplates, this.onOpenSchedules, this.notifications, this.showSignIn = false, this.showAndroidDownload = false, this.servers, }); 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; /// 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(); } @override Widget build(BuildContext context) { final content = SafeArea( child: SingleChildScrollView( // Web `.settings` page insets: 20 above the title, 16 at the sides and // a clear 32 below the last section. padding: const EdgeInsetsDirectional.fromSTEB( settingsPageSidePadding, settingsPageTopPadding, settingsPageSidePadding, settingsPageBottomPadding, ), child: Center( child: ConstrainedBox( constraints: const BoxConstraints( maxWidth: settingsContentMaxWidth, ), child: Column( crossAxisAlignment: CrossAxisAlignment.stretch, children: [ if (widget.servers != null) ...[ _SettingsSection( title: 'Servers', child: SavedServersSection(connections: widget.servers!), ), const SizedBox(height: settingsSectionGap), ], _SettingsSection( title: 'Connection', child: widget.servers != null ? ManagedConnectionSection( client: widget.client, controller: _controller, ) : SettingsConnectionSection( controller: _controller, serverUrlField: _serverUrlField, ), ), // A phone signs in at the web login; a browser has its own. if (widget.showSignIn) ...[ const SizedBox(height: settingsSectionGap), _SettingsSection( title: 'Sign in', child: SettingsSignInSection( endpoint: widget.servers == null ? _controller.serverUrl : widget.client.endpoint?.toString() ?? '', onChanged: () { final endpoint = widget.client.endpoint; if (endpoint != null) { widget.client.connectAny( widget.client.endpoints.isEmpty ? [endpoint] : widget.client.endpoints, ); } }, ), ), ], // The web page links the Android app the server offers. if (widget.showAndroidDownload) ...[ const SizedBox(height: settingsSectionGap), const _SettingsSection( title: 'Android app', child: SettingsAndroidDownloadSection(), ), ], // A phone installs newer builds from the server. if (widget.showSignIn && appUpdatesSupported) ...[ const SizedBox(height: settingsSectionGap), _SettingsSection( title: 'App updates', child: SettingsUpdatesSection( endpoint: widget.servers == null ? _controller.serverUrl : widget.client.endpoint?.toString() ?? '', ), ), ], const SizedBox(height: settingsSectionGap), _SettingsSection( title: 'Workspace', child: SettingsWorkspaceSection( controller: _controller, workspaceField: _workspaceField, ), ), if (widget.notifications != null) ...[ const SizedBox(height: settingsSectionGap), _SettingsSection( title: notificationSectionTitle, child: SettingsNotificationsSection( controller: widget.notifications!, ), ), ], // The server's ntfy choices, beside the in-app permission. const SizedBox(height: settingsSectionGap), _SettingsSection( title: ntfySectionTitle, child: SettingsNtfySection( gateway: widget.client, connected: widget.client.state.kind == transport.ConnectionKind.connected, ), ), if (widget.onOpenSchedules != null) ...[ const SizedBox(height: settingsSectionGap), _SettingsSection( title: 'Schedules', child: SettingsSchedulesSection( onOpen: widget.onOpenSchedules!, ), ), ], if (widget.onOpenTemplates != null) ...[ const SizedBox(height: settingsSectionGap), _SettingsSection( title: 'Templates', child: SettingsTemplatesSection( onOpen: widget.onOpenTemplates!, ), ), ], ], ), ), ), ), ); if (widget.embedded) return content; if (usesCupertinoControls(context)) { return CupertinoPageScaffold( navigationBar: const SegmentedBar(cupertino: true, title: 'Settings'), child: content, ); } return Scaffold( extendBodyBehindAppBar: true, appBar: const SegmentedBar(cupertino: false, title: 'Settings'), body: content, ); } } /// One grouped Settings section: a compact title followed by its body at the /// web's 8px title gap. Sections are separated by [settingsSectionGap]. A null /// title lets a body (the notification tile) draw its own compact heading. class _SettingsSection extends StatelessWidget { const _SettingsSection({required this.child, this.title}); final String? title; final Widget child; @override Widget build(BuildContext context) { final title = this.title; return Column( crossAxisAlignment: CrossAxisAlignment.stretch, children: [ if (title != null) ...[ Text(title, style: settingsTextStyle(context, title: true)), const SizedBox(height: settingsTitleGap), ], child, ], ); } }