[web libraries] Deprecate Dart web libraries

#59716

Deprecate dart:html, dart:svg, dart:indexed_db, dart:web_audio,
and dart:web_gl in favor of package:web and dart:js_interop.

dart:web_sql has already been deprecated and unable to be
imported.

CoreLibraryReviewExempt: JS-specific library, deprecation only.
Change-Id: I2799b474be660153318a60d5e801ecd8431b08a2
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/401045
Reviewed-by: Sigmund Cherem <[email protected]>

Author: srujzs

CHANGELOG.md

@@ -209,6 +209,40 @@ snapshot of these tools as package build/build_web_compiler depends on it. The
 AOT snapshot can be used as follows to run DDC <dart-sdk>/bin/dartaotruntime
 <dart-sdk>/bin/snapshots/dartdevc_aot.dart.snapshot <options>
 
+### Libraries
+
+#### `dart:html`
+
+- `dart:html` is marked deprecated and will be removed in an upcoming release.
+  Users should migrate to using `dart:js_interop` and `package:web`. See
+  [#59716][].
+
+#### `dart:indexed_db`
+
+- `dart:indexed_db` is marked deprecated and will be removed in an upcoming
+  release. Users should migrate to using `dart:js_interop` and `package:web`.
+  See [#59716][].
+
+#### `dart:svg`
+
+- `dart:svg` is marked deprecated and will be removed in an upcoming release.
+  Users should migrate to using `dart:js_interop` and `package:web`. See
+  [#59716][].
+
+#### `dart:web_audio`
+
+- `dart:web_audio` is marked deprecated and will be removed in an upcoming
+  release. Users should migrate to using `dart:js_interop` and `package:web`.
+  See [#59716][].
+
+#### `dart:web_gl`
+
+- `dart:web_gl` is marked deprecated and will be removed in an upcoming release.
+  Users should migrate to using `dart:js_interop` and `package:web`. See
+  [#59716][].
+
+[#59716]: https://github.com/dart-lang/sdk/issues/59716
+
 ## 3.6.0
 
 ### Language

sdk/lib/html/dart2js/html_dart2js.dart

@@ -24,6 +24,7 @@
 ///
 /// {@category Web (Legacy)}
 /// {@canonicalFor dart:_internal.HttpStatus}
+@Deprecated('Use package:web and dart:js_interop instead.')
 library dart.dom.html;
 
 import 'dart:async';

sdk/lib/indexed_db/dart2js/indexed_db_dart2js.dart

@@ -75,6 +75,7 @@
 /// documentation](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API).
 ///
 /// {@category Web (Legacy)}
+@Deprecated('Use package:web and dart:js_interop instead.')
 library dart.dom.indexed_db;
 
 import 'dart:async';

sdk/lib/svg/dart2js/svg_dart2js.dart

@@ -15,6 +15,7 @@
 /// [Scalable Vector Graphics Specification](http://www.w3.org/TR/SVG/).
 ///
 /// {@category Web (Legacy)}
+@Deprecated('Use package:web and dart:js_interop instead.')
 library dart.dom.svg;
 
 import 'dart:async';

sdk/lib/web_audio/dart2js/web_audio_dart2js.dart

@@ -10,6 +10,7 @@
 /// > our [migration guide](https://dart.dev/go/package-web).
 ///
 /// {@category Web (Legacy)}
+@Deprecated('Use package:web and dart:js_interop instead.')
 library dart.dom.web_audio;
 
 import 'dart:async';

sdk/lib/web_gl/dart2js/web_gl_dart2js.dart

@@ -10,6 +10,7 @@
 /// > our [migration guide](https://dart.dev/go/package-web).
 ///
 /// {@category Web (Legacy)}
+@Deprecated('Use package:web and dart:js_interop instead.')
 library dart.dom.web_gl;
 
 import 'dart:async';

tools/dom/templates/html/dart2js/html_dart2js.darttemplate

@@ -24,6 +24,7 @@
 ///
 /// {@category Web (Legacy)}
 /// {@canonicalFor dart:_internal.HttpStatus}
+@Deprecated('Use package:web and dart:js_interop instead.')
 library dart.dom.html;
 
 import 'dart:async';

tools/dom/templates/html/dart2js/indexed_db_dart2js.darttemplate

@@ -75,6 +75,7 @@
 /// documentation](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API).
 ///
 /// {@category Web (Legacy)}
+@Deprecated('Use package:web and dart:js_interop instead.')
 library dart.dom.indexed_db;
 
 import 'dart:async';

tools/dom/templates/html/dart2js/svg_dart2js.darttemplate

@@ -15,6 +15,7 @@
 /// [Scalable Vector Graphics Specification](http://www.w3.org/TR/SVG/).
 ///
 /// {@category Web (Legacy)}
+@Deprecated('Use package:web and dart:js_interop instead.')
 library dart.dom.svg;
 
 import 'dart:async';

tools/dom/templates/html/dart2js/web_audio_dart2js.darttemplate

@@ -10,6 +10,7 @@
 /// > our [migration guide](https://dart.dev/go/package-web).
 ///
 /// {@category Web (Legacy)}
+@Deprecated('Use package:web and dart:js_interop instead.')
 library dart.dom.web_audio;
 
 import 'dart:async';