expo-router 0.0.41 → 0.0.42

package/babel.js

@@ -1,8 +1,21 @@
 const nodePath = require("path");
 const resolveFrom = require("resolve-from");
+const { getExpoConstantsManifest } = require("./node/getExpoConstantsManifest");
 
 const debug = require("debug")("expo:router:babel");
 
+function getExpoAppManifest(projectRoot) {
+  if (process.env.APP_MANIFEST) {
+    return process.env.APP_MANIFEST;
+  }
+
+  const exp = getExpoConstantsManifest(projectRoot);
+
+  debug("public manifest", exp);
+
+  return JSON.stringify(exp);
+}
+
 function getExpoRouterAppRoot(projectRoot) {
   if (process.env.EXPO_ROUTER_APP_ROOT) {
     return process.env.EXPO_ROUTER_APP_ROOT;
@@ -35,7 +48,17 @@ module.exports = function (api) {
       // Add support for Node.js __filename
       Identifier(path, state) {
         if (path.node.name === "__filename") {
-          path.replaceWith(t.stringLiteral(getRelPath(state)));
+          path.replaceWith(
+            t.stringLiteral(
+              // `/index.js` is the value used by Webpack.
+              getRelPath(state)
+            )
+          );
+        }
+        // Add support for Node.js `__dirname`.
+        // This static value comes from Webpack somewhere.
+        if (path.node.name === "__dirname") {
+          path.replaceWith(t.stringLiteral("/"));
         }
       },
 
@@ -53,6 +76,9 @@ module.exports = function (api) {
           return;
         }
 
+        const projectRoot =
+          process.env.EXPO_PROJECT_ROOT || state.file.opts.root || "";
+
         // Used for log box and stuff
         if (
           t.isIdentifier(parent.node.property, {
@@ -60,11 +86,20 @@ module.exports = function (api) {
           }) &&
           !parent.parentPath.isAssignmentExpression()
         ) {
-          parent.replaceWith(
-            t.stringLiteral(
-              process.env.EXPO_PROJECT_ROOT || state.file.opts.root || ""
-            )
-          );
+          parent.replaceWith(t.stringLiteral(projectRoot));
+          return;
+        }
+
+        // Surfaces the `app.json` (config) as an environment variable which is then parsed by
+        // `expo-constants` https://docs.expo.dev/versions/latest/sdk/constants/
+        if (
+          t.isIdentifier(parent.node.property, {
+            name: "APP_MANIFEST",
+          }) &&
+          !parent.parentPath.isAssignmentExpression()
+        ) {
+          const manifest = getExpoAppManifest(projectRoot);
+          parent.replaceWith(t.stringLiteral(manifest));
           return;
         }
 
@@ -82,7 +117,7 @@ module.exports = function (api) {
 
         parent.replaceWith(
           // This is defined in Expo CLI when using Metro. It points to the relative path for the project app directory.
-          t.stringLiteral(getExpoRouterAppRoot(state.file.opts.root))
+          t.stringLiteral(getExpoRouterAppRoot(projectRoot))
         );
       },
     },

package/node/getExpoConstantsManifest.js

@@ -0,0 +1,179 @@
+const { getConfig, getNameFromConfig } = require("expo/config");
+// Use root to work better with create-react-app
+const DEFAULT_LANGUAGE_ISO_CODE = `en`;
+const DEFAULT_DISPLAY = "standalone";
+const DEFAULT_STATUS_BAR = "black-translucent";
+const DEFAULT_PREFER_RELATED_APPLICATIONS = true;
+// Convert expo value to PWA value
+function ensurePWAorientation(orientation) {
+  if (orientation && typeof orientation === "string") {
+    const webOrientation = orientation.toLowerCase();
+    if (webOrientation !== "default") {
+      return webOrientation;
+    }
+  }
+  return undefined;
+}
+
+const RESTRICTED_MANIFEST_FIELDS = [
+  // Omit app.json properties that get removed during the native build
+  "facebookScheme",
+  "facebookAppId",
+  "facebookDisplayName",
+  // Remove iOS and Android.
+  "ios",
+  "android",
+  // Hide internal / build values
+  "plugins",
+  "hooks",
+  "_internal",
+  // Remove metro-specific values
+  "assetBundlePatterns",
+];
+function getExpoConstantsManifest(projectRoot) {
+  const { exp } = getConfig(projectRoot, {
+    isPublicConfig: true,
+    skipSDKVersionRequirement: true,
+  });
+  const manifest = ensurePWAConfig(exp);
+  for (const field of RESTRICTED_MANIFEST_FIELDS) {
+    delete manifest[field];
+  }
+  return manifest;
+}
+function applyWebDefaults(appJSON) {
+  // For RN CLI support
+  // @ts-ignore: expo object doesn't exist on ExpoConfig
+  const appManifest = appJSON.expo || appJSON || {};
+  const {
+    web: webManifest = {},
+    splash = {},
+    ios = {},
+    android = {},
+  } = appManifest;
+  // rn-cli apps use a displayName value as well.
+  const { appName, webName } = getNameFromConfig(appJSON);
+  const languageISOCode = webManifest.lang || DEFAULT_LANGUAGE_ISO_CODE;
+  const primaryColor = appManifest.primaryColor;
+  const description = appManifest.description;
+  // The theme_color sets the color of the tool bar, and may be reflected in the app's preview in task switchers.
+  const webThemeColor = webManifest.themeColor || primaryColor;
+  const dir = webManifest.dir;
+  const shortName = webManifest.shortName || webName;
+  const display = webManifest.display || DEFAULT_DISPLAY;
+  const startUrl = webManifest.startUrl;
+  const { scope, crossorigin } = webManifest;
+  const barStyle = webManifest.barStyle || DEFAULT_STATUS_BAR;
+  const orientation = ensurePWAorientation(
+    webManifest.orientation || appManifest.orientation
+  );
+  /**
+   * **Splash screen background color**
+   * `https://developers.google.com/web/fundamentals/web-app-manifest/#splash-screen`
+   * The background_color should be the same color as the load page,
+   * to provide a smooth transition from the splash screen to your app.
+   */
+  const backgroundColor = webManifest.backgroundColor || splash.backgroundColor; // No default background color
+  /**
+   *
+   * https://developer.mozilla.org/en-US/docs/Web/Manifest#prefer_related_applications
+   * Specifies a boolean value that hints for the user agent to indicate
+   * to the user that the specified native applications (see below) are recommended over the website.
+   * This should only be used if the related native apps really do offer something that the website can't... like Expo ;)
+   *
+   * >> The banner won't show up if the app is already installed:
+   * https://github.com/GoogleChrome/samples/issues/384#issuecomment-326387680
+   */
+  const preferRelatedApplications =
+    webManifest.preferRelatedApplications === undefined
+      ? DEFAULT_PREFER_RELATED_APPLICATIONS
+      : webManifest.preferRelatedApplications;
+  const relatedApplications =
+    inferWebRelatedApplicationsFromConfig(appManifest);
+  return {
+    ...appManifest,
+    name: appName,
+    description,
+    primaryColor,
+    // Ensure these objects exist
+    ios: {
+      ...ios,
+    },
+    android: {
+      ...android,
+    },
+    web: {
+      ...webManifest,
+      meta: undefined,
+      build: undefined,
+      scope,
+      crossorigin,
+      description,
+      preferRelatedApplications,
+      relatedApplications,
+      startUrl,
+      shortName,
+      display,
+      orientation,
+      dir,
+      barStyle,
+      backgroundColor,
+      themeColor: webThemeColor,
+      lang: languageISOCode,
+      name: webName,
+    },
+  };
+}
+/**
+ * https://developer.mozilla.org/en-US/docs/Web/Manifest#related_applications
+ * An array of native applications that are installable by, or accessible to, the underlying platform
+ * for example, a native Android application obtainable through the Google Play Store.
+ * Such applications are intended to be alternatives to the
+ * website that provides similar/equivalent functionality — like the native app version of the website.
+ */
+function inferWebRelatedApplicationsFromConfig({
+  web = {},
+  ios = {},
+  android = {},
+}) {
+  const relatedApplications = web.relatedApplications || [];
+  const { bundleIdentifier, appStoreUrl } = ios;
+  if (bundleIdentifier) {
+    const PLATFORM_ITUNES = "itunes";
+    const iosApp = relatedApplications.some(
+      ({ platform }) => platform === PLATFORM_ITUNES
+    );
+    if (!iosApp) {
+      relatedApplications.push({
+        platform: PLATFORM_ITUNES,
+        url: appStoreUrl,
+        id: bundleIdentifier,
+      });
+    }
+  }
+  const { package: androidPackage, playStoreUrl } = android;
+  if (androidPackage) {
+    const PLATFORM_PLAY = "play";
+    const alreadyHasAndroidApp = relatedApplications.some(
+      ({ platform }) => platform === PLATFORM_PLAY
+    );
+    if (!alreadyHasAndroidApp) {
+      relatedApplications.push({
+        platform: PLATFORM_PLAY,
+        url:
+          playStoreUrl ||
+          `http://play.google.com/store/apps/details?id=${androidPackage}`,
+        id: androidPackage,
+      });
+    }
+  }
+  return relatedApplications;
+}
+function ensurePWAConfig(appJSON) {
+  const config = applyWebDefaults(appJSON);
+  return config;
+}
+
+module.exports = {
+  getExpoConstantsManifest,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-router",
-  "version": "0.0.41",
+  "version": "0.0.42",
   "main": "build/index.js",
   "files": [
     "entry.js",
@@ -12,7 +12,8 @@
     "stack.js",
     "stack.d.ts",
     "tabs.js",
-    "tabs.d.ts"
+    "tabs.d.ts",
+    "node"
   ],
   "repository": {
     "url": "https://github.com/expo/router.git",