feat: Add selectiveUnion for improved Superstruct error messaging

[FrederikBolding]

Adds selectiveUnion and rewrites a bunch of structs to use this pattern. This helps alleviate a problem where Superstruct errors would be impossible to read. The idea of selectiveUnion is to be able to guide Superstruct validation more with simple checks that can be used to choose between validation paths. This combined with typedUnion makes it possible to have drastically improved error messages for structs that use unions. This PR rewrites some of the UI structs to use these new patterns, but is not necessarily exhaustive. It also adds support for refinements and coercion to typedUnion.

Generally, this PR turns errors like this:

Invalid params: At path: ui -- Expected the value to satisfy a union of `union | union`, but received: "foo".'

into errors like this:

Invalid params: At path: ui -- Expected type to be one of: "Address", "Bold", "Box", "Button", "Copyable", "Divider", "Dropdown", "RadioGroup", "FileInput", "Form", "Heading", "Input", "Image", "Italic", "Link", "Row", "Spinner", "Text", "Tooltip", "Checkbox", "Card", "Icon", "Selector", "Section", "Container", but received: undefined.

This PR does not solve this problem for structs that use the children() utility function with more than one struct as the input (e.g. Button). These components will fail with something like:

Invalid params: At path: ui.props.children.1.props.children.props.children -- Expected the value to satisfy a union of `union | object | object`, but received: [object Object].

There may also still be other UI components that fail with similar errors, however, this is a huge step forward in readability and therefore dev-ex.

Progresses #2692

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 94.35%. Comparing base (8275454) to head (6295362).
Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2696      +/-   ##
==========================================
+ Coverage   94.31%   94.35%   +0.04%     
==========================================
  Files         481      481              
  Lines       10057    10129      +72     
  Branches     1521     1540      +19     
==========================================
+ Hits         9485     9557      +72     
  Misses        572      572              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[Mrtenz]

@metamaskbot update-pr