Doc imports again (#152958)

https://github.com/flutter/flutter/issues/150800

The only remaining reports of `comment_references` are now because of the known issues listed in https://github.com/flutter/flutter/issues/150800.

examples/api/lib/ui/text/font_feature.font_feature_tabular_figures.0.dart

@@ -4,7 +4,7 @@
 
 import 'package:flutter/widgets.dart';
 
-/// Flutter code sample for [dart]:ui FontFeature.FontFeature.tabularFigures.
+/// Flutter code sample for [FontFeature.tabularFigures].
 
 void main() => runApp(const ExampleApp());
 

packages/flutter/lib/src/animation/animation.dart

@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+/// @docImport 'package:flutter/scheduler.dart';
 /// @docImport 'package:flutter/widgets.dart';
 library;
 

packages/flutter/lib/src/material/app.dart

@@ -2,6 +2,8 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+/// @docImport 'package:flutter_localizations/flutter_localizations.dart';
+///
 /// @docImport 'app_bar.dart';
 /// @docImport 'color_scheme.dart';
 /// @docImport 'dialog.dart';

packages/flutter/lib/src/material/button_style_button.dart

@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+/// @docImport 'elevated_button_theme.dart';
 /// @docImport 'menu_anchor.dart';
 /// @docImport 'text_button_theme.dart';
 /// @docImport 'text_theme.dart';

packages/flutter/lib/src/material/material_localizations.dart

@@ -3,6 +3,7 @@
 // found in the LICENSE file.
 
 /// @docImport 'package:flutter/services.dart';
+/// @docImport 'package:flutter_localizations/flutter_localizations.dart';
 ///
 /// @docImport 'about.dart';
 /// @docImport 'action_buttons.dart';

packages/flutter/lib/src/material/reorderable_list.dart

@@ -2,6 +2,8 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+/// @docImport 'package:flutter_test/flutter_test.dart';
+///
 /// @docImport 'card.dart';
 library;
 

packages/flutter/lib/src/widgets/binding.dart

@@ -5,6 +5,7 @@
 /// @docImport 'dart:ui';
 /// @docImport 'package:flutter/animation.dart';
 /// @docImport 'package:flutter/material.dart';
+/// @docImport 'package:flutter_test/flutter_test.dart';
 ///
 /// @docImport 'adapter.dart';
 /// @docImport 'app_lifecycle_listener.dart';

packages/flutter/lib/src/widgets/default_selection_style.dart

@@ -2,6 +2,8 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+/// @docImport 'package:flutter/material.dart';
+///
 /// @docImport 'editable_text.dart';
 /// @docImport 'text.dart';
 library;

packages/flutter/lib/src/widgets/draggable_scrollable_sheet.dart

@@ -3,6 +3,7 @@
 // found in the LICENSE file.
 
 /// @docImport 'package:flutter/material.dart';
+/// @docImport 'package:flutter_test/flutter_test.dart';
 ///
 /// @docImport 'primary_scroll_controller.dart';
 /// @docImport 'scroll_configuration.dart';

packages/flutter/lib/src/widgets/framework.dart

@@ -3,9 +3,11 @@
 // found in the LICENSE file.
 
 /// @docImport 'dart:ui';
+///
 /// @docImport 'package:flutter/animation.dart';
 /// @docImport 'package:flutter/material.dart';
 /// @docImport 'package:flutter/widgets.dart';
+/// @docImport 'package:flutter_test/flutter_test.dart';
 library;
 
 import 'dart:async';

packages/flutter/lib/src/widgets/localizations.dart

@@ -3,6 +3,7 @@
 // found in the LICENSE file.
 
 /// @docImport 'package:flutter/material.dart';
+/// @docImport 'package:flutter_localizations/flutter_localizations.dart';
 ///
 /// @docImport 'app.dart';
 /// @docImport 'reorderable_list.dart';

packages/flutter/lib/src/widgets/primary_scroll_controller.dart

@@ -4,6 +4,7 @@
 
 /// @docImport 'package:flutter/material.dart';
 /// @docImport 'package:flutter/rendering.dart';
+/// @docImport 'package:flutter_test/flutter_test.dart';
 ///
 /// @docImport 'actions.dart';
 /// @docImport 'focus_manager.dart';

packages/flutter/lib/src/widgets/scroll_controller.dart

@@ -3,6 +3,7 @@
 // found in the LICENSE file.
 
 /// @docImport 'package:flutter/material.dart';
+/// @docImport 'package:flutter_test/flutter_test.dart';
 ///
 /// @docImport 'framework.dart';
 /// @docImport 'notification_listener.dart';

packages/flutter/lib/src/widgets/scroll_delegate.dart

@@ -663,10 +663,10 @@ class SliverChildListDelegate extends SliverChildDelegate {
   /// ```
   final List<Widget> children;
 
-  /// A map to cache key to index lookup for children.
+  // A map to cache key to index lookup for children.
-  ///
+  //
-  /// _keyToIndex[null] is used as current index during the lazy loading process
+  // _keyToIndex[null] is used as current index during the lazy loading process
-  /// in [_findChildIndex]. _keyToIndex should never be used for looking up null key.
+  // in [_findChildIndex]. _keyToIndex should never be used for looking up null key.
   final Map<Key?, int>? _keyToIndex;
 
   bool get _isConstantInstance => _keyToIndex == null;

packages/flutter/lib/src/widgets/scroll_view.dart

@@ -5,6 +5,7 @@
 /// @docImport 'package:flutter/cupertino.dart';
 /// @docImport 'package:flutter/material.dart';
 /// @docImport 'package:flutter/widgets.dart';
+/// @docImport 'package:flutter_test/flutter_test.dart';
 library;
 
 import 'dart:math' as math;

packages/flutter/lib/src/widgets/scrollbar.dart

@@ -4,6 +4,7 @@
 
 /// @docImport 'package:flutter/cupertino.dart';
 /// @docImport 'package:flutter/material.dart';
+/// @docImport 'package:flutter_test/flutter_test.dart';
 ///
 /// @docImport 'editable_text.dart';
 /// @docImport 'list_wheel_scroll_view.dart';

packages/flutter/lib/src/widgets/selectable_region.dart

@@ -3,6 +3,7 @@
 // found in the LICENSE file.
 
 /// @docImport 'package:flutter/material.dart';
+/// @docImport 'package:flutter_test/flutter_test.dart';
 ///
 /// @docImport 'editable_text.dart';
 /// @docImport 'text.dart';

packages/flutter/lib/src/widgets/sliver_prototype_extent_list.dart

@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+/// @docImport 'basic.dart';
 /// @docImport 'scroll_view.dart';
 /// @docImport 'sliver_fill.dart';
 library;

packages/flutter/pubspec.yaml

@@ -25,6 +25,8 @@ dev_dependencies:
     sdk: flutter
   flutter_goldens:
     sdk: flutter
+  flutter_localizations:
+    sdk: flutter
   fake_async: 1.3.1
   # To track memory leaks.
   leak_tracker_flutter_testing: 3.0.5
@@ -37,6 +39,7 @@ dev_dependencies:
   clock: 1.1.1 # THIS LINE IS AUTOGENERATED - TO UPDATE USE "flutter update-packages --force-upgrade"
   crypto: 3.0.3 # THIS LINE IS AUTOGENERATED - TO UPDATE USE "flutter update-packages --force-upgrade"
   file: 7.0.0 # THIS LINE IS AUTOGENERATED - TO UPDATE USE "flutter update-packages --force-upgrade"
+  intl: 0.19.0 # THIS LINE IS AUTOGENERATED - TO UPDATE USE "flutter update-packages --force-upgrade"
   matcher: 0.12.16+1 # THIS LINE IS AUTOGENERATED - TO UPDATE USE "flutter update-packages --force-upgrade"
   path: 1.9.0 # THIS LINE IS AUTOGENERATED - TO UPDATE USE "flutter update-packages --force-upgrade"
   platform: 3.1.5 # THIS LINE IS AUTOGENERATED - TO UPDATE USE "flutter update-packages --force-upgrade"
@@ -52,4 +55,4 @@ dev_dependencies:
   vm_service: 14.2.4 # THIS LINE IS AUTOGENERATED - TO UPDATE USE "flutter update-packages --force-upgrade"
   webdriver: 3.0.3 # THIS LINE IS AUTOGENERATED - TO UPDATE USE "flutter update-packages --force-upgrade"
 
-# PUBSPEC CHECKSUM: 3096
+# PUBSPEC CHECKSUM: 9ad0

packages/flutter_goldens/lib/flutter_goldens.dart

@@ -2,6 +2,9 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+/// @docImport 'dart:io';
+library;
+
 import 'dart:async' show FutureOr;
 import 'dart:io' as io show HttpClient, OSError, SocketException;