Feature: Add support for injected wallet download URL for unavailable injected wallets (#1754)

* Add ability to pass injected wallet url and display URL if wallet is unavailable and url is available

* Cleanup demo

* Add other wallet urls for most popular

* Add OKX wallet to downloads list, add slide transition for connect modal warning

* Add local flag to other transitions to keep the transition scope to that code block destroy/creation

Author: Adamj1232

docs/src/routes/docs/[...4]wallets/[...9]injected/+page.md

@@ -153,7 +153,12 @@ const equal = {
     provider: window.ethereum
   }),
   // A list of platforms that this wallet supports
-  platforms: ['desktop']
+  platforms: ['desktop'],
+  /**
+   * A Url to link users to a download page for the wallet
+   * to be shown if not installed or available on the browser
+   */
+  externalUrl: 'http://www.CoolEqualWalletDownload.com'
 }
 
 const injected = injectedModule({
@@ -172,17 +177,22 @@ You may want to display injected wallets that are not currently available to the
 
 ```javascript
 const injected = injectedModule({
-  displayUnavailable: true
+  // display all unavailable injected wallets
+  displayUnavailable: true,
+  ||
+  // display specific unavailable wallets
+  displayUnavailable: [ProviderLabel.MetaMask, ProviderLabel.Trust]
 })
 ```
 
-This will render every injected wallet as regardless of whether it has been detected in the window, happy days.
-Then the issue of the order of wallets displayed becomes apparent when you have 21 injected wallets at the top of the wallets list. To solve this, all injected wallets are sorted alphabetically by default and there is an additional `sort` parameter which receives the final list of wallets and then returns the list to be rendered. This allows for example setting MetaMask and Coinbase first and then just the rest alphabetically:
+This can be set to an array top specify which unavailable injected wallets to show or set to true to display all unavailable injected wallets regardless of whether it has been detected in the window, happy days.
+Then the issue of the order of wallets displayed becomes apparent when you have 21 injected wallets at the top of the wallets list. To solve this, all injected wallets are sorted **alphabetically** by default and there is an additional `sort` parameter which receives the final list of wallets and then returns the list to be rendered. This allows for example setting MetaMask and Coinbase first and then just the rest alphabetically:
 
 ```javascript
 const injected = injectedModule({
-  // display all wallets even if they are unavailable
-  displayUnavailable: true,
+  // display specific injected wallets even if they are unavailable
+  // can also be set to `true` to display all unavailable injected wallets
+  displayUnavailable: [ProviderLabel.MetaMask, ProviderLabel.Trust],
   // do a manual sort of injected wallets so that MetaMask and Coinbase are ordered first
   sort: (wallets) => {
     const metaMask = wallets.find(({ label }) => label === ProviderLabel.MetaMask)
@@ -203,11 +213,12 @@ const injected = injectedModule({
 })
 ```
 
-You may want to display all wallets, but filter out specific wallets based on their availability. For example I may want to display all unavailable wallets except when Binance and Bitski wallet is unavailable, then don't show them, but if they are available, then do show them. To do this, the filters value has been extended to have a new value: `'unavailable'`, as in; remove this wallet if it is unavailable, even though `displayUnavailable` wallets is set:
+You may want to display all unavailable injected wallets, but filter out specific wallets based on their availability. For example I may want to display all unavailable wallets except when Binance and Bitski wallet is unavailable, then don't show them, but if they are available, then do show them. To do this, the filters value has been extended to have a new value: `'unavailable'`, as in; remove this wallet if it is unavailable, even though `displayUnavailable` wallets is set:
 
 ```javascript
 const injected = injectedModule({
-  // display all wallets even if they are unavailable
+  // display specific injected wallets even if they are unavailable
+  // can also be set to `true` to display all unavailable injected wallets
   displayUnavailable: true,
   // but only show Binance and Bitski wallet if they are available
   filter: {
@@ -234,15 +245,16 @@ const injected = injectedModule({
 })
 ```
 
-If a wallet is selected, but is not available the default error message is: `Please install or enable ${walletName} to continue`. You may want to customise that message, so there is the `walletUnavailableMessage` parameter which is a function that takes the wallet object that is unavailable and returns a string which is the message to display:
+If a wallet is selected, but is not available the default error message is: `Oops ${wallet.label} is unavailable! Please <a href="${wallet.externalUrl}" target="_blank">install</a>` if a download link is available for that wallet. If there isn't a download link for that wallet the default is: `Please install or enable ${walletName} to continue`. You may want to customize that message, so there is the `walletUnavailableMessage` parameter which is a function that takes the wallet object that is unavailable and returns a string which is the message to display:
 
 ```javascript
 const injected = injectedModule({
   custom: [
     // include custom (not natively supported) injected wallet modules here
   ],
-  // display all wallets even if they are unavailable
-  displayUnavailable: true,
+  // display specific injected wallets even if they are unavailable
+  // can also be set to `true` to display all unavailable injected wallets
+  displayUnavailable: [ProviderLabel.MetaMask, ProviderLabel.Trust],
   // but only show Binance and Bitski wallet if they are available
   filter: {
     [ProviderLabel.Binance]: 'unavailable',
@@ -265,7 +277,10 @@ const injected = injectedModule({
         .filter((wallet) => wallet)
     )
   },
-  walletUnavailableMessage: (wallet) => `Oops ${wallet.label} is unavailable!`
+  walletUnavailableMessage: (wallet) =>
+    wallet.externalUrl
+      ? `Oops ${wallet.label} is unavailable! Please <a href="${wallet.externalUrl}" target="_blank">install</a>`
+      : `Oops ${wallet.label} is unavailable!`
 })
 ```
 

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@web3-onboard/core",
-  "version": "2.20.0",
+  "version": "2.20.1-alpha.1",
   "description": "Web3-Onboard makes it simple to connect Ethereum hardware and software wallets to your dapp. Features standardized spec compliant web3 providers for all supported wallets, framework agnostic modern javascript UI with code splitting, CSS customization, multi-chain and multi-account support, reactive wallet state subscriptions and real-time transaction state change notifications.",
   "keywords": [
     "Ethereum",

packages/core/src/views/account-center/AcctCenterTriggerLarge.svelte

@@ -143,7 +143,7 @@
 </style>
 
 <div
-  in:fade={{ duration: 250 }}
+  in:fade|local={{ duration: 250 }}
   out:fade={{ duration: 100 }}
   class="ac-trigger"
   on:click|stopPropagation={toggle}
@@ -187,7 +187,7 @@
           : shortenedFirstAddress}
       </div>
       {#if firstAddressBalance}
-        <div in:fade class="balance">
+        <div in:fade|local class="balance">
           {firstAddressBalance.length > 7
             ? firstAddressBalance.slice(0, 7)
             : firstAddressBalance}

packages/core/src/views/account-center/SecondaryTokenTable.svelte

@@ -72,7 +72,7 @@
               <div class="icon-name-container">
                 {#if token.icon}
                   {#await token.icon then iconLoaded}
-                    <div in:fade class="icon">
+                    <div in:fade|local class="icon">
                       {#if isSVG(iconLoaded)}
                         <!-- render svg string -->
                         {@html iconLoaded}

packages/core/src/views/account-center/WalletRow.svelte

@@ -237,7 +237,7 @@
 
         <!-- BALANCE -->
         {#if balance}
-          <div in:fade class="balance">
+          <div in:fade|local class="balance">
             {formatBalance(balance)}
           </div>
         {/if}
@@ -256,7 +256,7 @@
     </div>
 
     {#if showMenu === address}
-      <ul in:fade class="menu absolute">
+      <ul in:fade|local class="menu absolute">
         <li
           on:click|stopPropagation={() => {
             showMenu = ''

packages/core/src/views/connect/WalletButton.svelte

@@ -109,7 +109,7 @@
     class="wallet-button-styling"
     class:connected
     {disabled}
-    in:fade
+    in:fade|local
     on:click={onClick}
   >
     <div class="wallet-button-container-inner">

packages/core/src/views/notify/Index.svelte

@@ -133,7 +133,7 @@
       <li
         animate:flip={{ duration: 500 }}
         on:click|stopPropagation
-        in:fly={{ duration: 1200, delay: 300, x, y, easing: elasticOut }}
+        in:fly|local={{ duration: 1200, delay: 300, x, y, easing: elasticOut }}
         out:fade={{ duration: 300, easing: cubicOut }}
         class={`bn-notify-li-${position} ${
           position.includes('top')

packages/core/src/views/shared/WalletAppBadge.svelte

@@ -203,7 +203,7 @@
     {#await icon}
       <div class="placeholder-icon" />
     {:then iconLoaded}
-      <div in:fade class="icon flex justify-center items-center">
+      <div in:fade|local class="icon flex justify-center items-center">
         {#if isSVG(iconLoaded)}
           <!-- render svg string -->
           {@html iconLoaded}

packages/core/src/views/shared/Warning.svelte

@@ -1,6 +1,7 @@
 <script lang="ts">
-  import { fade } from 'svelte/transition'
+  import { slide } from 'svelte/transition'
   import infoIcon from '../../icons/info.js'
+  import { bounceIn, circIn, quadIn } from 'svelte/easing'
 </script>
 
 <style>
@@ -25,7 +26,7 @@
   
 </style>
 
-<div in:fade class="container flex justify-between">
+<div in:slide|local="{{delay: 50, duration: 500}}" class="container flex justify-between">
   <div>
     <slot />
   </div>

packages/demo/package.json

@@ -26,7 +26,7 @@
   "dependencies": {
     "@web3-onboard/cede-store": "^2.0.2",
     "@web3-onboard/coinbase": "^2.2.3",
-    "@web3-onboard/core": "^2.20.0",
+    "@web3-onboard/core": "^2.20.1-alpha.1",
     "@web3-onboard/dcent": "^2.2.7",
     "@web3-onboard/enkrypt": "^2.0.3",
     "@web3-onboard/fortmatic": "^2.0.18",
@@ -35,7 +35,7 @@
     "@web3-onboard/gas": "^2.1.7",
     "@web3-onboard/gnosis": "^2.1.9",
     "@web3-onboard/infinity-wallet": "^2.0.3",
-    "@web3-onboard/injected-wallets": "^2.9.0",
+    "@web3-onboard/injected-wallets": "^2.10.0-alpha.1",
     "@web3-onboard/keepkey": "^2.3.7",
     "@web3-onboard/keystone": "^2.3.7",
     "@web3-onboard/ledger": "^2.4.5",