@expo/config-types 47.0.0 → 49.0.0-alpha.1

package/build/ExpoConfig.d.ts

@@ -19,11 +19,11 @@ export interface ExpoConfig {
      */
     owner?: string;
     /**
-     * The auto generated Expo account name and slug used for display purposes. Formatted like `@username/slug`. When unauthenticated, the username is `@anonymous`. For published projects, this value may change when a project is transferred between accounts or renamed.
+     * The auto generated Expo account name and slug used for display purposes. It is not meant to be set directly. Formatted like `@username/slug`. When unauthenticated, the username is `@anonymous`. For published projects, this value may change when a project is transferred between accounts or renamed.
      */
     currentFullName?: string;
     /**
-     * The auto generated Expo account name and slug used for services like Notifications and AuthSession proxy. Formatted like `@username/slug`. When unauthenticated, the username is `@anonymous`. For published projects, this value will not change when a project is transferred between accounts or renamed.
+     * The auto generated Expo account name and slug used for services like Notifications and AuthSession proxy. It is not meant to be set directly. Formatted like `@username/slug`. When unauthenticated, the username is `@anonymous`. For published projects, this value will not change when a project is transferred between accounts or renamed.
      */
     originalFullName?: string;
     /**
@@ -38,11 +38,10 @@ export interface ExpoConfig {
      * **Note: Don't use this property unless you are sure what you're doing**
      *
      * The runtime version associated with this manifest.
-     * Set this to `{"policy": "nativeVersion"}` to generate it automatically based on the 'version' and
-     * 'android.versionCode'/'ios.buildNumber' or to `{"policy": "appVersion"}` to use just 'version' field.
+     * Set this to `{"policy": "nativeVersion"}` to generate it automatically.
      */
     runtimeVersion?: string | {
-        policy: RuntimeVersionPolicy;
+        policy: 'nativeVersion' | 'sdkVersion' | 'appVersion';
     };
     /**
      * Your app version. In addition to this field, you'll also use `ios.buildNumber` and `android.versionCode` — read more about how to version your app [here](https://docs.expo.dev/distribution/app-stores/#versioning-your-app). On iOS this corresponds to `CFBundleShortVersionString`, and on Android, this corresponds to `versionName`. The required format can be found [here](https://developer.apple.com/documentation/bundleresources/information_property_list/cfbundleshortversionstring).
@@ -101,10 +100,6 @@ export interface ExpoConfig {
          */
         androidCollapsedTitle?: string;
     };
-    /**
-     * @deprecated By default, Expo looks for the application registered with the AppRegistry as `main`. If you would like to change this, you can specify the name in this property.
-     */
-    appKey?: string;
     /**
      * Configuration for the status bar on Android. For more details please navigate to [Configuring StatusBar](https://docs.expo.dev/guides/configuring-statusbar/).
      */
@@ -122,7 +117,7 @@ export interface ExpoConfig {
          */
         hidden?: boolean;
         /**
-         * Sets `android:windowTranslucentStatus` in `styles.xml`. When false, the system status bar pushes the content of your app down (similar to `position: relative`). When true, the status bar floats above the content in your app (similar to `position: absolute`). Defaults to `true` to match the iOS status bar behavior (which can only float above content).
+         * When false, the system status bar pushes the content of your app down (similar to `position: relative`). When true, the status bar floats above the content in your app (similar to `position: absolute`). Defaults to `true` to match the iOS status bar behavior (which can only float above content). Explicitly setting this property to `true` will add `android:windowTranslucentStatus` to `styles.xml` and may cause unexpected keyboard behavior on Android when using the `softwareKeyboardLayoutMode` set to `resize`. In this case you will have to use `KeyboardAvoidingView` to manage the keyboard layout.
          */
         translucent?: boolean;
     };
@@ -159,15 +154,11 @@ export interface ExpoConfig {
         silentLaunch?: boolean;
     };
     /**
-     * **Standalone Apps Only**. URL scheme to link into your app. For example, if we set this to `'demo'`, then demo:// URLs would open your app when tapped.
-     */
-    scheme?: string;
-    /**
-     * The relative path to your main JavaScript file.
+     * **Custom Builds Only**. URL scheme(s) to link into your app. For example, if we set this to `'demo'`, then demo:// URLs would open your app when tapped.
      */
-    entryPoint?: string;
+    scheme?: string | string[];
     /**
-     * Any extra fields you want to pass to your experience. Values are accessible via `Expo.Constants.manifest.extra` ([Learn more](https://docs.expo.dev/versions/latest/sdk/constants/#constantsmanifest))
+     * Any extra fields you want to pass to your experience. Values are accessible via `Constants.expoConfig.extra` ([Learn more](https://docs.expo.dev/versions/latest/sdk/constants/#constantsmanifest))
      */
     extra?: {
         [k: string]: any;
@@ -187,9 +178,9 @@ export interface ExpoConfig {
          */
         enabled?: boolean;
         /**
-         * By default, Expo will check for updates every time the app is loaded. Set this to `ON_ERROR_RECOVERY` to disable automatic checking unless recovering from an error. Must be one of `ON_LOAD` or `ON_ERROR_RECOVERY`
+         * By default, Expo will check for updates every time the app is loaded. Set this to `ON_ERROR_RECOVERY` to disable automatic checking unless recovering from an error. Set this to `NEVER` to completely disable automatic checking. Must be one of `ON_LOAD` (default value), `ON_ERROR_RECOVERY`, `WIFI_ONLY`, or `NEVER`
          */
-        checkAutomatically?: 'ON_ERROR_RECOVERY' | 'ON_LOAD';
+        checkAutomatically?: 'ON_ERROR_RECOVERY' | 'ON_LOAD' | 'WIFI_ONLY' | 'NEVER';
         /**
          * How long (in ms) to allow for fetching OTA updates before falling back to a cached version of the app. Defaults to 0. Must be between 0 and 300000 (5 minutes).
          */
@@ -215,6 +206,16 @@ export interface ExpoConfig {
              */
             keyid?: string;
         };
+        /**
+         * Extra HTTP headers to include in HTTP requests made by `expo-updates`. These may override preset headers.
+         */
+        requestHeaders?: {
+            [k: string]: any;
+        };
+        /**
+         * Whether to use deprecated Classic Updates when developing with the local Expo CLI and creating builds. Omitting this or setting it to false affects the behavior of APIs like `Constants.manifest`. SDK 49 is the last SDK version that supports Classic Updates.
+         */
+        useClassicUpdates?: boolean;
     };
     /**
      * Provide overrides by locale for System Dialog prompts like Permissions Boxes
@@ -224,30 +225,6 @@ export interface ExpoConfig {
             [k: string]: any;
         };
     };
-    /**
-     * Used for all Facebook libraries. Set up your Facebook App ID at https://developers.facebook.com.
-     */
-    facebookAppId?: string;
-    /**
-     * Whether the Facebook SDK should be initialized automatically. The default in Expo (Client and in standalone apps) is `false`.
-     */
-    facebookAutoInitEnabled?: boolean;
-    /**
-     * Whether the Facebook SDK log app events automatically. If you don't set this property, Facebook's default will be used. (Applicable only to standalone apps.) Note: The Facebook SDK must be initialized for app events to work. You may autoinitialize Facebook SDK by setting `facebookAutoInitEnabled` to `true`
-     */
-    facebookAutoLogAppEventsEnabled?: boolean;
-    /**
-     * Whether the Facebook SDK should collect advertiser ID properties, like the Apple IDFA and Android Advertising ID, automatically. If you don't set this property, Facebook's default policy will be used. (Applicable only to standalone apps.)
-     */
-    facebookAdvertiserIDCollectionEnabled?: boolean;
-    /**
-     * Used for native Facebook login.
-     */
-    facebookDisplayName?: string;
-    /**
-     * Used for Facebook native login. Starts with 'fb' and followed by a string of digits, like 'fb1234567890'. You can find your scheme [here](https://developers.facebook.com/docs/facebook-login/ios)in the 'Configuring Your info.plist' section (only applicable to standalone apps and custom Expo Go apps).
-     */
-    facebookScheme?: string;
     /**
      * Is app detached
      */
@@ -268,7 +245,7 @@ export interface ExpoConfig {
     plugins?: (string | [] | [string] | [string, any])[];
     splash?: Splash;
     /**
-     * Specifies the JavaScript engine for apps. Supported only on EAS Build. Defaults to `jsc`. Valid values: `hermes`, `jsc`.
+     * Specifies the JavaScript engine for apps. Supported only on EAS Build. Defaults to `hermes`. Valid values: `hermes`, `jsc`.
      */
     jsEngine?: 'hermes' | 'jsc';
     ios?: IOS;
@@ -285,6 +262,10 @@ export interface ExpoConfig {
      * Enable experimental features that may be unstable, unsupported, or removed without deprecation notices.
      */
     experiments?: {
+        /**
+         * Enable tsconfig/jsconfig `compilerOptions.paths` and `compilerOptions.baseUrl` support for import aliases in Metro.
+         */
+        tsconfigPaths?: boolean;
         /**
          * Enables Turbo Modules, which are a type of native modules that use a different way of communicating between JS and platform code. When installing a Turbo Module you will need to enable this experimental option (the library still needs to be a part of Expo SDK already, like react-native-reanimated v2). Turbo Modules do not support remote debugging and enabling this option will disable remote debugging.
          */
@@ -338,7 +319,7 @@ export interface IOS {
      */
     bundleIdentifier?: string;
     /**
-     * Build number for your iOS standalone app. Corresponds to `CFBundleVersion` and must match Apple's [specified format](https://developer.apple.com/library/content/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/20001431-102364). (Note: Transporter will pull the value for `Version Number` from `expo.version` and NOT from `expo.ios.buildNumber`.)
+     * Build number for your iOS standalone app. Corresponds to `CFBundleVersion` and must match Apple's [specified format](https://developer.apple.com/documentation/bundleresources/information_property_list/cfbundleversion). (Note: Transporter will pull the value for `Version Number` from `expo.version` and NOT from `expo.ios.buildNumber`.)
      */
     buildNumber?: string;
     /**
@@ -351,16 +332,12 @@ export interface IOS {
      *  Expo will generate the other required sizes. This icon will appear on the home screen and within the Expo app.
      */
     icon?: string;
-    /**
-     * @deprecated Merchant ID for use with Apple Pay in your standalone app.
-     */
-    merchantId?: string;
     /**
      * URL to your app on the Apple App Store, if you have deployed it there. This is used to link to your store page from your Expo project page if your app is public.
      */
     appStoreUrl?: string;
     /**
-     * Enable iOS Bitcode optimizations in the native build. Accepts the name of an iOS build configuration to enable for a single configuration and disable for all others, e.g. Debug, Release. Not available in the classic 'expo build:ios' or Expo Go. Defaults to `undefined` which uses the template's predefined settings.
+     * Enable iOS Bitcode optimizations in the native build. Accepts the name of an iOS build configuration to enable for a single configuration and disable for all others, e.g. Debug, Release. Not available in Expo Go. Defaults to `undefined` which uses the template's predefined settings.
      */
     bitcode?: boolean | string;
     /**
@@ -392,15 +369,6 @@ export interface IOS {
          * A boolean indicating whether to initialize Google App Measurement and begin sending user-level event data to Google immediately when the app starts. The default in Expo (Go and in standalone apps) is `false`. [Sets the opposite of the given value to the following key in `Info.plist`.](https://developers.google.com/admob/ios/eu-consent#delay_app_measurement_optional)
          */
         googleMobileAdsAutoInit?: boolean;
-        /**
-         * @deprecated Use `ios.googleServicesFile` instead.
-         */
-        googleSignIn?: {
-            /**
-             * @deprecated Use `ios.googleServicesFile` instead.
-             */
-            reservedClientId?: string;
-        };
     };
     /**
      * [Firebase Configuration File](https://support.google.com/firebase/answer/7015592) Location of the `GoogleService-Info.plist` file for configuring Firebase.
@@ -454,10 +422,6 @@ export interface IOS {
      * Configuration for loading and splash screen for standalone iOS apps.
      */
     splash?: {
-        /**
-         * @deprecated Apple has deprecated `.xib` splash screens in favor of `.storyboard` files. Local path to a XIB file as the loading screen. It overrides other loading screen options. Note: This will only be used in the standalone app (i.e., after you build the app). It will not be used in the Expo Go.
-         */
-        xib?: string;
         /**
          * Color to fill the loading screen background
          */
@@ -474,21 +438,42 @@ export interface IOS {
          * Local path or remote URL to an image to fill the background of the loading screen. Image size and aspect ratio are up to you. Must be a .png.
          */
         tabletImage?: string;
+        /**
+         * Configuration for loading and splash screen for standalone iOS apps in dark mode.
+         */
+        dark?: {
+            /**
+             * Color to fill the loading screen background
+             */
+            backgroundColor?: string;
+            /**
+             * Determines how the `image` will be displayed in the splash loading screen. Must be one of `cover` or `contain`, defaults to `contain`.
+             */
+            resizeMode?: 'cover' | 'contain';
+            /**
+             * Local path or remote URL to an image to fill the background of the loading screen. Image size and aspect ratio are up to you. Must be a .png.
+             */
+            image?: string;
+            /**
+             * Local path or remote URL to an image to fill the background of the loading screen. Image size and aspect ratio are up to you. Must be a .png.
+             */
+            tabletImage?: string;
+            [k: string]: any;
+        };
         [k: string]: any;
     };
     /**
-     * Specifies the JavaScript engine for iOS apps. Supported only on EAS Build. Defaults to `jsc`. Valid values: `hermes`, `jsc`.
+     * Specifies the JavaScript engine for iOS apps. Supported only on EAS Build. Defaults to `hermes`. Valid values: `hermes`, `jsc`.
      */
     jsEngine?: 'hermes' | 'jsc';
     /**
      * **Note: Don't use this property unless you are sure what you're doing**
      *
      * The runtime version associated with this manifest for the iOS platform. If provided, this will override the top level runtimeVersion key.
-     * Set this to `{"policy": "nativeVersion"}` to generate it automatically based on the 'version' and 'ios.buildNumber' or
-     * to `{"policy": "appVersion"}` to use just 'version' field.
+     * Set this to `{"policy": "nativeVersion"}` to generate it automatically.
      */
     runtimeVersion?: string | {
-        policy: RuntimeVersionPolicy;
+        policy: 'nativeVersion' | 'sdkVersion' | 'appVersion';
     };
 }
 /**
@@ -519,10 +504,6 @@ export interface Android {
      * Configuration to force the app to always use the light or dark user-interface appearance, such as "dark mode", or make it automatically adapt to the system preferences. If not provided, defaults to `light`. Requires `expo-system-ui` be installed in your project to work on Android.
      */
     userInterfaceStyle?: 'light' | 'dark' | 'automatic';
-    /**
-     * @deprecated A Boolean value that indicates whether the app should use the new notifications API.
-     */
-    useNextNotificationsApi?: boolean;
     /**
      * Local path or remote URL to an image to use for your app's icon on Android. If specified, this overrides the top-level `icon` key. We recommend that you use a 1024x1024 png file (transparency is recommended for the Google Play Store). This icon will appear on the home screen and within the Expo app.
      */
@@ -536,7 +517,11 @@ export interface Android {
          */
         foregroundImage?: string;
         /**
-         * Local path or remote URL to a background image for your app's Adaptive Icon on Android. If specified, this overrides the `backgroundColor` key. Must have the same dimensions as  foregroundImage`, and has no effect if `foregroundImage` is not specified. Should follow the [specified guidelines](https://developer.android.com/guide/practices/ui_guidelines/icon_design_adaptive).
+         * Local path or remote URL to an image representing the Android 13+ monochromatic icon. Should follow the [specified guidelines](https://developer.android.com/guide/practices/ui_guidelines/icon_design_adaptive). This icon will appear on the home screen when the user enables 'Themed icons' in system settings on a device running Android 13+.
+         */
+        monochromeImage?: string;
+        /**
+         * Local path or remote URL to a background image for your app's Adaptive Icon on Android. If specified, this overrides the `backgroundColor` key. Must have the same dimensions as `foregroundImage`, and has no effect if `foregroundImage` is not specified. Should follow the [specified guidelines](https://developer.android.com/guide/practices/ui_guidelines/icon_design_adaptive).
          */
         backgroundImage?: string;
         /**
@@ -599,7 +584,7 @@ export interface Android {
      */
     permissions?: string[];
     /**
-     * List of permissions to block in the final `AndroidManifest.xml`. This is useful for removing permissions that are added by native package `AndroidManifest.xml` files which are merged into the final manifest. Internally this feature uses the `tools:node="remove"` XML attribute to remove permissions. Not available in the classic `expo build:android` or Expo Go.
+     * List of permissions to block in the final `AndroidManifest.xml`. This is useful for removing permissions that are added by native package `AndroidManifest.xml` files which are merged into the final manifest. Internally this feature uses the `tools:node="remove"` XML attribute to remove permissions. Not available in Expo Go.
      */
     blockedPermissions?: string[];
     /**
@@ -636,19 +621,6 @@ export interface Android {
          * A boolean indicating whether to initialize Google App Measurement and begin sending user-level event data to Google immediately when the app starts. The default in Expo (Client and in standalone apps) is `false`. [Sets the opposite of the given value to the following key in `Info.plist`](https://developers.google.com/admob/ios/eu-consent#delay_app_measurement_optional)
          */
         googleMobileAdsAutoInit?: boolean;
-        /**
-         * @deprecated Use `googleServicesFile` instead. [Google Sign-In Android SDK](https://developers.google.com/identity/sign-in/android/start-integrating) keys for your standalone app.
-         */
-        googleSignIn?: {
-            /**
-             * The Android API key. Can be found in the credentials section of the developer console or in `google-services.json`.
-             */
-            apiKey?: string;
-            /**
-             * The SHA-1 hash of the signing certificate used to build the APK without any separator (`:`). Can be found in `google-services.json`. https://developers.google.com/android/guides/client-auth
-             */
-            certificateHash?: string;
-        };
     };
     /**
      * Configuration for loading and splash screen for managed and standalone Android apps.
@@ -696,6 +668,54 @@ export interface Android {
          *  `Scale 4x`
          */
         xxxhdpi?: string;
+        /**
+         * Configuration for loading and splash screen for managed and standalone Android apps in dark mode.
+         */
+        dark?: {
+            /**
+             * Color to fill the loading screen background
+             */
+            backgroundColor?: string;
+            /**
+             * Determines how the `image` will be displayed in the splash loading screen. Must be one of `cover`, `contain` or `native`, defaults to `contain`.
+             */
+            resizeMode?: 'cover' | 'contain' | 'native';
+            /**
+             * Local path or remote URL to an image to fill the background of the loading screen. Image size and aspect ratio are up to you. Must be a .png.
+             */
+            image?: string;
+            /**
+             * Local path or remote URL to an image to fill the background of the loading screen in "native" mode. Image size and aspect ratio are up to you. [Learn more]( https://developer.android.com/training/multiscreen/screendensities)
+             *
+             *  `Natural sized image (baseline)`
+             */
+            mdpi?: string;
+            /**
+             * Local path or remote URL to an image to fill the background of the loading screen in "native" mode. Image size and aspect ratio are up to you. [Learn more]( https://developer.android.com/training/multiscreen/screendensities)
+             *
+             *  `Scale 1.5x`
+             */
+            hdpi?: string;
+            /**
+             * Local path or remote URL to an image to fill the background of the loading screen in "native" mode. Image size and aspect ratio are up to you. [Learn more]( https://developer.android.com/training/multiscreen/screendensities)
+             *
+             *  `Scale 2x`
+             */
+            xhdpi?: string;
+            /**
+             * Local path or remote URL to an image to fill the background of the loading screen in "native" mode. Image size and aspect ratio are up to you. [Learn more]( https://developer.android.com/training/multiscreen/screendensities)
+             *
+             *  `Scale 3x`
+             */
+            xxhdpi?: string;
+            /**
+             * Local path or remote URL to an image to fill the background of the loading screen in "native" mode. Image size and aspect ratio are up to you. [Learn more]( https://developer.android.com/training/multiscreen/screendensities)
+             *
+             *  `Scale 4x`
+             */
+            xxxhdpi?: string;
+            [k: string]: any;
+        };
         [k: string]: any;
     };
     /**
@@ -719,18 +739,17 @@ export interface Android {
      */
     softwareKeyboardLayoutMode?: 'resize' | 'pan';
     /**
-     * Specifies the JavaScript engine for Android apps. Supported only on EAS Build and in Expo Go. Defaults to `jsc`. Valid values: `hermes`, `jsc`.
+     * Specifies the JavaScript engine for Android apps. Supported only on EAS Build and in Expo Go. Defaults to `hermes`. Valid values: `hermes`, `jsc`.
      */
     jsEngine?: 'hermes' | 'jsc';
     /**
      * **Note: Don't use this property unless you are sure what you're doing**
      *
      * The runtime version associated with this manifest for the Android platform. If provided, this will override the top level runtimeVersion key.
-     * Set this to `{"policy": "nativeVersion"}` to generate it automatically based on the 'version' and 'versionCode' or
-     * to `{"policy": "appVersion"}` to use just 'version' field.
+     * Set this to `{"policy": "nativeVersion"}` to generate it automatically.
      */
     runtimeVersion?: string | {
-        policy: RuntimeVersionPolicy;
+        policy: 'nativeVersion' | 'sdkVersion' | 'appVersion';
     };
 }
 export interface AndroidIntentFiltersData {
@@ -767,6 +786,10 @@ export interface AndroidIntentFiltersData {
  * Configuration that is specific to the web platform.
  */
 export interface Web {
+    /**
+     * Sets the rendering method for the web app for both `expo start` and `expo export`. `static` statically renders HTML files for every route in the `app/` directory, which is available only in Expo Router apps. `single` outputs a Single Page Application (SPA), with a single `index.html` in the output folder, and has no statically indexable HTML. Defaults to `single`.
+     */
+    output?: 'single' | 'static';
     /**
      * Relative path of an image to use for your app's favicon.
      */
@@ -877,4 +900,3 @@ export interface PublishHook {
     };
     [k: string]: any;
 }
-export declare type RuntimeVersionPolicy = 'sdkVersion' | 'nativeVersion' | 'appVersion';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expo/config-types",
-  "version": "47.0.0",
+  "version": "49.0.0-alpha.1",
   "description": "Types for the Expo config object app.config.ts",
   "types": "build/ExpoConfig.d.ts",
   "main": "build/ExpoConfig.js",
@@ -10,7 +10,7 @@
     "generate": "ts-node ./scripts/generate.ts",
     "prepare": "yarn run clean && yarn build",
     "clean": "rimraf build ./tsconfig.tsbuildinfo",
-    "lint": "eslint .",
+    "lint": "eslint . && npx prettier --write src/ExpoConfig.ts",
     "test": "jest"
   },
   "repository": {
@@ -35,11 +35,12 @@
     "build"
   ],
   "devDependencies": {
+    "@expo/babel-preset-cli": "^0.2.24",
     "json-schema-to-typescript": "^10.0.0",
-    "@expo/babel-preset-cli": "^0.2.24"
+    "ts-node": "^10.9.1"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "eab2b09c735fb0fc2bf734a3f29a6593adba3838"
+  "gitHead": "b8be1f6c8dc273698908751db0555049866d899b"
 }