[sync] 2024/12/24 (#1537)

Author: AmosHuKe

.github/workflows/build.yml

@@ -34,7 +34,7 @@ jobs:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
         with:
           submodules: recursive
-      - uses: subosito/flutter-action@74af56c5ed2697ba4621264652728e8d217e53d3
+      - uses: subosito/flutter-action@f2c4f6686ca8e8d6e6d0f28410eeef506ed66aff
         with:
           channel: ${{ matrix.branch }}
       - name: Fetch Dart dependencies
@@ -58,7 +58,7 @@ jobs:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
         with:
           submodules: recursive
-      - uses: dart-lang/setup-dart@0a8a0fc875eb934c15d08629302413c671d3f672
+      - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
         with:
           sdk: stable
       - name: Fetch Dart dependencies
@@ -86,7 +86,7 @@ jobs:
         run: corepack install
       - name: Install node dependencies
         run: pnpm install --frozen-lockfile
-      - uses: dart-lang/setup-dart@0a8a0fc875eb934c15d08629302413c671d3f672
+      - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
         with:
           sdk: stable
       - name: Fetch Dart dependencies
@@ -109,7 +109,7 @@ jobs:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
         with:
           submodules: recursive
-      - uses: dart-lang/setup-dart@0a8a0fc875eb934c15d08629302413c671d3f672
+      - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
         with:
           sdk: stable
       - name: Fetch Dart dependencies
@@ -141,7 +141,7 @@ jobs:
         run: corepack install
       - name: Install node dependencies
         run: pnpm install --frozen-lockfile
-      - uses: dart-lang/setup-dart@0a8a0fc875eb934c15d08629302413c671d3f672
+      - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
         with:
           sdk: stable
       - name: Fetch Dart dependencies

.github/workflows/stage.yml

@@ -35,7 +35,7 @@ jobs:
         run: corepack install
       - name: Install node dependencies
         run: pnpm install --frozen-lockfile
-      - uses: dart-lang/setup-dart@0a8a0fc875eb934c15d08629302413c671d3f672
+      - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
         with:
           sdk: stable
       - name: Fetch Dart dependencies

.idx/dev.nix

@@ -2,7 +2,7 @@
 # see: https://developers.google.com/idx/guides/customize-idx-env
 { pkgs, ... }: {
   # Which nixpkgs channel to use.
-  channel = "stable-24.05"; # or "unstable"
+  channel = "stable-24.11"; # or "unstable"
 
   # Use https://search.nixos.org/packages to find packages
   packages = [

README.md

@@ -42,8 +42,8 @@ it's easiest to make changes using the GitHub UI.
 If you have an issue with the 
 API docs on [api.flutter.dev](https://api.flutter.dev), 
 please file those issues on 
-the [flutter/flutter](https://github.com/flutter/flutter/issues) repo, 
-not on this (flutter/website) repo. 
+the [`flutter/flutter`](https://github.com/flutter/flutter/issues) repo, 
+not on this (`flutter/website`) repo. 
 The API docs are embedded in Flutter's source code, 
 so the engineering team handles those.
 
@@ -129,7 +129,7 @@ If you prefer, you can use a version manager such as [nvm][],
 and run `nvm install` from the repository's root directory.
 
 If you already have Node installed, verify it's available on your path
-and already the latest stable version _(currently `20.17` or later)_:
+and already the latest stable version _(currently `22.12` or later)_:
 
 ```console
 node --version
@@ -200,7 +200,7 @@ following the instructions in [Get the prerequisites](#get-the-prerequisites).
    dart pub get
    ```
 
-3. (optional - We highly recommend you use `pnpm`, but you can also use `npm`.)
+3. _Optional:_ We recommend you use `pnpm`, but you can also use `npm`.
    Install `pnpm`, an alternative, efficient package manager for
    npm packages. If you already have `pnpm`, verify you have the
    latest stable version.
@@ -209,7 +209,7 @@ following the instructions in [Get the prerequisites](#get-the-prerequisites).
    node --version
    ```
 
-   If you do not already have `pnpm` installed, we recommend
+   If you don't already have `pnpm` installed, we recommend
    using [`corepack`][] to install and manage `pnpm` versions,
    since `corepack` is bundled with most installations of
    Node. If you installed `node` using Homebrew, you'll need
@@ -327,7 +327,7 @@ run `./dash_site refresh-excerpts`.
 To learn more about creating, editing, and using code excerpts,
 check out the [excerpt updater package documentation][].
 
-[excerpt updater package documentation]: https://github.com/dart-lang/site-shared/tree/main/packages/excerpter#readme
+[excerpt updater package documentation]: https://github.com/dart-lang/site-shared/tree/main/pkgs/excerpter#readme
 
 ## [Optional] Deploy to a staging site
 
@@ -360,7 +360,7 @@ you can build a full version and upload it to Firebase.
    ./dash_site build
    ```
 
-   This will build the site and copy it to your local `_site` directory.
+   This builds the site and copies it to your local `_site` directory.
    If that directory previously existed, it will be replaced.
 
 3. Deploy to your activated Firebase project's default hosting site:

analysis_options.yaml

@@ -1,2 +1,2 @@
 analyzer:
-  exclude: [flutter, site-shared, src, tmp]
+  exclude: [_site, flutter, site-shared, src, tmp]

dash_site

@@ -1,8 +1,8 @@
 #!/bin/bash
 
-REQUIRED_DART_VERSION="3.5"
-REQUIRED_NODE_VERSION="20.12"
-REQUIRED_PNPM_VERSION="9.0"
+REQUIRED_DART_VERSION="3.6"
+REQUIRED_NODE_VERSION="22.11"
+REQUIRED_PNPM_VERSION="9.12"
 
 # Check that the 'dart' command is available on the user's path.
 if ! command -v dart &> /dev/null; then

diagrams/app-architecture/architecture-docs.fig

@@ -6,6 +6,7 @@ import { registerFilters } from './src/_11ty/filters.js';
 import { registerShortcodes } from './src/_11ty/shortcodes.js';
 import { markdown } from './src/_11ty/plugins/markdown.js';
 import { configureHighlighting } from './src/_11ty/plugins/highlight.js';
+import { UserConfig } from '@11ty/eleventy';
 
 import minifier from 'html-minifier-terser';
 import yaml from 'js-yaml';
@@ -15,13 +16,9 @@ import * as path from 'node:path';
 import * as sass from 'sass';
 
 // noinspection JSUnusedGlobalSymbols
-/**
- * @typedef {import('11ty/eleventy/UserConfig')} EleventyConfig
- * @param {EleventyConfig} eleventyConfig
- */
-export default function (eleventyConfig) {
-  const isProduction = process.env.PRODUCTION === 'true';
-  const shouldOptimize = process.env.OPTIMIZE === 'true';
+export default function (eleventyConfig: UserConfig) {
+  const isProduction = process.env['PRODUCTION'] === 'true';
+  const shouldOptimize = process.env['OPTIMIZE'] === 'true';
 
   eleventyConfig.on('eleventy.before', async () => {
     await configureHighlighting(markdown);
@@ -31,8 +28,8 @@ export default function (eleventyConfig) {
 
   eleventyConfig.setLibrary('md', markdown);
 
-  eleventyConfig.addDataExtension('yml,yaml', (contents) =>
-    yaml.load(contents),
+  eleventyConfig.addDataExtension('yml,yaml', (contents: string) =>
+      yaml.load(contents),
   );
 
   eleventyConfig.setLiquidOptions({
@@ -51,7 +48,7 @@ export default function (eleventyConfig) {
   eleventyConfig.addWatchTarget('src/_sass');
   eleventyConfig.addExtension('scss', {
     outputFileExtension: 'css',
-    compile: function (inputContent, inputPath) {
+    compile: function (inputContent: string, inputPath: string) {
       const parsedPath = path.parse(inputPath);
       if (parsedPath.name.startsWith('_')) {
         return;
@@ -88,13 +85,13 @@ export default function (eleventyConfig) {
     filter: /^(?!_).+/,
   });
   eleventyConfig.addPassthroughCopy('src/content/tools/devtools/release-notes', {
-    filter: (path) => path.includes('src') || path.includes('images'),
+    filter: (path: string) => path.includes('src') || path.includes('images'),
   });
 
   if (shouldOptimize) {
     // If building for production, minify/optimize the HTML output.
     // Doing so during serving isn't worth the extra build time.
-    eleventyConfig.addTransform('minify-html', async function (content) {
+    eleventyConfig.addTransform('minify-html', async function (content: string) {
       if (this.page.outputPath && this.page.outputPath.endsWith('.html')) {
         // Minify the page's content if it's an HTML file.
         // Other options can be enabled, but each should be tested.

eleventy.config.js eleventy.config.ts

@@ -3,16 +3,15 @@ publish_to: none
 description: >-
   Shows how to create a simple or Hero animation using the Hero class directly.
 
+resolution: workspace
 environment:
-  sdk: ^3.5.0
+  sdk: ^3.6.0
 
 dependencies:
   flutter:
     sdk: flutter
 
 dev_dependencies:
-  example_utils:
-    path: ../../example_utils
   flutter_test:
     sdk: flutter
 

examples/_animation/basic_hero_animation/analysis_options.yaml

@@ -22,7 +22,7 @@ class Photo extends StatelessWidget {
     return Material(
       // Slightly opaque color appears where the image has transparency.
       // Makes it possible to see the radial transformation's boundary.
-      color: Theme.of(context).primaryColor.withOpacity(0.25),
+      color: Theme.of(context).primaryColor.withValues(alpha: 0.25),
       child: InkWell(
         onTap: onTap,
         child: Image.asset(

examples/_animation/basic_hero_animation/pubspec.yaml

@@ -4,16 +4,15 @@ description: >-
   Shows how to apply a radial transformation to the Hero
   as it animates to the new route.
 
+resolution: workspace
 environment:
-  sdk: ^3.5.0
+  sdk: ^3.6.0
 
 dependencies:
   flutter:
     sdk: flutter
 
 dev_dependencies:
-  example_utils:
-    path: ../../example_utils
   flutter_test:
     sdk: flutter
 

examples/_animation/basic_radial_hero_animation/analysis_options.yaml

@@ -187,9 +187,9 @@ class _StaggerDemoState extends State<StaggerDemo>
             width: 300,
             height: 300,
             decoration: BoxDecoration(
-              color: Colors.black.withOpacity(0.1),
+              color: Colors.black.withValues(alpha: 0.1),
               border: Border.all(
-                color: Colors.black.withOpacity(0.5),
+                color: Colors.black.withValues(alpha: 0.5),
               ),
             ),
             child: StaggerAnimation(controller: _controller.view),

examples/_animation/basic_radial_hero_animation/lib/main.dart

@@ -2,16 +2,15 @@ name: basic_staggered
 publish_to: none
 description: An introductory example to staggered animations.
 
+resolution: workspace
 environment:
-  sdk: ^3.5.0
+  sdk: ^3.6.0
 
 dependencies:
   flutter:
     sdk: flutter
 
 dev_dependencies:
-  example_utils:
-    path: ../../example_utils
   flutter_test:
     sdk: flutter
 

examples/_animation/basic_radial_hero_animation/pubspec.yaml

@@ -2,16 +2,15 @@ name: hero_animation
 publish_to: none
 description: Shows how to create a simple Hero transition.
 
+resolution: workspace
 environment:
-  sdk: ^3.5.0
+  sdk: ^3.6.0
 
 dependencies:
   flutter:
     sdk: flutter
 
 dev_dependencies:
-  example_utils:
-    path: ../../example_utils
   flutter_test:
     sdk: flutter
 

examples/_animation/basic_staggered_animation/analysis_options.yaml

@@ -25,7 +25,7 @@ class Photo extends StatelessWidget {
   Widget build(BuildContext context) {
     return Material(
       // Slightly opaque color appears where the image has transparency.
-      color: Theme.of(context).primaryColor.withOpacity(0.25),
+      color: Theme.of(context).primaryColor.withValues(alpha: 0.25),
       child: InkWell(
         onTap: onTap,
         child: LayoutBuilder(

examples/_animation/basic_staggered_animation/lib/main.dart

@@ -4,16 +4,15 @@ description: >-
   Shows how to apply a radial transformation to the Hero
   as it animates to the new route.
 
+resolution: workspace
 environment:
-  sdk: ^3.5.0
+  sdk: ^3.6.0
 
 dependencies:
   flutter:
     sdk: flutter
 
 dev_dependencies:
-  example_utils:
-    path: ../../example_utils
   flutter_test:
     sdk: flutter
 

examples/_animation/basic_staggered_animation/pubspec.yaml

@@ -26,7 +26,7 @@ class Photo extends StatelessWidget {
   Widget build(BuildContext context) {
     return Material(
       // Slightly opaque color appears where the image has transparency.
-      color: Theme.of(context).primaryColor.withOpacity(0.25),
+      color: Theme.of(context).primaryColor.withValues(alpha: 0.25),
       child: InkWell(
         onTap: onTap,
         child: LayoutBuilder(

examples/_animation/hero_animation/analysis_options.yaml

@@ -4,16 +4,15 @@ description: >-
   Shows how to apply a radial transformation to the Hero
   as it animates to the new route.
 
+resolution: workspace
 environment:
-  sdk: ^3.5.0
+  sdk: ^3.6.0
 
 dependencies:
   flutter:
     sdk: flutter
 
 dev_dependencies:
-  example_utils:
-    path: ../../example_utils
   flutter_test:
     sdk: flutter