feat: add deeplinks to our documentation (#1870)

* feat: add deeplinks to our documentation

These changes will only start to work once our documentation is updated
to support this feature:
- facebook/react-native-website#3618
- facebook/react-native-website#3619
- facebook/react-native-website#3620

* refactor: decouple our version checks

There was a single version check that would log an available stable
version of React Native that was greater than the current version in a
project.

The change breaks that up into:
- what is the current version
- what is the next stable upgrade if available
- log any stable upgrade if available

Author: blakef

__e2e__/__snapshots__/config.test.ts.snap

@@ -4,6 +4,7 @@ exports[`shows up current config without unnecessary output 1`] = `
 {
   "root": "<<REPLACED_ROOT>>/TestProject",
   "reactNativePath": "<<REPLACED_ROOT>>/TestProject/node_modules/react-native",
+  "reactNativeVersion": "0.71",
   "dependencies": {},
   "commands": [
     {

babel.config.js

@@ -18,6 +18,7 @@ module.exports = {
   ],
   plugins: [
     [require.resolve('@babel/plugin-transform-modules-commonjs'), {lazy: true}],
+    '@babel/plugin-proposal-export-namespace-from',
   ],
   sourceMaps: true,
 };

package.json

@@ -23,6 +23,7 @@
   },
   "devDependencies": {
     "@babel/core": "^7.0.0",
+    "@babel/plugin-proposal-export-namespace-from": "^7.18.9",
     "@babel/plugin-transform-modules-commonjs": "^7.2.0",
     "@babel/plugin-transform-runtime": "^7.6.2",
     "@babel/preset-env": "^7.0.0",

packages/cli-config/src/__tests__/__snapshots__/index-test.ts.snap

@@ -25,6 +25,7 @@ Object {
   "platforms": Object {},
   "project": Object {},
   "reactNativePath": "<<REPLACED>>",
+  "reactNativeVersion": "unknown",
   "root": "<<REPLACED>>",
 }
 `;

packages/cli-config/src/__tests__/index-test.ts

@@ -162,6 +162,7 @@ test('should merge project configuration with default values', () => {
 test('should load commands from "react-native-foo" and "react-native-bar" packages', () => {
   DIR = getTempDirectory('config_test_packages');
   writeFiles(DIR, {
+    'react-native.config.js': 'module.exports = { reactNativePath: "." }',
     'node_modules/react-native-foo/package.json': '{}',
     'node_modules/react-native-foo/react-native.config.js': `module.exports = {
       commands: [
@@ -220,6 +221,7 @@ test('does not use restricted "react-native" key to resolve config from package.
     'node_modules/react-native-netinfo/package.json': `{
       "react-native": "src/index.js"
     }`,
+    'react-native.config.js': 'module.exports = { reactNativePath: "." }',
     'package.json': `{
       "dependencies": {
         "react-native-netinfo": "0.0.1"

packages/cli-config/src/loadConfig.ts

@@ -8,7 +8,9 @@ import {
 } from '@react-native-community/cli-types';
 import {
   findProjectRoot,
+  version,
   resolveNodeModuleDir,
+  UnknownProjectError,
 } from '@react-native-community/cli-tools';
 import findDependencies from './findDependencies';
 import resolveReactNativePath from './resolveReactNativePath';
@@ -65,6 +67,7 @@ function loadConfig(projectRoot: string = findProjectRoot()): Config {
         ? path.resolve(projectRoot, userConfig.reactNativePath)
         : resolveReactNativePath(projectRoot);
     },
+    reactNativeVersion: 'unknown',
     dependencies: userConfig.dependencies,
     commands: userConfig.commands,
     healthChecks: [],
@@ -89,6 +92,22 @@ function loadConfig(projectRoot: string = findProjectRoot()): Config {
     },
   };
 
+  // Try our best to figure out what version of React Native we're running. This is
+  // currently being used to get our deeplinks working, so it's only worried with
+  // the major and minor version.
+  try {
+    let semver = version.current(initialConfig.reactNativePath);
+    if (semver) {
+      // Retain only these version, since they correspond with our documentation.
+      initialConfig.reactNativeVersion = `${semver.major}.${semver.minor}`;
+    }
+  } catch (e) {
+    // If we don't seem to be in a well formed project, give up quietly.
+    if (!(e instanceof UnknownProjectError)) {
+      throw e;
+    }
+  }
+
   const finalConfig = Array.from(
     new Set([
       ...Object.keys(userConfig.dependencies),

packages/cli-doctor/src/commands/info.ts

@@ -6,7 +6,7 @@
  */
 
 import getEnvironmentInfo from '../tools/envinfo';
-import {logger, releaseChecker} from '@react-native-community/cli-tools';
+import {logger, version} from '@react-native-community/cli-tools';
 import {Config} from '@react-native-community/cli-types';
 
 const info = async function getInfo(_argv: Array<string>, ctx: Config) {
@@ -17,7 +17,7 @@ const info = async function getInfo(_argv: Array<string>, ctx: Config) {
   } catch (err) {
     logger.error(`Unable to print environment info.\n${err}`);
   } finally {
-    await releaseChecker(ctx.root);
+    await version.logIfUpdateAvailable(ctx.root);
   }
 };
 

packages/cli-doctor/src/tools/healthchecks/androidSDK.ts

@@ -1,4 +1,4 @@
-import {findProjectRoot, logger} from '@react-native-community/cli-tools';
+import {findProjectRoot, logger, link} from '@react-native-community/cli-tools';
 import chalk from 'chalk';
 import fs from 'fs';
 import path from 'path';
@@ -182,7 +182,11 @@ export default {
 
     return logManualInstallation({
       healthcheck: 'Android SDK',
-      url: 'https://reactnative.dev/docs/environment-setup',
+      url: link.docs('environment-setup', {
+        hash: 'android-sdk',
+        guide: 'native',
+        platform: 'android',
+      }),
     });
   },
 } as HealthCheckInterface;

packages/cli-doctor/src/tools/healthchecks/androidStudio.ts

@@ -1,5 +1,7 @@
 import {join} from 'path';
 
+import {link} from '@react-native-community/cli-tools';
+
 import {HealthCheckInterface} from '../../types';
 
 import {downloadAndUnzip} from '../downloadAndUnzip';
@@ -74,7 +76,11 @@ export default {
 
     return logManualInstallation({
       healthcheck: 'Android Studio',
-      url: 'https://reactnative.dev/docs/environment-setup',
+      url: link.docs('environment-setup', {
+        hash: 'android-studio',
+        guide: 'native',
+        platform: 'android',
+      }),
     });
   },
 } as HealthCheckInterface;

packages/cli-doctor/src/tools/healthchecks/jdk.ts

@@ -1,4 +1,7 @@
 import {join} from 'path';
+
+import {link} from '@react-native-community/cli-tools';
+
 import versionRanges from '../versionRanges';
 import {doesSoftwareNeedToBeFixed} from '../checkInstallation';
 import {HealthCheckInterface} from '../../types';
@@ -58,7 +61,11 @@ export default {
     loader.fail();
     logManualInstallation({
       healthcheck: 'JDK',
-      url: 'https://reactnative.dev/docs/environment-setup',
+      url: link.docs('environment-setup', {
+        hash: 'jdk-studio',
+        guide: 'native',
+        platform: 'android',
+      }),
     });
   },
 } as HealthCheckInterface;