Consolidate JS API scripts under scripts/js-api/, update docs (#52469)

Summary:
Pull Request resolved: #52469

Organise `scripts/build-types/` and `scripts/diff-api-snapshot/` into a single grouping `scripts/js-api/` parent dir — matching the newly relocated `scripts/cxx-api/`.

Changelog: [Internal]

Reviewed By: robhogan

Differential Revision: D77865488

fbshipit-source-id: 33754d9275e65c3bda686294f18d855221ec7bff

Author: huntie

.github/actions/diff-js-api-breaking-changes/action.yml

@@ -17,7 +17,7 @@ runs:
       env:
         SCRATCH_DIR: ${{ runner.temp }}/diff-js-api-breaking-changes
       run: |
-        node ./scripts/diff-api-snapshot \
+        node ./scripts/js-api/diff-api-snapshot \
         ${{ github.workspace }}/packages/react-native/ReactNativeApi.d.ts  \
         $SCRATCH_DIR/ReactNativeApi-after.d.ts \
         > $SCRATCH_DIR/output.json

package.json

@@ -8,7 +8,7 @@
     "android": "yarn --cwd packages/rn-tester android",
     "build-android": "./gradlew :packages:react-native:ReactAndroid:build",
     "build": "node ./scripts/build/build.js",
-    "build-types": "node ./scripts/build-types",
+    "build-types": "node ./scripts/js-api/build-types",
     "clang-format": "clang-format -i --glob=*/**/*.{h,cpp,m,mm}",
     "clean": "node ./scripts/build/clean.js",
     "cxx-api-build": "node ./scripts/cxx-api/public-api.js",
@@ -17,6 +17,7 @@
     "format-check": "prettier --list-different \"./**/*.{js,md,yml,ts,tsx}\"",
     "format": "npm run prettier && npm run clang-format",
     "featureflags": "yarn --cwd packages/react-native featureflags",
+    "js-api-diff": "node ./scripts/js-api/diff-api-snapshot",
     "lint-ci": "./.github/workflow-scripts/analyze_code.sh && yarn shellcheck",
     "lint-markdown": "markdownlint-cli2 2>&1",
     "lint": "eslint --max-warnings 0 .",

packages/react-native/ReactNativeApi.d.ts

@@ -4,9 +4,9 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @generated SignedSource<<b56aa13d53b10140225651b9701de96d>>
+ * @generated SignedSource<<83d07f37fd6028027511209f02e7f056>>
  *
- * This file was generated by scripts/build-types/index.js.
+ * This file was generated by scripts/js-api/build-types/index.js.
  */
 
 // ----------------------------------------------------------------------------

scripts/build-types/README.md scripts/js-api/README.mdscripts/build-types/README.md renamed to scripts/js-api/README.md

@@ -11,9 +11,9 @@
 
 import type {PluginObj} from '@babel/core';
 
-const {PACKAGES_DIR, REACT_NATIVE_PACKAGE_DIR} = require('../consts');
-const {isGitRepo} = require('../scm-utils');
-const {API_EXTRACTOR_CONFIG_FILE, TYPES_OUTPUT_DIR} = require('./config');
+const {PACKAGES_DIR, REACT_NATIVE_PACKAGE_DIR} = require('../../consts');
+const {isGitRepo} = require('../../scm-utils');
+const {API_EXTRACTOR_CONFIG_FILE, TYPES_OUTPUT_DIR} = require('../config');
 const apiSnapshotTemplate = require('./templates/ReactNativeApi.d.ts-template.js');
 const applyBabelTransformsSeq = require('./utils/applyBabelTransformsSeq');
 const resolveCyclicImportsInDefinition = require('./utils/resolveCyclicImportsInDefinition');

scripts/build-types/BuildApiSnapshot.js …s/js-api/build-types/buildApiSnapshot.jsscripts/build-types/BuildApiSnapshot.js renamed to scripts/js-api/build-types/buildApiSnapshot.js scripts/build-types/BuildApiSnapshot.js renamed to scripts/js-api/build-types/buildApiSnapshot.js

@@ -8,8 +8,8 @@
  * @format
  */
 
-const {PACKAGES_DIR, REPO_ROOT} = require('../consts');
-const {ENTRY_POINT, IGNORE_PATTERNS, TYPES_OUTPUT_DIR} = require('./config');
+const {PACKAGES_DIR, REPO_ROOT} = require('../../consts');
+const {ENTRY_POINT, IGNORE_PATTERNS, TYPES_OUTPUT_DIR} = require('../config');
 const getRequireStack = require('./resolution/getRequireStack');
 const translatedModuleTemplate = require('./templates/translatedModule.d.ts-template');
 const translateSourceFile = require('./translateSourceFile');

…ripts/build-types/buildGeneratedTypes.js …s-api/build-types/buildGeneratedTypes.jsscripts/build-types/buildGeneratedTypes.js renamed to scripts/js-api/build-types/buildGeneratedTypes.js scripts/build-types/buildGeneratedTypes.js renamed to scripts/js-api/build-types/buildGeneratedTypes.js

@@ -8,9 +8,9 @@
  * @format
  */
 
-require('../babel-register').registerForScript();
+require('../../babel-register').registerForScript();
 
-const buildApiSnapshot = require('./BuildApiSnapshot');
+const buildApiSnapshot = require('./buildApiSnapshot');
 const buildGeneratedTypes = require('./buildGeneratedTypes');
 const debug = require('debug');
 const {parseArgs, styleText} = require('util');
@@ -40,7 +40,7 @@ async function main() {
 
   if (help) {
     console.log(`
-  Usage: node ./scripts/build-types
+  Usage: node ./scripts/js-api/build-types
 
   Build generated TypeScript types for react-native.
 

scripts/build-types/index.js scripts/js-api/build-types/index.jsscripts/build-types/index.js renamed to scripts/js-api/build-types/index.js

@@ -8,7 +8,7 @@
  * @format
  */
 
-const {REPO_ROOT} = require('../../consts');
+const {REPO_ROOT} = require('../../../consts');
 const debug = require('debug')('build-types:resolution');
 const fs = require('fs');
 const path = require('path');