[web docs] add package:web to the main sdk docs - api.dart.dev

Change-Id: I858db7090563cc7366d22f191b7cd3cf49047d5e
CoreLibraryReviewExempt: doc only change to the web libraries
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/348182
Commit-Queue: Devon Carew <devoncarew@google.com>
Reviewed-by: Srujan Gaddam <srujzs@google.com>

DEPS

@@ -141,7 +141,7 @@ vars = {
   #
   # For more details, see https://github.com/dart-lang/sdk/issues/30164.
   "dart_style_rev": "8b1f24a8475a0116757172cd9acca4acbf87d973", # disable rev_sdk_deps.dart
-  "dartdoc_rev": "49d48d7749f48e2d9930ffda5bcde1e692ffce31",
+  "dartdoc_rev": "0f13e6443595f8e49cc86d783210d78c93d3502e",
   "ecosystem_rev": "1e2785d6900b4d709a31f4c669381dc340cad605",
   "ffi_rev": "c926657618443ff4821411ede01684096b503f84",
   "file_rev": "cd3a9324f6483f313ba1f0f3ff382ea4e6982ef2",

sdk/lib/js_interop/js_interop.dart

@@ -11,11 +11,6 @@
 /// functionality like the conversion functions e.g. `toJS` and not runtime
 /// mechanisms like type checks and casts.
 ///
-/// > [!Important]
-/// > This library is still a work in progress. As such, JS types, allowed
-/// > syntax, semantics, and functionality may all change, so avoid using this
-/// > library in production.
-///
 /// {@category Web}
 library dart.js_interop;
 

tools/write_dartdoc_options_file.py

@@ -33,6 +33,23 @@ def Main(argv):
         revision = 'main'
     output = '''dartdoc:
   categoryOrder: ["Core", "VM", "Web", "Web (Legacy)"]
+  categories:
+    'Web':
+      external:
+        - name: 'package:web'
+          url: https://pub.dev/documentation/web/latest/
+          docs: >-
+            This package exposes browser APIs. It's intended to replace
+            dart:html and similar Dart SDK libraries. It will support access to
+            browser APIs from Dart code compiled to either JavaScript or
+            WebAssembly.
+    'Web (Legacy)':
+      external:
+        - name: 'package:js'
+          url: https://pub.dev/documentation/js/latest/
+          docs: >-
+            Use this package when you want to call JavaScript APIs from Dart
+            code, or vice versa.
   linkToSource:
     root: '.'
     uriTemplate: 'https://github.com/dart-lang/sdk/blob/%s/sdk/%%f%%#L%%l%%'