import 'dart:async'; import 'package:flutter/cupertino.dart'; import 'package:flutter/material.dart'; import '../../core/transport/pipelines_client.dart' as transport; import 'default_endpoint.dart'; import 'settings_controller.dart'; import 'settings_controls.dart'; import 'settings_layout.dart'; import 'settings_sections.dart'; import 'settings_store.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, }); final transport.PipelinesClient client; /// 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; @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( padding: const EdgeInsets.all(settingsPagePadding), child: Center( child: ConstrainedBox( constraints: const BoxConstraints( maxWidth: settingsContentMaxWidth, ), child: Column( crossAxisAlignment: CrossAxisAlignment.stretch, children: [ const _SectionTitle('Connection'), const SizedBox(height: settingsTitleGap), SettingsConnectionSection( controller: _controller, serverUrlField: _serverUrlField, ), const SizedBox(height: settingsSectionGap), const _SectionTitle('Workspace'), const SizedBox(height: settingsTitleGap), SettingsWorkspaceSection( controller: _controller, workspaceField: _workspaceField, ), ], ), ), ), ), ); if (widget.embedded) return content; if (usesCupertinoControls(context)) { return CupertinoPageScaffold( navigationBar: const CupertinoNavigationBar(middle: Text('Settings')), child: content, ); } return Scaffold( appBar: AppBar(title: const Text('Settings')), body: content, ); } } class _SectionTitle extends StatelessWidget { const _SectionTitle(this.title); final String title; @override Widget build(BuildContext context) { return Text(title, style: settingsTextStyle(context, title: true)); } }