Merge branch 'main' into document_stray_files2

.github/workflows/codeql-analysis.yml

@@ -33,7 +33,7 @@ jobs:
 
       # Initializes the CodeQL tools for scanning.
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@babb554ede22fd5605947329c4d04d8e7a0b8155
+        uses: github/codeql-action/init@df409f7d9260372bd5f19e5b04e83cb3c43714ae
         with:
           languages: ${{ matrix.language }}
           # If you wish to specify custom queries, you can do so here or in a config file.
@@ -44,7 +44,7 @@ jobs:
       # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
       # If this step fails, then you should remove it and run the build manually (see below)
       - name: Autobuild
-        uses: github/codeql-action/autobuild@babb554ede22fd5605947329c4d04d8e7a0b8155
+        uses: github/codeql-action/autobuild@df409f7d9260372bd5f19e5b04e83cb3c43714ae
 
       # ℹ️ Command-line programs to run using the OS shell.
       # 📚 https://git.io/JvXDl
@@ -58,4 +58,4 @@ jobs:
       #   make release
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@babb554ede22fd5605947329c4d04d8e7a0b8155
+        uses: github/codeql-action/analyze@df409f7d9260372bd5f19e5b04e83cb3c43714ae

.github/workflows/scorecards-analysis.yml

@@ -41,14 +41,14 @@ jobs:
 
       # Upload the results as artifacts (optional).
       - name: "Upload artifact"
-        uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882
+        uses: actions/upload-artifact@6f51ac03b9356f520e9adb1b1b7802705f340c2b
         with:
           name: SARIF file
           path: results.sarif
           retention-days: 5
 
       # Upload the results to GitHub's code scanning dashboard.
       - name: "Upload to code-scanning"
-        uses: github/codeql-action/upload-sarif@babb554ede22fd5605947329c4d04d8e7a0b8155
+        uses: github/codeql-action/upload-sarif@df409f7d9260372bd5f19e5b04e83cb3c43714ae
         with:
           sarif_file: results.sarif

package.json

@@ -26,7 +26,7 @@
     "@types/hast": "^3.0.4",
     "@types/markdown-it": "^14.1.2",
     "@types/node": "^22.10.2",
-    "firebase-tools": "^13.28.0",
+    "firebase-tools": "^13.29.1",
     "hast-util-from-html": "^2.0.3",
     "hast-util-select": "^6.0.3",
     "hast-util-to-text": "^4.0.2",
@@ -37,7 +37,7 @@
     "markdown-it-attrs": "^4.3.0",
     "markdown-it-container": "^4.0.0",
     "markdown-it-deflist": "^3.0.0",
-    "sass": "^1.82.0",
+    "sass": "^1.83.0",
     "shiki": "^1.24.2",
     "tsx": "^4.19.2"
   }

src/_data/glossary.yml

@@ -614,7 +614,7 @@
     - text: "Covariance and contravariance"
       link: "https://en.wikipedia.org/wiki/Covariance_and_contravariance_(computer_science)"
     - text: "The covariant keyword"
-      link: "/guides/language/sound-problems#the-covariant-keyword"
+      link: "/deprecated/sound-problems#the-covariant-keyword"
   labels:
     - "language"
     - "type system"

src/_data/keywords.yml

@@ -35,7 +35,7 @@
   link: /language/loops#break-and-continue
   type: reserved
 - term: 'covariant'
-  link: /guides/language/sound-problems#the-covariant-keyword
+  link: /deprecated/sound-problems#the-covariant-keyword
   type: bit
 - term: 'default'
   link: /language/branches#switch

src/_data/side-nav.yml

@@ -327,7 +327,7 @@
       - title: Customizing static analysis
         permalink: /tools/analysis
       - title: Fixing common type problems
-        permalink: /guides/language/sound-problems
+        permalink: /deprecated/sound-problems
       - title: Fixing type promotion failures
         permalink: /tools/non-promotion-reasons
       - title: Linter rules

src/_includes/navigation-main.html

@@ -15,7 +15,7 @@
     </li>
     <li class="mainnav__get-started">
       <a href="/guides" class="nav-link
-        {%- if page_url_path contains '/*/guides/' or page_url_path contains '/*/language/' or page_url_path contains '/*/resources/' or page_url_path contains '/*/codelabs/' or page_url_path contains '/*/samples/' or page_url_path contains '/*/tools/' or page_url_path contains '/*/tutorials/' or page_url_path contains '/*/server/' or page_url_path contains '/*/web/' or page_url_path contains '/*/effective-dart/' or page_url_path contains '/*/libraries/' %} active {%- endif -%}">
+        {%- if page_url_path contains '/*/guides/' or page_url_path contains '/*/language/' or page_url_path contains '/*/resources/' or page_url_path contains '/*/codelabs/' or page_url_path contains '/*/deprecated/' or page_url_path contains '/*/tools/' or page_url_path contains '/*/tutorials/' or page_url_path contains '/*/server/' or page_url_path contains '/*/web/' or page_url_path contains '/*/effective-dart/' or page_url_path contains '/*/libraries/' %} active {%- endif -%}">
         <span>Docs</span>
       </a>
     </li>

src/content/get-dart/index.md

@@ -23,9 +23,10 @@ includes the full Dart SDK. You don't need to install Dart separately and can sk
 Dart supports the following hardware architectures and platform versions
 to develop and run Dart code.
 
-{% assign yes = '<span class="material-symbols system-support" style="color: #158477;" aria-label="Supported" title="Supported">verified</span>' %}
+{% assign yes = '<span class="material-symbols system-support" style="color: #158477" aria-label="Supported" title="Supported">verified</span>' %}
 {% assign no = '<span class="material-symbols system-support" style="color: #D43324" aria-label="Not supported" title="Not supported">dangerous</span>' %}
 {% assign dep = '<span class="material-symbols system-support" style="color: #EF6C00" aria-label="Deprecated" title="Deprecated">error</span>' %}
+{% assign rem = '<span class="material-symbols system-support" style="color: #E25012" aria-label="Final deprecation" title="Final deprecation">report</span>' %}
 {% assign na = '<span class="material-symbols system-support" style="color: #DADCE0" aria-label="Does not exist" title="Does not exist">do_not_disturb_on</span>' %}
 {% assign macversions = 'Latest three versions of macOS:<br>' %}
 {% for version in macos limit:3 %}
@@ -40,14 +41,15 @@ to develop and run Dart code.
 
 | Platform |   x64   | IA32 (x86) |  Arm32  |  Arm64  | RISC-V (RV64GC) | OS Versions                                                 |
 |----------|:-------:|:----------:|:-------:|:-------:|:---------------:|-------------------------------------------------------------|
-| Windows  | {{yes}} |  {{dep}}   | {{no}}  | {{yes}} |     {{na}}      | [10], [11][]                                                |
-| Linux    | {{yes}} |  {{dep}}   | {{yes}} | {{yes}} |     {{yes}}     | [Debian stable][],<br>[Ubuntu LTS][] under standard support |
-| macOS    | {{yes}} |  {{no}}    | {{na}}  | {{yes}} |     {{na}}      | {{macversions}}                                             |
+| Windows  | {{yes}} |  {{rem}}   | {{no}}  | {{yes}} |     {{na}}      | [10], [11][]                                                |
+| Linux    | {{yes}} |  {{rem}}   | {{yes}} | {{yes}} |     {{yes}}     | [Debian stable][],<br>[Ubuntu LTS][] under standard support |
+| macOS    | {{yes}} |   {{no}}   | {{na}}  | {{yes}} |     {{na}}      | {{macversions}}                                             |
 
 {:.table .table-striped}
 
 {{yes}} Supported on all channels.<br>
 {{dep}} Support is deprecated and might be dropped in a future Dart release.<br>
+{{rem}} Support is deprecated and will likely be removed in the next stable release.<br>
 {{no}} Unsupported on all channels.<br>
 {{na}} Unsupported by the operating system.<br>
 

src/content/language/extend.md

@@ -78,7 +78,7 @@ it's similar to a downcast in that it can cause a type error at runtime.
 Still, narrowing the type is possible
 if the code can guarantee that a type error won't occur.
 In this case, you can use the
-[`covariant` keyword](/guides/language/sound-problems#the-covariant-keyword)
+[`covariant` keyword](/deprecated/sound-problems#the-covariant-keyword)
 in a parameter declaration.
 For details, see the
 [Dart language specification][].

src/content/language/type-system.md

@@ -179,7 +179,7 @@ subtype of the original parameter.
 
 :::note
 If you have a valid reason to use a subtype, you can use the
-[`covariant` keyword](/guides/language/sound-problems#the-covariant-keyword).
+[`covariant` keyword](/deprecated/sound-problems#the-covariant-keyword).
 :::
 
 Consider the `chase(Animal)` method for the `Animal` class:
@@ -488,7 +488,7 @@ and [Use sound parameter types when overriding methods](#use-proper-param-types)
 
 The following resources have further information on sound Dart:
 
-* [Fixing common type problems](/guides/language/sound-problems) - 
+* [Fixing common type problems](/deprecated/sound-problems) - 
   Errors you may encounter when writing sound Dart code, and how to fix them.
 * [Fixing type promotion failures](/tools/non-promotion-reasons) - 
   Understand and learn how to fix type promotion errors.

src/content/resources/coming-from/js-to-dart.md

@@ -122,7 +122,7 @@ consider themselves as equal.
 :::
 
 [Built-in types]: /language/built-in-types
-[Dart Language Tour]: /guides/language
+[Dart Language Tour]: /language
 
 For example:
 The equals operator `==` and the `identical()` method return `true`

src/content/resources/whats-new.md

@@ -548,7 +548,7 @@ we made the following changes to this site:
 * Added a section on customizing [`dart fix`][].
 
 [Objective-C and Swift interop]: /interop/objective-c-interop
-[Fixing common type problems]: /guides/language/sound-problems
+[Fixing common type problems]: /deprecated/sound-problems
 [What not to commit]: /tools/pub/private-files
 [`dart pub get` Options]: /tools/pub/cmd/pub-get#options
 [`dart compile`]: /tools/dart-compile