Merge branch 'master' into fix/network-hot-restart

Author: muhammadkamel

CONTRIBUTING.md

@@ -162,11 +162,11 @@ as the example Flutter app to connect to when working on DevTools.
 
 ## Running and debugging DevTools
 
-Please see [DEBUGGING.md]() for guidance on running and debugging DevTools.
+Please see [DEBUGGING.md](DEBUGGING.md) for guidance on running and debugging DevTools.
 
 ## Testing for DevTools
 
-Please see [TESTING.md]() for guidance on running and writing tests.
+Please see [TESTING.md](TESTING.md) for guidance on running and writing tests.
 
 ## Appendix
 

packages/devtools_app/lib/devtools_app.dart

@@ -10,6 +10,8 @@ export 'src/framework/notifications_view.dart';
 export 'src/framework/release_notes.dart';
 export 'src/framework/scaffold/app_bar.dart';
 export 'src/framework/scaffold/status_line.dart';
+export 'src/screens/accessibility/accessibility_controller.dart';
+export 'src/screens/accessibility/accessibility_screen.dart';
 export 'src/screens/app_size/app_size_controller.dart';
 export 'src/screens/app_size/app_size_screen.dart';
 export 'src/screens/debugger/breakpoint_manager.dart';

packages/devtools_app/lib/src/app.dart

@@ -23,6 +23,8 @@ import 'framework/notifications_view.dart';
 import 'framework/observer/disconnect_observer.dart';
 import 'framework/release_notes.dart';
 import 'framework/scaffold/scaffold.dart';
+import 'screens/accessibility/accessibility_controller.dart';
+import 'screens/accessibility/accessibility_screen.dart';
 import 'screens/app_size/app_size_controller.dart';
 import 'screens/app_size/app_size_screen.dart';
 import 'screens/debugger/debugger_controller.dart';
@@ -713,6 +715,11 @@ List<DevToolsScreen> defaultScreens({
       LoggingScreen(),
       createController: (_) => LoggingController(),
     ),
+    if (FeatureFlags.accessibility.isEnabled)
+      DevToolsScreen<AccessibilityController>(
+        AccessibilityScreen(),
+        createController: (_) => AccessibilityController(),
+      ),
     DevToolsScreen<DevToolsScreenController>(ProviderScreen()),
     DevToolsScreen<AppSizeController>(
       AppSizeScreen(),

packages/devtools_app/lib/src/screens/accessibility/accessibility_controller.dart

@@ -0,0 +1,121 @@
+// Copyright 2026 The Flutter Authors
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file or at https://developers.google.com/open-source/licenses/bsd.
+
+import 'dart:async';
+
+import 'package:devtools_app_shared/service.dart';
+import 'package:devtools_app_shared/utils.dart';
+import 'package:flutter/foundation.dart';
+
+import '../../service/service_extensions.dart' as extensions;
+import '../../shared/framework/screen.dart';
+import '../../shared/framework/screen_controllers.dart';
+import '../../shared/globals.dart';
+
+/// Modes for brightness override in the accessibility controls.
+enum BrightnessOverride {
+  system('System Default', 'system'),
+  light('Light Mode', 'Brightness.light'),
+  dark('Dark Mode', 'Brightness.dark');
+
+  const BrightnessOverride(this.display, this.value);
+
+  /// The user-facing display label for this override option.
+  final String display;
+
+  /// The raw value associated with this override option sent to or received
+  /// from the VM service extension.
+  final String value;
+}
+
+/// Controller for the Accessibility screen.
+class AccessibilityController extends DevToolsScreenController
+    with AutoDisposeControllerMixin {
+  AccessibilityController() {
+    _initListeners();
+  }
+
+  @override
+  void init() {
+    super.init();
+    _initServiceExtensionStates();
+  }
+
+  void _initListeners() {
+    addAutoDisposeListener(brightness, _onBrightnessChanged);
+    addAutoDisposeListener(textScale, _onTextScaleChanged);
+    addAutoDisposeListener(boldText, _onBoldTextChanged);
+    addAutoDisposeListener(screenReader, _onScreenReaderChanged);
+    addAutoDisposeListener(highContrast, _onHighContrastChanged);
+  }
+
+  void _initServiceExtensionStates() {
+    final state = serviceConnection.serviceManager.serviceExtensionManager
+        .getServiceExtensionState(extensions.brightnessMode.extension);
+
+    void updateFromDeviceState(ServiceExtensionState state) {
+      final newBrightness = !state.enabled || state.value == null
+          ? BrightnessOverride.system
+          : BrightnessOverride.values.firstWhere(
+              (b) => b.value == state.value,
+              orElse: () => BrightnessOverride.system,
+            );
+      brightness.value = newBrightness;
+    }
+
+    updateFromDeviceState(state.value);
+    addAutoDisposeListener(state, () => updateFromDeviceState(state.value));
+  }
+
+  void _onBrightnessChanged() {
+    final value = brightness.value;
+    unawaited(
+      serviceConnection.serviceManager.serviceExtensionManager
+          .setServiceExtensionState(
+            extensions.brightnessMode.extension,
+            enabled: value != BrightnessOverride.system,
+            value: value.value,
+          ),
+    );
+  }
+
+  void _onTextScaleChanged() {
+    // TODO(hannah-hyj): Implement VM service extension call for text scale override.
+  }
+
+  void _onBoldTextChanged() {
+    // TODO(hannah-hyj): Implement VM service extension call for bold text override.
+  }
+
+  void _onScreenReaderChanged() {
+    // TODO(hannah-hyj): Implement VM service extension call for screen reader / semantics debugger.
+    // e.g. using 'ext.flutter.showSemanticsDebugger'.
+  }
+
+  void _onHighContrastChanged() {
+    // TODO(hannah-hyj): Implement VM service extension call for high contrast override.
+  }
+
+  @override
+  final screenId = ScreenMetaData.accessibility.id;
+
+  // --- Accessibility Overrides State ---
+  final brightness = ValueNotifier<BrightnessOverride>(
+    BrightnessOverride.system,
+  );
+  final textScale = ValueNotifier<double>(1.0);
+  final boldText = ValueNotifier<bool>(false);
+  final screenReader = ValueNotifier<bool>(false);
+  final highContrast = ValueNotifier<bool>(false);
+
+  @override
+  void dispose() {
+    brightness.dispose();
+    textScale.dispose();
+    boldText.dispose();
+    screenReader.dispose();
+    highContrast.dispose();
+    super.dispose();
+  }
+}

packages/devtools_app/lib/src/screens/accessibility/accessibility_screen.dart

@@ -0,0 +1,64 @@
+// Copyright 2026 The Flutter Authors
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file or at https://developers.google.com/open-source/licenses/bsd.
+
+import 'package:devtools_app_shared/ui.dart';
+import 'package:devtools_app_shared/utils.dart';
+import 'package:flutter/material.dart';
+
+import '../../shared/framework/screen.dart';
+import '../../shared/globals.dart';
+import 'accessibility_controller.dart';
+import 'overrides_pane.dart';
+import 'semantics_tree_pane.dart';
+
+export 'overrides_pane.dart';
+export 'semantics_tree_pane.dart';
+
+/// A screen that displays accessibility information.
+class AccessibilityScreen extends Screen {
+  AccessibilityScreen() : super.fromMetaData(ScreenMetaData.accessibility);
+
+  static final id = ScreenMetaData.accessibility.id;
+
+  @override
+  Widget buildScreenBody(BuildContext context) =>
+      const AccessibilityScreenBody();
+}
+
+class AccessibilityScreenBody extends StatefulWidget {
+  const AccessibilityScreenBody({super.key});
+
+  @override
+  State<AccessibilityScreenBody> createState() =>
+      _AccessibilityScreenBodyState();
+}
+
+class _AccessibilityScreenBodyState extends State<AccessibilityScreenBody>
+    with AutoDisposeMixin {
+  late AccessibilityController controller;
+
+  @override
+  void initState() {
+    super.initState();
+    controller = screenControllers.lookup<AccessibilityController>();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final splitAxis = _splitAxisFor(context);
+    return SplitPane(
+      axis: splitAxis,
+      initialFractions: const [0.6, 0.4],
+      children: const [
+        AccessibilitySemanticsTreePane(),
+        AccessibilityOverridesPane(),
+      ],
+    );
+  }
+
+  Axis _splitAxisFor(BuildContext context) {
+    final screenSize = MediaQuery.of(context).size;
+    return screenSize.width > 1000 ? Axis.horizontal : Axis.vertical;
+  }
+}