Revert comment updates

sydneyjodon-wk · sydneyjodon-wk · commit 991992dc4858 · 2025-08-07T14:18:28.000-07:00
diff --git a/lib/src/dom/fire_event.dart b/lib/src/dom/fire_event.dart
@@ -41,7 +41,7 @@ import '../user_event/user_event.dart';
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// void main() {
diff --git a/lib/src/dom/pretty_dom.dart b/lib/src/dom/pretty_dom.dart
@@ -24,7 +24,7 @@ import 'package:js/js.dart';
 /// This can be helpful when debugging tests:
 ///
 /// ```dart
-/// 
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
diff --git a/lib/src/dom/queries/by_alt_text.dart b/lib/src/dom/queries/by_alt_text.dart
@@ -65,8 +65,8 @@ mixin ByAltTextQueries on IQueries {
   ///
   /// ```dart
   /// import 'package:react/react.dart' as react;
-  /// 
-  /// 
+  /// import 'package:react_testing_library/matchers.dart' show isInTheDocument;
+  /// import 'package:react_testing_library/react_testing_library.dart' as rtl;
   /// import 'package:test/test.dart';
   ///
   /// main() {
diff --git a/lib/src/dom/queries/by_display_value.dart b/lib/src/dom/queries/by_display_value.dart
@@ -71,8 +71,8 @@ mixin ByDisplayValueQueries on IQueries {
   ///
   /// ```dart
   /// import 'package:react/react.dart' as react;
-  /// 
-  /// 
+  /// import 'package:react_testing_library/matchers.dart' show isInTheDocument;
+  /// import 'package:react_testing_library/react_testing_library.dart' as rtl;
   /// import 'package:test/test.dart';
   ///
   /// main() {
diff --git a/lib/src/dom/queries/by_label_text.dart b/lib/src/dom/queries/by_label_text.dart
@@ -78,8 +78,8 @@ mixin ByLabelTextQueries on IQueries {
   ///
   /// ```dart
   /// import 'package:react/react.dart' as react;
-  /// 
-  /// 
+  /// import 'package:react_testing_library/matchers.dart' show isInTheDocument;
+  /// import 'package:react_testing_library/react_testing_library.dart' as rtl;
   /// import 'package:test/test.dart';
   ///
   /// main() {
diff --git a/lib/src/dom/queries/by_placeholder_text.dart b/lib/src/dom/queries/by_placeholder_text.dart
@@ -58,8 +58,8 @@ mixin ByPlaceholderTextQueries on IQueries {
   ///
   /// ```dart
   /// import 'package:react/react.dart' as react;
-  /// 
-  /// 
+  /// import 'package:react_testing_library/matchers.dart' show isInTheDocument;
+  /// import 'package:react_testing_library/react_testing_library.dart' as rtl;
   /// import 'package:test/test.dart';
   ///
   /// main() {
diff --git a/lib/src/dom/queries/by_role.dart b/lib/src/dom/queries/by_role.dart
@@ -88,8 +88,8 @@ mixin ByRoleQueries on IQueries {
   ///
   /// ```dart
   /// import 'package:react/react.dart' as react;
-  /// 
-  /// 
+  /// import 'package:react_testing_library/matchers.dart' show isInTheDocument;
+  /// import 'package:react_testing_library/react_testing_library.dart' as rtl;
   /// import 'package:test/test.dart';
   ///
   /// main() {
diff --git a/lib/src/dom/queries/by_testid.dart b/lib/src/dom/queries/by_testid.dart
@@ -73,8 +73,8 @@ mixin ByTestIdQueries on IQueries {
   ///
   /// ```dart
   /// import 'package:react/react.dart' as react;
-  /// 
-  /// 
+  /// import 'package:react_testing_library/matchers.dart' show isInTheDocument;
+  /// import 'package:react_testing_library/react_testing_library.dart' as rtl;
   /// import 'package:test/test.dart';
   ///
   /// main() {
diff --git a/lib/src/dom/queries/by_text.dart b/lib/src/dom/queries/by_text.dart
@@ -65,8 +65,8 @@ mixin ByTextQueries on IQueries {
   ///
   /// ```dart
   /// import 'package:react/react.dart' as react;
-  /// 
-  /// 
+  /// import 'package:react_testing_library/matchers.dart' show isInTheDocument;
+  /// import 'package:react_testing_library/react_testing_library.dart' as rtl;
   /// import 'package:test/test.dart';
   ///
   /// main() {
diff --git a/lib/src/dom/queries/by_title.dart b/lib/src/dom/queries/by_title.dart
@@ -62,8 +62,8 @@ mixin ByTitleQueries on IQueries {
   ///
   /// ```dart
   /// import 'package:react/react.dart' as react;
-  /// 
-  /// 
+  /// import 'package:react_testing_library/matchers.dart' show isInTheDocument;
+  /// import 'package:react_testing_library/react_testing_library.dart' as rtl;
   /// import 'package:test/test.dart';
   ///
   /// main() {
diff --git a/lib/src/matchers/jest_dom/contains_element.dart b/lib/src/matchers/jest_dom/contains_element.dart
@@ -31,8 +31,8 @@ import 'package:react_testing_library/src/matchers/jest_dom/util/constants.dart'
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show containsElement;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
diff --git a/lib/src/matchers/jest_dom/css_class_matchers.dart b/lib/src/matchers/jest_dom/css_class_matchers.dart
@@ -34,8 +34,8 @@ import 'package:react_testing_library/src/matchers/jest_dom/util/constants.dart'
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show hasClasses;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
@@ -78,8 +78,8 @@ Matcher hasClasses(dynamic classes) => _ElementClassNameMatcher(_ClassNameMatche
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show hasExactClasses;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
@@ -120,8 +120,8 @@ Matcher hasExactClasses(dynamic classes) =>
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show excludesClasses;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
diff --git a/lib/src/matchers/jest_dom/has_attribute.dart b/lib/src/matchers/jest_dom/has_attribute.dart
@@ -32,8 +32,8 @@ import 'package:react_testing_library/src/matchers/jest_dom/util/constants.dart'
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show hasAttribute;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
diff --git a/lib/src/matchers/jest_dom/has_description.dart b/lib/src/matchers/jest_dom/has_description.dart
@@ -51,8 +51,8 @@ import 'package:react_testing_library/src/matchers/jest_dom/util/element_text_co
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show hasDescription;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
diff --git a/lib/src/matchers/jest_dom/has_form_values.dart b/lib/src/matchers/jest_dom/has_form_values.dart
@@ -44,8 +44,8 @@ import 'package:react_testing_library/src/util/js_utils.dart';
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show hasFormValues;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
diff --git a/lib/src/matchers/jest_dom/has_styles.dart b/lib/src/matchers/jest_dom/has_styles.dart
@@ -37,8 +37,8 @@ import 'package:react_testing_library/src/matchers/jest_dom/util/constants.dart'
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show hasStyles;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
diff --git a/lib/src/matchers/jest_dom/has_text_content.dart b/lib/src/matchers/jest_dom/has_text_content.dart
@@ -37,8 +37,8 @@ import 'package:react_testing_library/src/matchers/jest_dom/util/element_text_co
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show hasTextContent;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
diff --git a/lib/src/matchers/jest_dom/has_value.dart b/lib/src/matchers/jest_dom/has_value.dart
@@ -47,8 +47,8 @@ import 'package:react_testing_library/src/matchers/jest_dom/util/get_value_of.da
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show hasValue;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
diff --git a/lib/src/matchers/jest_dom/is_checked.dart b/lib/src/matchers/jest_dom/is_checked.dart
@@ -39,8 +39,8 @@ import 'package:react_testing_library/src/matchers/jest_dom/util/constants.dart'
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show isChecked;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
diff --git a/lib/src/matchers/jest_dom/is_disabled.dart b/lib/src/matchers/jest_dom/is_disabled.dart
@@ -38,8 +38,8 @@ import 'package:react_testing_library/src/matchers/jest_dom/util/constants.dart'
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show isDisabled;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
diff --git a/lib/src/matchers/jest_dom/is_empty_dom_element.dart b/lib/src/matchers/jest_dom/is_empty_dom_element.dart
@@ -29,8 +29,8 @@ import 'package:react_testing_library/src/matchers/jest_dom/util/constants.dart'
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show isEmptyDomElement;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
diff --git a/lib/src/matchers/jest_dom/is_focused.dart b/lib/src/matchers/jest_dom/is_focused.dart
@@ -29,8 +29,8 @@ import 'package:react_testing_library/src/matchers/jest_dom/util/constants.dart'
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show isFocused;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
diff --git a/lib/src/matchers/jest_dom/is_in_the_document.dart b/lib/src/matchers/jest_dom/is_in_the_document.dart
@@ -39,8 +39,8 @@ import 'contains_element.dart' show containsElement;
 ///
 /// ```dart
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show isInTheDocument;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
diff --git a/lib/src/matchers/jest_dom/is_partially_checked.dart b/lib/src/matchers/jest_dom/is_partially_checked.dart
@@ -42,8 +42,8 @@ import 'package:react_testing_library/src/matchers/jest_dom/util/constants.dart'
 /// import 'dart:html';
 ///
 /// import 'package:react/react.dart' as react;
-/// 
-/// 
+/// import 'package:react_testing_library/matchers.dart' show isPartiallyChecked;
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 /// import 'package:test/test.dart';
 ///
 /// main() {
diff --git a/lib/src/react/render/render.dart b/lib/src/react/render/render.dart
@@ -45,8 +45,8 @@ import 'package:react_testing_library/src/react/render/types.dart' show JsRender
 /// ```dart
 /// import 'package:react/react.dart' as react;
 /// import 'package:test/test.dart';
-/// 
-/// 
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
+/// import 'package:react_testing_library/matchers.dart' show isInTheDocument;
 ///
 /// main() {
 ///   test('', () {
@@ -74,7 +74,7 @@ import 'package:react_testing_library/src/react/render/types.dart' show JsRender
 ///
 /// import 'package:react/react.dart' as react;
 /// import 'package:test/test.dart';
-/// 
+/// import 'package:react_testing_library/react_testing_library.dart' as rtl;
 ///
 /// main() {
 ///   test('', () {
diff --git a/lib/src/user_event/user_event.dart b/lib/src/user_event/user_event.dart
