This change adds a way to provide explicit focus order for a part of the widget tree.

It adds FocusTraversalPolicyGroup, which in many ways is similar to DefaultFocusTraversal, except that it groups a widget subtree together so that those nodes are traversed as a group. DefaultFocusTraversal doesn't work as one would expect: If there is more than one DefaultFocusTraversal inside of a focus scope, the policy can change depending on which node was asked to move "next", which can cause unexpected behavior. The new grouping mechanism doesn't have that problem. I deprecate DefaultFocusTraversal in this PR.

It also adds OrderedFocusTraversalPolicy, which is a policy that can be supplied to FocusTraversalPolicyGroup to set the policy for a sub-tree. It looks for FocusTraversalOrder inherited widgets, which use a FocusOrder to do the sorting. FocusOrder has two subclasses: NumericalFocusOrder (which sorts based on a double), and LexicalFocusOrder, which sorts based on a String.

As part of doing this, I refactored the way FocusTraversalPolicy is implemented so that it has more default implementation methods, and exposes a new protected member: sortDescendants, which makes it easier for developers to make their own policy subclasses: they only need to implement sortDescendants to get a new ordering behavior, but can also still override any of the default implementation behaviors if they need different behavior.

I was able to do this without breaking the API (AFAICT).

Revert "Fix SnackBar clipping when it is floating due to FloatingActionButton positioning (#47616)" (#50516)

This reverts commit 801a6a7e.

This makes FocusManager a ChangeNotifier that notifies when the primaryFocus changes so that an app can track the current focus.

Fixes #50501

This reverts commit 90206427.

Catalina VMs are using the latest major version of virtualization which has improved networking which should fix `Agent is not responding!` issue.

This PR modifies the existing API docs samples to use DartPad so that all of the samples are now interactive apps on the API docs site.

It also removes the restriction for the max width of the description area so that the dartpad region can expand horizontally.

I updated the first paragraph on the API docs to indicate that Flutter is more than just mobile now (same text as the README.md at the top level).

I modified a few of the examples so that they looked nicer, and fit better on the page.

I added the sample description text above each DartPad instance, since that often defines the context of the example.

I removed animations and images when they were redundant with the sample content. There were a few that made sense to keep, so I did.

* c9322145f Ensure fields of Rect and OffsetBase classes are optimized as non-null. (flutter/engine#16465)

* 5c70356a9 Simplify task queues locking mechanism (flutter/engine#16477)

* d589ddea6 Fix text range logic for a11y (flutter/engine#16496)

* 1a4f4e394 Fix unused import in Android embedder (flutter/engine#16494)

* 964ae1009 Disable ShellTest.WaitForFirstFrameTimeout on Fuchsia (flutter/engine#16495)

* 6158f03ef Roll src/third_party/skia 87e3bef6f82f..9f3eef796f63 (7 commits) (flutter/engine#16493)

The current implementation of DropdownButtonFormField does not pass the initial value to _DropdownButtonFormFieldState. As a result changes made through the child DropdownButton are not made to the FormFieldState and the widget is not updated unless a onChanged function is provided to the DropdownButtomFormField constructor.

This change modifies DropdownButtonFormField to behave more consistently with other FormField widgets in how the Form state is handled.

* 71ec0a181 Relax timing restrictions on WakeUpTimersAreSingletons. (flutter/engine#16446)

* 3ac1e6d8b Disable unit tests using --gtest-filter instead of at compile time (flutter/engine#16472)

* 80be2c43e Fix RasterCache LRU logic, opportunistic simplifications. (flutter/engine#16434)

* ca40f11ee Roll src/third_party/skia 7f36405ea3ec..c0360582d211 (6 commits) (flutter/engine#16476)

* c9e7713b5 Fix analyzer warnings for frontend_server change (flutter/engine#16470)

* 9ada1b0e0 Fix elf_loader.cc on Fuchsia, add a TODO for proper fix

* 051762798 Enable runtime_unittests on Fuchsia

* 03f639e12 Add noexcept annotations to EnableValue moves (flutter/engine#16478)

* 00904dd96 Various fixes in CanvasKit (flutter/engine#16433)

* de7022b3b Roll src/third_party/skia c0360582d211..121750c2efff (7 commits) (flutter/engine#16479)

* d2aab27b4 Enable shell_unittests on Fuchsia with Vulkan dependencies. (flutter/engine#16376)

* eec73e3a7 Roll src/third_party/dart b3396cbdcae1..49850e6919f7 (45 commits) (flutter/engine#16480)

* 557f3a2d2 Run Flutter framework tests against the web engine in Cirrus (flutter/engine#16343)

* 477527b3f Roll src/third_party/skia 121750c2efff..046f9893b953 (4 commits) (flutter/engine#16482)

* eb8691f2a Code cleanup on destructors (flutter/engine#16481)

* 73978177e Roll fuchsia/sdk/core/linux-amd64 from A9STP... to g2s3c... (flutter/engine#16484)

* 313527d2e Roll src/third_party/dart 49850e6919f7..16782e6c171f (16 commits) (flutter/engine#16485)

* 83feaf4fc Roll src/third_party/skia 046f9893b953..97bf6578796c (1 commits) (flutter/engine#16486)

* 918405870 Roll src/third_party/skia 97bf6578796c..f3560b680e35 (1 commits) (flutter/engine#16487)

* 0db017d09 Roll src/third_party/dart 16782e6c171f..d765d237460d (1 commits) (flutter/engine#16488)

* f9ed07cf5 Roll fuchsia/sdk/core/linux-amd64 from g2s3c... to LvSlH... (flutter/engine#16489)

* a1b91dad7 Roll src/third_party/skia f3560b680e35..77fdf66946d2 (1 commits) (flutter/engine#16490)

* 7edb803b6 Roll src/third_party/dart d765d237460d..514a8d4c8417 (7 commits) (flutter/engine#16491)

* 580503c35 Roll src/third_party/skia 77fdf66946d2..87e3bef6f82f (2 commits) (flutter/engine#16492)

This reverts commit 2b7582ef.

* d5442b86e Roll src/third_party/skia bc3307c395e2..ebc00f97fab1 (21 commits) (flutter/engine#16429)

* 76b291a65 Added a plugin method that gets called when the engine is about to be deleted (flutter/engine#16336)

* 07f25c51e fix bad reference to maxDiffRatePercent (flutter/engine#16440)

* 41d50c220 Reland #16206: "[web] Correct getPositionForOffset for multi-line paragraphs" (flutter/engine#16365)

* f25d325b1 [fuchsia] change kMaxFramesInFlight to 3 (flutter/engine#16425)

* 473f55940 Suppress some deprecation warnings on Windows (flutter/engine#16416)

* 2e34ad6b7 Roll fuchsia/sdk/core/mac-amd64 from ubThi... to fvWgE... (flutter/engine#16454)

* 47c02e6fc Roll src/third_party/skia ebc00f97fab1..cbf79b95c2d4 (4 commits) (flutter/engine#16456)

* 3d1b112d7 Roll buildroot (flutter/engine#16419)

* 28e663726 Add explicit casts to printing of function pointers (flutter/engine#16370)

* 9ad81dae1 Wrap strdup to use compliant name on Windows (flutter/engine#16372)

* 9708e5274 Roll rapidjson (flutter/engine#16347)

* f06ebba3e Include <memory> in hb_wrapper.h because unique_ptr is used. (flutter/engine#16442)

* e530376fb Roll fuchsia/sdk/core/linux-amd64 from VJv0H... to A9STP... (flutter/engine#16457)

* 4cc41ae97 Roll src/third_party/skia cbf79b95c2d4..4721e067812f (1 commits) (flutter/engine#16459)

* 2f233edf5 Roll src/third_party/skia 4721e067812f..f6e3eaf05150 (1 commits) (flutter/engine#16461)

* b0b0ed83b Roll src/third_party/skia f6e3eaf05150..cc21d0c1f2ce (1 commits) (flutter/engine#16463)

* 7fea936a0 Roll src/third_party/skia cc21d0c1f2ce..116b33e8ab21 (3 commits) (flutter/engine#16466)

* 001b3a0b1 Roll src/third_party/skia 116b33e8ab21..7f36405ea3ec (3 commits) (flutter/engine#16471)

* f3ce90e93 Reset width/height before deallocation for Safari allocation bug. (flutter/engine#16469)