rename parsePlatformValue to tryParsePlatform

Author: JasonVMo

packages/tools-react-native/README.md

@@ -37,8 +37,8 @@ import * as platformTools from "@rnx-kit/tools-react-native/platform";
 | platform | `getAvailablePlatformsUncached(startDir, platformMap)` | Returns a map of available React Native platforms. The result is NOT cached.                                                                                                                           |
 | platform | `getModuleSuffixes(platform, appendEmpty)`             | Get the module suffixes array for a given platform, suitable for use with TypeScript's moduleSuffixes setting in the form of ['.ios', '.native', ''] or ['.windows', '.win', '.native', ''] or similar |
 | platform | `parsePlatform(val)`                                   | Parse a string to ensure it maps to a valid react-native platform.                                                                                                                                     |
-| platform | `parsePlatformValue(val)`                              |                                                                                                                                                                                                        |
 | platform | `platformExtensions(platform)`                         | Returns file extensions that can be mapped to the target platform.                                                                                                                                     |
 | platform | `platformValues()`                                     |                                                                                                                                                                                                        |
+| platform | `tryParsePlatform(val)`                                |                                                                                                                                                                                                        |
 
 <!-- @rnx-kit/api end -->

packages/tools-react-native/src/index.ts

@@ -15,8 +15,8 @@ export {
   getAvailablePlatformsUncached,
   getModuleSuffixes,
   parsePlatform,
-  parsePlatformValue,
   platformExtensions,
   platformValues,
+  tryParsePlatform,
 } from "./platform";
 export type { AllPlatforms } from "./platform";

packages/tools-react-native/src/platform.ts

@@ -172,7 +172,7 @@ export function platformExtensions(platform: string): string[] {
 /**
  * @returns the given string as a platform value or undefined if it is not a valid platform.
  */
-export function parsePlatformValue(val: string): AllPlatforms | undefined {
+export function tryParsePlatform(val: string): AllPlatforms | undefined {
   return allValues.includes(val as AllPlatforms)
     ? (val as AllPlatforms)
     : undefined;
@@ -185,7 +185,7 @@ export function parsePlatformValue(val: string): AllPlatforms | undefined {
  * @returns React-native platform name. Throws `Error` on failure.
  */
 export function parsePlatform(val: string): AllPlatforms {
-  const platform = parsePlatformValue(val);
+  const platform = tryParsePlatform(val);
   if (!platform) {
     throw new Error(`Unknown platform '${val}'`);
   }