-
Notifications
You must be signed in to change notification settings - Fork 24.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Place TypeScript Declarations Alongside Source Files
Summary: React Native's TS definitions are currently mostly stored in one monolithic file. This change splits the definitions up to correspond to the source files they came from, and are placed next to the source files. I think this should help inform, and make it easy to update the TS declarations when touching the Flow file. I noticed as part of the change that the typings have not yet removed many APIs that were removed from RN. This is bad, since it means using the removed/non-functional API doesn't cause typechecker errors. Locating typings next to source should prevent that from being able to happen. The organization here means individual TS declarations can declare what will be in the RN entrypoint, which is a little confusing. Seems like a good potential next refactor, beyond the literal translation I did. Changelog: [General][Changed] - Place TS Declarations Alongside Source Files Reviewed By: lunaleaps, rshest Differential Revision: D39796598 fbshipit-source-id: b36366466fd1976bdd2d4c8f7a4104a33c457a07
- Loading branch information
1 parent
77e79d6
commit 8cdc9e7
Showing
85 changed files
with
10,329 additions
and
10,857 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,79 @@ | ||
/** | ||
* Copyright (c) Meta Platforms, Inc. and affiliates. | ||
* | ||
* This source code is licensed under the MIT license found in the | ||
* LICENSE file in the root directory of this source tree. | ||
* | ||
* @format | ||
*/ | ||
|
||
import {ProcessedColorValue} from '../StyleSheet/processColor'; | ||
import {ColorValue} from '../StyleSheet/StyleSheet'; | ||
|
||
/** | ||
* @see: https://reactnative.dev/docs/actionsheetios#content | ||
*/ | ||
export interface ActionSheetIOSOptions { | ||
title?: string | undefined; | ||
options: string[]; | ||
cancelButtonIndex?: number | undefined; | ||
destructiveButtonIndex?: number | number[] | undefined | null; | ||
message?: string | undefined; | ||
anchor?: number | undefined; | ||
tintColor?: ColorValue | ProcessedColorValue | undefined; | ||
cancelButtonTintColor?: ColorValue | ProcessedColorValue | undefined; | ||
userInterfaceStyle?: 'light' | 'dark' | undefined; | ||
disabledButtonIndices?: number[] | undefined; | ||
} | ||
|
||
export interface ShareActionSheetIOSOptions { | ||
message?: string | undefined; | ||
url?: string | undefined; | ||
subject?: string | undefined; | ||
/** The activities to exclude from the ActionSheet. | ||
* For example: ['com.apple.UIKit.activity.PostToTwitter'] | ||
*/ | ||
excludedActivityTypes?: string[] | undefined; | ||
} | ||
|
||
/** | ||
* @see https://reactnative.dev/docs/actionsheetios#content | ||
*/ | ||
export interface ActionSheetIOSStatic { | ||
/** | ||
* Display an iOS action sheet. The `options` object must contain one or more | ||
* of: | ||
* - `options` (array of strings) - a list of button titles (required) | ||
* - `cancelButtonIndex` (int) - index of cancel button in `options` | ||
* - `destructiveButtonIndex` (int) - index of destructive button in `options` | ||
* - `title` (string) - a title to show above the action sheet | ||
* - `message` (string) - a message to show below the title | ||
*/ | ||
showActionSheetWithOptions: ( | ||
options: ActionSheetIOSOptions, | ||
callback: (buttonIndex: number) => void, | ||
) => void; | ||
|
||
/** | ||
* Display the iOS share sheet. The `options` object should contain | ||
* one or both of `message` and `url` and can additionally have | ||
* a `subject` or `excludedActivityTypes`: | ||
* | ||
* - `url` (string) - a URL to share | ||
* - `message` (string) - a message to share | ||
* - `subject` (string) - a subject for the message | ||
* - `excludedActivityTypes` (array) - the activities to exclude from the ActionSheet | ||
* | ||
* NOTE: if `url` points to a local file, or is a base64-encoded | ||
* uri, the file it points to will be loaded and shared directly. | ||
* In this way, you can share images, videos, PDF files, etc. | ||
*/ | ||
showShareActionSheetWithOptions: ( | ||
options: ShareActionSheetIOSOptions, | ||
failureCallback: (error: Error) => void, | ||
successCallback: (success: boolean, method: string) => void, | ||
) => void; | ||
} | ||
|
||
export const ActionSheetIOS: ActionSheetIOSStatic; | ||
export type ActionSheetIOS = ActionSheetIOSStatic; |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,90 @@ | ||
/** | ||
* Copyright (c) Meta Platforms, Inc. and affiliates. | ||
* | ||
* This source code is licensed under the MIT license found in the | ||
* LICENSE file in the root directory of this source tree. | ||
* | ||
* @format | ||
*/ | ||
|
||
/** | ||
* @see https://reactnative.dev/docs/alert#content | ||
*/ | ||
export interface AlertButton { | ||
text?: string | undefined; | ||
onPress?: ((value?: string) => void) | undefined; | ||
isPreferred?: boolean; | ||
style?: 'default' | 'cancel' | 'destructive' | undefined; | ||
} | ||
|
||
interface AlertOptions { | ||
/** @platform android */ | ||
cancelable?: boolean | undefined; | ||
userInterfaceStyle?: 'unspecified' | 'light' | 'dark'; | ||
/** @platform android */ | ||
onDismiss?: (() => void) | undefined; | ||
} | ||
|
||
/** | ||
* Launches an alert dialog with the specified title and message. | ||
* | ||
* Optionally provide a list of buttons. Tapping any button will fire the | ||
* respective onPress callback and dismiss the alert. By default, the only | ||
* button will be an 'OK' button. | ||
* | ||
* This is an API that works both on iOS and Android and can show static | ||
* alerts. To show an alert that prompts the user to enter some information, | ||
* see `AlertIOS`; entering text in an alert is common on iOS only. | ||
* | ||
* ## iOS | ||
* | ||
* On iOS you can specify any number of buttons. Each button can optionally | ||
* specify a style, which is one of 'default', 'cancel' or 'destructive'. | ||
* | ||
* ## Android | ||
* | ||
* On Android at most three buttons can be specified. Android has a concept | ||
* of a neutral, negative and a positive button: | ||
* | ||
* - If you specify one button, it will be the 'positive' one (such as 'OK') | ||
* - Two buttons mean 'negative', 'positive' (such as 'Cancel', 'OK') | ||
* - Three buttons mean 'neutral', 'negative', 'positive' (such as 'Later', 'Cancel', 'OK') | ||
* | ||
* ``` | ||
* // Works on both iOS and Android | ||
* Alert.alert( | ||
* 'Alert Title', | ||
* 'My Alert Msg', | ||
* [ | ||
* {text: 'Ask me later', onPress: () => console.log('Ask me later pressed')}, | ||
* {text: 'Cancel', onPress: () => console.log('Cancel Pressed'), style: 'cancel'}, | ||
* {text: 'OK', onPress: () => console.log('OK Pressed')}, | ||
* ] | ||
* ) | ||
* ``` | ||
*/ | ||
export interface AlertStatic { | ||
alert: ( | ||
title: string, | ||
message?: string, | ||
buttons?: AlertButton[], | ||
options?: AlertOptions, | ||
) => void; | ||
prompt: ( | ||
title: string, | ||
message?: string, | ||
callbackOrButtons?: ((text: string) => void) | AlertButton[], | ||
type?: AlertType, | ||
defaultValue?: string, | ||
keyboardType?: string, | ||
) => void; | ||
} | ||
|
||
export type AlertType = | ||
| 'default' | ||
| 'plain-text' | ||
| 'secure-text' | ||
| 'login-password'; | ||
|
||
export const Alert: AlertStatic; | ||
export type Alert = AlertStatic; |
Oops, something went wrong.